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

এই ডকুমেন্টে, 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 পদ্ধতি ব্যবহার করে পর্যায়ক্রমে কনফিগারেশন মেটাডেটা পোল করার পরিবর্তে, কোনও অডিয়েন্স তালিকা উপলভ্য হলে আপনি অ্যাসিঙ্ক্রোনাসভাবে ওয়েবহুক বিজ্ঞপ্তি পেতে পারেন।

Webhook বিজ্ঞপ্তি কনফিগার করতে, নতুন রেকারিং অডিয়েন্স তালিকা তৈরি করার সময় webhookNotification ফিল্ড নির্দিষ্ট করুন।

Google Analytics Data API v1-এ Webhooks ব্যবহার করা সম্পর্কে আরও তথ্য পেতে, 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
}