פילוח

אפשר להטמיע פילוח ב-Google Ads API פשוט על ידי הוספת השדה המתאים לשאילתה. הפילוח זמין בממשק המשתמש של Google Ads בתור תפריט נפרד. לדוגמה, הוספת segments.device לשאילתה מובילה לדוח עם שורה לכל שילוב של מכשיר והמשאב שצוין בתנאי FROM, והערכים הסטטיסטיים (חשיפות, קליקים, המרות וכו') מתחלקים ביניהם.

בממשק המשתמש של Google Ads אפשר להשתמש רק בפלח אחד בכל פעם, אבל באמצעות ה-API אפשר לציין כמה פלחים באותה שאילתה.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

התוצאות של שליחת השאילתה הזו אל GoogleAdsService.SearchStream ייראו בערך כך במחרוזת ה-JSON:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    },
    ...
  ]
}

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

פילוח סמוי

כל דוח מפולח בהתחלה לפי המשאב שצוין בפסקה FROM. השדה resource_name של המשאב בפסקה FROM מוחזר והמדדים מחולקים לפיו, גם אם השדה resource_name לא נכלל במפורש בשאילתה. לדוגמה, כשמציינים את המשאב ad_group בפסקה FROM, המערכת מחזירה באופן אוטומטי את הערך ad_group.resource_name והמדדים יתפלגו לפיו באופן משתמע ברמת ad_group.

בשאילתה הזו,

SELECT metrics.impressions
FROM ad_group

תקבלו מחרוזת JSON כזו:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

שימו לב שהשדה resource_name של adGroup תמיד מוחזר כי ad_group צוין כמשאב בפסקה FROM.

שדות של פלחים שניתן לבחור

לא כל שדות הפלח ניתנים לבחירה למשאב נתון בפסקה FROM. לדוגמה, נמשיך לשלוח שאילתות מהמשאב ad_group. כדי שאפשר יהיה לבחור שדה פלח במשאב ad_group, השדה הזה צריך להופיע ברשימה Segments של ad_group. הרשימה Segments היא החלק הצהוב בטבלת השדות הזמינים בדף המטא-נתונים של המשאב ad_group.

משאבים של פלחים

כשבוחרים מתוך משאבים מסוימים, יכול להיות שתהיה אפשרות לבצע צירוף משתמע של משאבים קשורים על ידי בחירת השדות שלהם לצד השדות של המשאב בפסקה FROM. המשאבים הקשורים האלה מופיעים ברשימה Attributed Resources של המשאב בדף המטא-נתונים של התנאי FROM. במקרה של המשאב ad_group, תוכלו לראות שאפשר לבחור גם שדות מהמשאב campaign. השדה resource_name של כל Attributed Resources עם לפחות שדה אחד בפסקה SELECT יוחזר באופן אוטומטי, גם אם השדה resource_name לא נכלל במפורש בשאילתה.

בדומה לבחירת שדות Attributed Resource, אפשר גם לבחור שדות Segmenting Resource. אם למשאב נתון יש רשימת Segmenting Resources בדף המטא-נתונים שלו, בחירת שדות מאחד מהמשאבים האלה ברשימה תגרום לחלוקה נוספת של השאילתה לפי הערך של resource_name שהוחזר ב-Segmenting Resource. לדוגמה, המשאב campaign מופיע כ-Segmenting Resource למשאב campaign_budget. בחירה של שדה כלשהו בקמפיין, כמו campaign.name, מהמשאב campaign_budget תגרום להחזרת השדה campaign.name, אבל גם להחזרת השדה campaign.resource_name ולפילוח לפיו.

אפשרות לבחור בין פלחים לבין מדדים

יכול להיות ששדה פלח מסוים לא תואם לחלק משדות הפלח האחרים, או לחלק משדות המדדים. כדי לזהות אילו שדות של פלחים תואמים זה לזה, אפשר לעיין ברשימת selectable_with של הפלחים בפסקה SELECT.

במקרה של המשאב ad_group, יש יותר מ-50 פלחים זמינים שאפשר לבחור. עם זאת, רשימת selectable_with של segments.hotel_check_in_date היא קבוצה קטנה בהרבה של פלחים תואמים. כלומר, אם תוסיפו את השדה segments.hotel_check_in_date לתנאי SELECT, תוכלו לבחור רק את הפלחים שקיימים בקטע החופף של שתי הרשימות האלה.

כשמוסיפים פלחים מסוימים, ייתכן שהמדדים בשורת הסיכום ירדו

כשהפלח segments.keyword.info.match_type מתווסף לשאילתה עם FROM ad_group_ad, הוא מציין לשאילתה לקבל רק את שורות הנתונים שיש בהן מילות מפתח, ולהסיר כל שורה שלא משויכת למילת מפתח. במקרה כזה, המדדים יהיו נמוכים יותר כי הם לא יכללו מדדים שאינם קשורים למילות מפתח.

כללים לפלחים בתנאי WHERE

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

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

כללים לשדות של פלח תאריכים מרכזי

הפלחים segments.date,‏ segments.week,‏ segments.month,‏ segments.quarter ו-segments.year פועלים באופן הבא:

• אפשר לסנן את הפלחים האלה בפסקה WHERE בלי שהם יופיעו בפסקה SELECT.

• אם אחד מהפלחים האלה נמצא בפסקה SELECT, צריך לציין טווח תאריכים סופי שמורכב מפלחי תאריכים מרכזיים בפסקה WHERE (פלחי התאריכים לא חייבים להיות אותם פלחים שצוינו ב-SELECT).

דוגמאות

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'

SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2019
  AND segments.year < 2024

search_term_view

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

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

שני האובייקטים שמוחזרים בדוגמה הזו נראים ככפילות, אבל שמות המשאבים שלהם שונים, במיוחד בחלק 'קבוצת מודעות'. כלומר, מונח החיפוש 'google photos' משויך לשתי קבוצות המודעות (מספרים 2222222222 ו-33333333333) באותו תאריך (15 ביוני 2024). לכן, אפשר להסיק שה-API עבד כמצופה ולא החזיר אובייקטים כפולים במקרה הזה.