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

קמפיינים של מודעות וידאו מאפשרים לכם להציג מודעות וידאו ב-YouTube ובאתרים ובאפליקציות שפועלים אצל שותפי הווידאו של Google.

מגבלות ה-API

‫Google Ads API תומך בעיקר באחזור ובדיווח על קמפיינים קיימים של מודעות וידאו, קבוצות של מודעות, מודעות וקריטריונים. אי אפשר ליצור או לשנות קמפיינים של מודעות וידאו באמצעות Google Ads API, למעט החריגות וההתנהגויות הבאות שספציפיות לגרסה:

• יכולת השינוי של VideoResponsiveAdInfo: החל מגרסה v24, אובייקטים מסוג VideoResponsiveAdInfo ניתנים לשינוי (בגרסאות קודמות הם לא ניתנים לשינוי). כשיוצרים או משנים את VideoResponsiveAdInfo, השדות videos,‏ business_name ו-logo_images הם שדות חובה.
• הגנה על המותג: החל מ-v24, campaign.video_brand_safety_suitability ברמת הקמפיין יוסר. אפשר להשתמש בשדה customer.video_brand_safety_suitability כדי לשלוח שאילתה לגבי התאימות למותג ברמת החשבון.
• ניסויים בקמפיינים של מודעות וידאו: החל מגרסה v24, אפשר להשתמש ב-experiment.video_experiment כדי להגדיר ניסויים ב-YOUTUBE_CUSTOM שכוללים קמפיינים של מודעות וידאו.

חלופות לניהול קמפיינים

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

• סקריפטים של Google Ads: אתם יכולים לנהל קמפיינים של מודעות וידאו באמצעות סקריפטים של Google Ads. כך אפשר לנהל את הנתונים באופן אוטומטי בממשק של Google Ads.
• קמפיינים ליצירת ביקוש: אם המטרה שלכם היא להציג מודעות וידאו במוצרי Google, כולל YouTube, אתם יכולים ליצור ולנהל קמפיינים ליצירת ביקוש ב-Google Ads API.

קבלת נתוני ביצועים

כדי לאחזר נתוני ביצועים של קמפיינים בווידאו, קבוצות של מודעות וקריטריונים באמצעות GoogleAdsService.SearchStream, צריך לסנן לפי campaign.advertising_channel_type = 'VIDEO'.

הערה: השתמשו ב-metrics.video_trueview_views, ב-metrics.video_trueview_view_rate וב-metrics.trueview_average_cpv למדדי צפיות תקפות. החל מגרסה v25, אפשר גם לבחור את segments.ad_sub_format_type (לצד segments.ad_format_type) כדי לפלח מודעות וידאו In-stream שאי אפשר לדלג עליהן לפי משך הזמן, וגם לפי מדדי התעניינות ברשתות החברתיות (metrics.youtube_comments,‏ metrics.youtube_likes ו-metrics.youtube_shares).

ביצועי קבוצת מודעות

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

המדדים הבאים של משתמשים ייחודיים מודדים את פוטנציאל החשיפה של הקהל לפי קטגוריות תדירות:

• 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 ימים). אי אפשר לצבור אותו בין שורות ואין לו שדה _info נלווה.

בגרסה 26 ואילך, לכל מדד חשיפה יש שדה מטא-נתונים נלווה מסוג ReachMetricInfo: metrics.unique_users_info ו-metrics.unique_users_two_plus_info עד metrics.unique_users_ten_plus_info.

בשפת השאילתות של Google Ads ‏ (GAQL), שדות של היקף החשיפה של מודעות נלוות הם מדדים של MESSAGE שנבחרים ישירות בסעיף 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 שנים.

השאילתה הבאה מאחזרת את מדדי החשיפה ואת מצבי ההסתרה שלהם בקמפיין וידאו:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

הערה: אי אפשר לצבור את המדדים של היקף החשיפה והתדירות בשורות. המדדים metrics.unique_users ו-metrics.average_impression_frequency_per_user תומכים בטווחי תאריכים של עד 92 ימים, ואפשר לפלח אותם לפי segments.date,‏ segments.device,‏ segments.adjusted_age_range ו-segments.adjusted_gender. לעומת זאת, המדדים של קטגוריית התדירות unique_users_*_plus (עד 31 ימים) וכל השדות הנלווים של metrics.unique_users*_info תומכים רק ב-segments.date וב-segments.device. בנוסף, השדות הנלווים של metrics.unique_users*_info הם מדדים של MESSAGE עם filterable: false ו-sortable: false, ולכן אי אפשר להשתמש בהם בסעיפים WHERE או ORDER BY. במאמר השמטת מדדי החשיפה וערכי אפס מוסבר איך לטפל במדדי החשיפה שהושמטו בדוחות.