קמפיינים של מודעות וידאו מאפשרים לכם להציג מודעות וידאו ב-YouTube ובאתרים ובאפליקציות שפועלים אצל שותפי הווידאו של Google.
מגבלות ה-API
Google Ads API תומך בעיקר באחזור ובדיווח על קמפיינים קיימים של מודעות וידאו, קבוצות של מודעות, מודעות וקריטריונים. אי אפשר ליצור או לשנות קמפיינים של מודעות וידאו באמצעות Google Ads API, למעט החריגות וההתנהגויות הבאות שספציפיות לגרסה:
- יכולת השינוי של
VideoResponsiveAdInfo: החל מגרסה 24, אובייקטים מסוגVideoResponsiveAdInfoניתנים לשינוי (בגרסאות קודמות הם לא ניתנים לשינוי). כשיוצרים או משנים אתVideoResponsiveAdInfo, השדותvideos,business_nameו-logo_imagesהם שדות חובה. - התאמה להגנה על המותג: החל מגרסה 24, השדה
campaign.video_brand_safety_suitabilityברמת הקמפיין הוסר. אפשר להשתמש ב-customer.video_brand_safety_suitabilityכדי לשלוח שאילתות לגבי התאמה למותג ברמת החשבון. - ניסויים בקמפיינים של מודעות וידאו: החל מגרסה 24, אפשר להשתמש ב-
experiment.video_experimentכדי להגדיר ניסויים ב-YOUTUBE_CUSTOMשכוללים קמפיינים של מודעות וידאו.
חלופות לניהול קמפיינים
אם אתם צריכים ליצור או לנהל קמפיינים של מודעות וידאו באופן פרוגרמטי, כדאי לשקול את האפשרויות הבאות:
- סקריפטים של Google Ads: אתם יכולים לנהל קמפיינים של מודעות וידאו באמצעות סקריפטים של Google Ads. כך אפשר לנהל את הנתונים באופן אוטומטי בממשק של Google Ads.
- קמפיינים ליצירת ביקוש: אם המטרה שלכם היא להציג מודעות וידאו במוצרי Google, כולל YouTube, אתם יכולים ליצור ולנהל קמפיינים ליצירת ביקוש ב-Google Ads API.
קבלת נתוני ביצועים
כדי לאחזר נתוני ביצועים של קמפיינים בווידאו, קבוצות של מודעות וקריטריונים באמצעות GoogleAdsService.SearchStream, צריך לסנן לפי campaign.advertising_channel_type = 'VIDEO'.
ביצועי קבוצת מודעות
השאילתה הבאה מאחזרת מדדים של קמפיינים של מודעות וידאו וקבוצות של מודעות, כולל צפיות בסרטונים מסוג TrueView ושיעורי השלמה של רבעי סרטון, מהמשאב ad_group:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
ad_group.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.video_trueview_views,
metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'
דיווח על מיקומי מודעות וידאו וקריטריונים
מכיוון ש-ad_group_criterion לא תומך ישירות במדדים או בפילוחים, צריך להשתמש במשאבים של תצוגת קריטריונים כמו managed_placement_view כדי לאחזר מדדי ביצועים של סרטונים ב-YouTube, ערוצי YouTube או מיקומי מודעות מנוהלים אחרים:
SELECT
campaign.id,
ad_group.id,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.youtube_channel.channel_id,
metrics.impressions,
metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
AND segments.date DURING LAST_30_DAYS
דיווח על היקף החשיפה והתדירות
בקמפיינים של מודעות וידאו, אתם יכולים לשלוח שאילתות לגבי מדדי Unique Reach במשאבים campaign ו-customer (החל מגרסה 26) כדי למדוד את מספר האנשים הייחודיים שהמודעות שלכם הוצגו להם בתדירויות חשיפה ספציפיות.
המדדים הבאים של משתמשים ייחודיים מודדים את פוטנציאל החשיפה של הקהל לפי קטגוריות תדירות:
metrics.unique_users: מספר האנשים הייחודיים שראו את המודעה לפחות פעם אחת בטווח התאריכים שנבחר (עד 92 ימים). אי אפשר לצבור אותו בין שורות.metrics.unique_users_two_plusעדmetrics.unique_users_ten_plus: מספר המשתמשים הייחודיים שראו את המודעה לפחות 2 עד 10 פעמים, בהתאמה, בטווחי תאריכים של עד 31 ימים (עםmetrics.unique_users_six_plusעדmetrics.unique_users_nine_plusשמשלימים את הקבוצה של 2+ עד 10+ בגרסה 26 ואילך).-
metrics.average_impression_frequency_per_user: מספר הפעמים הממוצע שמשתמש ייחודי ראה את המודעה במהלך התקופה המבוקשת (עד 92 ימים). המדד הזה זמין רק במשאבcampaign, אי אפשר לצבור אותו בשורות ואין לו שדה_infoנלווה.
בגרסה 26 ואילך, לכל מדד של היקף החשיפה למשתמשים ייחודיים יש שדה מטא-נתונים נלווה מסוג ReachMetricInfo:
metrics.unique_users_info ו-metrics.unique_users_two_plus_info עד metrics.unique_users_ten_plus_info.
בשפת השאילתות של Google Ads (GAQL), השדות הנלווים של metrics.unique_users*_info הם מדדי MESSAGE עם filterable: false ו-sortable: false, ולכן אי אפשר להשתמש בהם בסעיפים WHERE או ORDER BY. בוחרים את השדות האלה ישירות בסעיף SELECT (לדוגמה, metrics.unique_users_info). לא מוסיפים את .reach_metric_states בסעיף SELECT, כי בחירה של שדות הודעות בתצוגת עץ ב-GAQL נכשלת עם UNRECOGNIZED_FIELD. במקום זאת, בחירה באפשרות metrics.unique_users_info מחזירה הודעת ReachMetricInfo שמכילה את שדה ה-enum החוזר reach_metric_states מסוג ReachMetricState, שמתאר אם המדד הושמט או שהוא שלם.
בכל פעם שמדד החשיפה מושמט או נמצא מחוץ לחלון השמירה (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION או DATE_RANGE_BEYOND_RETENTION), השדה optional int64 שלו ב-Metrics לא מוגדר (הערך שלו הוא 0 אם לא בודקים את נוכחות השדה), ואילו LOW_QUALITY עדיין מאכלס את המדד המספרי.
ערכי ה-enum של ReachMetricState מציינים את הסטטוס של נתוני היקף החשיפה:
-
COMPLETE: מדד היקף החשיפה הושלם במלואו, ללא הסתרה בגלל פרטיות, איכות או מגבלות אחרות. PRIVACY_SUPPRESSION: נתוני פוטנציאל החשיפה הוסתרו כדי להגן על פרטיות המשתמשים (לדוגמה, כשגודל הקהל לא עומד בערכי הסף של k-אנונימיות).-
QUALITY_SUPPRESSION: נתוני היקף החשיפה הוסתרו בגלל דרישות שקשורות לאיכות הנתונים. -
LOW_QUALITY: מדד החשיפה חושב אבל סומן כבעל איכות נמוכה. -
DATE_RANGE_BEYOND_RETENTION: מדדי החשיפה לא זמינים כי טווח התאריכים שנבחר חורג מתקופת שמירת הנתונים של 3 שנים עבור נתוני חשיפה.
השאילתה הבאה מאחזרת מדדי חשיפה ללא כפילויות ל-30 יום ואת מצבי ההחרגה שלהם בקמפיינים של מודעות וידאו, בפילוח לפי מכשיר ופורמט מודעה.
משמיטים את הפלח segments.date מהסעיף SELECT כדי שהמדדים של היקף החשיפה והתדירות ב-N+ ינוכו מכפילויות בכל חלון התאריכים ולא לפי יום:
SELECT
campaign.id,
campaign.name,
segments.device,
segments.ad_format_type,
segments.ad_sub_format_type,
metrics.unique_users,
metrics.unique_users_info,
metrics.unique_users_two_plus,
metrics.unique_users_two_plus_info,
metrics.unique_users_six_plus,
metrics.unique_users_six_plus_info,
metrics.unique_users_ten_plus,
metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
AND segments.date DURING LAST_30_DAYS
משאבים, חלונות תאריכים ופלחים נתמכים
שאילתות של היקף חשיפה ותדירות דורשות מסנן segments.date סופי בתוך חלון התאריכים המקסימלי של המדד. שאילתות בלי מסנן תאריכים או שאילתות שחורגות מהחלון מחזירות שדות של היקף חשיפה שלא הוגדרו:
| מדד | משאבים | טווח התאריכים המקסימלי | פלחים תואמים |
|---|---|---|---|
metrics.unique_users |
campaign, customer (גרסה 26 ואילך) |
92 ימים |
segments.date, segments.device, פלחים של פורמט מודעה (גרסה 26 ואילך), פלחים של רשת מודעות (גרסה 26 ואילך) ופלחים דמוגרפיים מותאמים
|
metrics.average_impression_frequency_per_user |
campaign |
92 ימים |
segments.date, segments.device ופלחים דמוגרפיים מותאמים
|
metrics.unique_users_two_plus עד metrics.unique_users_ten_plus
|
campaign, customer (גרסה 26 ואילך) |
31 ימים |
segments.date, segments.device, פלחים של פורמט מודעה (גרסה 26 ואילך) ופלחים של רשת מודעות (גרסה 26 ואילך)
|
metrics.unique_users*_info (גרסה 26 ואילך) |
campaign, customer |
תואם למדד הבסיס |
segments.date, segments.device, פלחים של פורמט מודעה ופלחים של רשת מודעות
|
כשמפלחים שאילתות של פוטנציאל חשיפה, צריך להחיל את אילוצי הפילוח המשותפים הבאים:
- פילוח לפי פורמט מודעה לעומת פילוח לפי רשת מודעות: אפשר לפלח לפי פורמט מודעה (
segments.ad_format_type, ואם רוצים גם לפיsegments.ad_sub_format_type) או לפי רשת מודעות (segments.ad_network_type, ואם רוצים גם לפיsegments.ad_sub_network_type), אבל אי אפשר לשלב פילוח לפי פורמט מודעה ופילוח לפי רשת מודעות באותה שאילתה. תמיד צריך לבחור את פלח ההורה (segments.ad_format_typeאוsegments.ad_network_type) כשבוחרים את פלח המשנה שלו. הפלחsegments.ad_sub_format_typeמפרט את מודעות הווידאו In-stream שלא ניתן לדלג עליהן לפי משך הזמן ומחזיר את הערךUNSEGMENTEDלפורמטים אחרים של מודעות, ואילו הפלחsegments.ad_sub_network_typeמפרט את הפלטפורמות של YouTube (YOUTUBE_INSTREAM,YOUTUBE_INFEEDו-YOUTUBE_SHORTS) רק בקמפיינים ליצירת ביקוש ומחזיר את הערךUNSEGMENTEDבקמפיינים של מודעות וידאו. - פלחים דמוגרפיים מותאמים: הפלחים
segments.adjusted_age_rangeו-segments.adjusted_genderזמינים רק לחשבונות שנכללים ברשימת ההיתרים, צריך לבחור אותם ביחד ואי אפשר לשלב אותם עם מדדיmetrics.unique_users_*_plus, שדותmetrics.unique_users*_infoאו פלחים של רשת המודעות.