پویشهای ویدیویی به شما امکان میدهند آگهیهای ویدیویی را در 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، یا بخشهای شبکه آگهی ترکیب شوند.