כדי לשלוף נתונים באופן אוטומטי או בקנה מידה גדול לצורך ניסויי GeoX, צריך להשתמש ב-Google Ads API כדי לשלוף נתוני עלות והוצאות. אחר כך אתם משלבים את הנתונים האלה עם נתונים גולמיים, לא מסוננים ולא משויכים של המרות או הכנסות ממערכת ה-CRM הפנימית, מנקודת מכירה (POS) או ממסדי נתונים פנימיים של מכירות.
ארכיטקטורה מומלצת לתהליך עבודה של API
כדי לשלוף במדויק נתוני קמפיינים ועלויות לפי פלחים גיאוגרפיים, צריך לפעול לפי המבנה הבא:
- שירות: משתמשים ב-
GoogleAdsService, באופן ספציפי בשיטותSearchאוSearchStream. מקור מידע: שאילתה
geographic_viewכדי לראות איפה המשתמש נמצא פיזית או איפה הוא הביע עניין, שזה בדרך כלל הסטנדרט לניסויי GeoX. לחלופין, אפשר לשלוח שאילתה לגביlocation_viewכדי לראות את הביצועים על סמך מיקומים גיאוגרפיים לטירגוט ספציפיים שהקמפיין מטרגט.שדות להכללה:
campaign.idsegments.datesegments.geo_target_city(או אזור או מדינה, בהתאם לרמת הפירוט של GeoX)metrics.cost_micros
שאילתת GAQL לדוגמה: ב-GeoX, המפרסמים שולפים מדדי עלות באמצעות Google Ads API במקום המרות משויכות (שאמורות להגיע ממערכות CRM פנימיות או ממערכות של צד שלישי). אפשר להשתמש בשאילתה הבאה:
SELECT campaign.id, segments.date, segments.geo_target_city, metrics.cost_micros FROM geographic_view WHERE segments.date DURING LAST_30_DAYS
עיבוד לאחר סריקה וחילוץ נתונים
מיפוי של פלחים גיאוגרפיים: ממשק ה-API לא מחזיר שמות בטקסט פשוט (כמו 'ניו יורק') או קודים קצרים (כמו '501' או 'ES') בתצוגות של דוחות. שדות כמו
segments.geo_target_cityאוsegments.geo_target_countryמחזירים מחרוזת של שם משאב שמפנה אלGeoTargetConstant(לדוגמה,geoTargetConstants/1023191). מחלצים את המזהה המספרי (1023191) ושולחים שאילתה למשאבgeo_target_constant:SELECT geo_target_constant.id, geo_target_constant.name, geo_target_constant.canonical_name FROM geo_target_constant WHERE geo_target_constant.id = 1023191לחלופין, כדי לבצע את השילוב באופן מקומי בקוד, מורידים את קובץ ה-CSV הסטטי של המיקומים הגיאוגרפיים לטירגוט במיקומים גיאוגרפיים לטירגוט.
עלות המרה: ה-API מחזיר ערכי עלות במיקרו. צריך לחלק את הערך
metrics.cost_microsב-1,000,000 כדי לקבל את ערך המטבע הסטנדרטי שנדרש בקובץ ההעלאה.
מזהי מיקום גיאוגרפי למוטציות טירגוט
כשמבצעים שינויים בטירגוט למיקום גיאוגרפי ברמת הקמפיין או קבוצת המודעות, המפרסמים צריכים לחפש את המזהה המדויק של GeoTargetConstant (geoTargetConstants/ID) באזורים שנבחרו ולהעביר אותו. אי אפשר להעביר קודי ISO או Nielsen גולמיים.
| סוג האזור | מזהה ה-API הנדרש (GeoTargetConstant) |
פורמט מדור קודם (אין להשתמש) |
|---|---|---|
| אזור DMA (אזור שוק ייעודי) | מזהה 200501 (לניו יורק) |
קוד Nielsen (לדוגמה, 501 לניו יורק) |
| מדינה | מספר תעודה מזהה 2724 (בספרד) |
קוד ISO (לדוגמה, "ES" לספרד) |
שיטות מומלצות ושגיאות עיצוב נפוצות
- פורמט התאריך: השדה
segments.dateמחזיר מחרוזות תאריך בפורמט ISO-8601, בפורמטYYYY-MM-DD. בצינור עיבוד הנתונים של ה-ETL, צריך להפוך את שדות התאריכים לסדרה באופן מפורש כמחרוזותYYYY-MM-DD, ולהימנע מפתיחת קובצי CSV שיוצאו באפליקציות של גיליונות אלקטרוניים שמשנות באופן אוטומטי את הפורמט של עמודות התאריכים. - אפסים בתחילת המיקוד: התייחסו למיקוד (לדוגמה,
01234) כסוגי מחרוזות (VARCHARאוSTRING) לאורך כל צינור עיבוד הנתונים, ולא כמספרים שלמים, כדי שהאפסים בתחילת המיקוד לא יוסרו. - צבירה: אם אתם מפעילים מחקר עם כמה קבוצות, אתם צריכים לספק מדדי הוצאות נפרדים לכל קבוצת ניסוי.
- איחוד נתוני המרות: כשמאחדים נתוני המרות ממערכת CRM פנימית או ממסדי נתונים פנימיים של מכירות, צריך לוודא שלנתוני ההמרות יש את המאפיינים הבאים כדי להבטיח עיבוד חלק של הנתונים עם נתוני Google Ads API ו-GeoX:
- סדרת נתונים עיתית יומית: הנתונים צריכים להיות מצטברים לפי יום.
- רמה גיאוגרפית: כל המרה צריכה להיות ממופה ליחידות הגיאוגרפיות המדויקות שאתם בודקים (לדוגמה, התאמה בין המיקוד למשלוח של הלקוח לבין אזור ה-DMA או אשכול המיקודים שבהם השתמשתם בתכנון).
- ערכי ברוטו: הנתונים חייבים להיות ערכים מוחלטים לא שליליים, כמו הכנסה ברוטו או מספר המרות ברוטו. אם במערכת ה-CRM שלכם מתבצע מעקב אחרי הכנסה נטו עם ערכים שליליים להחזרים כספיים, אתם צריכים להשתמש במספרים ברוטו בניסוי ולהחיל יחס החזרים כספיים מאוחר יותר.