এই নির্দেশিকাটি গুগল অ্যানালিটিক্স ডেটা এপিআই v1-এ কনভার্সন রিপোর্টিং কার্যকারিতা কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করে। এই বৈশিষ্ট্যটি আপনাকে বিভিন্ন অ্যাট্রিবিউশন মডেলের সমর্থন সহ কনভার্সন ইভেন্টের উপর কেন্দ্র করে রিপোর্ট তৈরি করতে দেয়। ডেটা এপিআই দিয়ে তৈরি কনভার্সন রিপোর্টগুলো গুগল অ্যানালিটিক্স UI- এর Advertising > Conversions বিভাগে পাওয়া অ্যাট্রিবিউশন রিপোর্টগুলোর মতোই। আরও তথ্যের জন্য, কনভার্সন পারফরম্যান্স রিপোর্ট হেল্প সেন্টার আর্টিকেলটি দেখুন।
রূপান্তর প্রতিবেদনের উদ্দেশ্য
কনভার্সন রিপোর্টিং নির্দিষ্ট ক্যাম্পেইন, উৎস এবং মাধ্যমের সাথে কনভার্সনগুলোকে সংযুক্ত করার মাধ্যমে আপনার মার্কেটিং প্রচেষ্টার কার্যকারিতা বিশ্লেষণ করার একটি উপায় প্রদান করে। সাধারণ ইভেন্ট-ভিত্তিক রিপোর্টগুলো শুধু ইভেন্ট গণনা করে, কিন্তু কনভার্সন রিপোর্টিং একটি অ্যাট্রিবিউশন মডেল প্রয়োগ করে সেইসব টাচপয়েন্টের মধ্যে কৃতিত্ব বণ্টন করে, যেগুলো একটি কনভার্সনের দিকে পরিচালিত করেছে।
রূপান্তর বনাম ঘটনা-ভিত্তিক প্রতিবেদন
- ইভেন্ট-ভিত্তিক রিপোর্ট : এগুলি ইভেন্টের প্রকৃত সংখ্যা (যেমন,
eventCount) প্রদান করে এবং আপনার প্রপার্টিতে সাধারণ কার্যকলাপ বোঝার জন্য উপযোগী। - রূপান্তর প্রতিবেদন : যে ইভেন্টগুলোকে রূপান্তর হিসেবে চিহ্নিত করা হয়েছে, সেগুলোর উপর আলোকপাত করে। এগুলো নির্দিষ্ট ডাইমেনশন ও মেট্রিক ব্যবহার করে ( রূপান্তর প্রতিবেদন স্কিমা দেখুন) এবং আপনাকে ডেটা-ড্রাইভেন বা লাস্ট ক্লিকের মতো মডেলের উপর ভিত্তি করে অ্যাট্রিবিউটেড ডেটা দেখার সুযোগ দেয়।
রূপান্তর প্রতিবেদন সক্রিয় করুন
একটি কনভার্সন রিপোর্ট চালানোর জন্য, ` runReport মেথডটি ব্যবহার করুন। একটি রিকোয়েস্টকে কনভার্সন রিপোর্ট হিসেবে গণ্য করা হয় যদি এটি এক বা একাধিক কনভার্সন মেট্রিক্স (যেমন, allConversionsByInteractionDate ) কোয়েরি করে, অথবা যদি রিকোয়েস্ট বডিতে conversionSpec ফিল্ডটি পূরণ করা থাকে।
conversionSpec অবজেক্টটিতে নিম্নলিখিত ফিল্ডগুলি রয়েছে:
-
conversionActions: রিপোর্টে অন্তর্ভুক্ত করার জন্য কনভার্সন অ্যাকশন রিসোর্স নামগুলির একটি তালিকা (যেমন,["conversionActions/12345"])। যদি খালি থাকে, তাহলে সমস্ত কনভার্সন অন্তর্ভুক্ত করা হবে।GetMetadataমেথডের রেসপন্সের মধ্যে থাকাconversionsতালিকারconversion_actionফিল্ড থেকে বৈধ কনভার্সন অ্যাকশন আইডিগুলি পাওয়া যাবে। -
attributionModel: যে অ্যাট্রিবিউশন মডেলটি ব্যবহার করতে হবে। সমর্থিত মানগুলো হলোDATA_DRIVEN(ডিফল্ট) এবংLAST_CLICK।
একটি রূপান্তর প্রতিবেদন তৈরি করুন
ডেটা-ড্রাইভেন অ্যাট্রিবিউশন মডেল ব্যবহার করে ক্যাম্পেইনের নাম অনুসারে কনভার্সন দেখানোর জন্য একটি কনভার্সন রিপোর্ট তৈরি করতে runReport মেথড ব্যবহার করে করা একটি নমুনা অনুরোধ এখানে দেওয়া হলো।
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "campaignName" } ], "metrics": [ { "name": "allConversionsByConversionDate" } ], "conversionSpec": { "conversionActions": [], "attributionModel": "DATA_DRIVEN" } }
উদাহরণ: একটি রূপান্তর কর্মক্ষমতা প্রতিবেদন পুনরায় তৈরি করুন
এই উদাহরণটি দেখায় যে কীভাবে প্রথমে একটি প্রপার্টির জন্য উপলব্ধ কনভার্সন অ্যাকশনগুলি পুনরুদ্ধার করতে হয় এবং তারপরে সেগুলি ব্যবহার করে Google Analytics UI- তে Advertising > Conversions > Conversion performance-এর অধীনে প্রদর্শিত কনভার্সন পারফরম্যান্স রিপোর্টের মতো একটি রিপোর্ট তৈরি করতে হয়।
ধাপ ১: রূপান্তর ক্রিয়াগুলি পুনরুদ্ধার করুন
আপনার প্রপার্টির জন্য বৈধ কনভার্সন অ্যাকশন আইডিগুলো খুঁজে পেতে getMetadata মেথডটি কল করুন। আপনার প্রপার্টির জন্য তৈরি হওয়া কনভার্সন অ্যাকশনগুলো দেখতে, GA প্রপার্টি আইডি উল্লেখ করতে ভুলবেন না (সব প্রপার্টির জন্য সাধারণ ফিল্ডগুলো পেতে 0 ব্যবহার করার পরিবর্তে)।
প্রতিক্রিয়াটিতে উপলব্ধ রূপান্তর ক্রিয়াকলাপগুলি সহ একটি conversions তালিকা রয়েছে:
{
...
"conversions": [
{
"conversionAction": "conversionActions/12345",
"displayName": "purchase"
},
{
"conversionAction": "conversionActions/67890",
"displayName": "sign_up"
}
]
}
ধাপ ২: রিপোর্টটি চালান।
` runReport মেথডটি কল করুন। আপনার রিপোর্ট ফিল্টার করতে ধাপ ১-এ পাওয়া কনভার্সন অ্যাকশন আইডিগুলো ব্যবহার করুন, অথবা সমস্ত কনভার্সনের উপর রিপোর্ট করার জন্য conversionActions খালি রাখুন। এই অনুরোধটি একটি কনভার্সন পারফরম্যান্স UI রিপোর্ট পুনরায় তৈরি করে, যেখানে বিজ্ঞাপনের ক্লিক, বিজ্ঞাপনের খরচ, প্রতি ক্লিকে বিজ্ঞাপনের খরচ, সমস্ত কনভার্সনের জন্য বিজ্ঞাপনের খরচ, বিজ্ঞাপনের ইম্প্রেশন, বিজ্ঞাপনের খরচের উপর রিটার্ন, মোট আয় এবং ডিফল্ট চ্যানেল গ্রুপ অনুযায়ী সমস্ত কনভার্সন দেখানো হয়।
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "allConversionsByInteractionDate" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerAllConversionsByInteractionDate" }, { "name": "advertiserAdImpressions" }, { "name": "advertiserAdClicks" }, { "name": "advertiserAdCostPerClick" }, { "name": "totalRevenueByInteractionDate" }, { "name": "returnOnAdSpendByInteractionDate" } ], "conversionSpec": { "conversionActions": [ "conversionActions/12345" ], "attributionModel": "DATA_DRIVEN" } }
এই অনুরোধের জন্য একটি নমুনা প্রতিক্রিয়া নিচে দেওয়া হলো:
{
"dimensionHeaders": [
{
"name": "defaultChannelGroup"
}
],
"metricHeaders": [
{
"name": "allConversionsByInteractionDate",
"type": "TYPE_FLOAT"
},
{
"name": "advertiserAdCost",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdCostPerAllConversionsByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdImpressions",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdClicks",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdCostPerClick",
"type": "TYPE_CURRENCY"
},
{
"name": "totalRevenueByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "returnOnAdSpendByInteractionDate",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Paid Search"
}
],
"metricValues": [
{
"value": "75.2"
},
{
"value": "500"
},
{
"value": "6.65"
},
{
"value": "10000"
},
{
"value": "500"
},
{
"value": "1"
},
{
"value": "1500"
},
{
"value": "3"
}
]
}
],
"rowCount": 1,
"metadata": {
"schemaRestrictionResponse": {},
"currencyCode": "USD",
"timeZone": "America/Los_Angeles",
"section": "SECTION_ADVERTISING"
},
"kind": "analyticsData#runReport"
}
রেসপন্সটি একটি কনভার্সন রিপোর্ট হিসেবে বিবেচিত হয়েছে কিনা, তা আপনি রেসপন্সের metadata.section ফিল্ডটি SECTION_ADVERTISING এ সেট করা আছে কিনা তা পরীক্ষা করে যাচাই করতে পারেন।
কনভার্সন রিপোর্টের জন্য উপলব্ধ ডাইমেনশন ও মেট্রিক্সের সম্পূর্ণ তালিকার জন্য, কনভার্সন রিপোর্ট স্কিমা দেখুন।