פילוח

הפילוח זמין בממשק המשתמש של Google Ads כתפריט נפרד מוטמעת ב-Google Ads API רק באמצעות הוספת השדה המתאים לשאילתה. עבור לדוגמה, הוספה של 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"
      }
    },
    ...
  ]
}

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

פילוח מרומז

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

לגבי השאילתה הזו,

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 בדף המטא-נתונים שלו, ולאחר מכן לבחור שדות מאחד מהמשאבים שברשימה. תגרום לפילוח נוסף של השאילתה לפי שם המשאב המוחזר. 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 > '2020-01-01'
  AND segments.date < '2020-02-01'

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

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

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

search_term_view

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

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

למרות ששני האובייקטים שהוחזרו בדוגמה הזו נראים זהים, שמות המשאבים שלהם למעשה שונים, במיוחד ב"קבוצת המודעות" חלק. כלומר, מונח החיפוש Google Photos משויך לשני הסוגים קבוצות של מודעות (מזהה 2222222222 ו-33333333333) באותו תאריך (15.06.2015). לכן אנחנו יכולים להסיק שה-API פעל כמצופה ולא חזר במקרה הזה,