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

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

You can export your audiences, including a snapshot of their users, using the Data 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

নির্দিষ্ট গুগল অ্যানালিটিক্স প্রপার্টিতে সংগৃহীত গুগল অ্যানালিটিক্স ইভেন্ট ডেটার উপর ভিত্তি করে রিপোর্টটি তৈরি করা হয়।

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

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

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
}