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

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

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

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

हर दिन नई ऑडियंस सूची बनाना

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

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

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

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

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

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

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

• audience फ़ील्ड में, ऑडियंस का मान्य नाम, जिसे properties/{propertyId}/audiences/{audienceId} के तौर पर फ़ॉर्मैट किया गया हो. इस वैल्यू को पाने के लिए, Google Analytics Admin API v1 के audiences.list तरीके का इस्तेमाल किया जा सकता है. audiences.list जवाब के Audience.name फ़ील्ड में ऑडियंस का नाम होता है.
• 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"
  ]
}

किसी प्रॉपर्टी के लिए, बार-बार जनरेट होने वाली सभी ऑडियंस सूचियों को सूची में शामिल करने के लिए, recurringAudienceLists.list का इस्तेमाल किया जा सकता है.

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

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

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

Google Analytics Data API v1 में वेबहुक इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, 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
}