প্রোটেক্টেড অডিয়েন্স 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 সহ) দ্বারা অর্জন করা যেতে পারে যা ব্যবহারকারীর জন্য একটি বিজয়ী বিজ্ঞাপন নির্বাচন করার জন্য বিজ্ঞাপন নির্বাচন এপিআইকে আহ্বান করে যে কোনো দর্শক তালিকার উপর ভিত্তি করে তারা একটি অংশ হতে পারে (এই উদাহরণে, "কার্টে পণ্য" কাস্টম দর্শক 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 নীরবে ব্যর্থ হয়৷

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

নির্ধারিত আপডেট

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

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

/**
* API To schedule delayed update events for Custom Audience
*
* @param request Criteria that determine when and where to trigger a call to a
* DSP endpoint to update one or more Custom Audiences
*/

public void scheduleCustomAudienceUpdate(
    @NonNull ScheduleCustomAudienceUpdateRequest request,
    @NonNull @CallBackExecutor Executor executor,
    @NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)

সময়সূচী কাস্টম শ্রোতা আপডেটের অনুরোধ

public final class ScheduleCustomAudienceUpdateRequest {
  // Required Field
  @NonNull public Uri getUpdateUri() {
    return mUpdateUri;
  }

  // Required Field
  @NonNull public Duration getMinDelay() {
    return mMinDelay;
  }

  //  Required Field
  @NonNull public List<PartialCustomAudience> getPartialCustomAudienceList() {
    return mPartialCustomAudiences;
  }

  //  Optional Field (default false)
  public boolean shouldReplacePendingUpdates () {
    return mShouldReplacePendingUpdates;
  }
}

ScheduleCustomAudienceUpdateRequest এ প্ল্যাটফর্মের সাথে চালানোর জন্য বিলম্বিত কাজ নিবন্ধনের জন্য প্রয়োজনীয় তথ্য রয়েছে। নির্দিষ্ট বিলম্বের পরে, একটি ব্যাকগ্রাউন্ড জব পর্যায়ক্রমে চলবে এবং অনুরোধ(গুলি) পাঠাবে৷ ScheduleCustomAudienceUpdateRequest এ নিম্নলিখিত তথ্য থাকতে পারে:

  • UpdateUri : URI এন্ডপয়েন্ট যা আপডেট আনতে একটি GET কল পাঠানো হবে। ক্রেতার পরিচয় ইটিএলডি+1 থেকে অভ্যন্তরীণভাবে অনুমান করা হয়েছে এবং স্পষ্টভাবে প্রদান করার প্রয়োজন নেই এবং আপডেট প্রতিক্রিয়া দ্বারা পরিবর্তন করা যাবে না। GET অনুরোধের বিনিময়ে customAudience অবজেক্টের একটি তালিকা ধারণকারী একটি JSON অবজেক্ট আশা করে।
  • বিলম্বের সময় : scheduleCustomAudienceUpdate() এপিআই কল করার সময় থেকে আপডেটের সময়সূচী করার সময় থেকে বিলম্ব বোঝায়।
  • আংশিক কাস্টম অডিয়েন্স : এপিআই ডিভাইসে SDK-কে আংশিকভাবে তৈরি কাস্টম অডিয়েন্সের একটি তালিকা পাঠাতেও অনুমতি দেয়। এটি অ্যাপ-মধ্যস্থ SDK-কে DSP-এর সাথে তাদের অংশীদারিত্বের ভিত্তিতে কাস্টম অডিয়েন্স ম্যানেজমেন্টের উপর সম্পূর্ণ থেকে আংশিক নিয়ন্ত্রণে দ্বৈত ভূমিকা পালন করার অনুমতি দেয়।

    • এটি এই API-কে fetchAndJoinCustomAudience() API-এর সাথে সামঞ্জস্যপূর্ণ রাখে যা অনুরূপ তথ্য ভাগ করে নেওয়ার অনুমতি দেয়।
  • ShouldReplacePendingUpdates : বুলিয়ান যা নির্ধারণ করে যে কোনো মুলতুবি থাকা নির্ধারিত আপডেট বাতিল করা হবে এবং বর্তমান ScheduleCustomAudienceUpdateRequest এ বিস্তারিত আপডেটের সাথে প্রতিস্থাপিত হবে কিনা। যদি এটি false সেট করা হয় এবং একই অ্যাপে একই ক্রেতার জন্য পূর্বে অনুরোধ করা আপডেটগুলি এখনও মুলতুবি থাকে, তাহলে এই ScheduleCustomAudienceUpdateRequest এর সাথে নির্ধারিত scheduleCustomAudienceUpdate একটি কল ব্যর্থ হবে৷ ডিফল্ট থেকে false

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

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

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

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

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

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

  • বিজ্ঞাপন প্রযুক্তিগুলি গোপনীয়তা স্যান্ডবক্সের সাথে নথিভুক্ত করে এবং একটি 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() জাভাস্ক্রিপ্ট ফাংশন থেকে registerAdBeacon() পদ্ধতিটি কল করতে পারে।

registerAdBeacon(beacons)

ইনপুট:

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

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

বিক্রয়-পক্ষের প্রতিবেদন

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

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}};
}

আউটপুট: একটি জসন অবজেক্টযুক্ত

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

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

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

কিনুন-সাইড রিপোর্টিং

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

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 সাফল্যের জন্য, ব্যর্থতার জন্য অন্য কোনও মান।
  • রিপোর্টিং ইউআরএল: প্ল্যাটফর্মটি এই ইউআরএলটি ফাংশন থেকে ফিরে আসে।

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

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

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 (al চ্ছিক) অ্যাট্রিবিউশন রিপোর্টিং এপিআইয়ের সাথে সংহতকরণের জন্য ব্যবহৃত হয়। এটি হয় একটি InputEvent অবজেক্ট (একটি ক্লিক ইভেন্টের জন্য) বা নাল (কোনও ভিউ ইভেন্টের জন্য)। এই প্যারামিটারে আরও তথ্যের জন্য অ্যাট্রিবিউশন রিপোর্টিং এপিআই ইন্টিগ্রেশন দেখুন।

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

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

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

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

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

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

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

উত্স নিবন্ধকরণ সক্ষম করা

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

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

দ্রষ্টব্য পোস্ট-নিলাম eventData সংবেদনশীল তথ্য থাকতে পারে, সুতরাং প্ল্যাটফর্মটি পুনঃনির্দেশিত উত্স নিবন্ধকরণের অনুরোধগুলিতে eventData ফেলে দেয়।

বাগদান এবং রূপান্তর প্রতিবেদনের উদাহরণ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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