প্রোটেক্টেড অডিয়েন্স API দিয়ে কাস্টম অডিয়েন্স টার্গেটিং সমর্থন করুন

মতামত প্রদান করুন

সাম্প্রতিক হাল নাগাদ

সুরক্ষিত দর্শক বিটাতে রয়েছে এবং সর্বজনীন ডিভাইসে পরীক্ষার জন্য উপলব্ধ!

সুরক্ষিত দর্শকদের সাথে, আপনি করতে পারেন:

  • পূর্ববর্তী ব্যবহারকারীর কর্মের উপর ভিত্তি করে কাস্টম দর্শকদের পরিচালনা করুন।
  • একক বিক্রেতা বা জলপ্রপাত মধ্যস্থতা সমর্থন সহ ডিভাইসে নিলাম শুরু করুন।
  • বিজ্ঞাপন নির্বাচনের পরে ইমপ্রেশন রিপোর্টিং অনুশীলন করুন।

শুরু করতে, সুরক্ষিত দর্শক বিকাশকারী নির্দেশিকা পড়ুন। আমরা সুরক্ষিত শ্রোতা বিকাশ অব্যাহত রেখে আপনার প্রতিক্রিয়া প্রশংসা করা হয়।

টাইমলাইন

আমরা আগামী মাসে নতুন বৈশিষ্ট্য প্রকাশ করব। বৈশিষ্ট্যের উপর নির্ভর করে সঠিক প্রকাশের তারিখ পরিবর্তিত হবে এবং এই টেবিলটি উপলভ্য হওয়ার সাথে সাথে ডকুমেন্টেশনের লিঙ্ক সহ আপডেট করা হবে।

বৈশিষ্ট্য বিকাশকারী পূর্বরূপ উপলব্ধ বিটাতে উপলব্ধ
ইভেন্ট-স্তরের রিপোর্টিং Q1 '23 Q3 '23
জলপ্রপাত মধ্যস্থতা Q1 '23 Q4 '23
অ্যাপ ইনস্টল বিজ্ঞাপন ফিল্টারিং Q2 '23 Q3 '23
ফ্রিকোয়েন্সি ক্যাপ ফিল্টারিং Q2 '23 Q3 '23
ফিল্টারিংয়ের জন্য বিজ্ঞাপন নির্বাচন কর্মপ্রবাহে প্রাসঙ্গিক বিজ্ঞাপনগুলি পাস করুন Q2 '23 Q3 '23
ইন্টারঅ্যাকশন রিপোর্টিং Q2 '23 Q3 '23
কাস্টম শ্রোতা প্রতিনিধি দলে যোগ দিন Q3 '23 Q4 '23
নন-সিপিএম বিলিং Q3 '23 Q4 '23
বিডিং এবং নিলাম পরিষেবা একীকরণ Q3 '23 Q4 '23
ডিবাগ রিপোর্টিং Q3 '23 Q4 '23
অ্যাট্রিবিউশন রিপোর্টিং ইন্টিগ্রেশন N/A Q4 '23
ওপেন বিডিং মধ্যস্থতা Q4 '23 Q4 '23
মুদ্রা ব্যবস্থাপনা Q1 '24 Q2 '24
কে-অ্যানন ইন্টিগ্রেশন N/A Q2 '24
সামগ্রিক রিপোর্টিং ইন্টিগ্রেশন Q3 '24 Q4 '24

ওভারভিউ

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

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

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

  1. কাস্টম অডিয়েন্স এপিআই : এটি "কাস্টম অডিয়েন্স" বিমূর্ততার উপর কেন্দ্রীভূত, যা সাধারণ উদ্দেশ্য সহ বিজ্ঞাপনদাতা-নির্ধারিত দর্শকদের প্রতিনিধিত্ব করে। শ্রোতাদের তথ্য ডিভাইসে সংরক্ষণ করা হয় এবং শ্রোতাদের জন্য প্রাসঙ্গিক প্রার্থী বিজ্ঞাপন এবং নির্বিচারে মেটাডেটার সাথে যুক্ত করা যেতে পারে, যেমন বিডিং সংকেত। তথ্যটি বিজ্ঞাপনদাতা বিড, বিজ্ঞাপন ফিল্টারিং এবং রেন্ডারিং জানাতে ব্যবহার করা যেতে পারে।
  2. বিজ্ঞাপন নির্বাচন এপিআই : এটি একটি কাঠামো প্রদান করে যা বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মের কর্মপ্রবাহকে অর্কেস্ট্রেট করে যা স্থানীয়ভাবে সঞ্চিত প্রার্থীর বিজ্ঞাপনগুলি বিবেচনা করে এবং একটি বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম যে বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মে ফিরে আসে সেই বিজ্ঞাপনগুলির উপর অতিরিক্ত প্রক্রিয়াকরণ করে একটি "জয়ী" বিজ্ঞাপন নির্ধারণ করার জন্য ডিভাইসে সিগন্যালগুলিকে কাজে লাগায়। যন্ত্র.
ফ্লো চার্ট যা Android-এ গোপনীয়তা স্যান্ডবক্সে কাস্টম অডিয়েন্স ম্যানেজমেন্ট এবং বিজ্ঞাপন নির্বাচনের কার্যপ্রবাহ দেখায়।

একটি উচ্চ স্তরে, ইন্টিগ্রেশন নিম্নরূপ কাজ করে:

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

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

  3. বিজ্ঞাপন পরিবেশনকারী অ্যাপ বা বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মের SDK নির্বাচিত বিজ্ঞাপন রেন্ডার করে।

  4. প্ল্যাটফর্মটি ইম্প্রেশন এবং বিজ্ঞাপন নির্বাচনের ফলাফলের রিপোর্টিং সহজতর করে। এই রিপোর্টিং ক্ষমতা অ্যাট্রিবিউশন রিপোর্টিং API এর পরিপূরক। বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলি তাদের প্রতিবেদনের প্রয়োজনের উপর ভিত্তি করে কাস্টমাইজ করতে পারে।

Android API-এ সুরক্ষিত শ্রোতাদের অ্যাক্সেস পান

অ্যাড টেক প্ল্যাটফর্মগুলিকে সুরক্ষিত শ্রোতা API অ্যাক্সেস করতে নথিভুক্ত করতে হবে। আরও তথ্যের জন্য একটি গোপনীয়তা স্যান্ডবক্স অ্যাকাউন্টের জন্য তালিকাভুক্তি দেখুন।

কাস্টম শ্রোতা ব্যবস্থাপনা

কাস্টম দর্শক

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

একটি বিজ্ঞাপনদাতা অ্যাপ বা সমন্বিত SDK একটি কাস্টম দর্শকদের সাথে যোগ দিতে বা ছেড়ে যেতে পারে, উদাহরণস্বরূপ, একটি অ্যাপে ব্যবহারকারীর ব্যস্ততা।

কাস্টম দর্শক মেটাডেটা

প্রতিটি কাস্টম শ্রোতা নিম্নলিখিত মেটাডেটা ধারণ করে:

  • মালিক: মালিক অ্যাপের প্যাকেজের নাম। এটি পরোক্ষভাবে কলার অ্যাপের প্যাকেজ নামের সাথে সেট করা আছে।
  • ক্রেতা: ক্রেতা বিজ্ঞাপন নেটওয়ার্ক যা এই কাস্টম দর্শকদের জন্য বিজ্ঞাপন পরিচালনা করে। ক্রেতা সেই পক্ষের প্রতিনিধিত্ব করে যারা কাস্টম দর্শকদের অ্যাক্সেস করতে পারে এবং প্রাসঙ্গিক বিজ্ঞাপনের তথ্য আনতে পারে। eTLD+1 বিন্যাস অনুসরণ করে ক্রেতাকে নির্দিষ্ট করা হয়েছে।
  • নাম: কাস্টম দর্শকদের জন্য একটি ইচ্ছাকৃত নাম বা শনাক্তকারী, যেমন একজন ব্যবহারকারী যার "শপিং কার্ট পরিত্যাগকারী" আছে। এই বৈশিষ্ট্যটি ব্যবহার করা যেতে পারে, উদাহরণস্বরূপ, বিজ্ঞাপনদাতার বিজ্ঞাপন প্রচারাভিযানের একটি টার্গেটিং মানদণ্ড বা বিডিং কোড আনার জন্য URL-এ একটি ক্যোয়ারী স্ট্রিং।
  • সক্রিয়করণের সময় এবং মেয়াদ শেষ হওয়ার সময়: এই ক্ষেত্রগুলি সময় উইন্ডোটি নির্ধারণ করে যখন এই কাস্টম দর্শক কার্যকর হবে৷ প্ল্যাটফর্মটি কাস্টম দর্শকদের থেকে সদস্যপদ প্রত্যাহার করতে এই তথ্য ব্যবহার করে। একটি কাস্টম দর্শকের জীবন সীমাবদ্ধ করার জন্য মেয়াদ শেষ হওয়ার সময় সর্বাধিক সময়সীমার উইন্ডো অতিক্রম করতে পারে না৷
  • দৈনিক আপডেট URL: যে URLটি প্ল্যাটফর্ম প্রার্থীর বিজ্ঞাপন এবং অন্যান্য মেটাডেটা আনার জন্য ব্যবহার করে "ব্যবহারকারীর বিডিং সিগন্যাল" এবং "বিশ্বস্ত বিডিং সিগন্যাল" ক্ষেত্রে পুনরাবৃত্ত ভিত্তিতে। আরও বিশদ বিবরণের জন্য, কাস্টম দর্শকদের জন্য প্রার্থী বিজ্ঞাপনগুলি কীভাবে আনতে হয় তার বিভাগটি দেখুন৷
  • ব্যবহারকারীর বিডিং সিগন্যাল: রিমার্কেটিং বিজ্ঞাপনের যেকোনো বিডিংয়ের জন্য বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম-নির্দিষ্ট সংকেত। সিগন্যালের উদাহরণগুলির মধ্যে রয়েছে: ব্যবহারকারীর মোটা অবস্থান, পছন্দের লোকেল এবং আরও অনেক কিছু।
  • বিশ্বস্ত বিডিং ডেটা: বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলি বিজ্ঞাপন পুনরুদ্ধার এবং স্কোরিং জানাতে রিয়েল-টাইম ডেটার উপর নির্ভর করে। উদাহরণস্বরূপ, একটি বিজ্ঞাপনের বাজেট শেষ হয়ে যেতে পারে এবং অবিলম্বে পরিবেশন বন্ধ করতে হবে। একটি অ্যাড-টেক একটি URL এন্ডপয়েন্টকে সংজ্ঞায়িত করতে পারে যেখান থেকে এই রিয়েল-টাইম ডেটা আনা যেতে পারে এবং কীগুলির সেট যার জন্য রিয়েল-টাইম লুকআপ করা দরকার। এই অনুরোধটি পরিচালনাকারী সার্ভারটি বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম দ্বারা পরিচালিত একটি বিশ্বস্ত সার্ভার হবে।
  • বিডিং লজিক URL: যে URLটি প্ল্যাটফর্মটি ডিমান্ড সাইড প্ল্যাটফর্ম থেকে বিডিং কোড আনতে ব্যবহার করে। যখন একটি বিজ্ঞাপন নিলাম শুরু হয় তখন প্ল্যাটফর্মটি এই পদক্ষেপটি সম্পাদন করে৷
  • বিজ্ঞাপন: কাস্টম দর্শকদের জন্য প্রার্থী বিজ্ঞাপনের একটি তালিকা। এর মধ্যে রয়েছে বিজ্ঞাপন প্রযুক্তির প্ল্যাটফর্ম-নির্দিষ্ট বিজ্ঞাপন মেটাডেটা এবং বিজ্ঞাপন রেন্ডার করার জন্য একটি URL। যখন কাস্টম দর্শকদের জন্য একটি নিলাম শুরু করা হয়, তখন বিজ্ঞাপন মেটাডেটার এই তালিকাটি বিবেচনা করা হবে৷ বিজ্ঞাপনের এই তালিকাটি সম্ভাব্য হলে দৈনিক আপডেট URL শেষ পয়েন্ট ব্যবহার করে রিফ্রেশ করা হবে। মোবাইল ডিভাইসে সম্পদের সীমাবদ্ধতার কারণে, কাস্টম দর্শকদের মধ্যে সংরক্ষিত বিজ্ঞাপনের সংখ্যার একটি সীমা রয়েছে।

কাস্টম দর্শক প্রতিনিধি দল

ঐতিহ্যগত কাস্টম দর্শকের সংজ্ঞা এবং কনফিগারেশন সাধারণত সার্ভার-সাইড প্রযুক্তি এবং এজেন্সি এবং বিজ্ঞাপনদাতা ক্লায়েন্ট এবং অংশীদারদের সাথে অংশীদারিত্বে বিজ্ঞাপন প্রযুক্তি দ্বারা চালিত ইন্টিগ্রেশনের উপর নির্ভর করে। সুরক্ষিত দর্শক API ব্যবহারকারীর গোপনীয়তা রক্ষা করার সময় কাস্টম শ্রোতা সংজ্ঞা এবং কনফিগারেশন সক্ষম করে। কাস্টম শ্রোতাদের সাথে যোগ দিতে, ক্রেতা বিজ্ঞাপন প্রযুক্তি যাদের অ্যাপে SDK উপস্থিতি নেই তাদের বিজ্ঞাপন প্রযুক্তির সাথে সহযোগিতা করতে হবে যাদের ডিভাইসে উপস্থিতি রয়েছে, যেমন মোবাইল পরিমাপ অংশীদার (MMPs) এবং সাপ্লাই-সাইড প্ল্যাটফর্ম (SSPs)। প্রোটেক্টেড অডিয়েন্স API-এর লক্ষ্য হল ক্রেতাদের পক্ষ থেকে কাস্টম অডিয়েন্স তৈরির আহ্বান জানাতে ডিভাইস কলারদের সক্ষম করে কাস্টম অডিয়েন্স ম্যানেজমেন্টের জন্য নমনীয় সমাধান প্রদান করে এই SDK গুলিকে সমর্থন করা। এই প্রক্রিয়াটিকে কাস্টম অডিয়েন্স ডেলিগেশন বলা হয়। এই পদক্ষেপগুলি অনুসরণ করে কাস্টম দর্শক প্রতিনিধি কনফিগার করুন:

একটি কাস্টম শ্রোতা যোগদান করুন

একটি কাস্টম শ্রোতা যোগদান দুটি উপায়ে করা যেতে পারে:

joinCustomAudience()

একটি অ্যাপ বা SDK প্রত্যাশিত পরামিতি সহ CustomAudience অবজেক্টকে ইনস্ট্যান্ট করার পরে joinCustomAudience() কল করে কাস্টম দর্শকদের সাথে যোগ দেওয়ার অনুরোধ করতে পারে। এখানে একটি দৃষ্টান্তমূলক কোড স্নিপেট উদাহরণ:

CustomAudience audience = new CustomAudience(
    Buyer = "example-dsp.com",
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    DailyUpdateURL = Uri.parse("https://..."),
    UserBiddingSignals = new JSONObject("{...}"),
    TrustedBiddingURL = Uri.parse("https://..."),
    TrustedBiddingKeys = {'key1","key2", ...,"key n"},
    BiddingLogicURL =  Uri.parse("https://..."),
    Ads = [new AdData(renderUrl = Uri.parse("https://..."),
           metadata = new JSONObject("{...}"), ...];

// Invoke ad services API to join a custom audience.
joinCustomAudience(audience);

fetchAndJoinCustomAudience()

একটি অ্যাপ বা SDK প্রত্যাশিত প্যারামিটার সহ fetchAndJoinCustomAudience() কল করে একটি বিজ্ঞাপন প্রযুক্তির পক্ষ থেকে একটি কাস্টম দর্শকদের সাথে যোগ দেওয়ার অনুরোধ করতে পারে যার ডিভাইসে উপস্থিতি নেই, নিম্নলিখিত উদাহরণের মতো:

FetchAndJoinCustomAudienceRequest fetchRequest = new FetchAndJoinCustomAudienceRequest(
    // Example: Optional verification token passed inside the fetch URL
    FetchURI = Uri.parse("https://example-dsp.com/...?mytoken=arbitrary1234"),
    // All the following parameters are optional
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    UserBiddingSignals = new JSONObject("{...}")
);

fetchAndJoinCustomAudience(fetchRequest);

ক্রেতার মালিকানাধীন URL এন্ডপয়েন্ট, প্রতিক্রিয়া বডিতে একটি CustomAudience JSON অবজেক্টের সাথে উত্তর দেয়। কাস্টম দর্শকদের ক্রেতা এবং মালিকের ক্ষেত্র উপেক্ষা করা হয় (এবং API দ্বারা স্বয়ংক্রিয়ভাবে পূরণ করা হয়)। এপিআই আরও প্রয়োগ করে যে দৈনিক আপডেট URLটি ক্রেতার eTLD+1 এর সাথেও মিলবে।

{
 "name": "running-shoes",
 "activation_time": 1680603133000,
 "expiration_time": 1680803133000,
 "user_bidding_signals" : {"signal1": "value"},
 "trusted_bidding_data": {
    "trusted_bidding_uri": "https://example-dsp.com/.."
    "trusted_bidding_keys": ["k1", "k2"],
 },
 "bidding_logic_uri": "https://example-dsp.com/...",
 "daily_update_uri": "https://example-dsp.com/...",
 "ads": [
   {
     "render_uri": "https://example-dsp.com/...",
     "metadata": {},
     "ad_filters": {
       "frequency_cap": {
         "win": [
           {
             "ad_counter_key": 1,
             "max_count": 2,
             "interval_in_seconds": 60
           },
         ],
         "view": [
           {
             "ad_counter_key": 2,
             "max_count": 10,
             "interval_in_seconds": 3600
           },
         ]
       },
       "app_install": {
         "package_names": [
           "package.name.one",
           "package.name.two", ...
         ]
       }
     }
   },
   ...
 ]
}

fetchAndJoinCustomAudience() API fetchUri এর eTLD+1 থেকে ক্রেতার পরিচয় নির্ধারণ করে। CustomAudience ক্রেতার পরিচয়টি joinCustomAudience() দ্বারা করা একই নথিভুক্তি এবং অ্যাপ অনুমোদন পরীক্ষা সম্পাদন করতে ব্যবহৃত হয় এবং আনা প্রতিক্রিয়া দ্বারা পরিবর্তন করা যায় না। CustomAudience মালিক হল কলিং অ্যাপ্লিকেশনটির প্যাকেজ নাম। eTLD+1 চেক ছাড়া fetchUri এর অন্য কোনো বৈধতা নেই এবং বিশেষ করে, k-anon চেক নেই। fetchAndJoinCustomAudience() API একটি HTTP GET অনুরোধ fetchUri ইস্যু করে এবং কাস্টম দর্শকদের প্রতিনিধিত্বকারী একটি JSON অবজেক্ট আশা করে। একই বাধ্যতামূলক, ঐচ্ছিক সীমাবদ্ধতা এবং কাস্টম অডিয়েন্স অবজেক্ট ক্ষেত্রগুলির জন্য ডিফল্ট মানগুলি প্রতিক্রিয়াতে প্রয়োগ করা হয়। আমাদের ডেভেলপার গাইডে বর্তমান প্রয়োজনীয়তা এবং সীমাবদ্ধতা সম্পর্কে জানুন।

ক্রেতার কাছ থেকে যে কোনো HTTP ত্রুটির প্রতিক্রিয়া fetchAndJoinCustomAudience ব্যর্থ করে দেয়। বিশেষ করে 429 এর একটি HTTP স্থিতি প্রতিক্রিয়া (অনেক বেশি অনুরোধ) বর্তমান অ্যাপ্লিকেশন থেকে সংজ্ঞায়িত সময়ের জন্য অনুরোধগুলিকে ব্লক করে। ক্রেতার কাছ থেকে প্রতিক্রিয়া ত্রুটিপূর্ণ হলে API কলও ব্যর্থ হয়। অস্থায়ী ব্যর্থতার (যেমন সার্ভার সাড়া না দেওয়া) বা ক্রমাগত ব্যর্থতাগুলি (যেমন ডেটা যাচাইকরণ ব্যর্থতা বা সার্ভারের সাথে যোগাযোগের সাথে অন্যান্য অ-অস্থায়ী ত্রুটি) পরিচালনা করার কারণে পুনরায় চেষ্টা করার জন্য দায়ী API কলারের কাছে ব্যর্থতাগুলি রিপোর্ট করা হয়।

CustomAudienceFetchRequest অবজেক্ট API কলারকে উপরের উদাহরণে দেখানো ঐচ্ছিক বৈশিষ্ট্য ব্যবহার করে কাস্টম অডিয়েন্সের জন্য কিছু তথ্য সংজ্ঞায়িত করতে দেয়। অনুরোধে সেট করা থাকলে, প্ল্যাটফর্ম দ্বারা প্রাপ্ত ক্রেতার প্রতিক্রিয়া দ্বারা এই মানগুলি ওভাররাইট করা যাবে না; সুরক্ষিত শ্রোতা API প্রতিক্রিয়ার ক্ষেত্রগুলিকে উপেক্ষা করে। যদি সেগুলি অনুরোধে সেট করা না থাকে, তবে সেগুলি অবশ্যই প্রতিক্রিয়াতে সেট করতে হবে, কারণ এই ক্ষেত্রগুলি একটি কাস্টম দর্শক তৈরি করতে প্রয়োজন৷ API কলার দ্বারা আংশিকভাবে সংজ্ঞায়িত CustomAudience এর বিষয়বস্তুর JSON উপস্থাপনা একটি বিশেষ শিরোনাম X-CUSTOM-AUDIENCE-DATAfetchUri GET অনুরোধে অন্তর্ভুক্ত করা হয়েছে। কাস্টম অডিয়েন্সের জন্য নির্দিষ্ট করা ডেটার ক্রমিক আকারের আকার 8KB-তে সীমাবদ্ধ। আকার অতিক্রম করা হলে fetchAndJoinCustomAudience API কল ব্যর্থ হয়।

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

যাচাইকরণ টোকেন সংজ্ঞা এবং সঞ্চয়স্থানের উপর একটি নোট

  • যাচাইকরণ টোকেনটি সুরক্ষিত শ্রোতা API দ্বারা কোন উদ্দেশ্যে ব্যবহার করা হয় না এবং এটি ঐচ্ছিক।

    • যাচাইকরণ টোকেনটি ক্রেতার দ্বারা যাচাই করতে ব্যবহার করা যেতে পারে যে দর্শকদের তৈরি করা হচ্ছে তাদের পক্ষে করা হচ্ছে।
    • সুরক্ষিত শ্রোতা API প্রস্তাবটি যাচাইকরণ টোকেনের জন্য একটি বিন্যাস বা ক্রেতা কীভাবে কলকারীর কাছে যাচাইকরণ টোকেন স্থানান্তর করে তা নির্দিষ্ট করে না। উদাহরণ স্বরূপ, যাচাইকরণ টোকেনটি মালিকের SDK বা ব্যাকএন্ডে প্রি-লোড করা হতে পারে বা ক্রেতার সার্ভার থেকে মালিকের SDK দ্বারা রিয়েল-টাইমে পুনরুদ্ধার করা যেতে পারে৷

একটি কাস্টম শ্রোতা ছেড়ে

একটি কাস্টম দর্শকের মালিক leaveCustomAudience() কল করে চলে যাওয়া বেছে নিতে পারেন, যেমনটি নীচের চিত্রিত কোড স্নিপেটে দেখানো হয়েছে:

// Invoke ad services API to leave a custom audience.
leaveCustomAudience(buyer, name);

স্টোরেজ এবং অন্যান্য ডিভাইস রিসোর্সের ব্যবহার সংরক্ষণে সাহায্য করার জন্য, কাস্টম দর্শকের মেয়াদ শেষ হয়ে যায় এবং একটি পূর্বনির্ধারিত সময়ের পরে ডিভাইসের স্টোর থেকে সরানো হয়। ডিফল্ট মান নির্ধারণ করতে হবে। মালিক এই ডিফল্ট মান ওভাররাইড করতে পারেন।

ব্যবহারকারী নিয়ন্ত্রণ

  • প্রস্তাবটি ব্যবহারকারীদের ইনস্টল করা অ্যাপের তালিকায় দৃশ্যমানতা দিতে চায় যা কমপক্ষে একটি কাস্টম দর্শক তৈরি করেছে
  • ব্যবহারকারীরা এই তালিকা থেকে অ্যাপগুলি সরাতে পারেন। অপসারণ অ্যাপগুলির সাথে যুক্ত সমস্ত কাস্টম শ্রোতা সাফ করে এবং অ্যাপগুলিকে নতুন কাস্টম দর্শকদের সাথে যুক্ত হতে বাধা দেয়৷
  • ব্যবহারকারীদের সুরক্ষিত শ্রোতা API সম্পূর্ণরূপে পুনরায় সেট করার ক্ষমতা আছে। এটি ঘটলে, ডিভাইসে বিদ্যমান যেকোনো কাস্টম দর্শক সাফ হয়ে যায়।
  • ব্যবহারকারীদের Android-এ গোপনীয়তা স্যান্ডবক্স থেকে সম্পূর্ণরূপে অপ্ট-আউট করার ক্ষমতা রয়েছে, যার মধ্যে রয়েছে সুরক্ষিত দর্শক API। যদি ব্যবহারকারী গোপনীয়তা স্যান্ডবক্স থেকে অপ্ট আউট করে থাকে, সুরক্ষিত দর্শক API নীরবে ব্যর্থ হয়৷

এই ক্ষমতার ডিজাইনের কাজ চলছে, এবং বিস্তারিত পরবর্তী আপডেটে অন্তর্ভুক্ত করা হবে।

অ্যাপের অনুমতি এবং নিয়ন্ত্রণ

প্রস্তাবটি তার কাস্টম শ্রোতাদের উপর অ্যাপস নিয়ন্ত্রণ প্রদান করতে চায়:

  • একটি অ্যাপ কাস্টম শ্রোতাদের সাথে তার অ্যাসোসিয়েশন পরিচালনা করতে পারে।
  • একটি অ্যাপ তার পক্ষ থেকে কাস্টম দর্শকদের পরিচালনা করার জন্য তৃতীয় পক্ষের বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলিকে অনুমতি দিতে পারে।

এই ক্ষমতার ডিজাইনের কাজ চলছে, এবং বিস্তারিত পরবর্তী আপডেটে অন্তর্ভুক্ত করা হবে।

বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম নিয়ন্ত্রণ

এই প্রস্তাবে বিজ্ঞাপন প্রযুক্তির জন্য তাদের কাস্টম শ্রোতাদের নিয়ন্ত্রণ করার উপায়গুলির রূপরেখা দেওয়া হয়েছে:

  • বিজ্ঞাপন প্রযুক্তিগুলি গোপনীয়তা স্যান্ডবক্সের সাথে নথিভুক্ত করে এবং একটি eTLD+1 ডোমেন প্রদান করে যা একটি কাস্টম দর্শকদের জন্য সমস্ত URL এর সাথে মেলে৷
  • বিজ্ঞাপন প্রযুক্তিগুলি যাচাইকরণ টোকেন প্রদান করতে অ্যাপ বা SDK-এর সাথে অংশীদার হতে পারে যা একটি কাস্টম দর্শক তৈরি যাচাই করতে ব্যবহৃত হয়। যখন এই প্রক্রিয়াটি একজন অংশীদারকে অর্পণ করা হয়, তখন কাস্টম অডিয়েন্স তৈরিকে কনফিগার করা যেতে পারে যাতে বিজ্ঞাপন প্রযুক্তির স্বীকৃতির প্রয়োজন হয়।
  • একটি বিজ্ঞাপন প্রযুক্তি তাদের তরফে joinCustomAudience কল নিষ্ক্রিয় করতে বেছে নিতে পারে এবং শুধুমাত্র fetchAndJoinCustomAudience API-কে সমস্ত কল কাস্টম দর্শকদের সক্ষম করার অনুমতি দেয়৷ গোপনীয়তা স্যান্ডবক্স তালিকাভুক্তির সময় নিয়ন্ত্রণ আপডেট করা যেতে পারে। নোট করুন নিয়ন্ত্রণটি সমস্ত বিজ্ঞাপন প্রযুক্তিকে অনুমতি দেয় বা কোনোটিই নয়। প্ল্যাটফর্মের সীমাবদ্ধতার কারণে, প্রতি বিজ্ঞাপন প্রযুক্তির ভিত্তিতে প্রতিনিধিদের অনুমতি দেওয়া যাবে না।

প্রার্থীর বিজ্ঞাপন এবং মেটাডেটা প্রতিক্রিয়া

বাই-সাইড প্ল্যাটফর্ম থেকে ফিরে আসা প্রার্থীর বিজ্ঞাপন এবং মেটাডেটাতে নিম্নলিখিত ক্ষেত্রগুলি অন্তর্ভুক্ত করা উচিত:

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

বিজ্ঞাপন নির্বাচন কর্মপ্রবাহ

এই প্রস্তাবের লক্ষ্য বিজ্ঞাপন নির্বাচন API প্রবর্তনের মাধ্যমে গোপনীয়তা উন্নত করা, যা বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মের জন্য নিলাম সম্পাদনের আয়োজন করে।

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

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

এই পদ্ধতিটি ব্যবহারকারীর অ্যাপ ইন্টারঅ্যাকশন ডেটাকে বিজ্ঞাপন নির্বাচন জানাতে সক্ষম করে, যখন তৃতীয় পক্ষের সাথে এই ডেটা ভাগাভাগি সীমিত করে।

ফ্লো চার্ট যা বিজ্ঞাপন নির্বাচনের কার্যপ্রবাহের সূচনা দেখায়।

এই বিজ্ঞাপন নির্বাচনের কার্যপ্রবাহটি নিম্নলিখিত ক্রম অনুসারে বিজ্ঞাপন প্রযুক্তি-প্রদত্ত জাভাস্ক্রিপ্ট কোডের অন-ডিভাইস এক্সিকিউশনকে অর্কেস্ট্রেট করে:

  1. বাই-সাইড বিডিং লজিক এক্সিকিউশন
  2. বাই-সাইড বিজ্ঞাপন ফিল্টারিং এবং প্রক্রিয়াকরণ
  3. সেল-সাইড ডিসিশন লজিক এক্সিকিউশন

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

কাস্টম শ্রোতাদের সাথে জড়িত নয় এমন বিজ্ঞাপন নির্বাচনের নকশা সক্রিয় ডিজাইনের অধীনে।

বিজ্ঞাপন নির্বাচনের কর্মপ্রবাহ শুরু করুন

যখন একটি অ্যাপকে একটি বিজ্ঞাপন দেখানোর প্রয়োজন হয়, তখন বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম SDK প্রত্যাশিত প্যারামিটার সহ AdSelectionConfig অবজেক্টকে ইনস্ট্যান্টিয়েট করার পরে selectAds() পদ্ধতিতে কল করে বিজ্ঞাপন নির্বাচনের কার্যপ্রবাহ শুরু করতে পারে:

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

নিম্নলিখিত উদাহরণমূলক কোড স্নিপেটটি একটি বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম SDK দেখায় যা প্রথমে AdSelectionConfig সংজ্ঞায়িত করে এবং তারপর বিজয়ী বিজ্ঞাপন পাওয়ার জন্য selectAds আহ্বান করে বিজ্ঞাপন নির্বাচনের কার্যপ্রবাহ শুরু করে:

AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig {
    Seller = "example-ssp1.com",
    DecisionLogicURL = Uri.parse("https://..."),
    CustomAudienceBuyerList = Arrays.asList("example-dsp1.com","bexample-dsp2.com"),
    AdSelectionSignals = "{"min_price": 10,"auction_attempts": 3}"
    SellerSignals = "{"seller_type": "news", "content_category": "sports","mature_ads_accepted" :"false"}"
    PerBuyerSignals = " {"buyer1Name": {"key1" : "value1"},
                         "buyer2Name": {"key1" : "value1", "key2" : "value2" }"
};

// Invoke ad services API to initiate ad selection workflow.
Ad winningAd = selectAds(myAdSelectionConfig);

বাই-সাইড বিডিং যুক্তি

বিডিং লজিক সাধারণত বাই-সাইড প্ল্যাটফর্ম দ্বারা প্রদান করা হয়। কোডের উদ্দেশ্য হল প্রার্থীর বিজ্ঞাপনের জন্য বিড নির্ধারণ করা। ফলাফল নির্ধারণ করতে এটি অতিরিক্ত ব্যবসায়িক যুক্তি প্রয়োগ করতে পারে।

প্ল্যাটফর্মটি কাস্টম দর্শকদের "বিডিং লজিক ইউআরএল" মেটাডেটা ব্যবহার করবে জাভাস্ক্রিপ্ট কোড আনার জন্য যাতে নিচের ফাংশন স্বাক্ষর অন্তর্ভুক্ত করা উচিত:

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ...};
}

generateBid() পদ্ধতি গণনাকৃত বিডের পরিমাণ ফেরত দেয়। প্ল্যাটফর্মটি ক্রমানুসারে সমস্ত বিজ্ঞাপনের (প্রসঙ্গগত বা পুনঃবিপণন) জন্য এই ফাংশনটি চালু করবে। যদি একাধিক বিডিং লজিক প্রোভাইডার থাকে, তাহলে সিস্টেমটি প্রদানকারীদের মধ্যে এক্সিকিউশন সিকোয়েন্সের গ্যারান্টি দেয় না।

ফাংশন নিম্নলিখিত পরামিতি আশা করে:

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

বিজ্ঞাপন খরচ

বিড ছাড়াও, বাই-সাইড প্ল্যাটফর্মগুলিতে generateBid() এর অংশ হিসাবে প্রতি ক্লিকে খরচ ফেরত দেওয়ার বিকল্প রয়েছে। উদাহরণ স্বরূপ:

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ..., 'adCost': ...,};
}

এই বিজ্ঞাপনটি বিজয়ী হলে, গোপনীয়তার জন্য adCost স্টোকাস্টিকভাবে 8 বিটে রাউন্ড করা হয়। adCost এর বৃত্তাকার মান তারপর ইম্প্রেশন রিপোর্টিংয়ের সময় reportWincontextual_signals প্যারামিটারে পাস করা হয়।

বাই-সাইড ফিল্টারিং যুক্তি

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

বাই-সাইড ফিল্টারিং যুক্তি একটি প্রদত্ত বিজ্ঞাপনের জন্য 0 এর একটি বিড মান ফিরিয়ে দিয়ে বিডিং যুক্তির অংশ হিসাবে প্রয়োগ করা যেতে পারে।

এর পাশাপাশি, বাই-সাইড প্ল্যাটফর্মগুলি সংকেত দিতে সক্ষম হবে যে প্রদত্ত বিজ্ঞাপনটি সুরক্ষিত দর্শকদের জন্য উপলব্ধ অতিরিক্ত অন-ডিভাইস সিগন্যালের ভিত্তিতে ফিল্টার করা উচিত এবং এটি ডিভাইসটি ছেড়ে যাবে না। যেহেতু আমরা অতিরিক্ত ফিল্টারিং লজিকের ডিজাইনকে দৃঢ় করি, বাই-সাইড প্ল্যাটফর্মগুলি ফিল্টারিং ঘটতে হবে তা সংকেত দিতে একই কাঠামো অনুসরণ করবে।

সেল-সাইড স্কোরিং যুক্তি

স্কোরিং লজিক সাধারণত সেল-সাইড প্ল্যাটফর্ম দ্বারা প্রদান করা হয়। কোডের উদ্দেশ্য হল বিডিং লজিক আউটপুটের উপর ভিত্তি করে একটি বিজয়ী বিজ্ঞাপন নির্ধারণ করা। ফলাফল নির্ধারণ করতে এটি অতিরিক্ত ব্যবসায়িক যুক্তি প্রয়োগ করতে পারে। একাধিক ডিসিশন লজিক প্রোভাইডার থাকলে, সিস্টেমটি প্রদানকারীদের মধ্যে এক্সিকিউশন সিকোয়েন্সের গ্যারান্টি দেয় না। প্ল্যাটফর্মটি JavaScript কোড আনার জন্য selectAds() API-এর "ডিসিশন লজিক URL" ইনপুট প্যারামিটার ব্যবহার করবে যাতে নিচের ফাংশন স্বাক্ষর অন্তর্ভুক্ত করা উচিত:

scoreAd(ad, bid, auction_config, trusted_scoring_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return score_for_this_ad;
}

ফাংশন নিম্নলিখিত পরামিতি আশা করে:

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

বিজ্ঞাপন নির্বাচন কোড রানটাইম

প্রস্তাবে, সিস্টেম কনফিগারযোগ্য URL এন্ডপয়েন্ট থেকে বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম-প্রদত্ত নিলাম কোড আনবে এবং ডিভাইসে কার্যকর করবে। মোবাইল ডিভাইসে সম্পদের সীমাবদ্ধতার পরিপ্রেক্ষিতে, নিলাম কোড নিম্নলিখিত নির্দেশিকাগুলি মেনে চলা উচিত:

  • কোডটি পূর্বনির্ধারিত সময়ের মধ্যে কার্যকর করা শেষ করা উচিত। এই আবদ্ধ সমস্ত ক্রেতা বিজ্ঞাপন নেটওয়ার্কের জন্য অভিন্নভাবে প্রযোজ্য হবে. এই আবদ্ধের বিবরণ পরবর্তী আপডেটে শেয়ার করা হবে।
  • কোডটি অবশ্যই স্বয়ংসম্পূর্ণ হতে হবে এবং কোনো বাহ্যিক নির্ভরতা থাকবে না।

যেহেতু নিলাম কোড, যেমন বিডিং লজিকের জন্য ব্যক্তিগত ব্যবহারকারীর ডেটা যেমন অ্যাপ ইনস্টল উত্সগুলিতে অ্যাক্সেসের প্রয়োজন হতে পারে, রানটাইম নেটওয়ার্ক বা স্টোরেজ অ্যাক্সেস প্রদান করবে না।

প্রোগ্রাম ভাষা

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

বিজয়ী বিজ্ঞাপন রেন্ডারিং

সর্বোচ্চ স্কোর সহ বিজ্ঞাপনটি নিলামের বিজয়ী বলে বিবেচিত হয়। এই প্রাথমিক প্রস্তাবে, বিজয়ী বিজ্ঞাপন রেন্ডারিংয়ের জন্য SDK-এ পাস করা হয়।

ব্যবহারকারীর কাস্টম অডিয়েন্স মেম্বারশিপ, বা অ্যাপ এনগেজমেন্টের ইতিহাস, বিজয়ী বিজ্ঞাপনের (Chrome-এর বেড়াযুক্ত ফ্রেমের প্রস্তাবের মতো) তথ্যের মাধ্যমে অ্যাপ বা SDK দ্বারা নির্ধারিত করা যাবে না তা নিশ্চিত করার জন্য সমাধানটি উদ্ভাবন করা।

ইমপ্রেশন এবং ইভেন্ট রিপোর্টিং

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

  1. সেল-সাইড রিপোর্টিং।
  2. বাই-সাইড রিপোর্টিং।

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

ইভেন্ট রিপোর্টিংকে সমর্থন করার জন্য দুটি ধাপ প্রয়োজন: সেল-সাইড এবং বাই-সাইড জাভাস্ক্রিপ্ট রেজিস্টার করতে হবে কোন ইভেন্টের জন্য ইভেন্ট রিপোর্ট পেতে হবে এবং সেল-সাইড ইভেন্ট-স্তরের তথ্য রিপোর্ট করার জন্য দায়ী।

সুরক্ষিত শ্রোতা বীকন নিবন্ধন করে বিজয়ী নিলামের সাথে সম্পর্কিত ভবিষ্যতের ইভেন্টগুলিতে সদস্যতা নেওয়ার একটি প্রক্রিয়া সরবরাহ করে। একজন বিক্রেতার reportResult() জাভাস্ক্রিপ্ট ফাংশনে, সেল-সাইড প্ল্যাটফর্ম প্ল্যাটফর্মের registerAdBeacon() ফাংশন ব্যবহার করে বীকন নিবন্ধন করতে পারে। একইভাবে, বাই-সাইড প্ল্যাটফর্মগুলি তাদের reportWin() JavaScript ফাংশন থেকে registerAdBeacon() পদ্ধতিতে কল করতে পারে।

registerAdBeacon(beacons)

ইনপুট:

  • event_key : একটি স্ট্রিং নির্দেশ করে যে কোন ধরনের ইন্টারঅ্যাকশনের জন্য নিবন্ধন করতে হবে। নিলামের ফলাফলের রিপোর্ট করার সময় প্ল্যাটফর্মের পিংসের শেষ বিন্দুটি দেখার জন্য এটি একটি কী হিসাবে ব্যবহৃত হয়।
  • reporting_url : ইভেন্ট পরিচালনার জন্য বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মের মালিকানাধীন URL।

ইভেন্ট কীগুলি হল স্ট্রিং শনাক্তকারী যা নিলামের ফলাফল রিপোর্ট করার জন্য দায়ী বিক্রয়-সাইড SDK-এর মালিকানাধীন৷ একটি কলব্যাক করার জন্য, বিজ্ঞাপন প্রযুক্তিগুলি ইভেন্টগুলি রিপোর্ট করার সময় সেল-সাইড দ্বারা ব্যবহৃত কীগুলির সাথে মেলে এমন কীগুলির সাথে বীকনগুলি নিবন্ধন করে৷ এগুলি কে-বেনামী হওয়ার দরকার নেই, যদিও প্রদত্ত কাস্টম দর্শকদের জন্য নিবন্ধিত হতে পারে এমন কীগুলির পরিমাণ এবং দৈর্ঘ্যের সীমা রয়েছে৷ যদি reportEvent() কল করা হয়, নিলাম চালানোর জন্য বিক্রয়-সাইড প্ল্যাটফর্মগুলি সর্বদা এই ইভেন্ট রিপোর্টগুলি পাওয়ার যোগ্য। শুধুমাত্র বিজয়ী বাই-সাইড প্ল্যাটফর্ম এই রিপোর্টগুলি পাওয়ার যোগ্য৷

সেল-সাইড রিপোর্টিং

প্ল্যাটফর্মটি selectAds() API-এর জন্য বিক্রেতার সিদ্ধান্ত লজিক ইউআরএল প্যারামিটার থেকে ডাউনলোড করা সাপ্লাই সাইড-প্রদত্ত কোডে reportResult() JavaScript ফাংশন চালু করে:

reportResult(render_url, bid, auction_config, contextual_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_url": reporting_url,
                  "signals_for_buyer": signals_for_buyer}};
}

আউটপুট: একটি JSON অবজেক্ট ধারণকারী

  • স্থিতি: সাফল্যের জন্য 0 , ব্যর্থতার জন্য অন্য কোনো মান।
  • রিপোর্টিং ইউআরএল: প্ল্যাটফর্মটি ফাংশন থেকে ফিরে আসা এই ইউআরএলকে আহ্বান করে।
  • ক্রেতার জন্য সংকেত: একটি JSON অবজেক্ট ক্রেতার reportWin ফাংশনে পাঠানো হবে।

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

  • বিজ্ঞাপন রেন্ডার URL
  • বিজয়ী দর পরিমাণ
  • অ্যাপ্লিকেশন নাম
  • ক্যোয়ারী শনাক্তকারী
  • ক্রেতার জন্য সংকেত: সাপ্লাই সাইড এবং ডিমান্ড সাইডের মধ্যে ডাটা শেয়ারিংকে সমর্থন করার জন্য, প্ল্যাটফর্ম এই রিটার্ন ভ্যালুকে ডিমান্ড সাইড রিপোর্টিং কোডে ইনপুট প্যারামিটার হিসেবে পাস করে।

বাই-সাইড রিপোর্টিং

প্ল্যাটফর্মটি নিলামের সাথে যুক্ত কাস্টম দর্শকদের বিডিং লজিক ইউআরএল মেটাডেটা থেকে ডাউনলোড করা ডিমান্ড সাইড-প্রদত্ত কোডে reportWin() JavaScript ফাংশনকে আহ্বান করে।

reportWin(render_url, bid, auction_signals, per_buyer_signals,
        signals_for_buyer, contextual_signals, custom_audience_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_uri": reporting_uri}};
}

ইনপুট:

  • auction_signals এবং per_buyer_signals AuctionConfig থেকে আনা হয়। বাই-সাইড প্ল্যাটফর্মের রিপোর্টিং ইউআরএলে পাস করার প্রয়োজন এমন যেকোন তথ্য এই ডেটাম থেকে আসতে পারে।
  • signals_for_buyer হল সেল-সাইড রিপোর্টের ফলাফলের আউটপুট। এটি প্রতিবেদনের উদ্দেশ্যে বাই-সাইড প্ল্যাটফর্মের সাথে ডেটা ভাগ করার সুযোগ সহ বিক্রয়-সাইড প্ল্যাটফর্ম প্রদান করে।
  • contextual_signals অ্যাপের নামের মতো তথ্য থাকে এবং custom_audience_signals কাস্টম দর্শকের তথ্য থাকে। অন্যান্য তথ্য ভবিষ্যতে যোগ করা যেতে পারে.

আউটপুট:

  • স্থিতি: সাফল্যের জন্য 0 , ব্যর্থতার জন্য অন্য কোনো মান।
  • রিপোর্টিং ইউআরএল: প্ল্যাটফর্মটি ফাংশন থেকে ফিরে আসা এই ইউআরএলকে আহ্বান করে।

রিপোর্টিং ঘটনা

নিলামের জন্য ইম্প্রেশন রিপোর্টিং সম্পূর্ণ হওয়ার পরেই ইভেন্টের প্রতিবেদন করা সম্ভব। সেল-সাইড SDK কোনো ইভেন্ট রিপোর্ট করার জন্য দায়ী। প্ল্যাটফর্মটি এমন একটি API প্রকাশ করে যা একটি ReportEventRequest নেয় যা সম্প্রতি চালানো নিলাম, রিপোর্ট করা ইভেন্ট কী, সেই কী-এর সাথে সম্পর্কিত ডেটা, প্রতিবেদনটি ক্রেতা বা বিক্রেতার কাছে পাঠানো উচিত কিনা (বা উভয়ই) এবং একটি ঐচ্ছিক বিজ্ঞাপন ইভেন্টের জন্য ইনপুট ইভেন্ট। ক্লায়েন্ট ইভেন্ট কী এবং রিপোর্ট করার জন্য ডেটা সংগ্রহকে সংজ্ঞায়িত করে।

ReportEventRequest request = new ReportEventRequest(
  AdSelectionId = ad_selection_id,
  event_key = "view"
  event_data = "{ "viewTimeInSeconds" :1 }",
  reporting_destinations =
    FLAG_REPORTING_DESTINATION_SELLER |
      FLAG_REPORTING_DESTINATION_BUYER,
  input_event = clickInputEvent // or null for view
  )

reportEvent(request)

ইনপুট:

  • ad_selection_id AdSelectionOutcome থেকে পুনরুদ্ধার করা সম্প্রতি চালানো নিলামের একটি AdSelectionId হতে হবে।
  • event_key একটি বিক্রয়-সাইড সংজ্ঞায়িত স্ট্রিং যা মিথস্ক্রিয়া ঘটনা বর্ণনা করে।
  • event_data হল একটি স্ট্রিং যা event_key এর সাথে সম্পর্কিত ডেটা উপস্থাপন করে
  • reporting_destinations হল প্ল্যাটফর্ম দ্বারা প্রদত্ত পতাকা ব্যবহার করে একটি বিট মাস্ক সেট। এটি FLAG_REPORTING_DESTINATION_SELLER বা FLAG_REPORTING_DESTINATION_BUYER বা উভয়ের একটি হতে পারে৷
  • input_event (ঐচ্ছিক) অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে একীকরণের জন্য ব্যবহার করা হয়। এটি হয় একটি InputEvent অবজেক্ট (একটি ক্লিক ইভেন্টের জন্য) অথবা নাল (একটি ভিউ ইভেন্টের জন্য)। এই প্যারামিটার সম্পর্কে আরও বিশদ বিবরণের জন্য অ্যাট্রিবিউশন রিপোর্টিং API ইন্টিগ্রেশন দেখুন।

সেল-সাইড SDK reportEvent আহ্বান করার পরে এবং reporting_destinations পতাকার উপর নির্ভর করে, প্ল্যাটফর্মটি তাদের reportWin এবং reportResult জাভাস্ক্রিপ্ট ফাংশনে ক্রেতা এবং বিক্রেতাদের দ্বারা নিবন্ধিত কীগুলির সাথে event_key সাথে মিল করার চেষ্টা করে। কোনো মিল থাকলে, প্ল্যাটফর্ম event_data সংশ্লিষ্ট reporting_url এ পোস্ট করে। অনুরোধের বিষয়বস্তুর ধরন হল প্লেইন টেক্সট যার মূল অংশ হল event_data । এই অনুরোধটি সর্বোত্তম প্রচেষ্টা হিসাবে করা হয় এবং একটি নেটওয়ার্ক ত্রুটি, সার্ভার ত্রুটি প্রতিক্রিয়া, বা কোন মিলিত কী পাওয়া না গেলে নীরবে ব্যর্থ হয়।

অ্যাট্রিবিউশন রিপোর্টিং API ইন্টিগ্রেশন

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

এই ক্রস-এপিআই ইন্টিগ্রেশনের মাধ্যমে, অ্যাডটেকগুলি করতে পারে:

  • 1) বিজ্ঞাপন ইন্টারঅ্যাকশন রিপোর্টিং এবং 2) উত্স নিবন্ধন উভয়ের জন্য ব্যবহার করার জন্য URI-এর একটি মূল-মান মানচিত্র তৈরি করুন৷
  • সংরক্ষিত শ্রোতা নিলাম থেকে নিলাম ডেটা অন্তর্ভুক্ত করুন তাদের উৎস-সাইড কী ম্যাপিং-এ সামগ্রিক সারাংশ প্রতিবেদনের জন্য (অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে) আরও তথ্যের জন্য ARA ডিজাইন প্রস্তাব দেখুন।

যখন একজন ব্যবহারকারী একটি বিজ্ঞাপন দেখেন বা ক্লিক করেন:

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

উৎস নিবন্ধন সক্ষম করা হচ্ছে

reportEvent() একটি নতুন ঐচ্ছিক প্যারামিটার InputEvent গ্রহণ করবে। বিজয়ী ক্রেতা যারা বিজ্ঞাপন বীকন নিবন্ধন করেন তারা নির্বাচন করতে পারেন কোন রিপোর্ট ইভেন্ট রিপোর্টগুলি নিবন্ধিত উত্স হিসাবে অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে নিবন্ধিত হবে৷ reportEvent() থেকে প্রেরিত সমস্ত ইভেন্ট রিপোর্টিং অনুরোধে অনুরোধ শিরোনাম Attribution-Reporting-Eligible যোগ করা হবে। উপযুক্ত ARA শিরোনাম সহ যেকোনো প্রতিক্রিয়া একইভাবে পার্স করা হবে যেভাবে অন্য যেকোন নিয়মিত ARA উৎস নিবন্ধন প্রতিক্রিয়া। কিভাবে একটি উৎস URL নিবন্ধন করতে হয় তার জন্য অ্যাট্রিবিউশন রিপোর্টিং API ব্যাখ্যাকারী দেখুন।

যেহেতু অ্যান্ড্রয়েডের ARA ইভেন্টগুলি দেখতে এবং ক্লিক করতে সমর্থন করে, তাই InputEvents দুটি প্রকারের মধ্যে পার্থক্য করতে ব্যবহৃত হয়৷ ঠিক যেমন ARA সোর্স রেজিস্ট্রেশনে, reportEvent() এপিআই একটি প্ল্যাটফর্ম-যাচাইকৃত InputEvent ক্লিক ইভেন্ট হিসেবে ব্যাখ্যা করবে। যদি InputEvent অনুপস্থিত, শূন্য, বা অবৈধ, উৎস নিবন্ধন একটি দৃশ্য হিসাবে বিবেচিত হবে.

মনে রাখবেন নিলাম-পরবর্তী eventData সংবেদনশীল তথ্য থাকতে পারে, তাই প্ল্যাটফর্মটি eventData রিডাইরেক্ট করা সোর্স রেজিস্ট্রেশনের অনুরোধে ফেলে দেয়।

প্রবৃত্তি এবং রূপান্তর রিপোর্টিং উদাহরণ

এই উদাহরণে, আমরা এটিকে ক্রেতার দৃষ্টিকোণ থেকে দেখব যারা নিলাম, রেন্ডার করা বিজ্ঞাপন এবং রূপান্তর অ্যাপ থেকে ডেটা যুক্ত করতে আগ্রহী।

এই কর্মপ্রবাহে, ক্রেতা নিলামে একটি অনন্য আইডি পাঠাতে বিক্রেতার সাথে সমন্বয় করে। নিলামের সময়, ক্রেতা নিলামের তথ্য সহ এই অনন্য আইডি পাঠান। রেন্ডার এবং রূপান্তরের সময়, রেন্ডার করা বিজ্ঞাপন থেকে ডেটাও একই অনন্য আইডি দিয়ে পাঠানো হয়। পরবর্তীতে, ইউনিক আইডি এই রিপোর্টগুলিকে একসাথে যুক্ত করতে ব্যবহার করা যেতে পারে।

কর্মপ্রবাহ: নিলাম শুরু হওয়ার আগে, ক্রেতা তাদের প্রোগ্রামেটিক রিয়েল-টাইম বিডিং ("RTB") বিড প্রতিক্রিয়ার অংশ হিসাবে বিক্রেতার কাছে একটি অনন্য ID পাঠায়। ID auctionId মত একটি পরিবর্তনশীল হিসাবে সেট করা যেতে পারে। আইডিটি auctionConfig perBuyerSignals হিসাবে পাস করা হয় এবং এটি ক্রেতার বিডিং যুক্তিতে উপলব্ধ হয়।

  1. reportWin কার্যকর করার সময়, ক্রেতা বিজ্ঞাপন রেন্ডারের সময় এবং নির্দিষ্ট ইন্টারঅ্যাকশন ইভেন্টগুলির জন্য ( registerAdBeacon() ) ট্রিগার করার জন্য একটি বিজ্ঞাপন বীকন নিবন্ধন করতে পারেন। একটি বিজ্ঞাপন ইভেন্টের জন্য নিলাম সংকেত সংযুক্ত করতে, বীকন URL-এর একটি ক্যোয়ারী প্যারাম হিসাবে auctionId সেট করুন৷
  2. বিজ্ঞাপন রেন্ডারের সময়, নিলামের সময় আপনার নিবন্ধিত বীকনগুলি ইভেন্ট-স্তরের ডেটা দিয়ে ট্রিগার বা উন্নত করা যেতে পারে। বিক্রেতাকে অবশ্যই reportEvent() ট্রিগার করতে হবে এবং ইভেন্ট-স্তরের ডেটাতে পাস করতে হবে। প্ল্যাটফর্মটি ক্রেতার নিবন্ধিত বিজ্ঞাপন বীকন ইউআরএলে পিং করবে যা reportEvent() যেটি ট্রিগার করা হয়েছিল তার সাথে সম্পর্কযুক্ত।
  3. ক্রেতা অ্যাট্রিবিউশন Attribution-Reporting-Register-Source রিপোর্টিং API-এর সাথে বিজ্ঞাপনটি নিবন্ধন করবেন। একটি রূপান্তর ইভেন্টের জন্য নিলাম সংকেত সংযুক্ত করতে, নিবন্ধন উৎস URL-এ auctionId সেট করুন৷

উপরোক্ত প্রক্রিয়ার পরে, ক্রেতার কাছে একটি নিলাম প্রতিবেদন, মিথস্ক্রিয়া প্রতিবেদন এবং রূপান্তর প্রতিবেদন থাকবে, যা একে অপরের সাথে যুক্ত হতে ব্যবহার করা অনন্য আইডি ব্যবহার করে সম্পর্কযুক্ত হতে পারে।

অনুরূপ কর্মপ্রবাহ একজন বিক্রেতার ক্ষেত্রে প্রযোজ্য হয় যদি তার অ্যাট্রিবিউশন ডেটাতে অ্যাক্সেসের প্রয়োজন হয় এবং বিক্রেতাও registerAdBeacon() এর সাথে পাঠাতে একটি অনন্য আইডি ব্যবহার করতে পারেন। reportEvent() কলটিতে একটি গন্তব্য সম্পত্তি রয়েছে যা ক্রেতা এবং বিক্রেতা উভয়কেই প্রতিবেদন পাঠাতে ব্যবহার করা যেতে পারে।

বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্ম বিশ্বস্ত সার্ভার পরিচালিত

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

  • এই সার্ভারের আচরণ, এই বিভাগে পরে বর্ণিত, ব্যবহারকারীর তথ্য ফাঁস করবে না।
  • সার্ভারগুলি যে ডেটা দেখে তার উপর ভিত্তি করে ছদ্মনাম প্রোফাইল তৈরি করবে না, অর্থাৎ এটিকে 'বিশ্বস্ত' হতে হবে।

বাই সাইড : একবার বাই সাইড বাই সাইড বিডিং লজিক শুরু করলে, প্ল্যাটফর্ম বিশ্বস্ত সার্ভার থেকে বিশ্বস্ত বিডিং ডেটা একটি HTTP আনয়ন করে। প্রসেস করা কাস্টম অডিয়েন্সের বিশ্বস্ত বিডিং সিগন্যাল মেটাডেটাতে উপস্থিত URL এবং কী যুক্ত করে ইউআরএলটি তৈরি করা হয়েছে। ডিভাইসের কাস্টম শ্রোতা থেকে বিজ্ঞাপনগুলি প্রক্রিয়া করার সময়ই এই আনয়ন করা হয়৷ এই পর্যায়ে, বাই সাইড বাজেট প্রয়োগ করতে পারে, প্রচারাভিযান পজ/আনপজ স্টেট চেক করতে পারে, টার্গেটিং সম্পাদন করতে পারে ইত্যাদি।

কাস্টম দর্শকদের কাছ থেকে বিশ্বস্ত বিডিং সিগন্যাল মেটাডেটার উপর ভিত্তি করে বিশ্বস্ত বিডিং ডেটা আনার জন্য নীচে একটি নমুনা URL রয়েছে:

https://www.kv-server.example/getvalues?keys=key1,key2

সার্ভার থেকে প্রতিক্রিয়া একটি JSON অবজেক্ট হওয়া উচিত যার কীগুলি হল key1, key2, ইত্যাদি এবং যার মানগুলি ক্রেতার বিডিং ফাংশনগুলিতে উপলব্ধ করা হবে৷

সেল সাইড : উপরের বাই সাইড ফ্লো অনুরূপ, বিক্রয় পক্ষ নিলামে বিবেচিত ক্রিয়েটিভ সম্পর্কে তথ্য আনতে চাইতে পারে। উদাহরণস্বরূপ, একজন প্রকাশক ব্র্যান্ড নিরাপত্তা উদ্বেগের ভিত্তিতে তাদের অ্যাপে কিছু ক্রিয়েটিভ দেখানো হয় না তা প্রয়োগ করতে চাইতে পারেন। এই তথ্য আনা এবং বিক্রয় পার্শ্ব নিলাম যুক্তি উপলব্ধ করা যেতে পারে. বাই সাইড ট্রাস্টেড সার্ভার লুকআপের মতো, সেল সাইড ট্রাস্টেড সার্ভার লুকআপও HTTP আনার মাধ্যমে হয়। ইউআরএলটি ট্রাস্টেড স্কোরিং সিগন্যাল ইউআরএল-এর সাথে ক্রিয়েটিভের রেন্ডার ইউআরএল যুক্ত করে তৈরি করা হয়েছে যার জন্য ডেটা আনতে হবে।

সৃজনশীল রেন্ডার ইউআরএলের উপর ভিত্তি করে নিলামে বিবেচিত ক্রিয়েটিভ সম্পর্কে তথ্য আনার জন্য নীচে একটি নমুনা URL রয়েছে:

https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2

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

এই সার্ভারগুলি বিভিন্ন নিরাপত্তা এবং গোপনীয়তা সুবিধা প্রদানের জন্য একটি বিশ্বস্ত উপায়ে কাজ করবে:

  • প্রতিটি কীর জন্য সার্ভারের রিটার্ন মান শুধুমাত্র সেই কীটির উপর ভিত্তি করে বিশ্বাস করা যেতে পারে।
  • সার্ভার ইভেন্ট-স্তরের লগিং সঞ্চালন করে না।
  • এই অনুরোধগুলির উপর ভিত্তি করে সার্ভারের অন্য কোন পার্শ্ব প্রতিক্রিয়া নেই।

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

ক্রেতা এবং বিক্রেতারা Android এবং ওয়েবের জন্য গোপনীয়তা স্যান্ডবক্সের সাথে সামঞ্জস্যপূর্ণ প্ল্যাটফর্মগুলির জন্য একটি সাধারণ বিশ্বস্ত কী-মান-টাইপ সার্ভার ব্যবহার করতে পারে৷