সুরক্ষিত শ্রোতা: ইন্টিগ্রেশন গাইড

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

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

সুরক্ষিত দর্শক ইন্টিগ্রেশন ওয়ার্কফ্লোতে বিভিন্ন ধরণের বিজ্ঞাপন প্রযুক্তি অংশীদারদের দ্বারা পরিচালিত 4টি মূল ধাপ রয়েছে:

1. ক্রেতা কাস্টম দর্শক তৈরি করে।
2. বিজ্ঞাপন নির্বাচন প্রক্রিয়া একটি বিজয়ী বিজ্ঞাপন নির্বাচন করে।
   1. বিক্রেতার অ্যাপ বিজ্ঞাপন নির্বাচন শুরু করে।
   2. বিজ্ঞাপন পরিষেবাগুলি বাই-সাইড ফিল্টারিং এবং বিডিং কোড কার্যকর করে।
   3. বিজ্ঞাপন পরিষেবাগুলি বিক্রয়-পক্ষের সিদ্ধান্ত কোড কার্যকর করে।
3. বিজয়ী বিজ্ঞাপনটি বিক্রেতার অ্যাপে রেন্ডার করা হয়।
4. বিজ্ঞাপনের ছাপের প্রতিবেদন ক্রেতা এবং বিক্রেতা উভয়ের জন্যই উপলব্ধ করা হয়।

নিম্নলিখিত চিত্রটি এই পদক্ষেপগুলি চিত্রিত করে:

পরিভাষা

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

পূর্বশর্ত, ইন্টিগ্রেশন পার্টনার এনগেজমেন্ট এবং সেটআপ

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

সুরক্ষিত শ্রোতাদের সাথে পরিচিত হন

প্রথম ধাপ হল Protected Audience API এবং পরিষেবাগুলির সাথে নিজেকে পরিচিত করা।

1. প্রোটেক্টেড অডিয়েন্স এপিআই এবং এর ক্ষমতা সম্পর্কে নিজেকে পরিচিত করার জন্য ডিজাইন প্রস্তাবটি পড়ে শুরু করুন।
2. আপনার ব্যবহারের ক্ষেত্রে প্রয়োজনীয় কোড এবং API কলগুলি এবং Protected Audience-এর সাথে একীভূত করার জন্য প্রয়োজনীয় পরিষেবাগুলি কীভাবে অন্তর্ভুক্ত করবেন তা জানতে ডেভেলপার নির্দেশিকাটি পড়ুন।
3. সুরক্ষিত শ্রোতা API, পরিষেবা এবং ডকুমেন্টেশনের নকশা এবং বাস্তবায়ন সম্পর্কে প্রতিক্রিয়া জমা দিন ।
4. সর্বশেষ প্রাইভেসি স্যান্ডবক্স বৈশিষ্ট্য সম্পর্কে আপডেট পেতে সাইন আপ করুন ।

নমুনা অ্যাপ সেট আপ করুন এবং পরীক্ষা করুন

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

1. যখন আপনি আপনার ইন্টিগ্রেশন শুরু করার জন্য প্রস্তুত হন, তখন সর্বশেষ প্রাইভেসি স্যান্ডবক্স ডেভেলপার প্রিভিউ দিয়ে আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করুন।
2. প্রয়োজনীয় সার্ভার এন্ডপয়েন্ট সেট আপ করুন। এই প্রক্রিয়াটি বুটস্ট্র্যাপ করতে আপনার পছন্দের API টেস্টিং সলিউশনের সাথে নমুনা মক ব্যবহার করুন।
3. কাস্টম দর্শক ব্যবস্থাপনা, বিজ্ঞাপন নির্বাচন কর্মপ্রবাহ এবং ইম্প্রেশন রিপোর্টিংয়ের সাথে নিজেকে পরিচিত করতে আমাদের নমুনা অ্যাপে কোডটি তৈরি করুন এবং চালান।

ইন্টিগ্রেশন পার্টনার এনগেজমেন্ট

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

বিটা সেটআপ (চতুর্থ প্রান্তিকে উপলব্ধ)

Android-এ Privacy Sandbox-এর মাধ্যমে আপনার প্রতিষ্ঠানের নাম নথিভুক্ত করুন । বিজ্ঞাপন প্রযুক্তি ডেভেলপাররা Privacy Sandbox-এর নীতিমালার মধ্যে কাজ করে এবং বিজ্ঞাপন প্রযুক্তি ডেভেলপারদের একাধিক SDK এবং ডোমেন জুড়ে তাদের পরিচয় সংজ্ঞায়িত করার সুযোগ দেয় তা নিশ্চিত করার জন্য তালিকাভুক্তি প্রয়োজন।

স্থাপত্য বিবেচনা

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

দর্শক এবং পুনঃবিপণন বিজ্ঞাপনগুলি ডিভাইসে সংরক্ষণ করা হয়

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

ডিভাইসে বিডিং এবং নিলাম প্রক্রিয়াগুলি ঘটে

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

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

ডেটা কৌশল

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

আপনার সমাধান তৈরি করুন

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

ক্রেতা: দর্শক তৈরি করা

ক্রেতারা সাধারণত কাস্টম অডিয়েন্স পরিচালনা করেন। যেহেতু কাস্টম অডিয়েন্স ডিভাইসে পরিচালিত হয়, তাই কাস্টম অডিয়েন্স পরিচালনার API ডিভাইসে ব্যবহার করার জন্য ডিজাইন করা হয়েছে।

যদি আপনার বিজ্ঞাপনদাতাদের অ্যাপে নিজস্ব SDK থাকে, তাহলে আপনি joinCustomAudience() ব্যবহার করে সরাসরি এই কোডটি বাস্তবায়ন করতে পারেন।

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

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

প্রোটোটাইপ পুনঃবিপণন প্রচারণা: একটি কাস্টম দর্শক তৈরি করুন

কাস্টম অডিয়েন্স হলো একই রকম আগ্রহের ব্যবহারকারীদের একটি গোষ্ঠী যাদের ব্যক্তিগতকৃত বিজ্ঞাপন পরিবেশন করা যেতে পারে। ক্রেতারা ব্যবহারকারীর কার্যকলাপের উপর ভিত্তি করে বিজ্ঞাপনদাতাদের তাদের অ্যাপে কাস্টম অডিয়েন্স তৈরি করতে সাহায্য করতে পারেন।

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

সেটআপ এবং প্রোটোটাইপ

• ডিভাইসে একটি অডিয়েন্স তৈরি এবং সংরক্ষণ করতে কাস্টম অডিয়েন্স এপিআই ব্যবহার করুন যা পরবর্তীতে নিলামে ব্যবহার করা যেতে পারে।
• বাস্তবায়ন এবং API ব্যবহারের বিশদ বিবরণের জন্য ডেভেলপার নির্দেশিকা দেখুন।

নকশা বিবেচনা

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

বিডিং লজিক ইউআরএল

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

ব্যবহারকারীর বিডিং সংকেত

ক্রেতারা ব্যবহারকারী সম্পর্কে বিজ্ঞাপনদাতা বা ক্রেতার নিজস্ব জ্ঞান ডিভাইসের ভবিষ্যতের নিলামে প্রেরণ করতে UserBiddingSignals ব্যবহার করতে পারেন। এর মধ্যে নিম্নলিখিত তথ্য অন্তর্ভুক্ত থাকতে পারে:

• ব্যবহারকারীকে অন্যান্য দর্শকদের সাথে যুক্ত করা হয়েছে।
• ব্যবহারকারী সম্পর্কে বিজ্ঞাপনদাতার প্রথম পক্ষের অন্তর্দৃষ্টি।

যেহেতু নিলামের সময় এই সংকেতগুলি পাওয়া যায়, ক্রেতারা নিলামের সময় কাস্টম বিডিং অপারেশনগুলি সম্পাদন করতে পারেন, যার মধ্যে রয়েছে:

• বিডিং সিগন্যালের উপর ভিত্তি করে বিড বাড়ান বা কমান।
• নিলাম থেকে নির্দিষ্ট বিজ্ঞাপনগুলি ফিল্টার করে বাদ দিন।

বিশ্বস্ত বিডিং ডেটা

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

TrustedBiddingData ফিল্ডটি একটি URL এবং কিছু কী-এর সেট দিয়ে তৈরি। কী ধরণের কী স্ট্রাকচার ব্যবহার করতে হবে তা ডিজাইন করার সময় এখানে কিছু বিবেচ্য বিষয় বিবেচনা করা হল:

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

অ্যাডডেটা তালিকা

পুনঃবিপণন প্রচারণা তৈরি করার সময়, বিজ্ঞাপনদাতারা সাধারণত দর্শকদের মধ্যে থাকা ব্যবহারকারীকে দেখানোর জন্য বিভিন্ন ধরণের বিজ্ঞাপন বিবেচনা করেন, যেমন অ্যাপের সাথে ব্যবহারকারীর পূর্বের সম্পৃক্ততার উপর ভিত্তি করে বিভিন্ন ছাড়ের বিজ্ঞাপন। একটি কাস্টম দর্শকদের একটি AdData তালিকা থাকে যা প্রার্থীদের বিজ্ঞাপন ধারণ করে।

প্রতিটি বিজ্ঞাপনে কত তথ্য অন্তর্ভুক্ত করতে হবে তা ক্রেতাদের সিদ্ধান্তের উপর নির্ভর করে। কিছু বিষয় বিবেচনা করতে হবে:

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

AdData একটি render_url থাকা উচিত। বিজয়ী পুনঃবিপণন বিজ্ঞাপনের রেন্ডার URL বিজ্ঞাপনটি রেন্ডার করার জন্য ব্যবহৃত হয়। কিছু বিবেচ্য বিষয়ের মধ্যে রয়েছে:

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

প্রোটোটাইপ করার সময়, শুধুমাত্র প্রয়োজনীয় ক্ষেত্র হল renderUri , যা বিজ্ঞাপনের রেন্ডারিং সম্পদগুলিকে নির্দেশ করে। আপনার সমাধান তৈরি করার সময় AdData তে থাকা মেটাডেটা ক্ষেত্রটি উপেক্ষা করা যেতে পারে। আপনার সমাধানটি উৎপাদনের দিকে নিয়ে যাওয়ার সময়, আপনার বিবেচনা করা উচিত যে কোন মেটাডেটা আপনার জন্য প্রাসঙ্গিক কারণ এটি বিড জেনারেশনের সময় আপনার বিড মূল্য সামঞ্জস্য করতে ব্যবহার করা যেতে পারে।

সক্রিয়করণের সময় এবং মেয়াদ শেষ হওয়ার সময়

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

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

ক্রেতা এবং বিক্রেতা: বিজ্ঞাপন নির্বাচন

বিজ্ঞাপন নির্বাচনের জন্য ক্রেতা এবং বিক্রেতার মধ্যে সহযোগিতা প্রয়োজন। এটিকে চার ধাপের প্রক্রিয়া হিসেবে দেখা যেতে পারে:

1. বিক্রেতারা একটি মধ্যস্থতা কৌশল সংজ্ঞায়িত করেন।
2. বিক্রেতারা নিলামটি কনফিগার করেন এবং বিজ্ঞাপন নির্বাচন শুরু করেন।
3. বিক্রেতার নির্ধারিত কনফিগারেশন ব্যবহার করে ক্রেতাদের নিলামে অংশগ্রহণের জন্য আমন্ত্রণ জানানো হয়। প্রার্থীর বিজ্ঞাপন নির্বাচন এবং বিড করার জন্য ক্রেতার বিডিং লজিক কার্যকর করা হয়।
4. প্রার্থীদের স্কোর করার এবং একটি বিজয়ী বিজ্ঞাপন নির্বাচন করার জন্য বিক্রেতাদের সিদ্ধান্তের যুক্তি কার্যকর করা হয়।

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

বিক্রেতারা: মধ্যস্থতার কৌশল নির্ধারণ করুন

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

বিক্রেতারা: নিলাম কনফিগার করুন

বিক্রেতারা নিলামটি কনফিগার করার জন্য, বিজ্ঞাপন নির্বাচন প্রক্রিয়ার তথ্য সরবরাহ করার জন্য দায়ী। বিক্রেতারা কেবল প্রতিটি বা নির্বাচিত পক্ষের কাছে তথ্য উপলব্ধ করতে পারেন। এর মধ্যে আপনার কাছে থাকা তথ্য বা ক্রেতাদের পক্ষে আপনার অন্তর্ভুক্ত তথ্য অন্তর্ভুক্ত থাকতে পারে।

সেটআপ এবং প্রোটোটাইপ

• একজন বিক্রেতা একটি AdSelectionConfig অবজেক্ট সেট আপ করে এবং AdSelection API ব্যবহার করে একটি নিলাম কনফিগার এবং শুরু করতে পারেন। selectAds() ব্যবহার করে নিলাম শুরু করুন।
• বাস্তবায়ন এবং API ব্যবহারের বিশদ বিবরণের জন্য ডেভেলপার নির্দেশিকা দেখুন।

নকশা বিবেচনা

এই বিভাগে বিজ্ঞাপন নির্বাচন কনফিগারেশনে মূল ক্ষেত্রগুলি পূরণ এবং ব্যবহারের জন্য নকশা বিবেচনা অন্তর্ভুক্ত রয়েছে।

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

• বিজ্ঞাপন নির্বাচনের কর্মপ্রবাহ শুরু করার আগে, ক্রেতাদের কাছ থেকে তথ্য সংগ্রহের জন্য একটি বিজ্ঞাপন অনুরোধ চালান। তারপর, বিজ্ঞাপন নির্বাচন কনফিগার করতে এই তথ্য ব্যবহার করুন।

• যেহেতু অনেক ক্রেতা ডিভাইসে কাস্টম অডিয়েন্স তৈরি করতে পারতেন, তাই বিক্রেতাদের অবশ্যই কাস্টম অডিয়েন্স বায়ার্স ফিল্ড ব্যবহার করে নির্দিষ্ট ক্রেতাদের এই প্রক্রিয়ায় অন্তর্ভুক্ত করতে হবে। এই তালিকা তৈরি করার অনেক উপায় আছে। কিছু উদাহরণের মধ্যে রয়েছে:

  • ক্রেতাদের একটি স্থির তালিকা যা বিক্রেতা সর্বদা প্রক্রিয়াটিতে অন্তর্ভুক্ত করতে চান।
  • তাদের বিজ্ঞাপনের প্রতিক্রিয়ায় অংশগ্রহণ করতে ইচ্ছুক ক্রেতাদের একটি তালিকা। এই বিকল্পটি কার্যকর যদি বিক্রেতা বিজ্ঞাপন এক্সচেঞ্জের সাথে কাজ করেন এবং সমস্ত ক্রেতা সম্পর্কে সম্পূর্ণ জ্ঞান নাও থাকতে পারে।

• বিক্রেতা বিভিন্ন উপায়ে প্রক্রিয়াটিতে তথ্য প্রেরণ করতে পারেন:

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

ক্রেতা: একটি বিজ্ঞাপন স্লটের জন্য বিডিং

সেটআপ এবং প্রোটোটাইপ

• একজন ক্রেতা তাদের বিডিং লজিক generateBid() জাভাস্ক্রিপ্ট ফাংশনে যোগ করতে পারেন যা একটি CustomAudience তৈরি করার সময় biddingLogicUrl প্যারামিটার সেট থেকে পরিবেশিত হয়। আপনি প্রদত্ত spec ব্যবহার করে একটি মক পরিষেবা সেট আপ করতে পারেন, অথবা একটি বাস্তব সার্ভারে এই এন্ডপয়েন্টটি বাস্তবায়ন করতে পারেন।
• বাস্তবায়ন এবং API ব্যবহারের বিশদ বিবরণের জন্য ডেভেলপার নির্দেশিকা দেখুন।

নকশা বিবেচনা

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

ডিজাইন বিডিং লজিক

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

বিডিং ডেটা সরবরাহ করুন

মূল-মূল্য পরিষেবাগুলির সাথে রিয়েল-টাইম বিডিং সিগন্যাল

একজন ক্রেতা হিসেবে, আপনি আপনার মালিকানাধীন একটি কী-ভ্যালু পরিষেবা থেকে নিলামের সময় রিয়েল টাইম সিগন্যাল পেতে পারেন। আপনি পাবলিক প্রাইভেসি স্যান্ডবক্স রিপোজিটরিতে এই পরিষেবার প্রাথমিক বাস্তবায়ন খুঁজে পেতে পারেন, অথবা আপনি নিজের একটি পরিষেবা তৈরি করতে পারেন। এই পরিষেবার URLটি একটি কাস্টম দর্শকদের মধ্যে trustedBiddingUrl হিসাবে নির্দিষ্ট করা হয়েছে এবং প্ল্যাটফর্মটি trusted_bidding_signals parameter ব্যবহার করে ডেটা সংগ্রহ করে আপনার generateBid ফাংশনে উপলব্ধ করার চেষ্টা করে। আপনাকে আপনার নিজস্ব কী কাঠামো স্থাপন করতে হবে।

প্রাসঙ্গিক এবং ব্যবহারকারীর সংকেত

ডিভাইসে নিলাম চালানোর সময় আপনার generateBid ফাংশন অতিরিক্ত ব্যবহারকারীর সিগন্যাল অ্যাক্সেস করতে পারে। এই সিগন্যালগুলি contextual_signals এবং per_buyer_signals ফিল্ডের মাধ্যমে প্রেরণ করা হয়। এই ফিল্ডগুলি হল JSON অবজেক্ট যার ফর্ম্যাট ক্রেতা এবং বিক্রেতাদের দ্বারা সংজ্ঞায়িত করা প্রয়োজন।

contextual_signals ফিল্ডে ব্যবহারকারী সম্পর্কে প্রাসঙ্গিক তথ্য রয়েছে। এই সিগন্যালগুলি ধারণকারী বস্তুটি সুরক্ষিত দর্শক নিজেই তৈরি করে এবং আপনার বিডিং লজিকে প্রেরণ করে। এটি একটি খালি বস্তু হিসাবে পাস করা হয়। যদি আপনি বিশ্বাস করেন যে ব্যবহারকারী সম্পর্কে একটি প্রাসঙ্গিক সংকেত আপনার ব্যবহারের ক্ষেত্রে প্রাসঙ্গিক হতে পারে, তাহলে বিবেচনার জন্য প্রতিক্রিয়া জমা দিন ।

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

• ব্র্যান্ড সুরক্ষার জন্য ফিল্টারিং। বিক্রেতা ক্রেতাদের বিজ্ঞাপনের অনুরোধকারী অ্যাপ সম্পর্কে কিছু শ্রেণীবিভাগ তথ্য জানাতে পারেন এবং ক্রেতা এই তথ্য ব্যবহার করে নির্দিষ্ট বিজ্ঞাপন ফিল্টার করতে পারেন।
• প্রাসঙ্গিক তথ্য বিবেচনা করে এমন একটি ML মডেলের জন্য একটি এম্বেডিং পাঠানো হচ্ছে।

বিক্রেতারা: স্কোর করুন এবং বিজয়ী বিজ্ঞাপনটি নির্বাচন করুন

সেটআপ এবং প্রোটোটাইপ

• একজন বিক্রেতা তাদের স্কোরিং লজিক scoreAd() জাভাস্ক্রিপ্ট ফাংশনে যোগ করতে পারেন যা AdSelectionConfig তৈরি করার সময় scoringLogicUrl প্যারামিটার সেট থেকে পরিবেশিত হয়। আপনি প্রদত্ত spec ব্যবহার করে একটি মক পরিষেবা সেট আপ করতে পারেন, অথবা একটি বাস্তব সার্ভারে এই এন্ডপয়েন্টটি বাস্তবায়ন করতে পারেন।
• বাস্তবায়ন এবং API ব্যবহারের বিশদ বিবরণের জন্য ডেভেলপার নির্দেশিকা দেখুন।

ডিজাইন স্কোরিং লজিক

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

স্কোরিং ডেটা সরবরাহ করুন

মূল-মান পরিষেবাগুলির সাথে রিয়েল-টাইম স্কোরিং সিগন্যাল

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

প্রাসঙ্গিক এবং ব্যবহারকারীর সংকেত

ডিভাইসে নিলাম চালানোর সময় আপনার scoreAd ফাংশন অতিরিক্ত ব্যবহারকারীর সিগন্যাল অ্যাক্সেস করতে পারে। এই সিগন্যালগুলি contextual_signal ফিল্ড ব্যবহার করে আপনার স্কোরিং ফাংশনে পাঠানো হয়। এই ফিল্ডে একটি JSON অবজেক্ট থাকে যার ফর্ম্যাট ক্রেতা এবং বিক্রেতাদের দ্বারা নির্ধারিত হয়।

contextual_signal ফিল্ডে প্রাসঙ্গিক তথ্য থাকে যা ব্যবহারকারী সম্পর্কে প্রাসঙ্গিক হতে পারে। এই সিগন্যালগুলি ধারণকারী অবজেক্টটি Protected Audience নিজেই তৈরি করে এবং আপনার স্কোরিং লজিকে প্রেরণ করে। এটি একটি খালি অবজেক্ট হিসাবে পাস করা হয়। যদি আপনি বিশ্বাস করেন যে ব্যবহারকারী সম্পর্কে কোনও সিগন্যাল আপনার ব্যবহারের ক্ষেত্রে প্রাসঙ্গিক হতে পারে, তাহলে বিবেচনার জন্য প্রতিক্রিয়া জমা দিন ।

বিক্রেতারা: একটি বিজ্ঞাপন রেন্ডার করুন

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

ইম্প্রেশনের ফলাফল রিপোর্ট করুন

সেটআপ এবং প্রোটোটাইপ

• ক্রেতা এবং বিক্রেতারা reportWin() জাভাস্ক্রিপ্ট ফাংশনে রিপোর্টিং লজিক যোগ করতে পারেন যা যথাক্রমে biddingLogicUrl বা scoringLogicUrl প্যারামিটার থেকে পরিবেশিত হয়। আপনি প্রদত্ত spec ব্যবহার করে একটি মক পরিষেবা সেট আপ করতে পারেন, অথবা একটি বাস্তব সার্ভারে এই এন্ডপয়েন্টটি বাস্তবায়ন করতে পারেন।
• বাস্তবায়ন এবং API ব্যবহারের বিশদ বিবরণের জন্য ডেভেলপার নির্দেশিকা দেখুন।

নকশা বিবেচনা

ক্রেতা এবং বিক্রেতাদের তাদের জাভাস্ক্রিপ্ট কোডে একটি reportWin ফাংশন প্রয়োগ করতে হবে যা তাদের কনফিগার করা এন্ডপয়েন্ট থেকে ফিরে আসে। এই পদ্ধতিটি আপনাকে আপনার সার্ভারে ডেটা ফেরত পাঠাতে দেয়।

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