অডিয়েন্স এক্সপোর্ট তৈরি করা

Google Analytics-এ অডিয়েন্স আপনার ব্যবসার জন্য গুরুত্বপূর্ণ উপায়ে ব্যবহারকারীদের ভাগ করতে দেয়। অডিয়েন্সের মাধ্যমে, আপনি শেয়ার করা অ্যাট্রিবিউটের ভিত্তিতে আপনার সাইট বা অ্যাপ্লিকেশনের ব্যবহারকারীদের গ্রুপ করতে পারবেন।

Data API ব্যবহার করে আপনি অডিয়েন্স এক্সপোর্ট করতে পারবেন, যার মধ্যে তাদের ব্যবহারকারীদের স্ন্যাপশটও অন্তর্ভুক্ত।

অডিয়েন্স এক্সপোর্টে আপনি যে ডেটা দেখতে পান সেই সম্পর্কে গুরুত্বপূর্ণ তথ্যের জন্য অডিয়েন্স এক্সপোর্ট ডেটা প্রত্যাশা গাইড দেখুন।

এক নজরে

অডিয়েন্স এক্সপোর্ট তৈরি ও কোয়েরি করতে নিম্নলিখিত ডেটা API অনুরোধ করুন:

  1. অডিয়েন্স এক্সপোর্ট তৈরি করতে audienceExports.create মেথড কল করুন।
  2. audienceExports.query মেথড কল করুন, এটি অডিয়েন্সে ব্যবহারকারীদের ফিরিয়ে আনতে ব্যবহার করা হয়।

আরও তথ্যের জন্য, আপনি audienceExports.get-এ কল করে নির্দিষ্ট দর্শক এক্সপোর্ট সম্পর্কে কনফিগারেশন মেটাডেটা ফিরিয়ে আনতে পারেন এবং audienceExports.list-এ কল করে নির্দিষ্ট প্রপার্টির জন্য আপনার সব দর্শক এক্সপোর্ট তালিকাভুক্ত করতে পারেন।

অভিযোগকারী এন্টিটি বেছে নিন

সব Data API পদ্ধতির জন্য URL অনুরোধ পাথের মধ্যে properties/GA_PROPERTY_ID ফর্ম্যাটে Google Analytics প্রপার্টি আইডেন্টিফায়ার উল্লেখ করতে হয়। একটা উদাহরণ দেওয়া হল:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

নির্দিষ্ট Google Analytics প্রপার্টিতে সংগ্রহ করা Google Analytics ইভেন্ট ডেটার উপর ভিত্তি করে রিপোর্ট তৈরি করা হয়।

আপনি Data API ক্লায়েন্ট লাইব্রেরি-এর মধ্যে কোনও একটি ব্যবহার করলে, আপনাকে অনুরোধের URL পাথ পরিবর্তন করতে হবে না। বেশিরভাগ API ক্লায়েন্ট property প্যারামিটার প্রদান করে যা properties/GA_PROPERTY_ID-এর ফর্ম্যাটে স্ট্রিং আশা করে। ক্লায়েন্ট লাইব্রেরি ব্যবহারের উদাহরণ দেখতে দ্রুত শুরুর নির্দেশিকা দেখুন।

অডিয়েন্স এক্সপোর্ট তৈরি করুন

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

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

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

HTTP অনুরোধ

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

audienceExports.create পদ্ধতির উত্তরে name ফিল্ডে অডিয়েন্স এক্সপোর্টের নাম থাকে, যেমন properties/1234567/audienceExports/123। এখানে একটি নমুনা উত্তর দেওয়া হল:

HTTP রেসপন্স

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

আপনি name ব্যবহার করে অডিয়েন্স এক্সপোর্ট থেকে ব্যবহারকারীদের কোয়েরি করতে পারবেন।

অডিয়েন্স এক্সপোর্ট করার জন্য প্রস্তুত কিনা তা কোয়েরি করুন

audienceExports.create কলের পরে অডিয়েন্স এক্সপোর্ট জেনারেট করতে কয়েক মিনিট সময় লাগতে পারে।

আপনি audienceExports.get পদ্ধতি কল করে অডিয়েন্স এক্সপোর্ট করার জন্য প্রস্তুত কিনা তা চেক করতে পারবেন।

আপনার অনুরোধে অডিয়েন্স এক্সপোর্ট নির্দিষ্ট করতে audienceExports.create রেসপন্স থেকে অডিয়েন্স এক্সপোর্টের নাম ব্যবহার করুন।

এখানে একটি নমুনা অনুরোধ দেওয়া হল:

HTTP অনুরোধ

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

অডিয়েন্স এক্সপোর্টের জন্য প্রস্তুতি স্ট্যাটাস উত্তরের state ফিল্ডে ফেরত পাঠানো হয়। অডিয়েন্স এক্সপোর্ট জেনারেশন সম্পূর্ণ হয়ে গেলে, এর স্ট্যাটাস CREATING থেকে ACTIVE-এ পরিবর্তিত হয়।

এখানে একটি নমুনা উত্তর দেওয়া হল:

HTTP রেসপন্স

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

আপনি audienceExports.list মেথড কল করে সব অডিয়েন্স এক্সপোর্টের স্ট্যাটাস পেতে পারেন।

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

অডিয়েন্স এক্সপোর্ট তৈরি হয়ে গেলে, audienceExports.query মেথড কল করুন এবং অনুরোধে অডিয়েন্স এক্সপোর্টের name উল্লেখ করুন।

এখানে একটি নমুনা অনুরোধ দেওয়া হল:

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
}