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

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

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

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

ওভারভিউ

একটি শ্রোতা রপ্তানি তৈরি এবং অনুসন্ধান করতে নিম্নলিখিত ডেটা API অনুরোধগুলি করুন:

  1. শ্রোতা রপ্তানি তৈরি করতে audienceExports.create পদ্ধতিতে কল করুন।
  2. শ্রোতাদের মধ্যে ব্যবহারকারীদের পুনরুদ্ধার করতে 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 ইভেন্ট ডেটার উপর ভিত্তি করে তৈরি করা হয়।

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

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

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

  • audience ফিল্ডে একটি বৈধ দর্শকের নাম, properties/{propertyId}/audiences/{audienceId} হিসাবে ফর্ম্যাট করা হয়েছে। আপনি এই মান পেতে Google Analytics অ্যাডমিন 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
}