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

এই ডকুমেন্টটি পুনরাবৃত্ত দর্শক তালিকা বর্ণনা করে, যা Google Analytics Data API v1 এর একটি উন্নত বৈশিষ্ট্য। দর্শক তালিকা রপ্তানি বৈশিষ্ট্যের ভূমিকার জন্য, দর্শক রপ্তানি মৌলিক নির্দেশিকা দেখুন।

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

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

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

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

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

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

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

পুনরাবৃত্ত দর্শক তালিকা শুধুমাত্র তখনই দর্শক তালিকা তৈরি করে যখন অতিরিক্ত দিনের ডেটা উপলব্ধ থাকে। এটি নতুন দর্শক তালিকা কখন তৈরি করবেন তা সিদ্ধান্ত নেওয়ার অনুমানকে সরিয়ে দেয়। পরিবর্তে, আপনি অতিরিক্ত ডেটা উপলব্ধ কিনা তা দেখার জন্য সারা দিন পুনরাবৃত্ত দর্শক তালিকার উপর সস্তায় ভোট দিতে পারেন।

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

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

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

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

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-এ Webhooks ব্যবহার সম্পর্কে আরও তথ্যের জন্য Async audience lists with webhooks গাইড অনুসরণ করুন।

একটি অডিয়েন্স এক্সপোর্টে ব্যবহারকারীদের পুনরুদ্ধার করুন

Audience Export-এ ব্যবহারকারীদের পুনরুদ্ধার করতে, audienceExports.query পদ্ধতিতে কল করুন এবং recurringAudienceLists.get অথবা recurringAudienceLists.list দ্বারা প্রদত্ত কনফিগারেশন মেটাডেটা থেকে প্রাপ্ত Audience Export নামটি নির্দিষ্ট করুন।

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
}