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

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

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

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

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

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

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

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

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

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

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

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

• audience फ़ील्ड में ऑडियंस का मान्य नाम, जिसे properties/{propertyId}/audiences/{audienceId} के तौर पर फ़ॉर्मैट किया गया हो. इस वैल्यू को पाने के लिए, Google Analytics एडमिन एपीआई 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 में वेबहुक इस्तेमाल करने के बारे में ज़्यादा जानकारी पाने के लिए, WebhookNotification दस्तावेज़ देखें.

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

ऑडियंस एक्सपोर्ट में उपयोगकर्ताओं को वापस पाने के लिए, 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
}