শ্রোতা রপ্তানি মৌলিক, শ্রোতা রপ্তানি মৌলিক

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

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

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

Google Analytics ডেটা API v1 অডিয়েন্স এক্সপোর্ট তৈরি করতে একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। প্রথমত, ব্যবহারকারীদের একটি শ্রোতা রপ্তানি তৈরি করতে audienceExports.create এক্সপোর্টস.ক্রিয়েট পদ্ধতির কাছে একটি অনুরোধ প্রয়োজন৷ তারপর, দর্শকদের মধ্যে ব্যবহারকারীদের পুনরুদ্ধার করতে audienceExports.query পদ্ধতি ব্যবহার করা হয়।

উপরন্তু, আপনি একটি নির্দিষ্ট শ্রোতা রপ্তানি সম্পর্কে কনফিগারেশন মেটাডেটা পুনরুদ্ধার করতে audienceExports.get audienceExports.list করতে পারেন।

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

ডেটা API v1-এর সমস্ত পদ্ধতির জন্য Google Analytics 4 প্রপার্টি আইডেন্টিফায়ারকে properties/GA4_PROPERTY_ID আকারে URL অনুরোধের পাথের মধ্যে নির্দিষ্ট করতে হবে, যেমন:

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

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

আপনি যদি ডেটা API ক্লায়েন্ট লাইব্রেরিগুলির মধ্যে একটি ব্যবহার করেন তবে অনুরোধ URL পাথটি ম্যানুয়ালি ম্যানিপুলেট করার দরকার নেই৷ বেশিরভাগ API ক্লায়েন্ট একটি property প্যারামিটার প্রদান করে যা properties/GA4_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"
  }
}

শ্রোতা রপ্তানি প্রস্তুতির অবস্থা জিজ্ঞাসা করুন

audienceExports.create কলের পর দর্শক রপ্তানি তৈরি করতে কয়েক মিনিট সময় লাগতে পারে। আপনি audienceExports.get পদ্ধতিতে কল করে শ্রোতা রপ্তানির জন্য প্রস্তুতির অবস্থা পেতে পারেন।

শ্রোতা রপ্তানির নাম ব্যবহার করুন (যেমন properties/1234567/audienceExports/123 ) আপনি শ্রোতা রপ্তানি নির্দিষ্ট করতে একটি শ্রোতা 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.create এক্সপোর্ট তৈরি করা হয়ে গেলে, audienceExports.query পদ্ধতিতে কল করুন এবং অডিয়েন্স এক্সপোর্টের নাম উল্লেখ করুন (যেমন properties/1234567/audienceExports/123 )।

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
}

দর্শক রপ্তানি তথ্য প্রত্যাশা

নিম্নলিখিত বিভাগটি দর্শক রপ্তানিতে ব্যবহারকারী সদস্যতার জন্য ডেটা প্রত্যাশা সেট করে।

ডেটা সতেজতা

শ্রোতা রপ্তানি ডেটা সতেজতা হল ইভেন্ট সংগ্রহ করতে, ইভেন্টগুলি প্রক্রিয়া করতে এবং তারপর দর্শকদের মধ্যে ব্যবহারকারীর সদস্যতা আপডেট করতে Google Analytics কত সময় নেয়। যদি সেই পুরো প্রক্রিয়াটি 24 ঘন্টা সময় নেয়, তাহলে দর্শক রপ্তানি ডেটা তাজাতা 24 ঘন্টা। আরও জানতে ডেটা ফ্রেশনেস দেখুন।

দ্রষ্টব্য: দর্শক রপ্তানি ডেটা সতেজতা সাধারণত গড়ে 24 ঘন্টা হবে।

উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী তাদের প্রথম কেনাকাটা সম্পূর্ণ করে, এবং তারপরে 7 ঘন্টা পরে, আপনি "ক্রেতাদের" দর্শকদের জন্য একটি দর্শক রপ্তানি তৈরি করেন, ব্যবহারকারী প্রায় নিশ্চিতভাবে এখনও "ক্রেতাদের" দর্শক রপ্তানিতে থাকবেন না৷ প্রথম কেনাকাটার 14 থেকে 38 ঘন্টার মধ্যে, সেই ব্যবহারকারী সম্ভবত নতুন দর্শক রপ্তানিতে থাকবে৷

দর্শক রপ্তানি স্ন্যাপশট হয়

দর্শক রপ্তানি হল সময়ের স্ন্যাপশটে দর্শকদের মধ্যে থাকা ব্যবহারকারীদের তালিকা। Google Ads পুনঃবিপণনের জন্য , Google Analytics স্বয়ংক্রিয়ভাবে এবং ক্রমাগত ব্যবহারকারীদের দর্শকদের Google বিজ্ঞাপনে রপ্তানি করে। বিপরীতে, ডেটা API v1 ব্যবহার করে তৈরি করা দর্শক রপ্তানির সাথে, সেই দর্শকদের মধ্যে সর্বশেষ ব্যবহারকারীদের দেখতে আপনাকে একটি নতুন অডিয়েন্স এক্সপোর্ট তৈরি করতে হবে।

শ্রোতা রপ্তানি উপলব্ধ সর্বশেষ ব্যবহারকারী সদস্যতা উপর ভিত্তি করে তৈরি করা হয়. যাইহোক, শ্রোতা রপ্তানিতে 20 ঘন্টার ডেটা সতেজতা থাকতে পারে এবং এর মানে হল যে দর্শক রপ্তানি বর্তমান মুহুর্তের 20 ঘন্টা আগের সমস্ত ইভেন্টের উপর ভিত্তি করে হবে৷

সাম্প্রতিক সদস্যপদ ডেটা প্রতিদিন একবার আপডেট করা হয়, সাধারণত প্রপার্টির টাইমজোনে দিনের আলোর সময়। এর মানে হল যে সকাল 9 AM এবং 11 AM তে একই দর্শকদের জন্য একটি দর্শক রপ্তানি সম্ভবত একই ডেটা ফেরত দেবে, কিন্তু 3 PM-এ একটি দর্শক রপ্তানি একটি অতিরিক্ত দিনের ডেটা অন্তর্ভুক্ত করার উপর ভিত্তি করে আলাদা হতে পারে।

দ্রষ্টব্য: আমরা প্রতি শ্রোতা প্রতি দিনে একবার শ্রোতা রপ্তানির অনুরোধ করার পরামর্শ দিই।

অডিয়েন্স এক্সপোর্টের মেয়াদ শেষ

শ্রোতা রপ্তানি 72 ঘন্টা পরে মেয়াদ শেষ হয়. নতুন ব্যবহারকারীরা প্রতিদিন একটি শ্রোতা প্রবেশ এবং প্রস্থান করতে পারে. সর্বশেষ ব্যবহারকারীদের স্ন্যাপশট পেতে, আপনাকে প্রতিটি দিনের জন্য নতুন দর্শক রপ্তানি তৈরি করতে হবে।

দর্শক রপ্তানি ব্যবহারকারী সীমা

যখন একটি শ্রোতা বা সম্পত্তির আকার ব্যবহারকারীর সীমা অতিক্রম করে, তখন দর্শক রপ্তানি দর্শকদের প্রতিনিধি নমুনা ফেরত দেয়। এই সীমাগুলি আপনার সম্পত্তির প্রকারের উপর নির্ভর করে (যেমন, একটি স্ট্যান্ডার্ড বা 360 সম্পত্তি) এবং প্রতিটি দর্শক রপ্তানিতে পৃথকভাবে প্রয়োগ করা হয়। প্রত্যাবর্তিত ব্যবহারকারীরা অনুরোধ করা শ্রোতাদের মধ্যে ব্যবহারকারী, এবং বিবেচিত ব্যবহারকারীরা এমন ব্যবহারকারী যারা দর্শকদের সদস্য হতে পারে বা নাও হতে পারে।

লিমিট টাইপ	স্ট্যান্ডার্ড সম্পত্তি সীমা	Analytics 360 সম্পত্তির সীমা
সর্বোচ্চ ব্যবহারকারীদের ফিরে	2 মিলিয়ন	200 মিলিয়ন
সর্বোচ্চ বিবেচিত ব্যবহারকারী	10 মিলিয়ন	1 বিলিয়ন

পরিচয়ের ধারাবাহিকতা রিপোর্ট করা

রিপোর্টিং আইডেন্টিটি সিদ্ধান্ত নেয় কিভাবে ব্যবহারকারীদের রিপোর্টে ডিডুপ্লিকেট করা হয়। শ্রোতা রপ্তানি রিপোর্টিং পরিচয় সেটিং উপর ভিত্তি করে পরিবর্তিত হয় না. দর্শক রপ্তানি সর্বদা ব্যবহারকারী-আইডি তারপর ডিভাইস আইডি দ্বারা ব্যবহারকারীদের সনাক্ত করে।

এর মানে হল যে শ্রোতাদের প্রতিবেদনগুলি দর্শক রপ্তানি আয়ের চেয়ে বেশি ব্যবহারকারীকে দেখাতে পারে৷ উদাহরণ স্বরূপ যদি রিপোর্টিং আইডেন্টিটি "ডিভাইস ভিত্তিক" হয় এবং ইউজার আইডি সংগ্রহ করা হয়, তাহলে রিপোর্ট ইউজার আইডির উপর ভিত্তি করে ইউজারদের ডিডপ্লিকেট করবে না কিন্তু অডিয়েন্স এক্সপোর্ট ইউজার আইডির উপর ভিত্তি করে ডুপ্লিকেট করবে।

ব্যাকফিল ধারাবাহিকতা

আপনি যখন Google Analytics-এ একটি দর্শক তৈরি করেন এবং Google Ads রিমার্কেটিং সক্ষম করেন, তখন Google Analytics সম্প্রতি যোগ করা সদস্যদের সাথে Google Ads-এ সেই দর্শকদের ব্যাকফিল করে । যাইহোক, Google Analytics রিপোর্ট এবং অডিয়েন্স এক্সপোর্টে ব্যাকফিলড শ্রোতা সদস্যতা থাকে না। সেই দর্শকদের মধ্যে ব্যবহারকারীকে দেখানোর জন্য প্রতিবেদন এবং শ্রোতা রপ্তানির জন্য দর্শক তৈরি হওয়ার পরে একজন ব্যবহারকারীকে একটি ইভেন্ট লগ করতে হবে।

উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী 20শে জুন একটি ক্রয় ইভেন্ট লগ করেন এবং আপনি 21শে জুন একটি "ক্রয়কারী" দর্শক তৈরি করেন, তাহলে সেই ব্যবহারকারীকে নতুন অডিয়েন্স এক্সপোর্টে সম্ভাব্যভাবে দেখতে আপনাকে সম্ভবত 22শে জুন পর্যন্ত অপেক্ষা করতে হবে৷ যাইহোক, সেই ব্যবহারকারী শুধুমাত্র দর্শক রপ্তানিতে থাকবে যদি ব্যবহারকারী 21শে জুন কোনো ইভেন্ট লগ ইন করে থাকে।