क्रिएटर की अहम जानकारी वाली सुविधा की मदद से, YouTube क्रिएटर्स के बारे में अहम जानकारी खोजें और पाएं. यह सुविधा, उन एजेंसियों और विज्ञापन देने वाले लोगों या कंपनियों के लिए काम की हो सकती है जो अपनी टारगेट ऑडियंस के हिसाब से क्रिएटर्स को ढूंढना चाहते हैं.
एपीआई के चार मुख्य फ़ंक्शन हैं:
- क्रिएटर को खोज पाना: विषयों, डेमोग्राफ़िक्स, ऑडियंस या क्रिएटर के एट्रिब्यूट के किसी सेट के लिए, टॉप क्रिएटर्स को ढूंढें.
- क्रिएटर के ब्रैंड की अहम जानकारी: किसी खास ब्रैंड से जुड़े क्रिएटर्स के बारे में अहम जानकारी पाएं.
- क्रिएटर की अहम जानकारी: YouTube के चुनिंदा चैनलों के बारे में अहम जानकारी पाएं. जैसे, सदस्यों की संख्या, व्यू की संख्या, और ऑडियंस के डेमोग्राफ़िक्स.
- ट्रेंडिंग की अहम जानकारी: चुनिंदा ऑडियंस या विषयों के आधार पर, खास ट्रेंड के बारे में अहम जानकारी पाएं.
ज़रूरी शर्तें
ContentCreatorInsightsService.GenerateCreatorInsights
, Google Ads API का एक निजी कॉम्पोनेंट है. इसे बिना किसी शुल्क के, डेटा लाइसेंस के साथ उपलब्ध कराया जाता है. हालांकि, यह लाइसेंस सिर्फ़ कुछ समय के लिए होता है. अनुमति वाले पार्टनर, YouTube क्रिएटर्स और कॉन्टेंट को एक्सप्लोर करने के लिए, स्टैंडर्ड
Google Ads क्लाइंट लाइब्रेरी का इस्तेमाल कर सकते हैं.
अनुमति पाने के लिए, पार्टनर को ये शर्तें पूरी करनी होंगी:
- उनके पास कोई प्लानिंग टूल या यूज़र इंटरफ़ेस होना चाहिए, जिसमें Google Ads API को इंटिग्रेट किया जा सके.
- उन्हें संभावित विज्ञापन के अवसरों के लिए, YouTube के कॉन्टेंट और क्रिएटर्स को एक्सप्लोर करने के लिए, एपीआई का इस्तेमाल करना होगा.
- उन्हें अनुमति पाने के लिए, पहले से स्क्रीन की गई असेसमेंट की प्रक्रिया पूरी करनी होगी.
- उन्हें डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तें पूरी करनी होंगी और समय-समय पर होने वाले डेटा ऑडिट के लिए तैयार रहना होगा.
- उन्हें डेटा लाइसेंसिंग के ऐसे समझौते पर हस्ताक्षर करने होंगे जो डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तों को कानूनी तौर पर लागू करता हो.
- उन्हें Google Ads API की सेवा की शर्तें स्वीकार करनी होंगी.
ज़्यादा जानकारी के लिए, अपने Google प्रतिनिधि से संपर्क करें.
क्रिएटर की अहम जानकारी जनरेट करना
क्रिएटर की अहम जानकारी जनरेट करने के लिए, ContentCreatorInsightsService.GenerateCreatorInsights
तरीके को अनुरोध भेजें. इस तरीके के लिए, हर सेकंड में पांच क्वेरी (क्यूपीएस) की सीमा तय की गई है. साथ ही, यह तीन तरह के इनपुट लेता है. यह इस बात पर निर्भर करता है कि आपको क्रिएटर को खोज पाने की सुविधा, क्रिएटर के ब्रैंड की अहम जानकारी या क्रिएटर की अहम जानकारी चाहिए. आपको उन देशों की जगहें बतानी होंगी जहां से आपको डेटा चाहिए.
क्रिएटर को खोज पाना: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी (इसमें अफ़िनिटी, इन-मार्केट, और लाइफ़ इवेंट ऑडियंस शामिल हैं). एपीआई, उन क्रिएटर्स की सूची दिखाता है जिनकी ऑडियंस, उन एट्रिब्यूट से मेल खाती है. क्रिएटर के एट्रिब्यूट भी दिए जा सकते हैं, ताकि उन क्रिएटर्स को फ़िल्टर किया जा सके जिनका कॉन्टेंट, आपके दिए गए क्रिएटर के एट्रिब्यूट से मेल खाता हो.
`AudienceInsightsService.ListAudienceInsightsAttributes` का इस्तेमाल करके, ऑडियंस के उपलब्ध एट्रिब्यूट वापस पाए जा सकते हैं. इसके लिए, आपको उन डाइमेंशन के बारे में बताना होगा जिनके लिए आपको एट्रिब्यूट चाहिए. जैसे, दिलचस्पी के विषयों के लिए
KNOWLEDGE_GRAPH.AudienceInsightsService.ListAudienceInsightsAttributesGoogle Ads API के वर्शन 23 से,
audience_combinationsका इस्तेमाल करके, ऑडियंस के एट्रिब्यूट के जटिल संबंधों के बारे में बताया जा सकता है. इस फ़ील्ड की मदद से, बूलियन लॉजिक (AND/OR) के साथ ऑडियंस को तय किया जा सकता है. ऐसाaudience_attributesके साथ नहीं किया जा सकता.audience_attributesका इस्तेमाल, यूनाइट किए गए (OR के साथ जोड़े गए) एट्रिब्यूट की सूची के आधार पर टारगेटिंग के लिए किया जा सकता है.जैसे, "खेल-कूद" या "यात्रा" या ... में दिलचस्पी रखने वाले उपयोगकर्ता. वहीं,audience_combinationsसे ज़्यादा बेहतर कंट्रोल मिलता है.audience_combinationsमें मौजूद हरInsightsAudienceAttributeGroup, एट्रिब्यूट को लॉजिकल OR के साथ जोड़ता है. इसके बाद, इन ग्रुप को लॉजिकल AND के साथ जोड़ा जाता है.उदाहरण के लिए, ("स्किन केयर" या "हेयर केयर") और "कॉस्मेटिक्स" में दिलचस्पी रखने वाली ऑडियंस को टारगेट करने के लिए,
audience_combinationsमें दोInsightsAudienceAttributeGroupआइटम का इस्तेमाल किया जाएगा. "स्किन केयर", "हेयर केयर", और "कॉस्मेटिक्स" दिलचस्पी के विषय हैं. इन्हें नॉलेज ग्राफ़ की इकाइयों से दिखाया जाता है. उदाहरण के लिए, कॉस्मेटिक्स के लिए/m/014trl. पहले ग्रुप में, "स्किन केयर" और "हेयर केयर" के लिए नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल होंगे. वहीं, दूसरे ग्रुप में "कॉस्मेटिक्स" के लिए नॉलेज ग्राफ़ की इकाई का एट्रिब्यूट शामिल होगा.ध्यान दें कि अगर
audience_attributesमें नॉलेज ग्राफ़ की इकाइयां, प्रॉडक्ट और सेवा की कैटगरी या उपयोगकर्ता की दिलचस्पी के बारे में बताया जाता है, तोaudience_combinationsका इस्तेमाल नहीं किया जा सकता. अगरaudience_combinationsका इस्तेमाल किया जाता है, तो इन एट्रिब्यूट कोaudience_combinationsमें बताना होगा. इन्हेंaudience_attributesमें नहीं बताया जा सकता. हालांकि,audience_combinationsके साथ, डेमोग्राफ़िक्स जैसे अन्य एट्रिब्यूट टाइप के लिए,audience_attributesका इस्तेमाल किया जा सकता है.क्रिएटर के ब्रैंड की अहम जानकारी: टॉप क्रिएटर्स को खोजने के लिए, कोई ब्रैंड बताएं. एपीआई, मेल खाने वाले चैनलों के बारे में अहम जानकारी दिखाता है.
क्रिएटर की अहम जानकारी: YouTube चैनल आईडी की सूची दें. एपीआई, उन खास चैनलों के बारे में अहम जानकारी दिखाता है.
generateCreatorInsights तरीका, GenerateCreatorInsightsResponse ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में, YouTubeCreatorInsights ऑब्जेक्ट की सूची शामिल होती है. हर YouTubeCreatorInsights ऑब्जेक्ट में, किसी क्रिएटर के बारे में यह जानकारी शामिल होती है:
- क्रिएटर का नाम
- YouTube चैनल
- क्रिएटर की कुल मेट्रिक
- YouTube चैनल की अहम जानकारी की सूची
YouTubeMetrics ऑब्जेक्ट में ये मेट्रिक शामिल होती हैं:
- सदस्यों की संख्या
- व्यू की संख्या
- वीडियो की संख्या
- शॉर्ट वीडियो बनाने वाला सक्रिय क्रिएटर है या नहीं
- पार्टनरशिप के अवसर (वर्शन 23 से उपलब्ध )
YouTubeChannelInsights ऑब्जेक्ट में, YouTube चैनल के बारे में यह जानकारी शामिल होती है:
- चैनल का नाम
- चैनल आईडी
- चैनल का यूआरएल
- चैनल का ब्यौरा
- चैनल की मेट्रिक
चैनल की ऑडियंस के एट्रिब्यूट (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी
की जानकारी)
सबसे ज़्यादा देखे गए वीडियो
चैनल प्रकार
चैनल के कॉन्टेंट से जुड़ी भाषाएं
काम का स्कोर (सिर्फ़ विषय के ट्रेंड की खोजों के लिए)
ट्रेंडिंग की अहम जानकारी जनरेट करना
ट्रेंडिंग की अहम जानकारी जनरेट करने के लिए, ContentCreatorInsightsService.GenerateTrendingInsights
तरीके को अनुरोध भेजें. इस तरीके के लिए, हर सेकंड में पांच क्वेरी (क्यूपीएस) की सीमा तय की गई है. साथ ही, यह दो तरह के इनपुट लेता है. यह इस बात पर निर्भर करता है कि आपको ऑडियंस के ट्रेंड या विषय के ट्रेंड चाहिए.
आपको उस देश की जगह बतानी होगी जहां से आपको ट्रेंड चाहिए.
ऑडियंस के ट्रेंड: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी (इसमें अफ़िनिटी, इन-मार्केट, और लाइफ़ इवेंट ऑडियंस शामिल हैं). एपीआई, उन ऑडियंस के लिए ट्रेंडिंग की अहम जानकारी की सूची दिखाता है. इसमें, तुलना की अवधि के दौरान ट्रेंड की वैल्यू में हुए प्रतिशत के बदलाव जैसी मेट्रिक शामिल होती हैं.
`AudienceInsightsService.ListAudienceInsightsAttributes` का इस्तेमाल करके, ऑडियंस के उपलब्ध एट्रिब्यूट वापस पाए जा सकते हैं. इसके लिए, आपको उन डाइमेंशन के बारे में बताना होगा जिनके लिए आपको एट्रिब्यूट चाहिए. जैसे, दिलचस्पी के विषयों के लिए
KNOWLEDGE_GRAPH.AudienceInsightsService.ListAudienceInsightsAttributesGoogle Ads API के वर्शन 23 से,
audience_combinationsका इस्तेमाल करके, ऑडियंस के एट्रिब्यूट के जटिल संबंधों के बारे में बताया जा सकता है. इस फ़ील्ड की मदद से, बूलियन लॉजिक (AND/OR) के साथ ऑडियंस को तय किया जा सकता है. ऐसाaudience_attributesके साथ नहीं किया जा सकता.audience_attributesका इस्तेमाल, यूनाइट किए गए (OR के साथ जोड़े गए) एट्रिब्यूट की सूची के आधार पर टारगेटिंग के लिए किया जा सकता है.जैसे, "खेल-कूद" या "यात्रा" या ... में दिलचस्पी रखने वाले उपयोगकर्ता. वहीं,audience_combinationsसे ज़्यादा बेहतर कंट्रोल मिलता है.audience_combinationsमें मौजूद हरInsightsAudienceAttributeGroup, एट्रिब्यूट को लॉजिकल OR के साथ जोड़ता है. इसके बाद, इन ग्रुप को लॉजिकल AND के साथ जोड़ा जाता है.उदाहरण के लिए, ("स्किन केयर" या "हेयर केयर") और "कॉस्मेटिक्स" में दिलचस्पी रखने वाली ऑडियंस को टारगेट करने के लिए,
audience_combinationsमें दोInsightsAudienceAttributeGroupआइटम का इस्तेमाल किया जाएगा. "स्किन केयर", "हेयर केयर", और "कॉस्मेटिक्स" दिलचस्पी के विषय हैं. इन्हें नॉलेज ग्राफ़ की इकाइयों से दिखाया जाता है. उदाहरण के लिए, कॉस्मेटिक्स के लिए/m/014trl. पहले ग्रुप में, "स्किन केयर" और "हेयर केयर" के लिए नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल होंगे. वहीं, दूसरे ग्रुप में "कॉस्मेटिक्स" के लिए नॉलेज ग्राफ़ की इकाई का एट्रिब्यूट शामिल होगा.ध्यान दें कि अगर
audience_attributesमें नॉलेज ग्राफ़ की इकाइयां, प्रॉडक्ट और सेवा की कैटगरी या उपयोगकर्ता की दिलचस्पी के बारे में बताया जाता है, तोaudience_combinationsका इस्तेमाल नहीं किया जा सकता. अगरaudience_combinationsका इस्तेमाल किया जाता है, तो इन एट्रिब्यूट कोaudience_combinationsमें बताना होगा. इन्हेंaudience_attributesमें नहीं बताया जा सकता. हालांकि,audience_combinationsके साथ, डेमोग्राफ़िक्स जैसे अन्य एट्रिब्यूट टाइप के लिए,audience_attributesका इस्तेमाल किया जा सकता है.विषय के ट्रेंड: कॉन्टेंट के विषयों की सूची दें. एपीआई, उन विषयों के लिए ट्रेंडिंग की अहम जानकारी की सूची दिखाता है. इसमें, तुलना की अवधि के दौरान ट्रेंड की वैल्यू में हुए प्रतिशत के बदलाव जैसी मेट्रिक शामिल होती हैं.