שליפת נתונים גיאוגרפיים לניסויים

כדי לשלוף נתונים באופן אוטומטי או בהיקף גדול לניסויי GeoX, צריך להשתמש ב-Google Ads API כדי לשלוף נתונים של עלויות והוצאות. תצטרכו לשלב את הנתונים האלה עם נתוני המרות או הכנסות גולמיים, לא מסוננים ולא משויכים, מתוך מערכת ה-CRM הפנימית, נקודת מכירה (POS) או מסדי נתונים פנימיים של מכירות.

כדי לשלוף בצורה מדויקת נתוני קמפיין ונתוני עלות לפי פלחים גיאוגרפיים, צריך לפעול לפי הארכיטקטורה הזו:

  • שירות: משתמשים ב-GoogleAdsService, ובמיוחד בשיטות Search או SearchStream.

  • מקור מידע: אפשר להריץ שאילתה על geographic_view כדי לראות איפה המשתמש היה פיזית או באילו מקומות הוא התעניין. בדרך כלל זה הסטנדרט בניסויי GeoX. לחלופין, אפשר להריץ שאילתה על location_view כדי לראות את הביצועים לפי מיקומים ספציפיים שמטורגטים בקמפיין.

  • שדות להכללה:

  • שאילתת 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). מפתחים יכולים לשלוח שאילתה ישירות לטבלה geo_target_constant:

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    לחלופין, כדי לבצע את הצירוף באופן מקומי בקוד, אפשר להוריד את קובץ ה-CSV הסטטי של המיקומים הגיאוגרפיים לטירגוט בכתובת Geo targets.

  • עלות המרה: ה-API מחזיר ערכי עלות במיקרו. צריך לחלק את metrics.cost_micros ב-1,000,000 כדי לקבל את ערך המטבע הרגיל שנדרש בקובץ ההעלאה.

קודי טירגוט (DMA ומדינה)

כשמבצעים שינויים בטירגוט, המפרסמים צריכים לחפש ולהעביר את המזהה המדויק GeoTargetConstant של האזורים שנבחרו. אי אפשר להעביר קודי ISO או קודי Nielsen גולמיים.

סוג האזור מזהה API נדרש (GeoTargetConstant) פורמט מדור קודם (אין להשתמש)
אזור שוק ייעודי (DMA) מזהה 200501 (לניו יורק) קוד Nielsen (לדוגמה, 501 לניו יורק)
מדינה מספר תעודה מזהה 2724 (בספרד) קוד ISO (לדוגמה, "ES" לספרד)

שיטות מומלצות ושגיאות נפוצות בעיצוב

  • פורמט תאריך: השדה segments.date מחזיר נתונים בפורמט YYYY-MM-DD. בגיליונות אלקטרוניים כמו Excel, פורמטים של תאריכים משתנים לעיתים קרובות באופן אוטומטי. כדי לוודא שהמערכת קוראת את טווח התאריכים בצורה מדויקת בפורמט הנדרש YYYY-MM-DD, צריך להעלות את הקובץ ל-Google Sheets קודם.
  • אפסים מובילים: מוודאים שאפסים מובילים במיקודים (לדוגמה, 01234) לא נמחקים. אפשר להשתמש באפשרות 'פורמט מספר בהתאמה אישית' ב-Google Sheets כדי לכפות מחרוזת של 5 ספרות.
  • צבירה: אם מפעילים מחקר עם כמה תאים, צריך לספק מדדי הוצאות נפרדים לכל קבוצת טיפול.
  • צירוף נתוני המרות: כשמצרפים נתוני המרות ממערכת CRM פנימית או ממסדי נתונים פנימיים של מכירות, צריך לוודא שלנתוני ההמרות יש את המאפיינים הבאים כדי להבטיח עיבוד חלק של הנתונים באמצעות נתונים מ-Google Ads API ומ-GeoX:
    • סדרת זמן יומית: הנתונים צריכים להיות מצטברים לפי יום.
    • ברמה הגיאוגרפית: כל המרה צריכה להיות ממופה ליחידות הגיאוגרפיות המדויקות שנבדקות (לדוגמה, התאמה של המיקוד למשלוח של הלקוח לאזור השיווק המיועד או לאשכול המיקודים שמשמשים בתכנון).
    • ערכים ברוטו: הנתונים צריכים להיות ערכים מוחלטים לא שליליים, כמו הכנסות ברוטו או מספר המרות ברוטו. אם במערכת ה-CRM שלכם מתבצע מעקב אחרי הכנסות נטו עם ערכים שליליים להחזרים כספיים, אתם צריכים להשתמש במספרים ברוטו בניסוי ולהחיל יחס החזרים כספיים מאוחר יותר.