کمپین‌های ویدیویی

پویش‌های ویدیویی به شما امکان می‌دهند آگهی‌های ویدیویی را در YouTube و در سراسر وب‌سایت‌ها و برنامه‌هایی که در شرکای ویدیو Google اجرا می‌شوند نمایش دهید.

محدودیت‌های میانای برنامه‌سازی کاربردی

Google Ads API در درجه اول از واکشی و گزارش‌دهی درباره پویش‌های ویدیویی، گروه‌های آگهی، آگهی‌ها، و معیارهای موجود پشتیبانی می‌کند. پویش‌های ویدیویی را نمی‌توان بااستفاده از Google Ads API ایجاد یا تغییر داد، به‌جز موارد استثنا و رفتارهای خاص نسخه زیر:

  • تغییرپذیری VideoResponsiveAdInfo: از نسخه ۲۴، اشیاء VideoResponsiveAdInfo تغییرپذیر هستند (در نسخه‌های قبلی، تغییرناپذیر هستند). هنگام ایجاد یا تغییر VideoResponsiveAdInfo، فیلدهای videos، business_name، و logo_images الزامی هستند.
  • مناسب بودن ایمنی نمانام: از نسخه ۲۴، campaign.video_brand_safety_suitability در سطح پویش برداشته می‌شود. بااستفاده از customer.video_brand_safety_suitability، مناسب بودن ایمنی نمانام را در سطح حساب جستجو کنید.
  • آزمایش‌های پویش ویدیویی: از نسخه ۲۴، experiment.video_experiment برای پیکربندی YOUTUBE_CUSTOM آزمایش‌های متشکل از پویش‌های ویدیویی دردسترس است.

جایگزین‌های مدیریت پویش

اگر لازم است پویش‌های «ویدیویی» را به‌صورت برنامه‌ای ایجاد یا مدیریت کنید، گزینه‌های زیر را درنظر بگیرید:

  • جاوااسکریپت Google Ads: می‌توانید «پویش‌های ویدیویی» را بااستفاده از جاوااسکریپت Google Ads مدیریت کنید. این کار امکان مدیریت خودکار را در میانای Google Ads فراهم می‌کند.
  • پویش‌های «تولید تقاضا»: اگر هدفتان ارائه آگهی‌های ویدیویی در دارایی‌های Google ازجمله YouTube است، پویش‌های «تولید تقاضا» به‌طور کامل در Google Ads API برای ایجاد و مدیریت پشتیبانی می‌شوند.

دریافت داده‌های عملکرد

می‌توانید داده‌های عملکرد را برای پویش‌های ویدیویی، گروه‌های آگهی، و معیارها بااستفاده از GoogleAdsService.SearchStream با فیلتر کردن برای campaign.advertising_channel_type = 'VIDEO' بازیابی کنید.

عملکرد گروه آگهی

پرسمان زیر سنجه‌های پویش ویدیویی و گروه آگهی را از منبع ad_group بازیابی می‌کند، ازجمله بازدیدهای ویدیو TrueView و نرخ‌های تکمیل چارک:

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

گزارش‌دهی دسترسی و بسامد

برای «پویش‌های ویدیویی»، می‌توانید سنجه‌های «دسترسی یکتا» را در منابع campaign و customer (از نسخه ۲۶ به بعد) پُرسمان کنید تا تعداد افراد یکتایی را که آگهی‌های شما را با بسامدهای ظهور خاصی دیده‌اند بسنجید.

سنجه‌های کاربر متمایز زیر، دسترسی مخاطب را در دسته‌های بسامد اندازه‌گیری می‌کنند:

  • metrics.unique_users: تعداد افراد متمایزی که آگهی شما را حداقل یک‌بار در محدوده تاریخ انتخاب‌شده (تا ۹۲ روز) دیده‌اند. نمی‌توان آن را در ردیف‌ها انبوهش کرد.
  • metrics.unique_users_two_plus تا metrics.unique_users_ten_plus: تعداد افراد غیرتکراری که آگهی شما را به‌ترتیب حداقل ۲ تا ۱۰ بار برای محدوده تاریخ حداکثر ۳۱ روز دیده‌اند (با metrics.unique_users_six_plus تا metrics.unique_users_nine_plus تکمیل مجموعه ۲+ تا ۱۰+ در نسخه ۲۶ و جدیدتر).
  • metrics.average_impression_frequency_per_user: میانگین دفعاتی که یک کاربر متمایز آگهی شما را درطول دوره درخواستی (حداکثر ۹۲ روز) دیده است. این سنجه فقط در منبع campaign دردسترس است، نمی‌تواند در ردیف‌ها تجمیع شود، و فیلد همراه _info ندارد.

در نسخه ۲۶ و نسخه‌های جدیدتر، هر سنجه دسترسی کاربر منحصربه‌فرد دارای یک فیلد فراداده همراه از نوع 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 همچنان سنجه عددی را پر می‌کند.

مقادیر شمارشی ReachMetricState وضعیت داده‌های دسترسی را نشان می‌دهند:

  • COMPLETE: سنجه دسترسی کامل است و به‌دلیل محدودیت‌های حریم خصوصی، کیفیت، یا محدودیت‌های دیگر، هیچ‌گونه سرکوبی وجود ندارد.
  • PRIVACY_SUPPRESSION: داده‌های دسترسی برای محافظت از حریم خصوصی کاربر حذف شد (برای مثال، وقتی حجم مخاطبان به آستانه k-گمنامی نمی‌رسد).
  • QUALITY_SUPPRESSION: داده‌های دسترسی به‌دلیل الزامات کیفیت داده‌ها حذف شد.
  • LOW_QUALITY: سنجه دسترسی محاسبه شده است اما به‌عنوان کیفیت پایین پرچم‌گذاری شده است.
  • DATE_RANGE_BEYOND_RETENTION: سنجه‌های «دسترسی» دردسترس نیستند زیرا محدوده تاریخ انتخاب‌شده از دوره ۳ ساله حفظ داده‌ها برای داده‌های «دسترسی» فراتر می‌رود.

پرسمان زیر سنجه‌های دسترسی ۳۰ روزه بدون تکرار و وضعیت‌های سرکوب آن‌ها را برای پویش‌های «ویدیویی» بازیابی می‌کند که براساس دستگاه و قالب آگهی بخش‌بندی شده‌اند. بخش 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 (نسخه ۲۶ و جدیدتر) ‫۹۲ روز segments.date، segments.device، بخش‌های قالب آگهی (نسخه ۲۶ و جدیدتر)، بخش‌های شبکه آگهی (نسخه ۲۶ و جدیدتر)، و بخش‌های جمعیت‌شناختی اصلاح‌شده
metrics.average_impression_frequency_per_user campaign ‫۹۲ روز ‫segments.date، segments.device، و بخش‌های جمعیت‌شناختی اصلاح‌شده
metrics.unique_users_two_plus تا metrics.unique_users_ten_plus ‫campaign،‏ customer (نسخه ۲۶ و جدیدتر) ‫۳۱ روز ‫segments.date،‏ segments.device، بخش‌های قالب آگهی (نسخه ۲۶ و جدیدتر)، و بخش‌های شبکه آگهی (نسخه ۲۶ و جدیدتر)
‫metrics.unique_users*_info (نسخه ۲۶ و جدیدتر) 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 آگهی‌های درون‌جاری‌سازی ردنشدنی را براساس مدت تفکیک می‌کند و برای سایر قالب‌های آگهی 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، یا بخش‌های شبکه آگهی ترکیب شوند.