Google מספקת מידע על מיקום גיאוגרפי באמצעות האובייקט Geo
, שמשותף לפרוטוקולים OpenRTB ו-Google. במסמך הזה מתוארים פרטים ברמה גבוהה יותר על האופן שבו Google מאכלסת את המיקום הגיאוגרפי בבקשות להצעות מחיר, ומציעה שיטות מומלצות לשימוש בו.
איך האובייקט הגיאוגרפי מאוכלס
Google שולפת את מיקומי המכשיר רק לפי מיקום גיאוגרפי ב-IP, ולא מ-GPS או ממקורות אחרים. מפרט OpenRTB תומך במיקומים גיאוגרפיים נפרדים למשתמש (לדוגמה, כתובת הבית) ולמכשיר (כאשר המכשיר נמצא כשהמודעה ממוקמת), אך Google תומכת רק במיקום השני. כתוצאה מכך, ההטמעה של OpenRTB ב-Google מאכלסת רק את BidRequest.device.geo
, ופרוטוקול RTB של Google שהוצא משימוש תומך רק בשדה BidRequest.geo
שמפנה למיקום המכשיר.
הגנות על הפרטיות
כדי להגן על פרטיות המשתמשים, Google מספקת רק מיקום גיאוגרפי גס שמשותף למספר גדול מספיק של משתמשים, תוך הכללת המיקום שזוהה לפי הצורך.
ייצוגי מיקום
האובייקט Geo
תומך בשני ייצוגים נפרדים של מיקום – מיקום אזרחי וקואורדינטות גיאוגרפיות.
מיקומים אזרחיים מיוצגים באמצעות השדות הבאים:
country
region
metro
city
zip
הקואורדינטות הגיאוגרפיות מיוצגות על ידי השדות הבאים:
lat
lon
accuracy
בפרוטוקולים של Google ו-OpenRTB, שני הייצוגים מכילים את אותו המיקום ואותו הדיוק. לדוגמה, אם בקשה להצעת מחיר מאכלסת את השדה Geo
עם דיוק ברמת העיר, השדות lat
ו-lon
יכילו את קו הרוחב וקו האורך של נקודת המרכז של העיר שצוינה, ו-accuracy
יהיה הרדיוס של מעגל עם אותו שטח כמו העיר הזו. בנוסף, Google מגבילה את הדיוק של השדות lat
ו-lon
ל-0.01 מעלות.
שיטות מומלצות לטירגוט למיקום גיאוגרפי
למגישי הצעות מחיר שצריכים נתוני מיקום גיאוגרפי מותאמים אישית, מומלץ להשתמש בשדות lat
, lon
ו-accuracy
המשוערים כדי לבצע חיפושים של מיקום גיאוגרפי מרחבי.
לא מומלץ להשתמש בשדה ip
למיקום גיאוגרפי, כי Google משתפת את כתובת ה-IP רק בצורה קטועה. השימוש בכתובות IP חתוכות למיקום גיאוגרפי עלול להוביל לתוצאות די לא מדויקות.
טבלת המיקומים הגיאוגרפיים (הוצאה משימוש)
השדה BidRequest.geo_criteria_id
של פרוטוקול RTB של Google שהוצא משימוש מייצג את המיקום הגיאוגרפי כמזהה מספרי, שממופה למיקום גיאוגרפי ב-geo-table.csv שזמין להורדה בקטע 'טבלאות עזר' בדף Protos & Reference Data. השדה הזה והטבלה התואמת הוצאו משימוש. אפשר להשתמש בשדה Geo
כדי לקבל מידע דומה על מיקום גיאוגרפי.
לדוגמה, אם הבקשה להצעת מחיר מכילה את הערך Geo
ברמת דיוק ברמת העיר, השדה geo_criteria_id
יכיל את הקוד של העיר המתאימה.
אפשר להשתמש במזהה הזה כדי לאתר רשומה בטבלת המיקומים הגיאוגרפיים.
עמודות
- מזהה קריטריון
- מזהה מוקצה ייחודי וקבוע. ב-API, הקריטריונים האלה הם מסוג
Location
. - שם
- השם הזמין הטוב ביותר של הטירגוט הגיאוגרפי באנגלית.
- השם הקנוני
- השם המורכב המלא באנגלית שמכיל את השם של המטרה עצמה ואת השם של ההורה והמדינה. השדה הזה נועד רק להבחנה בין שמות יעדים דומים – הוא לא נתמך ב-LocationCriterionService (במקום זאת, צריך להשתמש בשמות מיקומים או במזהי קריטריונים).
- זיהוי אב
- מזהה הקריטריונים של הורה. השדה הזה כלול לתמיכה מדור קודם, ויכול להיות שהמזהים לא יהיו עקביים בין מערכי הנתונים. שמות קנוניים הם השיטה המועדפת ליצירת היררכיות.
- קוד אזור
- קוד האזור לפי תקן ISO 3166-2 של המדינה או המחוז, אם קיים.
- קוד המדינה
- קוד המדינה בפורמט ISO-3166-1 alpha-2 המשויך ליעד.
- סוג המיקוד
ערכים מותרים:
- נמל תעופה
- רובע
- קהילה אוטונומית
- רובע
- קנטון
- עיר
- אזור של עיר
- מחוז קונגרס
- מדינה
- מחוז (בבריטניה)
- מחלקה
- מחוז
- אזור DMA
- Governorate
- מטרו
- רשות מקומית
- פארק לאומי
- שכונה
- רובע
- אחר
- מיקוד
- נפה
- מחוז
- אזור
- ארץ
- אזור
- אזור טלוויזיה
- טריטוריה של איחוד
- אוניברסיטה
מיקומים שלא ניתן לטרגט
עקב תקנות פרסום וחוקים של הרפובליקה העממית של סין, אם אתם מפרסמים קטגוריות מסוימות של מוצרים בסין, ייתכן שתתבקשו לספק אישורים ורישיונות. אין צורך לשלוח אישורים עד שהחשבון יופעל. כשהחשבון שלכם יהיה פעיל, תקבלו מידע שמסביר איך לשלוח אישורים ל-Google.