با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
گوگل اطلاعات موقعیت جغرافیایی را از طریق شی Geo ارائه می کند. این سند جزئیات سطح بالاتری را از نحوه پر کردن مکان جغرافیایی Google در درخواست‌های پیشنهادی توضیح می‌دهد و بهترین روش‌ها را برای استفاده از آن پیشنهاد می‌کند.
نحوه پر شدن شی Geo
Google فقط از اطلاعات موقعیت جغرافیایی که موقعیت مکانی دستگاهی را که آگهی در آن ارائه می‌شود، که در BidRequest.device.geo نشان داده شده است، پشتیبانی می‌کند. این اطلاعات مکان فقط از موقعیت جغرافیایی IP به دست می آید، نه از GPS یا منابع دیگر.
حفاظت از حریم خصوصی
به منظور محافظت از حریم خصوصی کاربر، Google فقط موقعیت جغرافیایی گسترده ای را ارائه می دهد که توسط تعداد زیادی از کاربران به اشتراک گذاشته می شود و در صورت لزوم مکان شناسایی شده را تعمیم می دهد.
نمایندگی های مکان
شی Geo از دو نمایش مجزا از مکان پشتیبانی می کند - موقعیت شهری و مختصات جغرافیایی.
مکان های مدنی با فیلدهای زیر نشان داده می شوند:
country
region
metro
city
zip
مختصات جغرافیایی با فیلدهای زیر نشان داده می شود:
lat
lon
accuracy
هر دو نمایش حاوی مکان و دقت یکسانی هستند. برای مثال، اگر یک درخواست پیشنهادی BidRequest.device.geo با دقت سطح شهر پر کند، فیلدهای lat و lon شامل طول و عرض جغرافیایی نقطه مرکزی شهر شناسایی شده خواهند بود و accuracy شعاع دایره ای با مساحت آن شهر خواهد بود. گوگل همچنین دقت فیلدهای lat و lon را به 0.01 درجه محدود می کند.
بهترین روش ها برای هدف گذاری موقعیت جغرافیایی
برای مناقصه‌دهندگانی که به داده‌های موقعیت جغرافیایی سفارشی نیاز دارند، توصیه می‌کنیم از فیلدهای تقریبی lat ، lon و accuracy برای انجام جستجوهای مکان‌یابی مکانی استفاده کنند. ما استفاده از فیلد BidRequest.device.ip را برای موقعیت جغرافیایی توصیه نمی کنیم، زیرا Google فقط آدرس IP را به صورت کوتاه شده به اشتراک می گذارد. استفاده از آدرس های IP کوتاه شده برای موقعیت جغرافیایی می تواند نتایج تا حدودی نادرست را به همراه داشته باشد.
جدول جغرافیایی (منسوخ شده)
فیلد BidRequest.device.geo.ext.geo_criteria_id موقعیت جغرافیایی را به عنوان یک شناسه عددی نشان می‌دهد که به یک مکان جغرافیایی در geo-table.csv که برای دانلود در بخش جداول مرجع صفحه Protos & Reference Data موجود است، نگاشت می‌شود. این فیلد و جدول مربوطه اکنون منسوخ شده اند . برای دریافت اطلاعات موقعیت جغرافیایی مشابه می توانید از BidRequest.device.geo استفاده کنید.
به عنوان مثال، اگر یک درخواست پیشنهاد geo با دقت سطح شهر پر کند، geo_criteria_id حاوی کد شهر مربوطه خواهد بود. می توانید از آن شناسه برای یافتن یک رکورد در جدول جغرافیایی استفاده کنید.
ستون ها
شناسه معیار
شناسه اختصاص داده شده منحصر به فرد و مداوم. در API، این معیارها از نوع Location هستند.
نام
بهترین نام انگلیسی موجود برای هدف جغرافیایی.
نام متعارف
نام انگلیسی کاملا واجد شرایط ساخته شده که از نام خود هدف و نام والدین و کشور آن تشکیل شده است. این فیلد فقط برای ابهام‌زدایی از نامهای هدف مشابه است - در LocationCriterionService پشتیبانی نمی‌شود (به جای آن از نامهای مکان یا شناسه معیارها استفاده کنید).
شناسه والدین
شناسه معیار یک والدین. این فیلد برای پشتیبانی قدیمی گنجانده شده است و ممکن است شناسه‌ها در بین مجموعه داده‌ها سازگار نباشند. نامهای متعارف روش ترجیحی برای ساخت سلسله مراتب است.
کد منطقه
کد منطقه ای ISO 3166-2 برای هدف ایالت یا استان، در صورت وجود.
کد کشور
کد کشور ISO-3166-1 آلفا-2 که با هدف مرتبط است.
نوع هدف
مقادیر مجاز:
فرودگاه
منطقه
جامعه خودمختار
شهرستان
کانتون
شهر
منطقه شهرستان
منطقه کنگره
کشور
شهرستان
بخش
ناحیه
منطقه DMA
استانداری
مترو
شهرداری
پارک ملی
محله
اوکروگ
دیگر
کد پستی
بخشداری
استان
منطقه
ایالت
قلمرو
منطقه تلویزیونی
قلمرو اتحادیه
دانشگاه
مکان های غیر قابل هدف
با توجه به مقررات و قوانین تبلیغاتی جمهوری خلق چین، اگر در حال تبلیغ دسته‌های خاصی از محصولات در چین هستید، ممکن است از شما خواسته شود گواهی‌ها و مجوزها را ارائه دهید. تا زمانی که حساب کاربری شما فعال نشده باشد، نیازی به ارسال گواهی نیست. پس از فعال شدن حساب شما، اطلاعاتی در مورد نحوه ارسال گواهی به 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."]]
