রূপান্তর ট্র্যাকিং

বাস্তবায়ন

সারসংক্ষেপ

একটি রূপান্তর ট্র্যাকিং বাস্তবায়নে তিনটি অংশ রয়েছে:

• ল্যান্ডিং পৃষ্ঠা/অ্যাপ এন্ট্রি পয়েন্ট থেকে rwg_token এবং merchant_id সংগ্রহ করা।
• উপযুক্ত অ্যাট্রিবিউশন উইন্ডোর জন্য rwg_token এবং merchant_id বজায় রাখা।
• রূপান্তরের সময় স্থায়ী merchant_id এবং merchant_id তুলনা করুন (বুকিং সম্পন্ন হয়েছে)।
• রূপান্তর সময়ে একটি রূপান্তর ইভেন্ট পাঠানো (বুকিং সম্পন্ন)।

এই রূপান্তর ট্র্যাকিং বাস্তবায়নের জন্য আপনাকে Google Analytics বা অন্য কোনো তৃতীয় পক্ষের জাভাস্ক্রিপ্ট ব্যবহার করতে হবে না।

আপনার রূপান্তর ট্র্যাকিং বাস্তবায়নে কাজ শুরু করার আগে, আপনি ডিভাইস স্তরে বা ব্যবহারকারীর স্তরে রূপান্তরগুলি ট্র্যাক করতে যাচ্ছেন কিনা তা নির্ধারণ করা উচিত:

• ডিভাইস স্তরে ব্রাউজার কুকিজ, স্থানীয় সঞ্চয়স্থান, অ্যাপ স্থানীয় স্টোরেজ, বা 30 দিনের অ্যাট্রিবিউশন উইন্ডোর জন্য টোকেন বজায় রাখতে পারে এমন অন্য কোনও পদ্ধতি ব্যবহার করা অন্তর্ভুক্ত। কারণ টোকেনটি ব্যবহারকারীর ডিভাইসে স্থানীয়ভাবে সংরক্ষণ করা হবে, ব্যবহারকারী যদি তাদের ব্যবহার করা ডিভাইসটি পরিবর্তন করে, তাদের স্থানীয় স্টোরেজ বা কুকিজ সাফ করে, অথবা একটি ব্যক্তিগত ব্রাউজিং বা ছদ্মবেশী মোড ব্যবহার করে তাহলে রূপান্তর ইভেন্টটি সঠিকভাবে দায়ী নাও হতে পারে। ডিভাইস স্তরের রূপান্তর ট্র্যাকিং ব্যবহার করার সময়, আপনাকে অবশ্যই প্রতিটি সমর্থিত পৃষ্ঠে (মোবাইল সহ) এটি পুনরায় প্রয়োগ করতে হবে।
• ব্যবহারকারীর স্তরে এটিকে সার্ভার-সাইড অ্যানালিটিক্স সিস্টেম বা অন্যান্য সার্ভার-সাইড সিস্টেমের মাধ্যমে আপনার অ্যাপ্লিকেশন ডাটাবেসে বজায় রাখা অন্তর্ভুক্ত। কারণ টোকেনটি সার্ভারের পাশে সংরক্ষণ করা হবে, ব্যবহারকারী যদি তাদের ব্যবহার করা ডিভাইসটি পরিবর্তন করে, তাদের স্থানীয় স্টোরেজ বা কুকিজ সাফ করে, অথবা একটি ব্যক্তিগত ব্রাউজিং বা ছদ্মবেশী মোড ব্যবহার করে তবে ব্যবহারকারীর লগ ইন করার পরেও রূপান্তর ইভেন্টটিকে দায়ী করা হবে। ইউজার লেভেল কনভার্সন ট্র্যাকিং ব্যবহার করার সময়, আপনার সিস্টেমের আর্কিটেকচারের উপর নির্ভর করে আপনি এটিকে আপনার সার্ভার সাইডে একবার প্রয়োগ করতে এবং সমস্ত সমর্থিত সারফেস জুড়ে পুনরায় ব্যবহার করতে পারবেন।

rwg_token সংগ্রহ করা হচ্ছে

প্রতিবার Google ফিডের মাধ্যমে আপনার দেওয়া একটি action_link প্রকাশ করে, সেই URLটিকে একটি অনন্য ক্যোয়ারী প্যারামিটার অন্তর্ভুক্ত করার জন্য সংশোধন করা হয়: rwg_token । rwg_token মান হল একটি এনকোড করা স্ট্রিং যাতে ব্যবহারকারীর ক্লিক করা লিঙ্ক সম্পর্কে কিছু মেটাডেটা থাকে কিন্তু ব্যবহারকারীর ডেটা নেই । আপনার এই টোকেনটি সংরক্ষণ করা উচিত এবং রূপান্তর ইভেন্টের অংশ হিসাবে এটিকে ফেরত দেওয়া উচিত।

প্রতিটি ল্যান্ডিং পৃষ্ঠা/অ্যাপ এন্ট্রি পয়েন্টে আপনাকে অবশ্যই rwg_token ক্যোয়ারী প্যারামিটারের জন্য সেট করা মান পার্স করতে হবে এবং সংরক্ষণ করতে হবে। এই পরামিতি সংরক্ষণের জন্য প্রয়োজনীয়তা ধাপে বর্ণনা করা হয়েছে, rwg_token ধরে রাখা।

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

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

merchant_id সংগ্রহ করা হচ্ছে

আপনি যদি ল্যান্ডিং পৃষ্ঠায় ফ্রন্টএন্ডে রূপান্তর ট্র্যাকিং যুক্তি প্রয়োগ করেন, তাহলে আপনাকে অবশ্যই একটি কাস্টম স্ক্রিপ্ট প্রয়োগ করতে হবে যা merchant_id খুঁজে পাবে এবং ক্যাপচার করবে। সাধারণত, merchant_id ইতিমধ্যেই ল্যান্ডিং পৃষ্ঠায় বা URL-এ উপস্থিত থাকতে পারে যাতে আপনি সেখান থেকে এটি ক্যাপচার করতে পারেন। যদি তা না হয় তবে আপনাকে অবশ্যই এটিকে কোথাও প্রকাশ করার একটি উপায় খুঁজে বের করতে হবে যাতে এটি ক্যাপচারযোগ্য যা সম্ভবত ব্যাকএন্ড পরিবর্তনগুলিকে বোঝায়।

আপনি যদি ব্যাকএন্ডে রূপান্তর ট্র্যাকিং যুক্তি প্রয়োগ করেন, তাহলে আপনি সেই ডেটার পাশাপাশি merchant_id খুঁজে পেতে পারেন যা ফ্রন্টএন্ড পৃষ্ঠা তৈরি করতে আপনার অভ্যন্তরীণ সিস্টেমকে জিজ্ঞাসা করে।

এই merchant_id অবশ্যই আপনার ফিডে Google এর সাথে শেয়ার করা একটির মতই হতে হবে৷

rwg_token এবং merchant_id বজায় রাখা

আপনাকে rwg_token URL প্যারামিটারটি বজায় রাখতে হবে, যা আপনার দেওয়া সমস্ত অ্যাকশন লিঙ্কের সাথে যুক্ত করা হবে, মোট 30 দিনের জন্য। rwg_token এর মান সংরক্ষণ করা উচিত এবং কোনো সম্পাদনা ছাড়াই ফেরত দেওয়া উচিত।

rwg_token এর সাথে, আপনাকে অ্যাকশন লিঙ্কের সাথে সংশ্লিষ্ট merchant_id সংরক্ষণ করতে হবে।

পূর্ববর্তী ভিজিট থেকে যদি একটি বিদ্যমান টোকেন অব্যাহত থাকে, তাহলে আগের rwg_token এবং merchant_id প্রতিস্থাপন করা উচিত এবং স্টোরেজের জন্য 30 দিনের উইন্ডো রিসেট করা উচিত।

উপরের জোড়াটি বজায় রাখার সময়, আপনি ডিভাইস স্তরে বা ব্যবহারকারী স্তরে মানগুলি সংরক্ষণ করতে পারেন:

• ডিভাইস স্তরে ব্রাউজার কুকিজ, স্থানীয় সঞ্চয়স্থান, অ্যাপ স্থানীয় স্টোরেজ, বা 30 দিনের অ্যাট্রিবিউশন উইন্ডোর জন্য টোকেন বজায় রাখতে পারে এমন অন্য কোনও পদ্ধতি ব্যবহার করা অন্তর্ভুক্ত।
• ব্যবহারকারীর স্তরে এটিকে সার্ভার-সাইড অ্যানালিটিক্স সিস্টেম বা অন্যান্য সার্ভার-সাইড সিস্টেমের মাধ্যমে আপনার অ্যাপ্লিকেশন ডাটাবেসে বজায় রাখা অন্তর্ভুক্ত।

নীচে একটি প্রথম পক্ষের কুকি ব্যবহার করে একটি ওয়েব ব্রাউজারে এই মানগুলি সংরক্ষণ করে ডিভাইস স্তরের রূপান্তর ট্র্যাকিংয়ের একটি উদাহরণ দেওয়া হল৷ এই উদাহরণটি অনুমান করে যে আপনি উপরের উদাহরণের মতো টোকেন মানটিকে একটি ভেরিয়েবলে পার্স করেছেন। এই উদাহরণটি ব্যবহার করার জন্য, আপনাকে আপনার ডোমেনে rootdomain.com আপডেট করতে হবে।

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

ব্যবহারকারী স্তরের রূপান্তর ট্র্যাকিং ব্যবহার করার সময় rwg_token + merchant_id সার্ভারে সংরক্ষণ করা উচিত এবং ব্যবহারকারীর সাথে যুক্ত করা উচিত।

রূপান্তর ডেটা পাঠানো হচ্ছে

যখন একজন ব্যবহারকারী একটি লেনদেন সম্পন্ন করে যা একটি Google প্লেস অ্যাকশন লিঙ্কের জন্য দায়ী, আপনাকে অবশ্যই একটি HTTP POST অনুরোধ পাঠাতে হবে রূপান্তর এন্ডপয়েন্টে। দুটি শেষ পয়েন্ট রয়েছে, একটি উত্পাদন পরিবেশের জন্য এবং একটি স্যান্ডবক্স পরিবেশের জন্য।

• উৎপাদন: https://www.google.com/maps/conversion/collect
• স্যান্ডবক্স: https://www.google.com/maps/conversion/debug/collect

পোস্ট বডি ফরম্যাটে একটি JSON এনকোডেড অবজেক্ট হওয়া উচিত:

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>,
  "merchant_changed": 1|2
}

উদাহরণ ( অংশীদার 20123456 এর টেস্ট টোকেন সহ অপরিবর্তিত বণিক ):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

বণিক_পরিবর্তিত মানটি প্রাথমিক পুনঃনির্দেশিত বণিক থেকে বণিক পরিবর্তন করা হয়েছে কিনা তা নির্ধারণ করতে ব্যবহৃত হয়। দুটি মান আছে যা পাস করা যেতে পারে

বণিক পরিবর্তন মান	প্রয়োজনীয়তা
1	এই মানটি ব্যবহার করা উচিত যখন কোনও ব্যবহারকারী আসল বণিকের ওয়েবসাইট ছেড়ে চলে যান এবং অন্য কোনও বণিকের সাথে আপনার প্ল্যাটফর্মের মাধ্যমে একটি কেনাকাটা সম্পূর্ণ করেন
2	যখন গ্রাহক মূল সত্তা (বণিক) এর মাধ্যমে একটি লেনদেন সম্পন্ন করেন তখন এই মানটি ব্যবহার করা উচিত।

একটি রূপান্তর ইভেন্ট পাঠানোর সময় স্যান্ডবক্স এবং উত্পাদন পরিবেশ উভয় ক্ষেত্রেই আপনাকে একটি বৈধ rwg_token প্রদান করতে হবে। পরীক্ষার উদ্দেশ্যে, আপনি চালু না হওয়া পর্যন্ত উভয় পরিবেশে নিম্নলিখিত পরীক্ষার টোকেন ব্যবহার করুন:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

এই পোস্টের অনুরোধ কীভাবে করা যায় তার জাভাস্ক্রিপ্টে ডিভাইস স্তরের রূপান্তর ট্র্যাকিংয়ের (ব্যবহারকারীর ডিভাইসে একটি কুকি ব্যবহার করে) একটি সম্পূর্ণ উদাহরণ নীচে অন্তর্ভুক্ত করা হয়েছে:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

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

রূপান্তর অ্যাট্রিবিউশন প্রয়োজনীয়তা

রূপান্তর অ্যাট্রিবিউশনের জন্য Google-এর প্রয়োজনীয় মান হল একটি 30-দিনের অ্যাট্রিবিউশন উইন্ডো যে কোনও দোকানে কোনও স্থানের লিঙ্কের সাথে কোনও ইন্টারঅ্যাকশনের জন্য।

এই অ্যাট্রিবিউশন উইন্ডোর মানে হল যে Google নিম্নলিখিত পরিস্থিতিতে একটি রূপান্তর ইভেন্ট পাঠানোর আশা করবে:

• একজন ব্যবহারকারী একটি প্লেস অ্যাকশন লিঙ্ক অনুসরণ করে এবং একই সেশনে একই বণিকের জন্য একটি অর্ডার দেয়। (বণিক পরিবর্তন মান = 2)
• একজন ব্যবহারকারী একটি প্লেস অ্যাকশন লিঙ্ক অনুসরণ করে এবং তারপর একই বণিকের জন্য অর্ডার দেওয়ার জন্য 30 দিনের মধ্যে একটি ভিন্ন চ্যানেল থেকে ফিরে আসে। (বণিক পরিবর্তন মান = 2)
• একজন ব্যবহারকারী একটি প্লেস অ্যাকশন লিঙ্ক অনুসরণ করে এবং তারপর একই সেশনের মধ্যে বা 30 দিনের উইন্ডোর মধ্যে একটি ভিন্ন সেশনের মধ্যে একটি ভিন্ন দোকানে একটি অর্ডার দেয়। (বণিক পরিবর্তন মান = 1)

উপরন্তু, Google আশা করে যে রূপান্তর ইভেন্টগুলি সমস্ত পৃষ্ঠ থেকে পাঠানো হবে একজন ব্যবহারকারী একটি প্লেস অ্যাকশন লিঙ্ক থেকে ল্যান্ড করতে পারে। সহ:

• ডেস্কটপ বা মোবাইল ওয়েব অ্যাপ্লিকেশন
• মোবাইল অ্যাপ, হয় একটি অ্যাপ ডিপ লিঙ্কের মাধ্যমে অথবা আপনার ডোমেনের জন্য একটি নিবন্ধিত অ্যাপ-ইন্টেন্টের মাধ্যমে

যদি টোকেনটি ব্যবহারকারীর স্তরে সংরক্ষিত থাকে (টোকেনটি বজায় রাখা দেখুন), তাহলে আশা করা হচ্ছে আপনি ক্রস-ডিভাইস অ্যাট্রিবিউশন প্রদান করবেন। অর্থাৎ, যে ব্যবহারকারী ডেস্কটপ থেকে একটি অ্যাকশন লিঙ্ক অনুসরণ করেন এবং তারপরে মোবাইলে লেনদেন সম্পন্ন করেন (একই ব্যবহারকারীর অ্যাকাউন্ট ব্যবহার করে), তার একটি রূপান্তর ইভেন্ট ট্রিগার করা উচিত।

যদি টোকেনটি একচেটিয়াভাবে ডিভাইস স্তরে সংরক্ষণ করা হয়, যেমন ব্রাউজার কুকিতে, তাহলে এটি প্রত্যাশিত নয় যে আপনি ক্রস-ডিভাইস অ্যাট্রিবিউশন প্রদান করবেন। এই ক্ষেত্রে, প্রতিটি ডিভাইসে একটি পৃথক টোকেন থাকবে যদি ব্যবহারকারী সেই ডিভাইসে একটি অ্যাকশন লিঙ্ক অনুসরণ করে থাকে এবং প্রতিটি ডিভাইস আলাদাভাবে অ্যাট্রিবিউশন নিয়ম অনুসরণ করবে।