वीडियो कैंपेन

वीडियो कैंपेन की मदद से, YouTube और Google वीडियो पार्टनर पर चल रही सभी वेबसाइटों और ऐप्लिकेशन पर वीडियो विज्ञापन दिखाए जा सकते हैं.

एपीआई की सीमाएं

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 इंटरफ़ेस में, अपने-आप होने वाले मैनेजमेंट की सुविधा मिलती है.
• मांग बढ़ाने में मदद करने वाले कैंपेन: अगर आपका लक्ष्य YouTube के साथ-साथ Google की सभी प्रॉपर्टी पर वीडियो विज्ञापन दिखाना है, तो Google Ads API में मांग बढ़ाने में मदद करने वाले कैंपेन बनाने और उन्हें मैनेज करने की सुविधा पूरी तरह से काम करती है.

परफ़ॉर्मेंस डेटा पाना

GoogleAdsService.SearchStream का इस्तेमाल करके, अपने वीडियो कैंपेन, विज्ञापन ग्रुप, और शर्तों के लिए परफ़ॉर्मेंस डेटा वापस पाया जा सकता है. इसके लिए, campaign.advertising_channel_type = 'VIDEO' को फ़िल्टर करें.

ध्यान दें: TrueView के व्यू की मेट्रिक के लिए, metrics.video_trueview_views, metrics.video_trueview_view_rate, और metrics.trueview_average_cpv का इस्तेमाल करें. v25 से, स्किप न किए जा सकने वाले इन-स्ट्रीम विज्ञापनों को अवधि के हिसाब से अलग-अलग करने के लिए, segments.ad_format_type के साथ-साथ segments.ad_sub_format_type को भी चुना जा सकता है. साथ ही, वीडियो के लिए सोशल मीडिया पर यूज़र ऐक्टिविटी की मेट्रिक (metrics.youtube_comments, metrics.youtube_likes, और metrics.youtube_shares) को भी चुना जा सकता है.

विज्ञापन समूह प्रदर्शन

यहां दी गई क्वेरी, 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, मेट्रिक या सेगमेंट के साथ सीधे तौर पर काम नहीं करता. इसलिए, टारगेट किए गए YouTube वीडियो, YouTube चैनलों या पहले से चुने हुए अन्य प्लेसमेंट की परफ़ॉर्मेंस मेट्रिक पाने के लिए, managed_placement_view जैसे क्राइटेरिया व्यू रिसॉर्स का इस्तेमाल करें:

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 रिसॉर्स पर यूनीक रीच मेट्रिक के बारे में क्वेरी की जा सकती है. इससे, उन यूनीक लोगों की संख्या का पता लगाया जा सकता है जिन्हें इंप्रेशन की तय फ़्रीक्वेंसी पर आपके विज्ञापन दिखाए गए थे.

यूनीक उपयोगकर्ता की ये मेट्रिक, फ़्रीक्वेंसी बकेट में ऑडियंस रीच को मेज़र करती हैं:

• metrics.unique_users: यह उन यूनीक लोगों की संख्या है जिन्होंने चुनी गई तारीख की सीमा (ज़्यादा से ज़्यादा 92 दिन) के अंदर, आपके विज्ञापन को कम से कम एक बार देखा. इसे पंक्तियों में एग्रीगेट नहीं किया जा सकता.
• metrics.unique_users_two_plus से metrics.unique_users_ten_plus: 31 दिनों तक की तारीख की सीमाओं के लिए, आपके विज्ञापन को कम से कम 2 से 10 बार देखने वाले यूनीक लोगों की संख्या. इसमें metrics.unique_users_six_plus से metrics.unique_users_nine_plus, v26 और उसके बाद के वर्शन में सेट किए गए 2+ से 10+ को पूरा करता है.
• metrics.average_impression_frequency_per_user: अनुरोध की गई अवधि (ज़्यादा से ज़्यादा 92 दिन) के दौरान, किसी यूनीक उपयोगकर्ता को आपका विज्ञापन औसतन कितनी बार दिखा. इसे पंक्तियों में एग्रीगेट नहीं किया जा सकता. साथ ही, इसमें कोई कंपैनियन _info फ़ील्ड नहीं होता.

v26 और इसके बाद के वर्शन में, हर रीच मेट्रिक के साथ 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). SELECT क्लॉज़ में .reach_metric_states को न जोड़ें, क्योंकि GAQL में नेस्ट किए गए मैसेज फ़ील्ड चुनने पर, UNRECOGNIZED_FIELD गड़बड़ी होती है. इसके बजाय, metrics.unique_users_info को चुनने पर, ReachMetricInfo मैसेज दिखता है. इसमें ReachMetricState टाइप का बार-बार इस्तेमाल होने वाला enum फ़ील्ड reach_metric_states होता है. इससे पता चलता है कि मेट्रिक को दबाया गया था या वह पूरी है.

जब भी कोई रीच मेट्रिक को दबाया जाता है या वह डेटा के रखरखाव की अवधि (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION या DATE_RANGE_BEYOND_RETENTION) से बाहर होती है, तो Metrics पर उसका optional int64 फ़ील्ड अनसेट हो जाता है. अगर फ़ील्ड की मौजूदगी की जांच नहीं की जाती है, तो इसका आकलन 0 के तौर पर किया जाता है. हालांकि, LOW_QUALITY अब भी न्यूमेरिक मेट्रिक को पॉप्युलेट करता है.

ReachMetricState ईनम वैल्यू से, रीच डेटा की स्थिति का पता चलता है:

• COMPLETE: रीच मेट्रिक का डेटा पूरा है. निजता, क्वालिटी या अन्य सीमाओं की वजह से, डेटा को छिपाया नहीं गया है.
• PRIVACY_SUPPRESSION: उपयोगकर्ता की निजता की सुरक्षा के लिए, रीच डेटा को छिपाया गया था. उदाहरण के लिए, जब ऑडियंस की संख्या, के-एनोनिमिटी थ्रेशोल्ड को पूरा नहीं करती.
• QUALITY_SUPPRESSION: डेटा क्वालिटी की ज़रूरी शर्तों की वजह से, रीच डेटा को छिपा दिया गया था.
• LOW_QUALITY: रीच मेट्रिक का हिसाब लगाया गया था, लेकिन इसे खराब क्वालिटी के तौर पर फ़्लैग किया गया है.
• DATE_RANGE_BEYOND_RETENTION: रीच मेट्रिक का डेटा उपलब्ध नहीं है, क्योंकि चुनी गई तारीख की सीमा, रीच डेटा के रखरखाव के लिए तय की गई तीन साल की अवधि से ज़्यादा है.

यहां दी गई क्वेरी, किसी वीडियो कैंपेन के लिए रीच मेट्रिक और उनके सप्रेस किए जाने की स्थितियों को फ़ेच करती है:

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 फ़ील्ड, filterable: false और sortable: false वाली MESSAGE मेट्रिक हैं. इसलिए, इनका इस्तेमाल WHERE या ORDER BY क्लॉज़ में नहीं किया जा सकता. रिपोर्ट में छिपाई गई रीच मेट्रिक को मैनेज करने के बारे में ज़्यादा जानने के लिए, रीच मेट्रिक को छिपाना और शून्य वैल्यू देखें.