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

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

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

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

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

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

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

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

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

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

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

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

  1. accountId और webPropertyId को वापस पाने के लिए, मैनेजमेंट एपीआई या खाता एक्सप्लोरर का इस्तेमाल करें.
  2. linkedViews [] प्रॉपर्टी के लिए व्यू (प्रोफ़ाइल) आईडी फिर से पाने के लिए, मैनेजमेंट एपीआई या खाता एक्सप्लोरर का इस्तेमाल करें.
  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 बनाना होगा, जिसमें NOT ऑपरेटर (! वर्ण) नहीं है. अगर आपको बाहर रखने की शर्त शामिल करनी है, तो आपको statebasedDefinition तय करना होगा. ज़्यादा जानने के लिए, स्थिति पर आधारित ऑडियंस देखें. ज़्यादा जानकारी के लिए, पहचान फ़ाइल का उदाहरण देखें.

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

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

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