रीमार्केटिंग ऑडियंस के लिए डेवलपर गाइड

इस दस्तावेज़ में Google Analytics रीमार्केटिंग ऑडियंस को मैनेज करने के लिए, Management API का इस्तेमाल करने का तरीका बताया गया है.

शुरुआती जानकारी

मैनेजमेंट एपीआई की मदद से, Google Analytics प्रॉपर्टी के लिए create, get, delete, list, update, और patch रीमार्केटिंग ऑडियंस बनाई जा सकती हैं. रीमार्केटिंग ऑडियंस के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Analytics में रीमार्केटिंग ऑडियंस के बारे में जानकारी वाला सहायता केंद्र का लेख पढ़ें.

इस्तेमाल के उदाहरण

रीमार्केटिंग ऑडियंस रिसॉर्स get,delete, list, पैच, और अपडेट के साथ काम करता है. हालांकि, इनके इस्तेमाल के मुख्य उदाहरण यहां दिए गए हैं:

रीमार्केटिंग ऑडियंस की सूची बनाएं

किसी प्रॉपर्टी की सभी रीमार्केटिंग ऑडियंस की सूची बनाने के लिए:

  1. accountId और webPropertyId को वापस पाने के लिए, Management API या खाता एक्सप्लोरर का इस्तेमाल करें.
  2. रीमार्केटिंग ऑडियंस संसाधन का list तरीका लागू करें.

रीमार्केटिंग ऑडियंस के संसाधन के लिए list तरीके की जानकारी के लिए, एपीआई रेफ़रंस देखें.

नई रीमार्केटिंग ऑडियंस बनाएं

किसी प्रॉपर्टी के लिए नई रीमार्केटिंग ऑडियंस बनाने के लिए:

  1. accountId और webPropertyId को वापस पाने के लिए, Management API या खाता एक्सप्लोरर का इस्तेमाल करें.
  2. linkedViews [] प्रॉपर्टी के लिए व्यू (प्रोफ़ाइल) आईडी फिर से पाने के लिए, Management API या खाता एक्सप्लोरर का इस्तेमाल करें.
  3. linkedAdAccounts.linkedAccountId के लिए Google Ads खाता आईडी फिर से पाने के लिए, Google Ads लिंक कलेक्शन का इस्तेमाल करें.
    • फ़िलहाल, linkedAdAccounts[] प्रॉपर्टी सिर्फ़ एक linkedForeignAccount के लिए उपलब्ध है.
    • linkedAdAccounts[].type को ADWORDS_LINKS, DBM_LINKS, MCC_LINKS या OPTIMIZE पर सेट किया जा सकता है.
  4. includeConditions की segment प्रॉपर्टी को सेट करने के विकल्पों के लिए, सेगमेंट कलेक्शन का इस्तेमाल करें. अगर राज्य के हिसाब से ऑडियंस बनाई जा रही है, तो excludeConditions के लिए भी ऐसा ही किया जा सकता है. साथ ही, कोई सेगमेंट तय करने के लिए सेगमेंट रेफ़रंस देखें.
    • includeConditions में membershipDurationDays और daysToLookBack के लिए वैकल्पिक तौर पर वैल्यू हो सकती हैं
    • excludeConditions.exclusionDuration को PERMANENT पर सेट किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
  5. रीमार्केटिंग ऑडियंस संसाधन का insert तरीका एक्ज़ीक्यूट करें.

एपीआई आपको दो तरह की ऑडियंस बनाने की अनुमति देता है: SIMPLE और STATE_BASED. SIMPLE ऑडियंस के लिए, आपको सिर्फ़ पॉज़िटिव segment के साथ audienceDefinition बनाना होगा. इसमें नहीं ऑपरेटर (! वर्ण) शामिल नहीं होगा. अगर आपको बाहर रखने की शर्त शामिल करनी है, तो आपको statebasedDefinition तय करना होगा. ज़्यादा जानने के लिए, स्टेट के आधार पर ऑडियंस देखें. ज़्यादा जानकारी के लिए, रेफ़रंस का उदाहरण देखें.

मौजूदा रीमार्केटिंग ऑडियंस को अपडेट करना

किसी प्रॉपर्टी के लिए मौजूदा रीमार्केटिंग ऑडियंस अपडेट करने के लिए:

  1. अगर आपके पास पहले से रीमार्केटिंग ऑडियंस आईडी है, तो आपके पास get को कॉल करने का विकल्प है. इसके अलावा, list को कॉल करके वह ऑडियंस भी चुनी जा सकती है जिसे आपको अपडेट करना है.
  2. किसी भी राइटेबल फ़ील्ड को अपडेट करें और अपडेट किए गए ऑडियंस ऑब्जेक्ट में पासिंग update को कॉल करें.