बार-बार आने वाली दर्शक सूचियां

इस दस्तावेज़ में आवर्ती ऑडियंस सूचियों के बारे में बताया गया है, जो Google Analytics डेटा एपीआई v1 की बेहतर सुविधा के बारे में ज़्यादा जानें. ऑडियंस की सूची एक्सपोर्ट करने की सुविधा के बारे में जानने के लिए, ऑडियंस एक्सपोर्ट करने की बुनियादी बातों वाली गाइड देखें.

बार-बार होने वाली ऑडियंस की सूचियां, इस तरह रोज़ ऑडियंस की सूचियां बनाती हैं: ऑडियंस की सदस्यताओं में बदलाव किया जा सकता है. इससे यह पक्का करने में मदद मिलती है कि आपको सबसे नए डेटा का इस्तेमाल किया जा रहा हो.

सामान्य (अपने-आप रिन्यू न होने वाली) ऑडियंस सूचियां, ऑडियंस में शामिल उपयोगकर्ताओं की स्टैटिक सूचियां होती हैं का इस्तेमाल करते हैं.

रोज़ एक नई ऑडियंस सूची बनाएं

एक दिन के ऑडियंस डेटा को प्रोसेस करने और उसे अपडेट करने में समय लग सकता है की सदस्यता. यह पक्का करने का कोई तरीका नहीं है कि ऑडियंस की सूची का डेटा 24 घंटे.

उदाहरण के लिए, भले ही आपने ऑडियंस की सूची का अनुरोध हर दिन एक ही समय पर किया हो, कुछ दिन ऑडियंस की सूची पहले जैसी ही रहेगी पिछले दिन और अन्य दिनों में, ऑडियंस की सूची अलग होगी और सदस्यता में एक अतिरिक्त दिन बदलाव होने चाहिए.

ऑडियंस की सूचियां, सबसे हाल ही के एक दिन पहले के इवेंट डेटा पर आधारित होती हैं सदस्यता में हुए बदलाव. अगर आपने पैसे चुकाकर ली जाने वाली रोज़ाना की सदस्यता से पहले ऑडियंस की सूची बनाई है, तो अपडेट होते हैं, तो इसमें दो दिन पहले के डेटा का उपयोग किया जाएगा. अगर आपको रोज़ाना की सदस्यता अपडेट होने के बाद, ऑडियंस की सूची इस तरह की ऑडियंस की सूची के डेटा का इस्तेमाल करेगी बीत�� हुआ कल.

समय-समय पर, ऑडियंस की बार-बार लागू होने वाली सूची के लिए पोल करना

बार-बार आने वाली ऑडियंस सूचियां सिर्फ़ तब ऑडियंस सूचियां बनाती हैं, जब किसी अतिरिक्त दिन का डेटा उपलब्ध है. इससे आपको नए वीडियो बनाने का समय तय नहीं करना पड़ता ऑडियंस की सूचियां. इसके बजाय, बार-बार लागू होने वाली ऑडियंस की सूची के लिए, सस्ते में पोल का इस्तेमाल किया जा सकता है ताकि अतिरिक्त डेटा उपलब्ध हो.

बार-बार लागू होने वाली ऑडियंस की सूची बनाना

बार-बार लागू होने वाली ऑडियंस की सूची बनाने के लिए, recurringAudienceLists.create तरीका इस्तेमाल करके RecurringAudienceList किसी अनुरोध में ऑब्जेक्ट शामिल है. ये पैरामीटर ज़रूरी हैं:

• इसमें ऑडियंस का मान्य नाम audience फ़ील्ड में, properties/{propertyId}/audiences/{audienceId} फ़ॉर्मैट में डाला गया है. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए audiences.list Google Analytics एडमिन एपीआई v1 का इस्तेमाल करें. कॉन्टेंट बनाने Audience.name audiences.list जवाब के फ़ील्ड में ऑडियंस का नाम डालें.
• डाइमेंशन की एक मान्य सूची dimensions फ़ील्ड में डालें. इस तरीके से काम करने वाले डाइमेंशन की सूची यहां दी गई है: ऑडियंस एक्सपोर्ट स्कीमा दस्तावेज़. इस फ़ील्ड में बताए गए डाइमेंशन का डेटा ही इसमें शामिल किया जाता है ऑडियंस सूची.

यहां ऑडियंस की सूची बनाने के लिए बार-बार किए जाने वाले अनुरोध का सैंपल दिया गया है:

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

recurringAudienceLists.create तरीके के रिस्पॉन्स में name फ़ील्ड में अपना नाम डालें (जैसे कि properties/1234567/recurringAudienceLists/123), इसका इस्तेमाल इन कामों में किया जा सकता है कॉन्फ़िगरेशन मेटाडेटा को वापस पाने के लिए, बाद की क्वेरी आपको यह बार-बार लागू होने वाली ऑडियंस की सूची के लिए दिखेगा. साथ ही, कॉन्फ़िगरेशन मेटाडेटा में ऑडियंस की सूची के इंस्टेंस के लिए संसाधन के नाम ऑडियंस की इस सूची के लिए बनाई गई.

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

पोल कॉन्फ़िगरेशन का मेटाडेटा

इसका इस्तेमाल करें recurringAudienceLists.get किसी खास फ़ील्ड का कॉन्फ़िगरेशन मेटाडेटा वापस पाने का तरीका बार-बार लागू होने वाली ऑडियंस की सूची चुनें. कॉन्फ़िगरेशन मेटाडेटा में यह शामिल है ऑडियंस की सूची के इंस्टेंस के लिए संसाधन के नाम ऑडियंस की इस सूची के लिए बनाई गई.

यहां एक उदाहरण दिया गया है:

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

RecurringAudienceList का एक इंस्टेंस जवाब में दिया जाता है. इसमें कॉन्फ़िगरेशन मेटाडेटा शामिल होता है, जिसमें यह शामिल होता है ऑडियंस की सूची के इंस्टेंस के लिए संसाधन के नाम ऑडियंस की इस सूची के लिए बनाई गई.

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Google Analytics 4 पर माइग्रेट करने के लिए, recurringAudienceLists.list का इस्तेमाल करें.

ऑडियंस की नई सूचियों के बारे में एसिंक्रोनस सूचनाएं पाने के लिए, वेबहुक का इस्तेमाल करें

किसी खास इवेंट के लिए कॉन्फ़िगरेशन मेटाडेटा की समय-समय पर पोलिंग करने के बजाय बार-बार लागू होने वाली ऑडियंस की सूची recurringAudienceLists.get तरीके का इस्तेमाल करते हैं, तो ऑडियंस सूची उपलब्ध हो जाती है.

वेबहुक की सूचनाएं कॉन्फ़िगर करने के लिए, webhookNotification फ़ील्ड में, बार-बार लागू होने वाली ऑडियंस की नई सूची बनाते समय इस फ़ील्ड में.

Async audience lists with webhooks गाइड का पालन करें .

ऑडियंस एक्सपोर्ट में उपयोगकर्ताओं को वापस लाना

किसी ऑडियंस एक्सपोर्ट में मौजूद उपयोगकर्ताओं को फिर से पाने के लिए, audienceExports.query तरीका और ऑडियंस एक्सपोर्ट का नाम डालें के ज़रिए दिए गए कॉन्फ़िगरेशन मेटाडेटा से लिया गया है recurringAudienceLists.get या recurringAudienceLists.list.

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

अगर ऑडियंस एक्सपोर्ट तैयार है, तो एक जवाब, जिसमें ऑडियंस में शामिल उपयोगकर्ताओं को दिखाया जाता है:

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}