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

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

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

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

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

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

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

পরিভাষা

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

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

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

সুরক্ষিত শ্রোতা বৈশিষ্ট্যগুলির জন্য রোলআউট গাইড দেখানো ডায়াগ্রাম৷
সুরক্ষিত শ্রোতা বৈশিষ্ট্যগুলির জন্য রোলআউট গাইড।

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

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

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

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

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

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

ইন্টিগ্রেশন অংশীদার প্রবৃত্তি

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

বিটা সেটআপ (Q4 এ উপলব্ধ)

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

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

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

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

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

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

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

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

ডেটা কৌশল

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

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

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

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

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

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

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

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

প্রোটোটাইপ পুনঃবিপণন প্রচারাভিযান: একটি কাস্টম দর্শক ডিজাইন করুন

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

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

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

ডিজাইন বিবেচ্য বিষয়

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

বিক্রেতা: মধ্যস্থতা কৌশল সংজ্ঞায়িত করুন

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

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

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

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

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

ডিজাইন বিবেচ্য বিষয়

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

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

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

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

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

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

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

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

ডিজাইন বিবেচ্য বিষয়

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

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

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

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

মূল-মূল্য পরিষেবা সহ রিয়েল-টাইম বিডিং সংকেত

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ছাপ ফলাফল রিপোর্ট করুন

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

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

ডিজাইন বিবেচ্য বিষয়

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

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

{% শব্দার্থে %} {% endverbatim %} {% শব্দার্থে %} {% endverbatim %}