הפילוח זמין בממשק המשתמש של 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
).
דוגמאות
לא חוקי: מכיוון ש-segments.date הוא
בסעיף SELECT , צריך לציין טווח תאריכים סופי
הסעיף WHERE עבור segments.date ,
segments.week , segments.month ,
segments.quarter או segments.year .
|
SELECT campaign.name, metrics.clicks, segments.date FROM campaign |
חוקי: שאילתה זו מחזירה שמות של קמפיינים וגם
הקליקים שהצטברו בטווח התאריכים. הערה: segments.date
לא צריך להופיע בסעיף SELECT .
|
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 פעל כמצופה ולא חזר
במקרה הזה,