পুনরাবৃত্ত শ্রোতা তালিকা

এই ডকুমেন্টটিতে রিকারিং অডিয়েন্স লিস্ট (recurring audience lists) সম্পর্কে বর্ণনা করা হয়েছে, যা গুগল অ্যানালিটিক্স ডেটা এপিআই ভি১ (Google Analytics Data API v1)-এর একটি অ্যাডভান্সড ফিচার। অডিয়েন্স লিস্ট এক্সপোর্ট (auditium list export) ফিচারটির পরিচিতির জন্য, অডিয়েন্স এক্সপোর্ট ফান্ডামেন্টালস গাইড (auditium export fundamentals guide) দেখুন।

পুনরাবৃত্তিমূলক দর্শক তালিকাগুলো দর্শক সদস্যপদ পরিবর্তনের সাথে সাথে প্রতিদিন নতুন তালিকা তৈরি করে, যাতে আপনি সবচেয়ে সাম্প্রতিক ডেটা নিয়ে কাজ করতে পারেন।

নিয়মিত (অ-পুনরাবৃত্তিমূলক) দর্শক তালিকা হলো তালিকাটি তৈরি করার সময় দর্শক তালিকায় থাকা ব্যবহারকারীদের একটি স্থির তালিকা।

প্রতিদিন একটি নতুন দর্শক তালিকা তৈরি করুন

একদিনের দর্শকের তথ্য প্রক্রিয়াকরণ এবং সদস্যপদ হালনাগাদ করতে পরিবর্তনশীল সময় লাগে। দর্শক তালিকার তথ্য ২৪ ঘণ্টার মধ্যে হালনাগাদ হবে, এমনটা নিশ্চিত করার কোনো উপায় নেই।

উদাহরণস্বরূপ, আপনি যদি প্রতিদিন একই সময়ে দর্শক তালিকার জন্য অনুরোধ করেন, তবুও কোনো কোনো দিন দর্শক তালিকাটি আগের দিনের মতোই থাকবে, আবার অন্য দিন তালিকাটি ভিন্ন হবে এবং তাতে সদস্যপদ পরিবর্তনের জন্য একটি অতিরিক্ত দিনের তথ্য অন্তর্ভুক্ত থাকবে।

দর্শক তালিকাগুলো সর্বশেষ সদস্যতা পরিবর্তনের আগের দিনের ইভেন্টের তথ্যের উপর ভিত্তি করে তৈরি করা হয়। আপনি যদি দৈনিক সদস্যতা আপডেট হওয়ার আগে একটি দর্শক তালিকা তৈরি করেন, তবে এটি আগের দুই দিনের তথ্য ব্যবহার করবে। আপনি যদি দৈনিক সদস্যতা আপডেট হওয়ার পরে একটি দর্শক তালিকা তৈরি করেন, তবে এটি গতকালের তথ্য ব্যবহার করবে।

পর্যায়ক্রমে একটি নিয়মিত দর্শক তালিকা থেকে মতামত জরিপ করুন।

Recurring Audience Lists only produce Audience Lists when an additional day's data is available. This removes the guesswork of deciding when to create new Audience Lists. Instead, you can cheaply poll the Recurring Audience List throughout the day to see if additional data is available.

একটি পুনরাবৃত্তিমূলক দর্শক তালিকা তৈরি করুন

একটি পুনরাবৃত্তিমূলক অডিয়েন্স তালিকা তৈরি করতে, একটি রিকোয়েস্টে RecurringAudienceList অবজেক্টটি ব্যবহার করে recurringAudienceLists.create মেথডটি কল করুন। নিম্নলিখিত প্যারামিটারগুলো আবশ্যক:

• audience ফিল্ডে একটি বৈধ অডিয়েন্সের নাম থাকতে হবে, properties/{propertyId}/audiences/{audienceId} ফরম্যাটে বিন্যস্ত থাকবে। এই মানটি পাওয়ার জন্য আপনি Google Analytics Admin API v1-এর audiences.list মেথডটি ব্যবহার করতে পারেন। audiences.list রেসপন্সের Audience.name ফিল্ডটিতে অডিয়েন্সের নামটি থাকে।
• dimensions ফিল্ডে ডাইমেনশনগুলির একটি বৈধ তালিকা থাকতে হবে। এই পদ্ধতি দ্বারা সমর্থিত ডাইমেনশনগুলির তালিকা 'Audience Export Schema' ডকুমেন্টেশনে পাওয়া যাবে। শুধুমাত্র এই ফিল্ডে উল্লিখিত ডাইমেনশনগুলির ডেটা একটি 'Audience List'-এ অন্তর্ভুক্ত করা হয়।

পুনরাবৃত্তিমূলক দর্শক তালিকা তৈরির অনুরোধের একটি নমুনা নিচে দেওয়া হলো:

HTTP অনুরোধ

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

recurringAudienceLists.create মেথডের রেসপন্সে name ফিল্ডে নামটি থাকে (যেমন properties/1234567/recurringAudienceLists/123 ), যা পরবর্তী কোয়েরিগুলোতে এই রিকারিং অডিয়েন্স লিস্টের কনফিগারেশন মেটাডেটা পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে। এছাড়াও, কনফিগারেশন মেটাডেটাতে এই রিকারিং অডিয়েন্স লিস্টের জন্য তৈরি করা অডিয়েন্স লিস্ট ইনস্ট্যান্সগুলোর রিসোর্স নেম থাকে।

HTTP প্রতিক্রিয়া

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

পোল কনফিগারেশন মেটাডেটা

একটি নির্দিষ্ট রিকারিং অডিয়েন্স লিস্টের কনফিগারেশন মেটাডেটা পুনরুদ্ধার করতে recurringAudienceLists.get মেথডটি ব্যবহার করুন। এই রিকারিং অডিয়েন্স লিস্টের জন্য তৈরি করা অডিয়েন্স লিস্ট ইনস্ট্যান্সগুলোর রিসোর্স নেম এই কনফিগারেশন মেটাডেটাতে থাকে।

এখানে একটি উদাহরণ দেওয়া হলো:

HTTP অনুরোধ

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

প্রতিক্রিয়ায় RecurringAudienceList এর একটি ইনস্ট্যান্স ফেরত দেওয়া হয়। এতে কনফিগারেশন মেটাডেটা থাকে, যার মধ্যে এই রিকারিং অডিয়েন্স লিস্টের জন্য তৈরি করা অডিয়েন্স লিস্ট ইনস্ট্যান্সগুলোর রিসোর্স নাম অন্তর্ভুক্ত থাকে।

HTTP প্রতিক্রিয়া

{
  "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 দ্বারা প্রদত্ত কনফিগারেশন মেটাডেটা থেকে প্রাপ্ত অডিয়েন্স এক্সপোর্টের নামটি উল্লেখ করুন।

HTTP অনুরোধ

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

অডিয়েন্স এক্সপোর্ট প্রস্তুত থাকলে, একটি অডিয়েন্সে থাকা ব্যবহারকারীদের তালিকা সম্বলিত একটি প্রতিক্রিয়া ফেরত দেওয়া হয়:

HTTP প্রতিক্রিয়া

{
  "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
}