קמפיינים של מודעות וידאו

קמפיינים של מודעות וידאו מאפשרים לכם להציג מודעות וידאו ב-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 או פלחים של רשת המודעות.