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