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

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

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

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

এক নজরে

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

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

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

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

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

  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
}