অ্যাট্রিবিউশন রিপোর্টিং এপিআই ক্রস ওয়েব এবং অ্যাপ ইমপ্লিমেন্টেশন গাইড

অ্যাট্রিবিউশন রিপোর্টিং API একই ডিভাইসে ঘটতে থাকা উত্স এবং ট্রিগারগুলির জন্য ক্রস অ্যাপ এবং ওয়েব অ্যাট্রিবিউশন সক্ষম করে৷ ব্রাউজার, যেমন ক্রোম, ব্রাউজারে সেই নিবন্ধনগুলি পরিচালনা করার পরিবর্তে Android এর জন্য অ্যাট্রিবিউশন রিপোর্টিং API-এ উত্স এবং ট্রিগার নিবন্ধন উভয়ই অর্পণ করতে পারে৷ এটি অ্যান্ড্রয়েডকে সাইট এবং অ্যাপ উভয় জুড়ে উত্স এবং ট্রিগারগুলিকে মেলাতে অনুমতি দেয়৷

এই নির্দেশিকা আপনাকে শেখাবে কিভাবে ক্রস অ্যাপ এবং ওয়েব অ্যাট্রিবিউশন সেট আপ করতে হয়।

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

অ্যান্ড্রয়েড ওএসের সাথে উত্স এবং ট্রিগার নিবন্ধন করুন৷

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

ব্রাউজার বা ওএসের সাথে ওয়েব সোর্স বা ওয়েব ট্রিগার নিবন্ধন করতে হবে কিনা তা বিজ্ঞাপন প্রযুক্তিকে সিদ্ধান্ত নিতে হবে।

  • শুধুমাত্র ওয়েব প্রচারাভিযানের জন্য, বিজ্ঞাপন প্রযুক্তি এখনও Chrome এর অ্যাট্রিবিউশন রিপোর্টিং API এর সাথে উত্স এবং ট্রিগার উভয় নিবন্ধন করতে পারে বা OS-এ উভয়কেই অর্পণ করতে বেছে নিতে পারে৷ শুধুমাত্র ওয়েব প্রচারাভিযানের জন্য যেখানে উৎস বা ট্রিগার একটি WebView-এ ঘটতে পারে, বিজ্ঞাপন প্রযুক্তিকে অবশ্যই OS-এ উৎস এবং ট্রিগার নিবন্ধন উভয়ই অর্পণ করতে হবে। আরও তথ্যের জন্য WebViews-এ বিভাগটি দেখুন।
  • ডুপ্লিকেট অ্যাট্রিবিউশন রিপোর্ট তৈরি এড়াতে বিজ্ঞাপন প্রযুক্তিগুলিকে একই সাথে Chrome এবং Android APIs উভয়ের সাথে উত্স এবং ট্রিগার নিবন্ধন করা এড়াতে হবে৷

  • অ্যাট্রিবিউশন ব্রাউজার এবং ওএসের জন্য আলাদাভাবে ঘটে। যদি কোনো উৎস ব্রাউজারে নিবন্ধিত থাকে কিন্তু ট্রিগারটি OS-এর সাথে নিবন্ধিত থাকে, তাহলে ঐ দুটিকে মেলানো যাবে না এবং অন্যভাবে।

  • একটি অ্যাপ বা ওয়েব ট্রিগার হতে পারে এমন উত্সগুলির জন্য, বিজ্ঞাপন প্রযুক্তির জন্য ওয়েব উত্স অর্পণ করা এবং Android অ্যাট্রিবিউশন রিপোর্টিং API-এ নিবন্ধনগুলি ট্রিগার করার জন্য এটি অত্যন্ত সুপারিশ করা হয়৷

  • অ্যাপ ভিত্তিক উত্স দ্বারা চালিত হতে পারে এমন ট্রিগারগুলির জন্য, বিজ্ঞাপন প্রযুক্তি Android অ্যাট্রিবিউশন রিপোর্টিং API-এ ওয়েব ট্রিগার নিবন্ধন অর্পণ করতে বেছে নিতে পারে।

  • প্রচারাভিযানের জন্য যেখানে উত্স এবং ট্রিগার উভয়ই একটি অ্যাপে ঘটে, উভয়কেই OS অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে নিবন্ধিত হতে হবে৷

একটি অ্যাপ উত্স এবং ওয়েব ট্রিগার নিবন্ধন করুন৷

কিছু প্রচারাভিযানের জন্য, উত্সটি একটি অ্যাপে ঘটতে পারে যখন একই ডিভাইসে মোবাইল ব্রাউজারে একটি ওয়েবসাইটে ট্রিগার ঘটবে।

উদাহরণ

একজন ব্যবহারকারী তাদের প্রিয় সংবাদ অ্যাপে নিবন্ধ পড়ছেন। তারা প্যারিসের সস্তা ফ্লাইটের জন্য একটি বিজ্ঞাপন দেখে এবং বুক করার জন্য উত্তেজিতভাবে ক্লিক করে। সংবাদ অ্যাপে বিজ্ঞাপন পরিবেশনকারী বিজ্ঞাপন প্রযুক্তি অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে ক্লিকের উৎস নিবন্ধন করে। ব্যবহারকারীকে Chrome-এ বিজ্ঞাপনদাতার ওয়েব পৃষ্ঠায় নিয়ে যাওয়া হয় যেখানে তারা রূপান্তর করতে সক্ষম হয়। বিজ্ঞাপনদাতার সাইটের বিজ্ঞাপন প্রযুক্তি OS স্তরের API উপলব্ধ আছে কিনা তা পরীক্ষা করে এবং এটি আছে। বিজ্ঞাপন প্রযুক্তি ক্রোমকে সরাসরি Chrome-এর অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে নিবন্ধন না করে OS-এ নিবন্ধন অর্পণ করার নির্দেশ দিয়ে রূপান্তর ট্রিগার নিবন্ধন করে৷ OS-স্তরের অ্যাট্রিবিউশন রিপোর্টিং এপিআই তখন অ্যাপ সোর্স এবং ওয়েব ট্রিগারের সাথে মেলে এবং প্রাসঙ্গিক রিপোর্ট পাঠাতে সক্ষম হয়।

ওয়েব অ্যাট্রিবিউশন প্রবাহে অ্যাপ
ওয়েব অ্যাট্রিবিউশন প্রবাহে অ্যাপ

অ্যাপ উত্স নিবন্ধন:

  1. ডেইলি নিউজ অ্যান্ড্রয়েড অ্যাপে বিজ্ঞাপন প্রযুক্তি SDK registerSource() ব্যবহার করে ক্লিক নিবন্ধন করে

  2. অ্যান্ড্রয়েডে অ্যাট্রিবিউশন রিপোর্টিং এপিআই registerSource() এ প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়

  3. সোর্স রেজিস্ট্রেশন সম্পূর্ণ করতে বিজ্ঞাপন প্রযুক্তি সার্ভার অ্যাট্রিবিউশন-রিপোর্টিং-রেজিস্টার-সোর্স হেডারের সাথে সাড়া দেয়

ওয়েব ট্রিগার নিবন্ধন:

  1. বিজ্ঞাপন প্রযুক্তি একটি ট্রিগার নিবন্ধন করে এবং অ্যাট্রিবিউশন রিপোর্টিং API-এ OS উপলব্ধতা পরীক্ষা করে

  2. ওয়েব ARA কোন প্ল্যাটফর্ম সমর্থিত সে সম্পর্কে তথ্য প্রদান করে

  3. OS-Trigger হেডার ওয়েব ARA API কে OS ARA API registerWebTrigger() ফাংশন কল করতে বলে

  4. registerWebTrigger() কলটি হুডের অধীনে ঘটে এবং বিকাশকারীকে সরাসরি OS এর সাথে registerWebTrigger() কল করার প্রয়োজন নেই

  5. OS ARA গ্রহণ করে এবং Attribution-Reporting-Register-OS-Trigger হেডার দ্বারা প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়

  6. বিজ্ঞাপন প্রযুক্তি OS API এর সাথে ট্রিগার নিবন্ধন সম্পূর্ণ করবে

  7. OS ARA অ্যাপ<>অ্যাপ অ্যাট্রিবিউশনে প্রয়োগ করা একই যুক্তি অনুসারে অ্যাট্রিবিউশন সম্পাদন করবে এবং একই রিপোর্ট পাঠাবে

কর্মপ্রবাহ

নিম্নলিখিত পদক্ষেপগুলি কীভাবে কাজটি সম্পূর্ণ করতে হয় সে সম্পর্কে আরও বিশদ অন্তর্ভুক্ত করে:

  1. অ্যাপের বিজ্ঞাপন প্রযুক্তি নিম্নলিখিত সমন্বয়গুলির সাথে Android এর অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে একটি উৎস নিবন্ধন করে:

    • একটি ওয়েবসাইটে রূপান্তরিত হতে পারে এমন একটি অ্যাপ উত্স নিবন্ধন করতে, Attribution-Reporting-Register-Source প্রতিক্রিয়া শিরোনামে একটি অ্যাপ গন্তব্যের পরিবর্তে একটি ওয়েব গন্তব্য (eTLD+1) অন্তর্ভুক্ত করা উচিত।
    Attribution-Reporting-Register-Source: {
        "web_destination": "https://advertiser.example",
        ...
    }
    
    • কিছু বিজ্ঞাপনদাতা 302 রিডাইরেক্ট চেইন ব্যবহার করে একাধিক পরিমাপ প্রদানকারী (উদাহরণস্বরূপ, একটি তৃতীয় পক্ষের পরিমাপ সরঞ্জাম বা একটি বিশ্লেষণ সরঞ্জাম) ব্যবহার করতে পারে। কিছু ক্ষেত্রে, অ্যাট্রিবিউশন রিপোর্টিং এপিআই ব্যাকগ্রাউন্ডে অ্যাট্রিবিউশন-রিপোর্টিং-রিডাইরেক্ট হেডারে উল্লেখিত রিডাইরেক্ট পাথ অনুসরণ করবে এবং একই সময়ে 302 রিডাইরেক্ট পাথ ফোরগ্রাউন্ডে বিদ্যমান নেভিগেশন অনুরোধের জন্য কার্যকর করে। এই অনুরোধগুলি একই URL-এ যাবে এবং তৃতীয় পক্ষের পরিমাপ প্রদানকারীর ডবল কাউন্টিং রেজিস্ট্রেশন হতে পারে। দ্বৈত গণনা নিবন্ধন প্রতিরোধ করতে, বিজ্ঞাপন প্রযুক্তিগুলি অ্যাট্রিবিউশন রিপোর্টিং এপিআই নিবন্ধনকে একটি বিকল্প অথচ নির্ধারক URL-এ পাঠাতে পুনর্নির্দেশ আচরণ পরিবর্তন করতে পারে৷
    • এই আচরণটি সক্ষম করার জন্য, বিজ্ঞাপন প্রযুক্তিগুলিকে একটি নিবন্ধন অনুরোধে সাড়া দেওয়ার সময় একটি নতুন HTTP শিরোনাম অন্তর্ভুক্ত করতে হবে:

      • শিরোনাম হল Attribution-Reporting-Redirect-Config
      • শিরোনামের মান পুনঃনির্দেশ করা উচিত-302-টু-সুপরিচিত
      Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
      
    • সোর্স রেজিস্ট্রেশনের বাকি প্রক্রিয়াটি একটি স্ট্যান্ডার্ড অ্যাপ-টু-অ্যাপ সোর্স রেজিস্ট্রেশনের মতোই।

  2. বিজ্ঞাপনদাতার ওয়েবসাইটের বিজ্ঞাপন প্রযুক্তি ট্রিগার নিবন্ধন করে ক্রোমকে Android অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে নিবন্ধন অর্পণ করতে বলে:

    • একবার একজন ব্যবহারকারী একটি ওয়েবসাইটে একটি রূপান্তর সম্পূর্ণ করলে, বিজ্ঞাপন প্রযুক্তি Chrome-এর সাথে ট্রিগার নিবন্ধন করার জন্য একটি অনুরোধ করবে

      1. একটি পিক্সেল বা fetch() অনুরোধ একটি ট্রিগার নিবন্ধন করার অনুরোধ করতে ব্যবহার করা যেতে পারে

      2. Attribution-Reporting-Support অনুরোধ শিরোনামটি Chrome দ্বারা বিজ্ঞাপন প্রযুক্তিতে ফেরত দেওয়া হয়। ক্রোম ব্রাউজার এবং অ্যান্ড্রয়েড ডিভাইস উভয়েই API সক্ষম করা থাকলে, হেডারটি os, web ফিরে আসবে

      Attribution-Reporting-Support: os, web
      
    • বিজ্ঞাপন প্রযুক্তির তখন ক্রোমকে বলা উচিত যে Attribution-Reporting-Register-OS-Trigger শিরোনাম ব্যবহার করে OS-এ প্রতিনিধিত্ব করতে যা:

      1. Chrome কে OS-এ নিবন্ধন অর্পণ করতে বলে৷

      2. OS API ফাংশন registerWebTrigger() কল করে Chrome OS-এ নিবন্ধন অর্পণ করে

        • registerWebTrigger() জন্য কলটি হুডের অধীনে ঘটে, বিজ্ঞাপন প্রযুক্তিকে সরাসরি registerWebTrigger() কল করার দরকার নেই
      3. OS API ব্রাউজার থেকে পাস করা বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করে

      Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
      "https://other-adtech.example/register-trigger"
      
    • কিছু ক্ষেত্রে Attribution-Reporting-Support হেডার অনুপলব্ধ এবং পাঠানো যাবে না। এটি ঘটলে, বিজ্ঞাপন প্রযুক্তি এখনও Attribution-Reporting-Info শিরোনাম অন্তর্ভুক্ত করে ট্রিগার নিবন্ধন পরিচালনা করার জন্য একটি পছন্দের প্ল্যাটফর্ম সেট করতে পারে। কীটি পছন্দের-প্ল্যাটফর্ম এবং অনুমোদিত মানগুলি হল os এবং web । ব্রাউজার উপলব্ধ হলে পছন্দের প্ল্যাটফর্মটি ব্যবহার করবে এবং OS অনুপলব্ধ হলে ওয়েব প্ল্যাটফর্মে ফিরে আসবে।

    Attribution-Reporting-Info: preferred-platform=os
    
    • ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করতে, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে রেসপন্স হেডার ব্যবহার করে Android অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধে সাড়া দিতে হবে।
    Attribution-Reporting-Register-Trigger: {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    

একটি ওয়েব উত্স এবং একটি অ্যাপ ট্রিগার নিবন্ধন করুন৷

কিছু প্রচারাভিযানের জন্য, একটি মোবাইল ব্রাউজারে একটি সাইটে একটি উৎস ঘটতে পারে যখন একই ডিভাইসে একটি অ্যাপে ট্রিগার ঘটতে পারে।

উদাহরণ

একজন ব্যবহারকারী তাদের Android ফোনে তাদের Chrome ব্রাউজারে একটি সাইট ব্রাউজ করছেন। তারা তাদের প্রিয় দোকানগুলির একটি থেকে একটি সোয়েটারের জন্য একটি বিজ্ঞাপন দেখে। তারা বিজ্ঞাপনটিতে ক্লিক করে এবং তারা ইতিমধ্যে ডাউনলোড করা অ্যাপে নিয়ে যায়। যে ওয়েবসাইটে বিজ্ঞাপনটি পরিবেশন করা হয়েছিল সেখানে বিজ্ঞাপন প্রযুক্তিটি Chrome-এ অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার না করে Android অ্যাট্রিবিউশন রিপোর্টিং API-এ নিবন্ধন অর্পণ করার জন্য Chrome-কে নির্দেশ দিয়ে ক্লিক উত্স নিবন্ধিত করে৷ ব্যবহারকারী শপিং অ্যাপে সোয়েটার ক্রয় করেন। বিজ্ঞাপনদাতার অ্যাপে বিজ্ঞাপন প্রযুক্তি তারপর Android অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে কনভার্সন ট্রিগার নিবন্ধন করে। OS-স্তরের অ্যাট্রিবিউশন রিপোর্টিং API ওয়েব সোর্স এবং অ্যাপ ট্রিগারের সাথে মেলে এবং প্রাসঙ্গিক রিপোর্ট পাঠাতে সক্ষম।

ওয়েব থেকে অ্যাপ অ্যাট্রিবিউশন ফ্লো
ওয়েব থেকে অ্যাপ অ্যাট্রিবিউশন ফ্লো

ওয়েব উৎস নিবন্ধন:

  1. বিজ্ঞাপন প্রযুক্তি একটি উৎস নিবন্ধন করে এবং অ্যাট্রিবিউশন রিপোর্টিং এপিআই-এ OS উপলব্ধতা পরীক্ষা করে

  2. ওয়েব ARA কোন প্ল্যাটফর্ম সমর্থিত সে সম্পর্কে তথ্য প্রদান করে

  3. OS-Source হেডার ওয়েব ARA API কে OS ARA API registerWebSource() ফাংশন কল করতে বলে

  4. registerWebSource() করার জন্য কলটি হুডের অধীনে ঘটে এবং বিকাশকারীকে সরাসরি OS এর সাথে registerWebSource() কল করার প্রয়োজন নেই

  5. OS ARA গ্রহণ করে এবং Attribution-Reporting-Register-OS-Source হেডার দ্বারা প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়

  6. বিজ্ঞাপন প্রযুক্তি OS API-এর মাধ্যমে উৎস নিবন্ধন সম্পন্ন করবে

অ্যাপ ট্রিগার নিবন্ধন:

  1. ক্লোথিং স্টোর অ্যান্ড্রয়েড অ্যাপে বিজ্ঞাপন প্রযুক্তি SDK OS ARA-এর সাথে ট্রিগার নিবন্ধন করে

  2. অ্যান্ড্রয়েডে অ্যাট্রিবিউশন রিপোর্টিং এপিআই registerTrigger() এ প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়

  3. অ্যাড টেক সার্ভার ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করতে Attribution-Reporting-Register-Trigger হেডারের সাথে সাড়া দেয়

  4. OS ARA অ্যাপ<>অ্যাপ অ্যাট্রিবিউশনে প্রয়োগ করা একই যুক্তি অনুসারে অ্যাট্রিবিউশন সম্পাদন করবে এবং একই রিপোর্ট পাঠাবে

কর্মপ্রবাহ

নিম্নলিখিত পদক্ষেপগুলি কীভাবে কাজটি সম্পূর্ণ করতে হয় সে সম্পর্কে আরও বিশদ অন্তর্ভুক্ত করে:

  1. প্রকাশক ওয়েবসাইটের বিজ্ঞাপন প্রযুক্তি ক্রোমকে Android অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে নিবন্ধন অর্পণ করার নির্দেশ দিয়ে উত্সটি নিবন্ধন করে:

    • একটি ওয়েব থেকে অ্যাপ ব্যবহারের ক্ষেত্রে, একটি উৎস নিবন্ধন করার সময়, অ্যাট্রিবিউশন সোর্স প্যারামিটারটি সরাসরি নির্দিষ্ট করতে হবে, হয় attributionsrc ট্যাগ ব্যবহার করে বা JavaScript নিবন্ধন ব্যবহার করে
    • নিম্নলিখিত উদাহরণটি উত্স প্যারামিটার নির্দিষ্ট করতে attributionsrc ট্যাগ ব্যবহার করে:
    <img src="https://adtech.example/conversionpixel"
    attributionsrc="https://adtech.example/register-source?purchase=12">
    
  2. Attribution-Reporting-Support অনুরোধ শিরোনামটি Chrome দ্বারা বিজ্ঞাপন প্রযুক্তিতে ফেরত দেওয়া হয়। ক্রোম ব্রাউজার এবং অ্যান্ড্রয়েড ডিভাইস উভয়েই এপিআই সক্ষম করা থাকলে, হেডারটি os, web ফিরে আসবে।

    Attribution-Reporting-Support: os, web
    
  3. Attribution-Reporting-Register-OS-Source শিরোনাম ব্যবহার করে বিজ্ঞাপন প্রযুক্তির ক্রোমকে OS-স্তরের API-এ প্রতিনিধিত্ব করতে বলা উচিত:

    1. Chrome কে OS-এ নিবন্ধন অর্পণ করতে বলে৷
    2. OS API ফাংশন registerWebSource() কল করে Chrome OS-এ নিবন্ধন অর্পণ করে
    3. registerWebSource() জন্য কলটি হুডের অধীনে ঘটে, বিজ্ঞাপন প্রযুক্তিকে সরাসরি registerWebSource() কল করার প্রয়োজন নেই
    4. OS API ব্রাউজার থেকে পাস করা বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করে
    Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
    
    • কিছু ক্ষেত্রে Attribution-Reporting-Support শিরোনাম অনুপলব্ধ। এটি ঘটলে, বিজ্ঞাপন প্রযুক্তি এখনও Attribution-Reporting-Info শিরোনাম অন্তর্ভুক্ত করে উৎস নিবন্ধন পরিচালনা করার জন্য একটি পছন্দের প্ল্যাটফর্ম সেট করতে পারে। কীটি পছন্দের-প্ল্যাটফর্ম এবং অনুমোদিত মানগুলি হল os এবং web । ব্রাউজার উপলব্ধ হলে পছন্দের প্ল্যাটফর্মটি ব্যবহার করবে এবং OS অনুপলব্ধ হলে ওয়েব প্ল্যাটফর্মে ফিরে যাবে।
    Attribution-Reporting-Info: preferred-platform=os
    
    • সোর্স রেজিস্ট্রেশন সম্পূর্ণ করতে, অ্যাড টেকের এন্ডপয়েন্টকে Attribution-Reporting-Register-Source রেসপন্স হেডার সহ Android অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধে সাড়া দিতে হবে। প্রতিক্রিয়াটি গন্তব্য ক্ষেত্রের একটি অ্যাপের গন্তব্যও উল্লেখ করা উচিত।
    Attribution-Reporting-Register-Source: {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        ...
    }
    
    • সোর্স রেজিস্ট্রেশনের জন্য রিডাইরেক্ট সমর্থন করতে, ক্রোম রিডাইরেক্ট অনুসরণ করবে এবং প্রতিটি রিডাইরেক্ট হপের জন্য ওয়েব কনটেক্সট API-কে কল করবে।
    • উৎস নিবন্ধনের অবশিষ্টাংশ একই থাকে।
  4. বিজ্ঞাপনদাতার অ্যাপের বিজ্ঞাপন প্রযুক্তি Android অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে একটি ট্রিগার নিবন্ধন করে:

    • অ্যাপ্লিকেশানগুলিতে ঘটে এমন ট্রিগারগুলির জন্য, অ্যাপ্লিকেশানগুলি স্বাভাবিক হিসাবে Android অ্যাট্রিবিউশন রিপোর্টিং API এর সাথে ট্রিগারগুলি নিবন্ধন করে

যে প্রচারাভিযানগুলিতে অ্যাপ এবং ওয়েব সম্ভাব্য গন্তব্য উভয়ই রয়েছে৷

  1. দ্বৈত গন্তব্য সেট আপ করুন

    • কিছু প্রচারাভিযান বিজ্ঞাপনদাতার অ্যাপে বা বিজ্ঞাপনদাতার ওয়েব পৃষ্ঠায় রূপান্তর করার জন্য সেট আপ করা হতে পারে বিভিন্ন কারণের উপর নির্ভর করে যেমন ব্যবহারকারীর অ্যাপ ইনস্টল করা আছে কিনা।
    • এই ক্ষেত্রে, যেখানে উপলব্ধ আছে সেখানে সোর্স রেজিস্ট্রেশন অর্পণ করার পরামর্শ দেওয়া হয় যাতে ট্রিগারটি যেখানেই ঘটুক না কেন উৎসটিকে সঠিকভাবে দায়ী করা যায়। OS এর সাথে উৎস নিবন্ধন করার সময়, একটি অ্যাপ এবং ওয়েব গন্তব্য উভয়ই সংশ্লিষ্ট প্যারামিটারে নির্দিষ্ট করা যেতে পারে।
    • অ্যাপের গন্তব্য destination ক্ষেত্রের মধ্যে থাকা উচিত
    • ওয়েব গন্তব্য web_destination ক্ষেত্রে থাকা উচিত
    • Chrome ডেভেলপারদের মনে রাখা উচিত যে OS অ্যাট্রিবিউশন রিপোর্টিং API-এর destination ক্ষেত্রটি একটি অ্যাপ প্যাকেজ হওয়া উচিত এবং একটি URL নয়৷
    Attribution-Reporting-Register-Source: {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        "web_destination": "https://example.advertiser"
        ...
    }
    
    • মোটা রিপোর্টিং এর পরবর্তী বিভাগটি ব্যাখ্যা করবে যে কিভাবে দ্বৈত গন্তব্য ব্যবহার করা আপনার প্রতিবেদনে গোলমালকে প্রভাবিত করতে পারে।
  2. দ্বৈত গন্তব্য উত্সের জন্য ইভেন্ট-স্তরের প্রতিবেদনে শব্দ কমাতে মোটা রিপোর্টিং ব্যবহার করুন:

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

Chrome কাস্টম ট্যাব ব্যবহার করে অ্যাপের জন্য

কিছু অ্যাপ ওয়েব কন্টেন্ট রেন্ডার করতে কাস্টম ট্যাব ব্যবহার করতে পারে। অ্যাপ এবং মোবাইল ওয়েব সাইট জুড়ে পরিমাপ করার সময় কাস্টম ট্যাবগুলি একটি নিয়মিত ওয়েব পৃষ্ঠার মতোই আচরণ করে৷

  1. একটি অ্যাপ উত্স এবং কাস্টম ট্যাব ট্রিগার নিবন্ধন করুন:

  2. একটি কাস্টম ট্যাব উৎস এবং অ্যাপ ট্রিগার নিবন্ধন করুন:

  3. একটি সিসিটি উৎস এবং সিসিটি ট্রিগার নিবন্ধন করুন

WebView ব্যবহার করে অ্যাপের জন্য

কিছু অ্যাপ কন্টেন্ট প্রদর্শন করতে WebView ব্যবহার করতে পারে। ওয়েবভিউ-এর জন্য বিভিন্ন ধরনের ব্যবহারের ক্ষেত্রে রয়েছে, যেমন রেন্ডারিং বিজ্ঞাপন, ওয়েব কন্টেন্ট হোস্ট করা, বা কাস্টম অ্যাপ বৈশিষ্ট্যগুলি একটি ওয়েব ফর্ম্যাটের জন্য আরও উপযুক্ত৷

  1. WebViews-কে অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করার অনুমতি দিতে, এম্বেডিং অ্যাপটিকে সঠিক অনুমতি দিয়ে কনফিগার করতে হবে।

  2. WebView-এ শুধুমাত্র OS-স্তরের অ্যাট্রিবিউশন পাওয়া যায়। অ্যাট্রিবিউশন-রিপোর্টিং-সহায়তা শিরোনামটি শুধুমাত্র OS প্রদান করবে এবং শুধুমাত্র যদি Android অ্যাট্রিবিউশন রিপোর্টিং API উপলব্ধ থাকে।

  3. OS-এ অর্পণ করার সময়, WebView registerSource বা registerWebSource এবং registerTrigger বা registerWebTrigger ব্যবহার করতে পারে। WebView দ্বারা কোন পদ্ধতিগুলি ব্যবহার করা হয় তা WebView রেন্ডারিং অ্যাপ দ্বারা সেট করা হয় এবং প্রতি WebView ভিত্তিতে নির্ধারিত হয়।

    • registerSource এবং registerWebSource এর মধ্যে পার্থক্য হল কোন উৎসটি প্রকাশক হিসাবে লগ করা হয়। registerSource এর সাথে, অ্যাপটি প্রকাশক হিসাবে লগ করা হয়েছে; registerSource কখন ব্যবহার করবেন তার একটি উদাহরণ হল একটি প্রকাশক অ্যাপ যা ওয়েবভিউ ব্যবহার করে রেন্ডার করা বিজ্ঞাপন দেখায়। registerWebSource এর সাথে, ওয়েবভিউতে হোস্ট করা ওয়েবসাইট প্রকাশক হিসাবে লগ করা হয়; registerWebSource কখন ব্যবহার করবেন তার একটি উদাহরণ হল একটি অ্যাপ যা একটি ওয়েবভিউ হোস্ট করে এবং যে ওয়েবসাইটটি ওয়েবভিউ দ্বারা রেন্ডার করা হচ্ছে সেটি বিজ্ঞাপন দেখাচ্ছে৷ registerTrigger এবং registerWebTrigger একইভাবে আচরণ করে। আইটেম #3-এর চার্টে একটি অ্যাপ বা SDK বিকাশকারী কখন registerSource বা registerWebSource , এবং registerTrigger বা registerWebTrigger ব্যবহার করার জন্য API কনফিগার করতে চাইবে তার জন্য বিভিন্ন পরিস্থিতির বিবরণ দেয়।
    • ডিফল্টরূপে, Android অ্যাট্রিবিউশন রিপোর্টিং API কল করার সময় WebView registerSource এবং registerWebTrigger ব্যবহার করবে। এটি অ্যাপের সাথে উত্সগুলিকে সংযুক্ত করে এবং যখন ট্রিগারটি ঘটে তখন WebView-এ URL-এর শীর্ষ-স্তরের উত্সের সাথে ট্রিগার করে৷
      • যদি একটি অ্যাপের ভিন্ন আচরণের প্রয়োজন হয়, তাহলে তাদের androidx.webkit.WebViewSettingsCompat ক্লাসে একটি নতুন পদ্ধতি setAttributionRegistrationBehavior ব্যবহার করতে হবে। এই পদ্ধতিটি নির্দিষ্ট করবে যে WebView-কে registerWebSource() বা registerWebTrigger() কল করা উচিত কিনা registerSource() বা registerTrigger() এর পরিবর্তে।

      • এই আচরণটি শুরু করা প্রতিটি WebView এর জন্য সেট করা প্রয়োজন।

      • বিজ্ঞাপন প্রযুক্তি SDK যদি WebView চালু করে, তাহলে SDK-কে এই ডিফল্ট আচরণ সেট করতে হবে।

      • যে অ্যাপগুলি অ্যাপের পরিবর্তে WebView-এ ওয়েবসাইটের সাথে সোর্স রেজিস্ট্রেশন সংযুক্ত করতে registerWebSource() ব্যবহার করতে চায়, তাদের অবশ্যই WebApp অনুমোদিত তালিকায় যোগ দিতে হবে। অনুমোদিত তালিকায় যোগ দিতে এই ফর্মটি পূরণ করুন । অনুমোদিত তালিকার উদ্দেশ্য হল ওয়েব প্রেক্ষাপটের জন্য বিশ্বাস স্থাপনের জন্য গোপনীয়তা বিবেচনাকে প্রশমিত করা।

      মান বর্ণনা উদাহরণ ব্যবহার ক্ষেত্রে
      APP_SOURCE_AND_WEB_TRIGGER (ডিফল্ট) অ্যাপগুলিকে ওয়েবভিউ থেকে অ্যাপ উত্স (অ্যাপ প্যাকেজ নামের সাথে যুক্ত উত্স) এবং ওয়েব ট্রিগার (eTLD+1 এর সাথে যুক্ত ট্রিগার) নিবন্ধন করার অনুমতি দেয়৷ যে অ্যাপগুলি ওয়েব ব্রাউজিং সক্ষম করার পরিবর্তে বিজ্ঞাপন পরিবেশন করতে WebView ব্যবহার করে৷
      WEB_SOURCE_AND_WEB_TRIGGER অ্যাপগুলিকে ওয়েবভিউ থেকে ওয়েব উত্স এবং ওয়েব ট্রিগার নিবন্ধন করার অনুমতি দেয়৷ WebView-ভিত্তিক ব্রাউজার অ্যাপ, যেখানে বিজ্ঞাপন ইম্প্রেশন এবং রূপান্তর উভয়ই WebView-এর ওয়েবসাইটে ঘটতে পারে।
      APP_SOURCE_AND_APP_TRIGGER অ্যাপগুলিকে ওয়েবভিউ থেকে অ্যাপ উত্স এবং অ্যাপ ট্রিগার নিবন্ধন করার অনুমতি দেয়৷ WebView-ভিত্তিক অ্যাপ্লিকেশান যেখানে বিজ্ঞাপনের ইমপ্রেশন এবং রূপান্তরগুলি সবসময় WebView এর eTLD+1 এর পরিবর্তে অ্যাপের সাথে যুক্ত হওয়া উচিত।
      অক্ষম WebView থেকে উৎস এবং ট্রিগার নিবন্ধন নিষ্ক্রিয় করে।
    1. WebView থেকে উত্স এবং ট্রিগার নিবন্ধন
    2. বিজ্ঞাপন প্রযুক্তিগুলিকে Attribution-Reporting-Register-OS-Source হেডার ব্যবহার করে সোর্স রেজিস্ট্রেশনে সাড়া দেওয়া উচিত। WebView-এর জন্য সেট আচরণের উপর ভিত্তি করে, এটি হয় registerSource() অথবা registerWebSource() OS-এর সাথে কল করবে এবং Android অ্যাট্রিবিউশন রিপোর্টিং API থেকে অ্যাড টেক URI-তে একটি সেকেন্ডারি API কল শুরু করবে।

      • সোর্স রেজিস্ট্রেশন সম্পূর্ণ করতে, অ্যাড টেকের এন্ডপয়েন্টকে রেসপন্স হেডার সহ Android অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধে সাড়া দিতে হবে।
       Attribution-Reporting-Register-OS-Source: {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        ...
      }
      
    3. উৎস নিবন্ধনের অবশিষ্টাংশ একই থাকে।

    4. বিজ্ঞাপন প্রযুক্তিগুলিকে Attribution-Reporting-Register-OS-Trigger হেডার ব্যবহার করে ট্রিগার নিবন্ধনের প্রতিক্রিয়া জানানো উচিত। WebView-এর জন্য সেট আচরণের উপর ভিত্তি করে, এটি OS-এর সাথে registerTrigger() অথবা registerWebTrigger() কল করবে এবং Rb থেকে অ্যাড টেক URI-তে একটি সেকেন্ডারি API কল শুরু করবে।

    5. ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করতে, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে রেসপন্স হেডার সহ Android অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধে সাড়া দিতে হবে।

    Attribution-Reporting-Register-OS-Trigger: {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    

ডিবাগ

ওয়েব ইমপ্লিমেন্টেশনের জন্য একটি অ্যাপ সেট আপ করার সময়, উৎস এবং ট্রিগারগুলি সঠিকভাবে নিবন্ধিত হচ্ছে কিনা তা যাচাই করার জন্য ডিবাগ রিপোর্ট সেট আপ করার সুপারিশ করা হয় এবং কেন সেগুলি নিবন্ধিত না হয় সে সম্পর্কে তথ্য পেতে৷

সাধারণ অ্যাট্রিবিউশন রিপোর্টিং ডিবাগিং ধাপের জন্য, ডিবাগিং কুকবুক দেখুন।