Google Ads API में कई व्यू उपलब्ध हैं. इनकी मदद से, यह विश्लेषण किया जा सकता है कि आपके विज्ञापन कहां और कैसे दिख रहे हैं और उनकी परफ़ॉर्मेंस कैसी है:
managed_placement_view,
group_placement_view,
detail_placement_view, और
performance_max_placement_view. हर व्यू में, प्लेसमेंट डेटा को अलग-अलग तरीके से देखा जा सकता है. Google Ads यूज़र इंटरफ़ेस (यूआई) में प्लेसमेंट स्क्रीन को दोहराने वाली, इस्तेमाल के लिए तैयार Google Ads क्वेरी लैंग्वेज (GAQL) और curl क्वेरी के लिए, क्वेरी कुकबुक देखें.
पहले से चुने हुए प्लेसमेंट का व्यू
- इससे क्या पता चलता है:
managed_placement_viewरिसॉर्स से, विज्ञापन ग्रुप में टारगेट की गई पॉज़िटिव प्लेसमेंट की शर्तों के हिसाब से एग्रीगेट किया गया परफ़ॉर्मेंस डेटा मिलता है. इस व्यू में, Google Ads के यूज़र इंटरफ़ेस (यूआई) में कॉन्टेंट > प्लेसमेंट के तहत मैनेज की जाने वाली सभी पांच तरह की शर्तें शामिल हैं: वेबसाइटें, YouTube चैनल, YouTube वीडियो, मोबाइल ऐप्लिकेशन, और मोबाइल ऐप्लिकेशन की कैटगरी. - यूज़र इंटरफ़ेस (यूआई) के बराबर: कॉन्टेंट > प्लेसमेंट
- क्वेरी बिल्डर: क्वेरी बिल्डर में एक्सप्लोर करें
चुने गए प्लेसमेंट की शर्तों के टाइप
managed_placement_view संसाधन की हर लाइन, AdGroupCriterion फ़ील्ड को पॉप्युलेट करती है. यह फ़ील्ड, इसकी ad_group_criterion.type वैल्यू से मैच करता है. साथ ही, अन्य प्लेसमेंट फ़ील्ड को सेट नहीं करता:
| यूज़र इंटरफ़ेस (यूआई) प्लेसमेंट टाइप | ad_group_criterion.type की कीमत का |
शर्त की जानकारी वाले फ़ील्ड | नोट |
|---|---|---|---|
| वेबसाइटें | PLACEMENT |
ad_group_criterion.placement.url |
टारगेट वेबसाइट या डोमेन का यूआरएल. |
| YouTube चैनल | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
YouTube चैनल आईडी. ad_group_criterion.display_name फ़ील्ड, चैनल का नाम दिखाता है. |
| YouTube वीडियो | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
YouTube वीडियो का आईडी. ad_group_criterion.display_name फ़ील्ड, वीडियो का टाइटल दिखाता है. |
| ऐप्लिकेशन | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
{platform}-{platform_native_id} फ़ॉर्मैट में ऐप्लिकेशन आईडी (iOS के लिए 1-, Android के लिए 2-) और ऐप्लिकेशन का नाम. |
| ऐप्लिकेशन की कैटगरी | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
mobileAppCategoryConstants/{mobile_app_category_id} फ़ॉर्मैट में संसाधन का नाम. मोबाइल ऐप्लिकेशन की कैटगरी के नाम और हैरारकी देखें. |
उदाहरण के तौर पर दी गई क्वेरी
पिछले 30 दिनों में, टारगेट किए गए सभी प्लेसमेंट टाइप की परफ़ॉर्मेंस मेट्रिक फ़ेच करने के लिए, टाइप के हिसाब से फ़ील्ड के साथ-साथ ad_group_criterion.type फ़ील्ड चुनें:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
मोबाइल ऐप्लिकेशन की कैटगरी के नाम और हैरारकी
Google Ads के यूज़र इंटरफ़ेस (यूआई) में, टारगेट की गई मोबाइल ऐप्लिकेशन कैटगरी, अपना पूरा ऐप स्टोर पाथ दिखाती हैं. जैसे, ऐप्लिकेशन की कैटगरी > Apple App Store > शिक्षा. Google Ads API से क्वेरी करते समय, इन बातों का ध्यान रखें:
- मोबाइल ऐप्लिकेशन कैटगरी के कॉन्सटेंट एट्रिब्यूट करना:
mobile_app_category_constantरिसॉर्स,managed_placement_viewरिसॉर्स का एट्रिब्यूट किया गया रिसॉर्स नहीं है. इसके बजाय,ad_group_criterion.mobile_app_category.mobile_app_category_constantफ़ील्ड चुनें (उदाहरण के लिए,mobileAppCategoryConstants/60503) या जब आपको मेट्रिक की ज़रूरत न हो, तबad_group_criterionसंसाधन को क्वेरी करें. - सिर्फ़ लीफ़ कैटगरी के डिसप्ले नेम:
ad_group_criterion.display_nameऔरmobile_app_category_constant.name, दोनों फ़ील्ड सिर्फ़ लीफ़ कैटगरी का नाम दिखाते हैं. जैसे,"Education"या"Games". दोनों में से किसी भी फ़ील्ड में, पैरंट ऐप स्टोर का पाथ शामिल नहीं है. - ऐप स्टोर पाथ को हल करना: Google Play और Apple App Store, अलग-अलग क्राइटेरिया आईडी के लिए लीफ़ कैटगरी के नाम शेयर करते हैं. उदाहरण के लिए, क्राइटेरिया आईडी
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education), और60503(/All Apps/Apple App Store/Education) के लिए,nameऔरdisplay_nameफ़ील्ड में"Education"वैल्यू दिखती है. संसाधन के नाम से{mobile_app_category_id}सफ़िक्स निकालें और मोबाइल ऐप्लिकेशन की कैटगरी टेबल या CSV फ़ाइल में, उसका पूरा हैरारकी पाथ देखें.
ग्रुप प्लेसमेंट व्यू
- इससे क्या पता चलता है:
group_placement_viewरिसॉर्स से पता चलता है कि Display Network और YouTube पर आपके विज्ञापन असल में कहां दिखाए गए. इससे कोई फ़र्क़ नहीं पड़ता कि प्लेसमेंट को साफ़ तौर पर टारगेट किया गया था या Google के सिस्टम ने उन्हें अपने-आप खोजा था. इसमें वेबसाइटें, YouTube चैनल या वीडियो, और ऐप्लिकेशन शामिल हो सकते हैं. - यूज़र इंटरफ़ेस (यूआई) के बराबर: कॉन्टेंट > विज्ञापन कहां दिखाए गए
- क्वेरी बिल्डर: क्वेरी बिल्डर में एक्सप्लोर करें
उदाहरण के तौर पर दी गई क्वेरी
नीचे दी गई क्वेरी, उन डोमेन, मोबाइल ऐप्लिकेशन, और YouTube चैनलों की परफ़ॉर्मेंस मेट्रिक फ़ेच करती है जहां पिछले 30 दिनों में विज्ञापन दिखाए गए थे:
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
"कुल: अन्य" पंक्ति
रिपोर्ट जनरेट करने की प्रोसेस को तेज़ करने के लिए, group_placement_view और detail_placement_view रिसॉर्स, उन प्लेसमेंट को शामिल नहीं करते जो इंप्रेशन या इंटरैक्शन की तय सीमा को पूरा नहीं करते.
- Google Ads के यूज़र इंटरफ़ेस (यूआई) में: यूआई, गतिविधि की इस सीमा को पूरा न करने वाले प्लेसमेंट को कुल: अन्य लेबल वाली खास जानकारी वाली लाइन में इकट्ठा करता है.
- Google Ads API में: एपीआई, रिपोर्ट के नतीजों से उन प्लेसमेंट को हटा देता है जो गतिविधि की तय सीमा को पूरा नहीं करते. साथ ही, यह ऐसी खास जानकारी वाली लाइन नहीं दिखाता जिसमें
group_placement_view.placementयाdetail_placement_view.placementफ़ील्ड की वैल्यू"Other"हो.
इस वजह से, group_placement_view और detail_placement_view रिसॉर्स में अलग-अलग प्लेसमेंट की पंक्तियों का योग, विज्ञापन ग्रुप या कैंपेन की कुल मेट्रिक से कम हो सकता है. ज़्यादा जानकारी के लिए, "विज्ञापन कहां दिखाए गए" रिपोर्ट के बारे में जानकारी लेख पढ़ें. थ्रेशोल्ड और मेटाडेटा मौजूद न होने से, क्रॉस-व्यू की तुलनाओं पर क्या असर पड़ता है, इस बारे में ज़्यादा जानने के लिए, प्लेसमेंट व्यू के बीच मेट्रिक में अंतर और प्लेसमेंट की जानकारी के बिना वाली लाइनें देखें.
प्लेसमेंट टारगेटिंग की सेटिंग
group_placement_view के काम करने के तरीके और उपयोगिता पर, विज्ञापन ग्रुप लेवल पर PLACEMENT डाइमेंशन के लिए TargetingSetting का असर पड़ता है. इस सेटिंग में target_restrictions की सूची होती है. हर सूची में एक bid_only बूलियन फ़ील्ड होता है. इससे यह तय होता है कि आपके विज्ञापन सिर्फ़ चुने गए प्लेसमेंट पर दिखेंगे या अन्य प्लेसमेंट पर भी. "टारगेटिंग" और "निगरानी" सेटिंग के बारे में जानें.
bid_only = false: यह वैल्यू, प्लेसमेंट के लिए Google Ads यूज़र इंटरफ़ेस (यूआई) में टारगेटिंग से जुड़ी है. अगर आपका विज्ञापन ग्रुप "टारगेटिंग" पर सेट है, तो आपके विज्ञापन सिर्फ़ उन प्लेसमेंट पर दिखेंगे जिन्हें आपने साफ़ तौर पर शर्त के तौर पर जोड़ा है. इन प्लेसमेंट के लिए, बिड घटाने या बढ़ाने की सुविधा लागू की जा सकती है. इस मामले में,group_placement_viewकाफ़ी हद तकmanaged_placement_viewसे मेल खाता है. हालांकि, यह अब भी गतिविधि के थ्रेशोल्ड पर निर्भर करता है.bid_only = true: यह वैल्यू, प्लेसमेंट के लिए Google Ads यूज़र इंटरफ़ेस (यूआई) में ऑब्ज़र्वेशन से मेल खाती है. अगर आपका विज्ञापन ग्रुप "ऑब्ज़र्वेशन" पर सेट है, तो आपके विज्ञापन, Display Network और YouTube पर किसी भी ज़रूरी प्लेसमेंट पर दिख सकते हैं. टारगेट किए गए किसी भी प्लेसमेंट के लिए, बिड घटाने या बढ़ाने की सुविधा भी लागू की जा सकती है. ऐसे में,group_placement_viewकी मदद से उन नए प्लेसमेंट का पता लगाया जा सकता है जहां आपके विज्ञापन दिख रहे हैं. इसके बाद, आपके पास उन्हें पहले से चुने हुए प्लेसमेंट या बाहर रखे गए प्लेसमेंट के तौर पर जोड़ने का विकल्प होता है.
प्लेसमेंट की ज़्यादा जानकारी वाला व्यू
- इससे क्या पता चलता है:
detail_placement_viewरिसॉर्स से, प्लेसमेंट के बारे में ज़्यादा जानकारी मिलती है. इसमें डोमेन या चैनल लेवल से ज़्यादा जानकारी शामिल होती है. उदाहरण के लिए, इससे उन यूआरएल या YouTube वीडियो के आईडी की जानकारी मिलती है जहां आपके विज्ञापन दिखाए गए. - यूज़र इंटरफ़ेस (यूआई) के बराबर: कॉन्टेंट > विज्ञापन कहां दिखाए गए में पंक्तियां चुनने के बाद, जानकारी देखें पर क्लिक करने के बराबर.
- क्वेरी बिल्डर: क्वेरी बिल्डर में एक्सप्लोर करें
- अहम बातें:
group_placement_viewरिसॉर्स की तरह ही, इस व्यू में कम गतिविधि वाले उन प्लेसमेंट को शामिल नहीं किया जाता है जो गतिविधि की कम से कम थ्रेशोल्ड को पूरा नहीं करते. इसके बारे में ज़्यादा जानने के लिए, "कुल: अन्य" लाइन सेक्शन देखें.
उदाहरण के तौर पर दी गई क्वेरी
नतीजों की संख्या को सीमित करने के लिए, यह क्वेरी सात दिनों की विंडो में यूआरएल-लेवल और वीडियो-लेवल की प्लेसमेंट मेट्रिक फ़ेच करती है. बड़े खातों के लिए, campaign.id या ad_group.id फ़ील्ड के हिसाब से और फ़िल्टर करें:
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
जिन पंक्तियों में प्लेसमेंट का मेटाडेटा उपलब्ध नहीं है उन्हें बाहर रखने के लिए, AND
detail_placement_view.target_url IS NOT NULL जोड़ें. इसके बारे में ज़्यादा जानने के लिए, ऐसी पंक्तियां जिनमें प्लेसमेंट की जानकारी उपलब्ध नहीं है लेख पढ़ें. जब आपको resource_name फ़ील्ड की ज़रूरत न हो, तो PARAMETERS
omit_unselected_resource_names = true क्लॉज़ जोड़ें.
प्लेसमेंट व्यू के बीच मेट्रिक में अंतर
गतिविधि की कम से कम सीमा का आकलन, हर लेवल पर अलग-अलग किया जाता है:
group_placement_viewरिसॉर्स, एग्रीगेट किए गए डोमेन, मोबाइल ऐप्लिकेशन या YouTube चैनल के लिए थ्रेशोल्ड का आकलन करता है.detail_placement_viewरिसॉर्स, हर पेज के यूआरएल या YouTube वीडियो के लिए, थ्रेशोल्ड का आकलन अलग-अलग करता है.
detail_placement_view रिसॉर्स, उन पेज यूआरएल या YouTube वीडियो को शामिल नहीं करता जो थ्रेशोल्ड को पूरा नहीं करते. इस वजह से, किसी डोमेन या YouTube चैनल के लिए detail_placement_view पंक्तियों को जोड़ने पर (detail_placement_view.group_placement_target_url फ़ील्ड के हिसाब से फ़िल्टर किया गया), उससे जुड़ी group_placement_view पंक्ति की तुलना में कम इंप्रेशन मिल सकते हैं.
ऐसी लाइनें जिनमें प्लेसमेंट की जानकारी उपलब्ध नहीं है
group_placement_view या detail_placement_view रिसॉर्स के लिए की गई क्वेरी, एक ही विज्ञापन ग्रुप में कई लाइनें दिखा सकती है. इनमें placement, display_name, और target_url फ़ील्ड सेट नहीं होते हैं. साथ ही, इनमें एक जैसी resource_name वैल्यू होती है. उदाहरण के लिए, ~MTRf पर खत्म होने वाली वैल्यू.
ऐसा इन वजहों से होता है:
- इंटरनल प्लेसमेंट ग्रुपिंग: दोनों व्यू, परफ़ॉर्मेंस मेट्रिक को
resource_nameयाplacementस्ट्रिंग फ़ील्ड के बजाय, यूनीक इंटरनल प्लेसमेंट आइडेंटिफ़ायर के हिसाब से ग्रुप करते हैं. - प्लेसमेंट का मेटाडेटा उपलब्ध नहीं है: Google Ads के यूज़र इंटरफ़ेस (यूआई) में, बैकएंड लुकअप टेबल में मेटाडेटा के बिना प्लेसमेंट, जानकारी नहीं है, चैनल अब उपलब्ध नहीं है या वीडियो अब उपलब्ध नहीं है के तौर पर दिखते हैं. एपीआई में, हर यूनीक प्लेसमेंट आइडेंटिफ़ायर अब भी मेट्रिक की एक लाइन दिखाता है. इसमें
placement,display_name, औरtarget_urlफ़ील्ड सेट नहीं होते. - सिंथसाइज़ किए गए संसाधन के नाम:
resource_nameफ़ील्ड में{base64_placement}सफ़िक्स,{type_id}_{placement}से Base64-कोड में बदला गया है. इसमें{type_id},PlacementTypeenum नंबर के बजाय, प्लेसमेंट टाइप का इंटरनल आइडेंटिफ़ायर है. जबplacement_typeफ़ील्डWEBSITE(इंटरनल आईडी14) होता है औरplacementफ़ील्ड सेट नहीं होता है, तो स्ट्रिंग"14_",MTRfमें एन्कोड होती है (इसी तरह,MOBILE_APPLICATION,"55_"कोNTVfमें एन्कोड करता है,YOUTUBE_VIDEO,"89_"कोODlfमें एन्कोड करता है, औरYOUTUBE_CHANNEL,"90_"कोOTBfमें एन्कोड करता है). इसलिए, एक ही विज्ञापन ग्रुप में मौजूद, एक ही तरह के कई प्लेसमेंट के लिए, मेटाडेटा उपलब्ध न होने पर, वे एक हीresource_nameवैल्यू शेयर करते हैं. हालांकि, वे अलग-अलग मेट्रिक लाइन रिपोर्ट करते हैं.
क्लाइंट कोड में group_placement_view या detail_placement_view के नतीजों को प्रोसेस करते समय, सिर्फ़ resource_name फ़ील्ड के आधार पर डुप्लीकेट लाइनें न हटाएं. ऐसा करने से, अलग-अलग प्लेसमेंट की मेट्रिक ओवरराइट हो सकती हैं. ऐसा तब होता है, जब मेटाडेटा उपलब्ध न हो.
GAQL में, उपलब्ध न होने वाले मेटाडेटा वाली पंक्तियों को बाहर रखने के लिए, target_url या display_name फ़ील्ड पर फ़िल्टर करें. ऐसा इसलिए, क्योंकि placement और resource_name फ़ील्ड को फ़िल्टर नहीं किया जा सकता. उदाहरण के लिए, WHERE group_placement_view.target_url IS
NOT NULL या WHERE detail_placement_view.target_url IS NOT NULL का इस्तेमाल करें.
परफ़ॉर्मेंस मैक्स कैंपेन का प्लेसमेंट व्यू
- इससे क्या पता चलता है:
performance_max_placement_viewरिसॉर्स से, उन प्लेसमेंट के लिए इंप्रेशन डेटा (metrics.impressions) मिलता है जहां परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाए गए थे. v24 और इसके बाद के वर्शन में,performance_max_placement_viewकोsegments.ad_network_typeके हिसाब से सेगमेंट किया जा सकता है. हालांकि, v23 में ऐसा नहीं किया जा सकता. - यूज़र इंटरफ़ेस (यूआई) के हिसाब से: अहम जानकारी और रिपोर्ट > रिपोर्ट एडिटर > परफ़ॉर्मेंस मैक्स कैंपेन का प्लेसमेंट
- क्वेरी बिल्डर: क्वेरी बिल्डर में एक्सप्लोर करें
उदाहरण के तौर पर दी गई क्वेरी
नीचे दी गई क्वेरी, पिछले 30 दिनों के दौरान परफ़ॉर्मेंस मैक्स कैंपेन के लिए, विज्ञापन नेटवर्क टाइप के हिसाब से सेगमेंट किए गए प्लेसमेंट इंप्रेशन फ़ेच करती है:
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
प्लेसमेंट व्यू चुनना
managed_placement_viewका इस्तेमाल करके, उन प्लेसमेंट की परफ़ॉर्मेंस का आकलन करें जिन्हें आपने टारगेट किया है और जिन पर बिडिंग की है.group_placement_viewका इस्तेमाल करके, यह जानें कि आपके विज्ञापन कहां दिख रहे हैं. खास तौर पर, "ऑब्ज़र्वेशन" सेटिंग का इस्तेमाल करते समय, टारगेट करने के नए अवसर या एक्सक्लूज़न खोजें.detail_placement_viewका इस्तेमाल करके, उन यूआरएल या वीडियो के बारे में ज़्यादा से ज़्यादा जानकारी पाएं जहां आपके विज्ञापन दिखाए गए. आम तौर पर, इसका इस्तेमालgroup_placement_viewमें किसी डोमेन या चैनल की पहचान करने के बाद किया जाता है.- परफ़ॉर्मेंस मैक्स कैंपेन के प्लेसमेंट इंप्रेशन की जांच करने के लिए,
performance_max_placement_viewका इस्तेमाल करें.