Ads API पदानुक्रम और शब्दावली

Ads API में सफलतापूर्वक काम करने के लिए यह समझना ज़रूरी है कि X Ads में मौजूद इकाइयाँ आपस में कैसे संबंधित हैं। यह ट्यूटोरियल X Ads ऑब्जेक्ट पदानुक्रम की बुनियादी बातें समझाता है।

​

विज्ञापन समूह (line items)

विज्ञापन समूह, जिन्हें Ads API में line items कहा जाता है, कैंपेन के अंतर्गत आते हैं और X उपयोगकर्ताओं के एक समूह को लक्षित करने तथा उन पर बोली लगाने के लिए इस्तेमाल किए जाते हैं। विज्ञापनदाता पोस्ट्स या मीडिया (उदाहरण के लिए, ऐसे वीडियो जिन्हें In-stream ads के रूप में प्रमोट किया जाता है) को किसी line item से जोड़कर उनका प्रचार करते हैं। Ad Group भी देखें।

​

अकाउंट मीडिया

क्रिएटिव्स का एक संग्रह, जिन्हें किसी ads account में account media के रूप में अपलोड किया गया है। इसमें promoted video pre-roll assets शामिल हो सकते हैं, जिन्हें in-stream ads भी कहा जाता है, साथ ही ऐसी इमेज भी शामिल हो सकती हैं जिन्हें X Audience Platform पर प्रमोट किया जा सकता है।

​

Ads Accounts

X Ads पदानुक्रम के शीर्ष स्तर पर ads accounts होते हैं। एक ads account को कई X उपयोगकर्ता प्रबंधित कर सकते हैं। @Furni, हमारा डेमो फ़र्नीचर स्टोर, ऐसे उपयोगकर्ता का एक उदाहरण है जो एक ads account प्रबंधित करता है। हम ads accounts की पहचान account_id से करते हैं, जो एक base36 अल्फ़ान्यूमेरिक स्ट्रिंग होती है।

हर account के अंतर्गत, हम कई entity types संग्रहीत करते हैं जिन्हें कैंपेन में दोबारा इस्तेमाल किया जा सकता है, जैसे tailored audiences, जिनका उपयोग targeting के लिए किया जा सकता है, account media, जो videos या images होते हैं, और cards, जो विस्तारित creatives होते हैं जिन्हें आप किसी पोस्ट में जोड़ सकते हैं।

​

Amplify Video

वीडियो एसेट अपलोड करते समय, अपलोड करने वाली इकाई वीडियो के लिए एक श्रेणी तय कर सकती है (उदाहरण के लिए, Tweet Video, Tweet Gif, Tweet Image और Amplify Video)। जिस वीडियो को in-stream advertisement के रूप में दिखाया जाना है, उसे अपलोड करने के लिए amplify video श्रेणी आवश्यक है। इन वीडियो के लिए विशेष प्रोसेसिंग की आवश्यकता होती है, ताकि यह सुनिश्चित किया जा सके कि उन्हें सर्व किया जा सके। इसी वजह से Amplify Video media category आवश्यक है।

​

Analytics

Analytics मेट्रिक्स, पार्टनर और विज्ञापनदाताओं को यह समझने में मदद करते हैं कि वे X पर जिस कॉन्टेंट का प्रचार करते हैं, उसका प्रदर्शन कैसा है। इसमें impressions, clicks, video views, और spend जैसी जानकारी शामिल होती है। इसके अलावा, पार्टनर और विज्ञापनदाता उन ऑडियंस के विभिन्न सेगमेंट के लिए विस्तृत मेट्रिक्स भी प्राप्त कर सकते हैं, जिन तक उनकी पहुँच होती है।

Ads API, कैंपेन performance के विस्तृत मेट्रिक्स प्राप्त करने के दो तरीकों का समर्थन करता है: synchronously और asynchronously।

synchronous analytics अनुरोधों में, अनुरोधित मेट्रिक्स रिस्पॉन्स में लौटाए जाते हैं। synchronous endpoint कम समय-सीमा का समर्थन करता है और real-time कैंपेन performance को query करने के लिए आदर्श है।

asynchronous analytics endpoints में, अनुरोधित मेट्रिक्स संबंधित “job” की processing पूरी होने के बाद डाउनलोड की जा सकने वाली results file में उपलब्ध होते हैं। asynchronous endpoints, कहीं लंबी समय-सीमा में मेट्रिक्स का अनुरोध करने, segmented data लौटाने, और बहुत अधिक डेटा प्राप्त करने का समर्थन करते हैं — इसलिए ये reporting या historical backfills जनरेट करने के लिए आदर्श हैं।

​

कैंपेन

विज्ञापनदाता जो भी कैंपेन चलाता है, उसे किसी मौजूदा funding instrument के अंतर्गत बनाना आवश्यक है। कैंपेन की मदद से आप विज्ञापन कैंपेन का नाम, समय-सारणी और बजट जैसी चीज़ें तय कर सकते हैं। Furni के उदाहरण को आगे बढ़ाते हुए, हम “Furni home decor” नाम का एक कैंपेन बना सकते हैं।

यह ध्यान देने योग्य है कि एक ads account में अधिकतम 200 सक्रिय कैंपेन ही हो सकते हैं; इस सीमा को विज्ञापनदाता का account manager बढ़ा सकता है। किसी कैंपेन को तब तक सक्रिय माना जाता है, जब तक उसका end time नहीं आ जाता या उसका बजट समाप्त नहीं हो जाता। कैंपेन limits के संदर्भ में, paused कैंपेन को भी सक्रिय कैंपेन माना जाता है।

​

कार्ड्स

कार्ड्स, किसी Tweet को दृश्य रूप से विस्तारित करने का एक तरीका देते हैं, ताकि उसमें इमेज, वीडियो या UI एलिमेंट शामिल किए जा सकें। Ads API कई तरह के कार्ड्स का समर्थन करता है, जिनका उपयोग Tweets में किया जा सकता है और फिर उन्हें अभियानों में प्रमोट किया जा सकता है।

​

क्रिएटिव्स

विज्ञापनदाता उन कैंपेनों में Tweets को प्रमोट कर सकते हैं जिनमें इमेज, GIFs और वीडियो जैसे क्रिएटिव्स शामिल होते हैं। इन क्रिएटिव्स को X cards से जोड़ा जा सकता है, जिनकी मदद से Tweets के साथ समृद्ध फ़ोटो, वीडियो और अन्य मीडिया अनुभव संलग्न किए जा सकते हैं। क्रिएटिव्स को सीधे Tweets के साथ भी संलग्न किया जा सकता है। उदाहरण के लिए, आप टेक्स्ट और एक वीडियो (या अधिकतम 3 इमेज) शामिल करके एक प्रमोट किया गया Tweet बना सकते हैं।

चलाने के लिए, प्रत्येक line item के साथ कम-से-कम एक creative जुड़ा होना ज़रूरी है। क्रिएटिव्स के लिए कई विकल्प उपलब्ध हैं, जिनमें नए फ़ॉलोअर्स हासिल करने के लिए Promoted Accounts, TX Audience Platform में line items के लिए इमेज या वीडियो जैसे Media Creatives, या Promoted Posts शामिल हैं।

​

वित्तपोषण साधन

ads account के अंतर्गत वित्तपोषण साधन भी होते हैं। ये वे अलग-अलग वित्तीय स्रोत हैं जिन्हें विज्ञापनदाता ने X Ads के साथ उपयोग करने के लिए सेट अप किया होता है। इनमें X के साथ हस्ताक्षरित insertion orders से लेकर खाते से जुड़े क्रेडिट कार्ड तक शामिल होते हैं।

​

लाइन आइटम्स

किसी कैंपेन के भीतर, आपके पास एक या उससे अधिक ad groups हो सकते हैं, जिन्हें Ads API में line items भी कहा जाता है। Line items को कैंपेन के अलग-अलग सेगमेंट के रूप में समझा जा सकता है, जिनमें से प्रत्येक का अपना targeting set और अपना creative होता है। जिन कैंपेनों में कई line items होते हैं, उन्हें अक्सर “ad group campaigns” कहा जाता है।

एक ही कैंपेन के भीतर कई line items होने का एक लाभ यह है कि आप targeting और creative के अधिक विविध संयोजन बना सकते हैं।

हमारे “Furni home decor” कैंपेन के अंतर्गत, हम दो line items बनाना चाह सकते हैं: एक “San Francisco में home buyers” हो सकता है, और दूसरा “London में home buyers” हो सकता है।

प्रति कैंपेन अधिकतम 100 line items की अनुमति है, और एक ads account में सभी कैंपेनों में कुल मिलाकर 4,000 active line items तक हो सकते हैं।

​

मोबाइल ऐप प्रमोशन (MAP)

मोबाइल ऐप प्रमोशन, या MAP, उत्पादों का एक ऐसा समूह है जो विज्ञापनदाताओं को X के माध्यम से मोबाइल ऐप्स का प्रचार करने में सक्षम बनाता है। इसमें ऐप इंस्टॉल, कन्वर्ज़न और फिर से जुड़ाव शामिल हैं।

​

मोबाइल ऐप रूपांतरण ट्रैकिंग (MACT)

X मोबाइल ऐप प्रमोशन मापन विज्ञापनदाताओं को X पर उन विज्ञापन कैंपेनों की सफलता ट्रैक करने की सुविधा देता है, जिन्हें ऐप इंस्टॉल या अन्य इन-ऐप रूपांतरण बढ़ाने के लिए डिज़ाइन किया गया है। X का एक मोबाइल मापन भागीदार विज्ञापनदाता को यह प्रबंधित करने की सुविधा देता है कि वे X पर प्रमोट किए जा रहे ऐप्स से किन रूपांतरणों को ट्रैक करना चाहते हैं। MACT अवलोकन

​

मीडिया लाइब्रेरी

Media Library एंडपॉइंट्स, X Ads ads accounts के लिए इमेज, GIF और वीडियो को प्रबंधित करने की सुविधा देते हैं। लाइब्रेरी में मौजूद मीडिया एसेट्स का उपयोग पोस्ट्स में और कार्ड बनाने के लिए किया जा सकता है। इन्हें कई क्रिएटिव्स में फिर से इस्तेमाल भी किया जा सकता है, जिससे एक ही एसेट को बार-बार अपलोड करने की आवश्यकता नहीं रहती।

​

प्रमोटेड अकाउंट्स

प्रमोटेड अकाउंट्स (फ़ॉलोअर कैंपेन) Who to Follow का हिस्सा हैं, जो ऐसे अकाउंट्स सुझाता है जिन्हें लोग अभी फ़ॉलो नहीं करते, लेकिन जो उन्हें दिलचस्प लग सकते हैं। प्रमोटेड अकाउंट्स लोगों को ऐसे और भी विविध अकाउंट्स से परिचित कराने में मदद करते हैं जो उन्हें पसंद आ सकते हैं।

प्रमोटेड अकाउंट्स विज्ञापनदाताओं को अपने अकाउंट का प्रचार करने और X पर अपनी ऑडियंस बढ़ाने की सुविधा देते हैं। फ़ॉलोअर कैंपेन X प्लेटफ़ॉर्म पर कई जगहों पर दिखाए जाते हैं — जिनमें Home Timelines, Who to Follow, और खोज परिणाम शामिल हैं — और इस सुझाव पर Promoted का लेबल लगाया जाता है, ताकि इसे अन्य सुझाए गए अकाउंट्स से अलग पहचाना जा सके।

​

प्रमोट किए जा सकने वाले उपयोगकर्ता

प्रत्येक X Ads account में एक या अधिक प्रमोट किए जा सकने वाले उपयोगकर्ता हो सकते हैं, यानी ऐसे उपयोगकर्ता जिन्हें हम उस ads account के माध्यम से प्रमोट कर सकते हैं। Furni के ads account के अंतर्गत Furni का @Furni handle, FULL प्रमोट किए जा सकने वाले उपयोगकर्ता का एक उदाहरण है। इसका अर्थ है कि हम @Furni और उनके Tweets के लिए सभी प्रकार के कैंपेन चला सकते हैं। किसी ads account के लिए केवल एक ही FULL प्रमोट किए जा सकने वाले उपयोगकर्ता हो सकता है।

ध्यान दें कि किसी ads account के अंतर्गत अन्य प्रमोट किए जा सकने वाले उपयोगकर्ता भी हो सकते हैं। उदाहरण के लिए, यदि हम Furni के उत्पादों के बारे में @Jack के Tweets को प्रमोट करना चाहें, तो वह उस खाते पर केवल retweet-only प्रमोट किए जा सकने वाले उपयोगकर्ता बन जाएंगे, जिसे RETWEETS_ONLY से दर्शाया जाता है। विज्ञापनदाताओं को अपने ads account में retweet उपयोगकर्ताओं को जोड़ने के बारे में जानकारी के लिए अपने X account manager से संपर्क करना चाहिए।

​

प्रमोटेड वीडियो

प्रमोटेड वीडियो, Promoted Tweets में शामिल वे वीडियो होते हैं जिनके लिए विज्ञापनदाता भुगतान करते हैं। ये होम टाइमलाइन में, X पर खोज परिणामों में सबसे ऊपर, और प्लेटफ़ॉर्म पर अन्य जगहों पर दिखाई देते हैं, और इन्हें स्पष्ट रूप से “Promoted” के रूप में लेबल किया जाता है।

​

Publisher Network

X Audience Platform देखें।

​

अनुसूचित Tweets

अनुसूचित Tweets विज्ञापनदाताओं या उपयोगकर्ताओं को ऐसा Tweet बनाने की सुविधा देते हैं, जिसे बाद की किसी तारीख पर लाइव होने के लिए शेड्यूल किया जा सके। इन Tweets को बनाने और प्रबंधित करने के अलावा, API इन Tweets को किसी line item से संबद्ध करने की सुविधा भी देता है, ताकि Tweet के लाइव होते ही उसका प्रमोशन किया जा सके। इससे विज्ञापनदाता पहले से native Tweets तैयार कर सकते हैं और किसी भी प्रमुख पहल से पहले अपनी कैंपेन creatives की योजना बना सकते हैं। उदाहरण के लिए, किसी नए उत्पाद की घोषणा होते ही तुरंत लाइव करने के लिए किसी Tweet creative को पहले से तैयार रखना।

​

सेगमेंटेशन

सेगमेंटेशन की मदद से भागीदार और विज्ञापनदाता ऐसे मेट्रिक्स प्राप्त कर सकते हैं, जिन्हें आयु, डिवाइस या भाषाओं जैसे विशिष्ट टार्गेटिंग मानों के आधार पर विभाजित किया गया हो। यह सुविधा केवल हमारे asynchronous analytics endpoints के माध्यम से उपलब्ध है। सेगमेंट किए गए मेट्रिक्स का अनुरोध करने के लिए, segmentation_type request parameter का उपयोग करें। सेगमेंटेशन विकल्पों के बारे में अधिक जानकारी के लिए, Metrics and Segmentation देखें।

​

अनुकूलित ऑडियंस - सूची

सूचियों से बनाए गए अनुकूलित ऑडियंस, अनुकूलित ऑडियंस के तीन प्रकारों में से एक हैं। इन्हें आपकी अपनी उपयोगकर्ता और ग्राहक डेटा वाली फ़ाइल अपलोड करके बनाया जाता है। आपकी सूचियों का X पर उपयोगकर्ताओं से मिलान किया जाता है, ताकि आप उन्हें अपने कैंपेनों में सीधे लक्षित कर सकें। कृपया इन प्रतिबंधों की समीक्षा करें।

​

अनुकूलित ऑडियंस - वेब

वेब से अनुकूलित ऑडियंस, अनुकूलित ऑडियंस के तीन प्रकारों में से एक, उन X उपयोगकर्ताओं का समूह है जो आपकी वेबसाइट पर आ चुके हैं। वेब से अनुकूलित ऑडियंस का उपयोग करने के लिए, आपकी वेबसाइट पर हमारा X pixel इंस्टॉल होना चाहिए या आपको हमारे स्वीकृत tag manager भागीदारों में से किसी एक का उपयोग करना होगा। कृपया इन प्रतिबंधों की समीक्षा करें।

​

लक्ष्यीकरण मानदंड

जैसा कि हमने पहले बताया था, लक्ष्यीकरण मानदंड किसी line item से जुड़े होते हैं। आपके उपयोग के लिए हमारे पास कई तरह के लक्ष्यीकरण विकल्प उपलब्ध हैं, जिनमें location, keywords, और gender से लेकर user behaviors और interests जैसी अधिक सूक्ष्म विशेषताएँ शामिल हैं। “Home Buyers in San Francisco” line item के लिए, हम “home buying” behavior के साथ “San Francisco” location को target कर सकते हैं।

उपलब्ध अलग-अलग प्रकार के लक्ष्यीकरण के बारे में अधिक जानकारी के लिए, हमारी developer site पर Targeting Overview पेज देखें।

​

Twitter Object Nest (TON)

Twitter Object Nest (TON) में Media Upload endpoints के माध्यम से अपलोड किए गए मीडिया और विभिन्न एसेट्स संग्रहीत रहते हैं, जिनका उपयोग Creatives के रूप में किया जाता है।

​

क्रिएटिव्स

चलाने के लिए प्रत्येक line item के साथ कम से कम एक creative जुड़ा होना ज़रूरी है। क्रिएटिव्स के लिए कई विकल्प उपलब्ध हैं, जिनमें नए followers पाने के लिए Promoted Accounts, X Audience Platform में line items के लिए image या video जैसे Media Creatives, या Promoted Posts शामिल हैं। यहाँ एक उदाहरण पोस्ट है, जिसे @Furni प्रमोट कर सकता है और creative के रूप में इस्तेमाल कर सकता है।