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

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

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

• 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, v26 और उसके बाद के वर्शन में 2+ से 10+ सेट को पूरा करता है.
• metrics.average_impression_frequency_per_user: अनुरोध की गई अवधि (ज़्यादा से ज़्यादा 92 दिन) के दौरान, किसी यूनीक उपयोगकर्ता को आपका विज्ञापन औसतन कितनी बार दिखा. यह मेट्रिक सिर्फ़ campaign रिसॉर्स पर उपलब्ध है. इसे सभी लाइनों में एग्रीगेट नहीं किया जा सकता. साथ ही, इसमें _info फ़ील्ड नहीं होता.

v26 और इसके बाद के वर्शन में, हर यूनीक उपयोगकर्ता रीच मेट्रिक में ReachMetricInfo टाइप का एक कंपैनियन मेटाडेटा फ़ील्ड होता है: metrics.unique_users_info और metrics.unique_users_two_plus_info से लेकर metrics.unique_users_ten_plus_info तक.

Google Ads क्वेरी लैंग्वेज (GAQL) में, कंपैनियन metrics.unique_users*_info फ़ील्ड, filterable: false और sortable: false वाली MESSAGE मेट्रिक होती हैं. इसलिए, इन्हें WHERE या ORDER BY क्लॉज़ में इस्तेमाल नहीं किया जा सकता. इन फ़ील्ड को सीधे 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 enum वैल्यू से, रीच डेटा की स्थिति का पता चलता है:

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

नीचे दी गई क्वेरी, वीडियो कैंपेन के लिए 30 दिनों की डुप्लीकेट कॉपी हटाने की तकनीक वाली रीच मेट्रिक और उनके सप्रेस किए गए स्टेटस को वापस लाती है. इन्हें डिवाइस और विज्ञापन फ़ॉर्मैट के हिसाब से सेगमेंट किया जाता है. SELECT क्लॉज़ से segments.date सेगमेंट को हटाएं, ताकि रीच और 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 (v26 और इसके बाद के वर्शन)	92 दिन	segments.date, segments.device, विज्ञापन फ़ॉर्मैट सेगमेंट (v26 और इसके बाद के वर्शन), विज्ञापन नेटवर्क सेगमेंट (v26 और इसके बाद के वर्शन), और अडजस्ट किए गए डेमोग्राफ़िक सेगमेंट
metrics.average_impression_frequency_per_user	campaign	92 दिन	segments.date, segments.device, और अडजस्ट किए गए डेमोग्राफ़िक सेगमेंट
metrics.unique_users_two_plus से metrics.unique_users_ten_plus	campaign, customer (v26 और इसके बाद के वर्शन)	31 दिन	segments.date, segments.device, विज्ञापन फ़ॉर्मैट सेगमेंट (v26 और इसके बाद के वर्शन), और विज्ञापन नेटवर्क कंपनी सेगमेंट (v26 और इसके बाद के वर्शन)
metrics.unique_users*_info (v26 और इसके बाद के वर्शन)	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 फ़ील्ड या विज्ञापन नेटवर्क सेगमेंट के साथ नहीं जोड़ा जा सकता.

ध्यान दें: रीच और फ़्रीक्वेंसी मेट्रिक को अलग-अलग लाइनों में एग्रीगेट नहीं किया जा सकता. customer रिसॉर्स में, campaign फ़ील्ड को फ़िल्टर नहीं किया जा सकता. साथ ही, यूनीक उपयोगकर्ता रीच मेट्रिक, खाते में मौजूद उन सभी कैंपेन टाइप की डुप्लीकेट रीच को हटा देती हैं जो इस सुविधा के साथ काम करते हैं. ज़्यादा जानकारी के लिए, रीच मेट्रिक को छिपाना और शून्य वैल्यू देखें.