تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر Google معلومات الموقع الجغرافي من خلال العنصر
Geo. يصف هذا المستند
تفاصيل أعلى مستوى عن كيفية تعبئة Google للموقع الجغرافي في طلبات عروض
الأسعار ويقترح أفضل الممارسات لاستخدامه.
كيفية تعبئة عنصر Geo
لا تتيح Google سوى معلومات الموقع الجغرافي التي تصف الموقع الجغرافي
للجهاز الذي سيتم عرض الإعلان عليه، والتي يتم عرضها في
BidRequest.device.geo. لا يتم الحصول على معلومات الموقع الجغرافي هذه إلا من الموقع الجغرافي لعنوان IP، وليس من نظام تحديد المواقع العالمي (GPS) أو مصادر أخرى.
إجراءات حماية الخصوصية
لحماية خصوصية المستخدم، لا تقدّم Google سوى الموقع الجغرافي التقريبي الذي شاركه عدد كبير من المستخدمين، ما يؤدي إلى تعميم الموقع الجغرافي الذي تم رصده حسب الضرورة.
تمثيلات المواقع الجغرافية
يتيح عنصر Geo عرضَين منفصلَين للموقع الجغرافي، وهما الموقع الجغرافي المدني
والإحداثيات الجغرافية.
يتم تمثيل المواقع الجغرافية المدنية من خلال الحقول التالية:
country
region
metro
city
zip
يتم تمثيل الإحداثيات الجغرافية بالحقول التالية:
lat
lon
accuracy
يحتوي كلا التمثيلَين على الموقع الجغرافي والدقة نفسها. على سبيل المثال، إذا كان طلب BidRequest.device.geolatlonaccuracy تحدّ Google أيضًا من دقة الحقلين
lat وlon لتكون 0.01 درجة.
أفضل الممارسات المتعلّقة باستهداف الموقع الجغرافي
بالنسبة إلى مقدّمي عروض الأسعار الذين يحتاجون إلى بيانات موقع جغرافي مخصّصة، ننصحك باستخدام الحقول المقاربة
lat وlon وaccuracy لإجراء عمليات بحث عن الموقع الجغرافي المكاني.
لا ننصح باستخدام الحقل BidRequest.device.ip لتحديد الموقع الجغرافي،
لأنّ Google تشارك عنوان IP فقط في شكل مقتطع، ويمكن أن يؤدي استخدام عناوين IP المقطوفة
لتحديد الموقع الجغرافي إلى نتائج غير دقيقة إلى حد ما.
جدول المواقع الجغرافية (ميزة متوقّفة نهائيًا)
يمثّل الحقل BidRequest.device.geo.ext.geo_criteria_id الموقع الجغرافي كأحد
المعرّفات الرقمية، والذي يتم ربطه بموقع جغرافي في geo-table.csv
المتاح للتنزيل في
قسم الجداول المرجعية
من صفحة "البيانات المرجعية والنماذج الأولية". تم إيقاف هذا الحقل والجدول المقابل له
نهائيًا. يمكنك استخدام BidRequest.device.geo للحصول على معلومات مماثلة
عن الموقع الجغرافي.
على سبيل المثال، إذا كان طلب عروض الأسعار يعبّئ geo بدقة على مستوى المدينة،
سيحتوي geo_criteria_id على رمز المدينة المعنيّة. يمكنك
استخدام هذا المعرّف لتحديد موقع سجلّ في جدول المواقع الجغرافية.
الأعمدة
الرقم التعريفي للمعايير
معرّف مُحدَّد فريد ودائم في واجهة برمجة التطبيقات، تكون هذه المعايير من النوع
Location.
الاسم
أفضل اسم متاح باللغة الإنجليزية للاستهداف الجغرافي
الاسم الأساسي
الاسم الإنجليزي المؤهل بالكامل الذي تم إنشاؤه ويتكون من اسم
الهدف واسم الشركة الرئيسية والبلد هذا الحقل مخصّص فقط لإزالة التباس أسماء الاستهداف المتشابهة، وهو غير متاح في
LocationCriterionService
(استخدِم أسماء المواقع الجغرافية أو أرقام تعريف المعايير بدلاً من ذلك).
الرقم التعريفي للمصدر الرئيسي
معرّف المعايير لأحد المعايير الرئيسية تم تضمين هذا الحقل لدعم الإصدارات القديمة،
وقد لا تكون المعرّفات متسقة في مجموعات البيانات. إنّ الأسماء الأساسية هي
الطريقة المفضّلة لإنشاء التسلسلات الهرمية.
رمز المنطقة
رمز المنطقة وفقًا لمعيار ISO 3166-2 للولاية أو المحافظة المستهدَفة، إن توفّرت.
رمز البلد
رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 والمرتبط بالهدف
نوع الاستهداف
القيم المسموح بها:
مطار
الدائرة
منتدى مستقل
منطقة إدارية
كانتون
المدينة
منطقة في مدينة
دائرة انتخابية
البلد
المقاطعة
القسم
مقاطعة
منطقة سوق محددة
محافظة
مترو
بلدية
متنزه وطني
حي
تقسيم إقليمي
غير ذلك
الرمز البريدي
مديرية
إقليم
المنطقة
الحالة
المنطقة
منطقة بث تلفزيوني
إقليم اتحادي
جامعة
المواقع الجغرافية غير القابلة للاستهداف
بموجب اللوائح والقوانين المتعلقة بالإعلان في جمهورية الصين الشعبية،
قد يُطلب منك تقديم شهادات وتراخيص إذا كنت تُعلِن عن فئتين معيّنتين
من المنتجات في الصين. لست بحاجة إلى إرسال الشهادات إلا بعد فعالية حسابك. بعد تفعيل حسابك، سيتم تزويدك
بمعلومات حول كيفية إرسال الشهادات إلى Google.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle uses IP geolocation to provide coarse location data in bid requests, prioritizing user privacy by generalizing the location.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGeo\u003c/code\u003e object contains civil location fields (country, region, etc.) and geographical coordinates (lat, lon, accuracy) representing the same location.\u003c/p\u003e\n"],["\u003cp\u003eFor custom geolocation targeting, utilize the \u003ccode\u003elat\u003c/code\u003e, \u003ccode\u003elon\u003c/code\u003e, and \u003ccode\u003eaccuracy\u003c/code\u003e fields for spatial lookups instead of the truncated \u003ccode\u003eip\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egeo_criteria_id\u003c/code\u003e and associated geo-table are deprecated; migrate to the \u003ccode\u003eGeo\u003c/code\u003e object for location information.\u003c/p\u003e\n"],["\u003cp\u003eWhile some locations may appear in reports, they might be non-targetable due to advertising regulations, like those in China.\u003c/p\u003e\n"]]],[],null,["Google provides geolocation information through the\n[`Geo`](/authorized-buyers/rtb/openrtb-guide#geo) object. This document\ndescribes higher-level details of how Google populates geolocation in bid\nrequests and suggests best practices for its use.\n| **Note:** The `BidRequest.device.geo.ext.geo_criteria_id` field is deprecated; we encourage using the `Geo` object instead.\n\nHow the Geo object is populated\n\nGoogle only supports geolocation information describing the location of the\ndevice on which the ad would be rendered, which is exposed in\n`BidRequest.device.geo`. This location information is only obtained from IP\ngeolocation, never from GPS or other sources.\n\nPrivacy protections\n\nIn order to protect user privacy, Google only provides a coarse geolocation that\nis shared by a sufficiently large number of users, generalizing detected\nlocation as necessary.\n\nLocation representations\n\nThe `Geo` object supports two separate representations of location -- civil\nlocation and geographical coordinates.\n\nCivil locations are represented by the following fields:\n\n- `country`\n- `region`\n- `metro`\n- `city`\n- `zip`\n\nGeographical coordinates are represented by the following fields:\n\n- `lat`\n- `lon`\n- `accuracy`\n\nBoth representations contain the same location and accuracy. For example, if a\nbid request populates `BidRequest.device.geo` with city-level precision, then\nthe `lat` and `lon` fields will contain the latitude and longitude of the\ncenterpoint of the identified city, and `accuracy` will be the radius of a\ncircle with the same area as that city. Google also limits the precision of the\n`lat` and `lon` fields to 0.01 degrees.\n\nBest practices for geolocation targeting\n\nFor bidders that need custom geolocation data we recommend using the approximate\n`lat`, `lon` and `accuracy` fields for performing spatial geolocation lookups.\nWe don't recommend the use of the `BidRequest.device.ip` field for geolocation,\nsince Google only shares the IP address in truncated form; the use of truncated\nIP addresses for geolocation can result in somewhat inaccurate results.\n\nThe Geo Table (Deprecated) **Caution:** Google strongly recommends using `BidRequest.device.geo` instead. Support for the geo criteria ID has been temporarily added with the `BidRequest.device.geo.ext.geo_criteria_id` extension in order to simplify migration from the obsolete Google RTB protocol. Support for this extension can be removed at any time after May 1st, 2025.\n\nThe `BidRequest.device.geo.ext.geo_criteria_id` field represents geolocation as\na numeric identifier, which is mapped to a geolocation in **geo-table.csv**\navailable for download in the\n[Reference tables section](/authorized-buyers/rtb/data#reference-tables-click-to-download-csvs)\nof the Protos \\& Reference Data page. **This field and the corresponding table\nare now deprecated** . You can use `BidRequest.device.geo` to get similar\ngeolocation information.\n\nAs an example, if a bid request populates `geo` with city-level precision, then\nthe `geo_criteria_id` will contain the code for the corresponding city. You can\nuse that ID to locate a record in the geo table.\n\nColumns\n\nCriteria ID\n: Unique and persistent assigned ID. In the API, these criteria are of type\n [`Location`](/adwords/api/docs/reference/latest/CampaignCriterionService.Location).\n\nName\n: Best available English name of the geo target.\n\nCanonical Name\n: The constructed fully qualified English name consisting of the target's own\n name, and that of its parent and country. This field is meant only for\n disambiguating similar target names--it's not supported in\n [LocationCriterionService](/adwords/api/docs/reference/latest/LocationCriterionService)\n (use location names or criteria IDs instead).\n\nParent ID\n: The criteria ID of a parent. This field is included for legacy support,\n and the IDs may not be consistent across datasets. Canonical names is the\n preferred method of constructing hierarchies.\n\nRegion Code\n: The ISO 3166-2 region code for the state or province target, if one exists.\n\nCountry Code\n: The ISO-3166-1 alpha-2 country code that is associated with the target.\n\nTarget Type\n\n: Allowable values:\n\n - Airport\n - Arrondissement\n - Autonomous Community\n - Borough\n - Canton\n - City\n - City Region\n - Congressional District\n - Country\n - County\n - Department\n - District\n - DMA region\n - Governorate\n - Metro\n - Municipality\n - National Park\n - Neighborhood\n - Okrug\n - Other\n - Postal Code\n - Prefecture\n - Province\n - Region\n - State\n - Territory\n - TV Region\n - Union Territory\n - University\n\nNon-targetable locations **Note:** Some countries or territories are not targetable, but may appear in reports based on the user's area of interest or physical location.\n\nDue to advertising regulations and laws of the People's Republic of China, you\nmay be asked to provide certificates and licenses if you are advertising certain\ncategories of products in China. You do not need to submit certificates until\nafter your account has been activated. Once your account is active, you will be\nprovided with information on how to submit certificates to Google."]]
