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

এই ডকুমেন্টে রেকারিং অডিয়েন্স তালিকা সম্পর্কে বর্ণনা করা হয়েছে, যা Google Analytics Data API v1-এর একটি উন্নত ফিচার। অডিয়েন্স তালিকা এক্সপোর্ট করার ফিচার সম্পর্কে জানতে, অডিয়েন্স এক্সপোর্ট করার ফান্ডামেন্টাল গাইড দেখুন।

আপনি যাতে সবচেয়ে সাম্প্রতিক ডেটা নিয়ে কাজ করতে পারেন তা নিশ্চিত করতে, অডিয়েন্স মেম্বারশিপ পরিবর্তন হওয়ার সাথে সাথে রেকারিং অডিয়েন্স তালিকা প্রতিদিন অডিয়েন্স তালিকা তৈরি করে।

রেগুলার (নন-রেকারিং) অডিয়েন্স তালিকা হল তালিকা তৈরি করার সময় অডিয়েন্সে থাকা ব্যবহারকারীদের স্ট্যাটিক তালিকা।

প্রতিদিন নতুন অডিয়েন্স তালিকা তৈরি করুন

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

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

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

নির্দিষ্ট সময় অন্তর একটি রেকারিং অডিয়েন্স তালিকা পোল করুন

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

একটি রেকারিং অডিয়েন্স তালিকা তৈরি করুন

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

• 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 বিজ্ঞপ্তি পেতে পারেন।

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
}