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

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

আপনি ডেটা API ব্যবহার করে আপনার দর্শকদের, তাদের ব্যবহারকারীদের একটি স্ন্যাপশট সহ, রপ্তানি করতে পারেন।

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

সংক্ষিপ্ত বিবরণ

একটি অডিয়েন্স এক্সপোর্ট তৈরি এবং কোয়েরি করার জন্য নিম্নলিখিত ডেটা এপিআই অনুরোধগুলি করুন:

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

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

একটি রিপোর্টিং সত্তা নির্বাচন করুন

সকল ডেটা এপিআই পদ্ধতির জন্য 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 ক্ষেত্রে audience export এর নাম থাকে, উদাহরণস্বরূপ 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 কলের পরে audience export তৈরি করতে কয়েক মিনিট সময় লাগতে পারে।

আপনি audienceExports.get পদ্ধতিতে কল করে একটি audience export এর প্রস্তুতির অবস্থা পরীক্ষা করতে পারেন।

আপনার অনুরোধে অডিয়েন্স এক্সপোর্ট উল্লেখ করতে 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 পদ্ধতিতে কল করে আপনি সমস্ত audience exports এর অবস্থা জানতে পারবেন।

দর্শক রপ্তানি থেকে ব্যবহারকারীদের পুনরুদ্ধার করুন

একবার অডিয়েন্স এক্সপোর্ট তৈরি হয়ে গেলে, 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
}