সুরক্ষিত শ্রোতা API (পূর্বে FLEDGE)

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

ক্রোম প্রোটেক্টেড অডিয়েন্স API-এর জন্য একটি অরিজিন ট্রায়াল চালাচ্ছে৷ অনুমোদিত ক্রেতারা অ্যাড ম্যানেজার প্রকাশক ইনভেনটরিতে সুরক্ষিত দর্শক API-এর পরীক্ষায় অংশগ্রহণের যোগ্য। দরদাতারা সুরক্ষিত শ্রোতা API পরীক্ষা করে নিম্নলিখিতগুলি অর্জন করতে পারে:

  • পুনরাবৃত্তি করুন এবং সুরক্ষিত দর্শক API প্রবাহের কার্যকারিতা সম্পর্কে জানুন।
  • পাবলিক ফোরামে সম্ভাব্য API উন্নতির বিষয়ে প্রতিক্রিয়া তৈরি করুন—উদাহরণস্বরূপ, GitHub
  • তৃতীয় পক্ষের কুকিজের উপর নির্ভর না করে API এর মাধ্যমে ব্যক্তিগতকৃত বিজ্ঞাপন সমর্থন করার জন্য প্রস্তুত হন।

পরীক্ষায় আগ্রহী অনুমোদিত ক্রেতাদের বিস্তারিত জানার জন্য অনবোর্ডিং বিভাগটি পরীক্ষা করা উচিত।

পরিবেশন প্রবাহ সারাংশ

অনুমোদিত ক্রেতা অংশীদারদের জন্য সুরক্ষিত শ্রোতাদের বিজ্ঞাপন পরিবেশন প্রবাহের সারাংশ এখানে দেওয়া হল:

Flow diagram

  1. একজন দরদাতা তার বিজ্ঞাপনদাতাদের সাথে কাজ করে প্রতিটি বিজ্ঞাপনদাতার স্বার্থ গ্রুপ বজায় রাখতে। প্রায়শই, বিজ্ঞাপনদাতারা আগ্রহের গোষ্ঠীতে একটি ব্রাউজার যোগ করতে বিজ্ঞাপনদাতার পৃষ্ঠায় একটি দরদাতার ট্যাগ যোগ করে।
  2. একজন শেষ-ব্যবহারকারী একজন বিজ্ঞাপনদাতার পৃষ্ঠায় যান। পৃষ্ঠায় দরদাতার ট্যাগ থাকতে পারে।
  3. দরদাতার ট্যাগ সুরক্ষিত শ্রোতা API joinAdInterestGroup() আহ্বান করে। এই কল ব্রাউজারকে একটি আগ্রহের গোষ্ঠীতে ব্যবহারকারীকে যুক্ত করার জন্য অনুরোধ করে৷
  4. শেষ-ব্যবহারকারী একটি প্রকাশকের ওয়েবপেজে যান। ব্যবহারকারীর ব্রাউজার Google এর প্রকাশক বিজ্ঞাপন ট্যাগ অনুরোধ করে।
  5. Google এর প্রকাশক বিজ্ঞাপন ট্যাগ একটি Google সার্ভারের কাছে একটি প্রাসঙ্গিক বিজ্ঞাপন অনুরোধ করে।
  6. Google অংশগ্রহণকারী দরদাতাদের প্রাসঙ্গিক বিড অনুরোধ পাঠায়। আরও তথ্যের জন্য বিড অনুরোধ পরিবর্তন বিভাগ দেখুন।
  7. দরদাতা interest_group_bidding ক্ষেত্রের সাথে একটি BidResponse প্রদান করে। যদি দরদাতা interest_group_bidding নির্দিষ্ট না করে, Google নিলাম কনফিগারেশনে interestGroupBuyers এ দরদাতার উত্স অন্তর্ভুক্ত করে না। বিড প্রতিক্রিয়াতে interest_group_bidding.per_buyer_signals ও থাকতে পারে। per_buyer_signals ইন-ব্রাউজার নিলামের সময় দরদাতার বিডিং ফাংশনে পাস করা হবে। আরও তথ্যের জন্য বিড প্রতিক্রিয়া পরিবর্তন বিভাগ দেখুন।
  8. Google সার্ভার-সাইড নিলাম চালায় এবং ব্রাউজারে একটি বিড প্রতিক্রিয়া প্রদান করে। সার্ভার-সাইড নিলাম ঐতিহ্যগত, সার্ভার-সাইড বিড বিবেচনা করে। বিড প্রতিক্রিয়াতে একটি প্রাসঙ্গিক বিজয়ী বিড (যদি থাকে) সম্পর্কে তথ্য থাকতে পারে।
  9. বিড প্রতিক্রিয়াতে ব্রাউজার নিলামের জন্য একটি নিলাম কনফিগারেশন রয়েছে। এতে প্রতিটি অংশগ্রহণকারী ক্রেতার কাছ থেকে প্রাসঙ্গিক সংকেত অন্তর্ভুক্ত থাকতে পারে (যেটি interest_group_bidding.per_buyer_signals এর মাধ্যমে পাঠানো হয়েছে), প্রাসঙ্গিক বিজয়ী তথ্য এবং বিডের যোগ্যতার সেটিংস।
  10. Google-এর প্রকাশক ট্যাগ অন-ডিভাইস ইন্টারেস্ট গ্রুপ নিলাম শুরু করতে সুরক্ষিত দর্শক API runAdAuction() আহ্বান করে। Google শুধুমাত্র সেইসব ক্রেতাদের অন্তর্ভুক্ত করে যারা পূর্বে নিলাম কনফিগারেশনে interestGroupBuyers হিসেবে interest_group_bidding ফিরিয়ে দিয়েছে।
  11. Google সুরক্ষিত দর্শক নিলাম কনফিগারেশনে প্রতিটি যোগ্য বিডারের per_buyer_signals পাস করে।
  12. যদি একটি প্রদত্ত দরদাতার আগ্রহের গোষ্ঠী trustedBiddingSignalsUrl ইউআরএল নির্দিষ্ট করে থাকে, ব্রাউজার প্রতিটি গোষ্ঠীর জন্য রিয়েল-টাইম সিগন্যাল আনার জন্য প্রতিটি গোষ্ঠীর trustedBiddingSignalsUrl সিগন্যাল ইউআরএলকে একটি অনুরোধ করে৷ Protected Audience API স্পেক এ বিস্তারিত দেখুন।
  13. ব্রাউজারটি প্রতিটি স্বার্থ গোষ্ঠীর জন্য দরদাতার generateBid() আহ্বান করে যারা নির্বাচন করেছে এবং ইন-ব্রাউজার নিলামে অংশগ্রহণের জন্য যোগ্য। এই ধাপটি বিড গণনা করে এবং একটি সৃজনশীল নির্বাচন করে। generateBid() দরদাতা দ্বারা প্রদত্ত per_buyer_signals এবং প্রদত্ত স্বার্থ গোষ্ঠীর জন্য বিশ্বস্ত বিডিং সংকেতগুলিতে অ্যাক্সেস রয়েছে৷
  14. ব্রাউজারটি বিক্রেতার (এই ক্ষেত্রে, Google এর) scoreAd() আগ্রহী গ্রুপ বিজ্ঞাপন নিলামে প্রতিটি বিডের জন্য একটি র‌্যাঙ্ক বরাদ্দ করতে আহ্বান করে। বিডগুলি প্রকাশকের সুরক্ষা, বিজ্ঞাপন নীতি এবং অন্যান্য সীমাবদ্ধতার উপর ভিত্তি করে র‌্যাঙ্ক করা এবং ফিল্টার করা হয়।
  15. ব্রাউজারটি যোগ্য স্বার্থ গোষ্ঠীর বিডগুলির সাথে একটি নিলাম চালায়৷ শীর্ষস্থানীয় প্রাসঙ্গিক বিড ইন-ব্রাউজার নিলামে অংশগ্রহণ করে।
  16. নিলামের পর, যদি কোনো স্বার্থ গোষ্ঠী বিজয়ী হয়, ব্রাউজার ইন-ব্রাউজার নিলামের বিজয়ী সম্পর্কে প্রতিটি পক্ষকে অবহিত করার জন্য বিক্রেতার reportResult() এবং দরদাতার reportWin() আহ্বান করে।
  17. যদি কোনো আগ্রহ গোষ্ঠীর বিজ্ঞাপন জয়ী হয়, Google-এর প্রকাশক ট্যাগ বিজ্ঞাপনটিকে একটি iframe-এ রেন্ডার করে।

প্রবাহ বিবরণ পরিবেশন

বিজ্ঞাপন পরিবেশন আগে

সৃজনশীল পর্যালোচনা

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

renderUrls জন্য প্রয়োজনীয়তা:

  • API-এর মাধ্যমে জমা দেওয়া renderUrl আগ্রহের গ্রুপ বিজ্ঞাপন নিলামে ব্যবহৃত renderUrl সাথে মেলে।
  • প্রতিটি renderUrl শুধুমাত্র একটি বিজ্ঞাপনদাতা বা বিজ্ঞাপন প্রচারের প্রতিনিধিত্ব করতে পারে। একটি প্রদত্ত renderUrl একাধিক বিজ্ঞাপনদাতার হয়ে বিজ্ঞাপন রেন্ডার করতে ব্যবহার করা যাবে না৷ প্রতিটি renderUrl একটি একক সৃজনশীল মানচিত্র করতে হবে.
  • renderUrl Google-এর অফলাইন ক্রিয়েটিভ রিভিউ সিস্টেমের মাধ্যমে বিজ্ঞাপনটি শেষ বিড করার 7 দিন পর্যন্ত অ্যাক্সেসযোগ্য এবং আনয়নযোগ্য হতে হবে।
রিয়েল-টাইম বিডিং API

দরদাতারা সুদ গ্রুপ বিডিংয়ের জন্য ক্রিয়েটিভ আপলোড করতে রিয়েল-টাইম বিডিং API ব্যবহার করতে পারেন।

স্বয়ংক্রিয় সৃজনশীল স্ক্যানিং

বিডাররা ক্রিয়েটিভের জন্য স্বয়ংক্রিয় সৃজনশীল স্ক্যানিং সেট আপ করতে পারে যা রিয়েল-টাইম বিডিং API এর মাধ্যমে আপলোড করা হয় না।

আপনি যদি স্বয়ংক্রিয় সৃজনশীল স্ক্যানিং সেট আপ করেন, Google ইন-ব্রাউজার নিলামে সৃজনশীল খুঁজে পায় এবং স্বয়ংক্রিয়ভাবে সেগুলি স্ক্যান করে, যাতে তারা ভবিষ্যতের নিলামের জন্য যোগ্য হয়৷

এখানে কিভাবে স্বয়ংক্রিয় সৃজনশীল স্ক্যানিং চালু করবেন:

  • আগ্রহী গোষ্ঠী ক্রিয়েটিভের সমস্ত renderUrl উত্স অনুমোদিত ক্রেতা অ্যাকাউন্টে যুক্ত করুন৷

  • সৃজনশীলের HTTP প্রতিক্রিয়াতে নিম্নলিখিত কাস্টম HTTP শিরোনাম যোগ করুন:

    Authorized-Buyers-Creative-ID

    স্ট্রিং

    ক্রেতা-নির্দিষ্ট ক্রিয়েটিভ আইডি। ক্রিয়েটিভ আইডির সর্বোচ্চ দৈর্ঘ্য 128 বাইট।

    Authorized-Buyers-Click-Through-URLs

    স্ট্রিং

    RFC2396 অনুযায়ী এনকোড করা ক্রিয়েটিভের জন্য ঘোষিত গন্তব্য URL-এর সেট।

উদাহরণ:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
সৃজনশীল মেয়াদ

সৃজনশীল 15 দিনের জন্য অনুমোদিত হয়. আপনি যদি রিয়েল-টাইম বিডিং API এর সাথে ক্রিয়েটিভ জমা দেন, তাহলে আপনাকে 15 দিন পরে ক্রিয়েটিভটি আবার জমা দিতে হবে। আপনি যদি স্বয়ংক্রিয় সৃজনশীল স্ক্যানিংয়ের উপর নির্ভর করেন, স্ক্যানিং প্রক্রিয়া স্বয়ংক্রিয়ভাবে তাদের পুনরায় স্ক্যান করে।

ক্রেতা রিপোর্টিং আইডি

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

আগ্রহের গ্রুপ কনফিগারেশনে buyerAndSellerReportingId কীভাবে যোগ করতে হয় তার একটি উদাহরণ নিচে দেওয়া হল:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

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

সার্ভার-সাইড নিলাম

বিড অনুরোধ পরিবর্তন

নিম্নলিখিতগুলি পরীক্ষায় ব্যবহারের জন্য সমর্থিত প্রোটোকলগুলির প্রাথমিক সংস্করণ:

সুদ গ্রুপ নিলাম সমর্থন নির্দেশ করুন

বিড অনুরোধের একটি নতুন ক্ষেত্র আছে, auction_environment

  • Google RTB প্রোটোকল: BidRequest.adslot.auction_environment
  • OpenRTB: BidRequest.imp.ext.auction_environment

আপনি এই ক্ষেত্রটি ব্যবহার করতে পারেন ইম্প্রেশন সুযোগগুলির মধ্যে পার্থক্য করতে যা ব্রাউজার-এর মধ্যে সুরক্ষিত দর্শকদের স্বার্থ গোষ্ঠী নিলামকে সমর্থন করে এবং যেগুলি শুধুমাত্র ঐতিহ্যগত সার্ভার-সাইড বিনিময় নিলামকে সমর্থন করে৷ auction_environment enum-এর নিম্নলিখিত মান থাকতে পারে:

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0 ): ঐতিহ্যগত সার্ভার-সাইড নিলাম
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1 ): সুরক্ষিত শ্রোতা সমর্থন সহ অনুরোধ, যেখানে এক্সচেঞ্জের সার্ভারে একটি প্রাসঙ্গিক নিলাম চলে এবং স্বার্থ গোষ্ঠী বিডিং এবং চূড়ান্ত নিলাম ব্রাউজারে চলে
সুরক্ষিত দর্শক বিজ্ঞাপন স্লট আকার নির্দেশ করুন

বিড অনুরোধে আপনাকে সুরক্ষিত দর্শক বিজ্ঞাপন স্লট আকার প্রদান করার জন্য নিম্নলিখিত ক্ষেত্রগুলি অন্তর্ভুক্ত রয়েছে:

  • Google RTB প্রোটোকল:
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height
  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction width
    • BidRequest.imp.ext.interest_group_auction height

এই ক্ষেত্রগুলি পিক্সেলে সুরক্ষিত দর্শক নিলামের জন্য বিজ্ঞাপন স্লটের আকার নির্দেশ করে৷

এই আকারটি প্রাসঙ্গিক অনুরোধের আকার থেকে ভিন্ন হতে পারে ( Adslot.width এবং Adslot.height , অথবা OpenRTB: BidRequest.imp.banner.format )।

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

সুরক্ষিত দর্শকদের বিজ্ঞাপন রেন্ডারযোগ্যতা নির্দেশ করুন

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

  • Google RTB প্রোটোকল: BidRequest.adslot.interest_group_auction.render_interest_group_ads
  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
ব্যবহারকারী শনাক্তকারীর উপর নির্ভর করা কমিয়ে দিন

প্রটেক্টেড অডিয়েন্স এপিআই পরীক্ষার সুযোগে প্রাসঙ্গিক বিড অনুরোধগুলি ব্রাউজার থেকে উপলব্ধ হলে ঐতিহ্যগত কুকি-ভিত্তিক শনাক্তকারী বহন করা চালিয়ে যেতে পারে, যেমন google_user_id ( OpenRTB-তে BidRequest.user.id ) এবং hosted_match_data ( OpenRTB-তে BidRequest.user.buyerid ) ক্ষেত্র বিড অনুরোধে এই ধরনের শনাক্তকারীর উপস্থিতি যেকোন বিদ্যমান গোপনীয়তা নীতির সাপেক্ষে চলতে থাকবে। আমরা সুপারিশ করি যে আপনি তৃতীয় পক্ষের কুকিজ আর উপলব্ধ না থাকলে দক্ষ কেনার জন্য আরও ভালভাবে প্রস্তুত করার জন্য পরীক্ষার সময় লক্ষ্য নির্ধারণ এবং বিডিংয়ের উদ্দেশ্যে কুকি-ভিত্তিক শনাক্তকারীর উপর নির্ভর করবেন না।

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

2024 সালে তৃতীয় পক্ষের কুকি অবচয় (3PCD) এর জন্য প্রস্তুত করার জন্য, Chrome এখন Chrome-সুবিধাযুক্ত পরীক্ষা অফার করে।

সাইট এবং বিক্রেতারা 3PCD-এর অধীনে তাদের সিস্টেম পরীক্ষা করার জন্য Chrome-সুবিধাযুক্ত পরীক্ষা ব্যবহার করতে পারে। পরীক্ষায়, Chrome ব্রাউজারগুলিকে একটি 3PCD পরীক্ষামূলক গোষ্ঠীতে বরাদ্দ করা হয়, হয় মোড A বা মোড B৷ প্রতিটি ব্রাউজারকে একটি নির্দিষ্ট 3PCD পরীক্ষা গোষ্ঠীর সাথে সম্পর্কিত একটি সামঞ্জস্যপূর্ণ লেবেল বরাদ্দ করা হয় যা আপনি ইন-ব্রাউজার Chrome API এর মাধ্যমে অ্যাক্সেস করতে পারেন৷

RTB বিড অনুরোধে Google Chrome API থেকে অপরিবর্তিত লেবেল পাস করে। একটি পৃথক লেবেলের ছোট ট্রাফিক স্লাইসগুলির কারণে, Google সর্বদা গোপনীয়তা-সীমিত প্রসঙ্গে লেবেলটিকে অন্তর্ভুক্ত করে না।

এখানে এমন ক্ষেত্র রয়েছে যেখানে আপনি লেবেলটি দেখতে পারেন:

  • Google RTB প্রোটোকল: BidRequest.device.cookie_deprecation_label
  • OpenRTB: BidRequest.device.ext.cdep

বিড প্রতিক্রিয়া পরিবর্তন

সুদ গ্রুপ নিলাম অংশগ্রহণ ইঙ্গিত

প্রাসঙ্গিক বিড প্রতিক্রিয়াতে InterestGroupBidding অবজেক্ট ফেরত দিয়ে ইন-ব্রাউজার নিলামে অংশ নেওয়ার আপনার অভিপ্রায় স্পষ্টভাবে নির্দেশ করার জন্য আপনি দায়ী:

  • Google RTB প্রোটোকল: BidResponse.interest_group_bidding
  • OpenRTB: BidResponse.ext.igbid

আপনাকে অবশ্যই একটি প্রাসঙ্গিক বিড প্রতিক্রিয়া প্রদান করতে হবে। প্রতিক্রিয়া একটি প্রাসঙ্গিক বিড অন্তর্ভুক্ত করার প্রয়োজন নেই. InterestGroupBidding অবজেক্টে স্বার্থ গোষ্ঠীর মালিকের origin থাকা উচিত, যা তাদের অ্যাকাউন্টের জন্য দরদাতার দ্বারা কনফিগার করা উত্সগুলির একটির সাথে মেলে৷ Google Publisher Tag যখন runAdAuction() কল করে তখন নিলাম কনফিগারেশনের interestGroupBuyers সাথে origin যোগ করা হয়।

ক্রেতা প্রাসঙ্গিক সংকেত প্রচার করুন (perBuyerSignals)

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

  • Google RTB: BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
ক্রেতা প্রাসঙ্গিক রেন্ডারিং সংকেত প্রচার করুন

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

আপনি প্রাসঙ্গিক বিড প্রতিক্রিয়াতে একটি URL-নিরাপদ স্ট্রিং হিসাবে সিরিয়ালকৃত ক্রেতার রেন্ডারিং সংকেত অন্তর্ভুক্ত করতে পারেন, যেটিকে Google ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} ম্যাক্রো তৈরি করে বিজয়ী আগ্রহ গোষ্ঠী রেন্ডার URL-এ প্রতিস্থাপন করবে।

প্রোটোকলের উপর নির্ভর করে নিম্নলিখিত ক্ষেত্রগুলির সাথে বিড প্রতিক্রিয়াতে রেন্ডারিং সংকেত নির্দিষ্ট করা যেতে পারে:

  • Google RTB: BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig

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

সংকেতগুলি ইউআরএল-নিরাপদ না হলে, ম্যাক্রো প্রত্যয়গুলি অনন্য না হলে, বা 3 টির বেশি সংকেতগুলি সরবরাহ করা হলে স্বার্থ গোষ্ঠীর ক্রেতাকে সুরক্ষিত দর্শক নিলামে অংশগ্রহণ থেকে প্রত্যাখ্যান করা হবে৷

সর্বোচ্চ ইন-ব্রাউজার বিড মূল্য নির্দিষ্ট করুন

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

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

বিড প্রতিক্রিয়াতে, আপনি নিম্নলিখিত ক্ষেত্রগুলিতে প্রত্যাশিত সর্বোচ্চ বিড মান নির্দিষ্ট করতে পারেন:

  • Google RTB প্রোটোকল: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (মাইক্রোসিপিএম-এ প্রকাশ করা হয়েছে)
  • OpenRTB: BidResponse.igbid.igbuyer.maxbid (CPM মুদ্রা ইউনিটে প্রকাশ করা হয়)
একাধিক অ্যাকাউন্টে ইম্প্রেশন অ্যাট্রিবিউট করুন

একজন দরদাতাকে অবশ্যই একটি বিলিং আইডি নির্বাচন করতে হবে যাতে নিম্নোক্ত ক্ষেত্রগুলি ব্যবহার করে তাদের আগ্রহের গোষ্ঠীর বিডের ইম্প্রেশনগুলিকে অ্যাট্রিবিউট করতে হয়:

  • Google RTB প্রোটোকল: BidResponse.interest_group_bidding.interest_group_buyers.billing_id
  • OpenRTB: BidResponse.igbid.igbuyer.billing_id

বিড অনুরোধ থেকে নির্বাচিত বিলিং আইডি অবশ্যই একটি যোগ্য বিলিং আইডি হতে হবে:

  • Google RTB প্রোটোকল: BidRequest.adslot.matching_ad_data.billing_id
  • OpenRTB: BidRequest.imp.ext.billing_id

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

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

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

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

ইন-ব্রাউজার নিলামের সময়

ইন-ব্রাউজার বিড তৈরি করুন

ইন-ব্রাউজার বিড তৈরি করতে generateBid() ব্যবহার করুন।

Google নিম্নলিখিত পরামিতি প্রদান করে:

  • auctionSignals : খালি
  • perBuyerSignals : প্রাসঙ্গিক প্রতিক্রিয়াতে দরদাতা দ্বারা প্রদত্ত একই সংকেতের একটি জাভাস্ক্রিপ্ট অবজেক্ট

নিম্নলিখিত পরামিতিগুলি ফেরত দেওয়া হয়:

  • ad : Google এই ক্ষেত্রটিকে উপেক্ষা করে।
  • bid : একটি সংখ্যাসূচক বিড যা নিলামে প্রবেশ করে। CPM ইউনিটে থাকতে হবে (মাইক্রো নয়)।
  • render : বিড নিলামে জিতলে সৃজনশীল প্রদর্শনের জন্য রেন্ডার করা URL। Google অবশ্যই এই URL পর্যালোচনা এবং অনুমোদন করবে, নতুবা এটি নিলাম থেকে ফিল্টার করা হবে৷
  • allowComponentAuction : true হতে হবে। Google বর্তমানে বহু-বিক্রেতার নিলামের পরীক্ষা সমর্থন করে৷

এখানে একটি উদাহরণ:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

generateBid() ফাংশনের ব্যাখ্যার জন্য Protected Audience spec অন-ডিভাইস বিডিং বিভাগটি দেখুন।

বিড কারেন্সি

ইন-ব্রাউজার নিলাম বিডগুলি নির্বাচিত বিড কারেন্সির CPM-এর ইউনিটে স্থাপন করা হয়।

বিড কারেন্সি অবশ্যই প্রাসঙ্গিক বিড প্রতিক্রিয়া এবং generateBid রিটার্ন মান উভয়েই নির্দেশিত হতে হবে এবং অবশ্যই একটি বৈধ ISO 4217 আলফা কোড হতে হবে, যেমন "USD", "EUR", বা "JPY"৷

OpenRTB-তে, Google-এর বিড প্রতিক্রিয়া এক্সটেনশনে InterestGroupBuyer অবজেক্টে নতুন cur ক্ষেত্রটি ব্যবহার করুন।

এখানে একটি উদাহরণ:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

Google RTB প্রোটোকলে, বিড প্রতিক্রিয়ায় InterestGroupBuyer বার্তায় নতুন currency ক্ষেত্রটি ব্যবহার করুন।

এখানে একটি উদাহরণ:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

দরদাতাদের generateBid ফাংশনগুলিকে অবশ্যই একই মুদ্রায় বিডগুলি ফেরত দিতে হবে যা প্রাসঙ্গিক বিড প্রতিক্রিয়াতে নির্দেশিত হয়েছে৷ generateBid এর রিটার্ন মানের মধ্যে নতুন bidCurrency সম্পত্তি পূরণ করুন:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

যদি প্রাসঙ্গিক বিড প্রতিক্রিয়া থেকে কারেন্সি generateBid দ্বারা প্রত্যাবর্তিত মুদ্রা থেকে আলাদা হয়, অথবা যদি তাদের মধ্যে একটি অবৈধ মুদ্রা ফেরত দেয়, তাহলে নিলামের আগে বিড ফিল্টার করা হবে৷

বিজ্ঞাপনের গুণমান পরীক্ষা

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

ডিজিটাল পরিষেবা আইন সমর্থন

ডিজিটাল পরিষেবা আইনের ধারা 26-এর কারণে, প্রকাশকদের ক্রেতাদের ইন-অ্যাড স্বচ্ছতা প্রকাশের প্রয়োজন হতে পারে। যখন "ইইএ-তে আমার সাইট বা অ্যাপে শুধুমাত্র DSA স্বচ্ছতা তথ্য সহ ক্রেতাদের বিজ্ঞাপন দেখাতে বলুন" নিয়ন্ত্রণটি একজন প্রকাশকের দ্বারা সক্ষম করা হয়, তখন আগ্রহ গ্রুপের ক্রেতারা নিম্নলিখিত ক্ষেত্রগুলি লক্ষ্য করে ক্রেতাদের স্বচ্ছতা প্রদানের জন্য কোন সুযোগগুলি প্রয়োজন হবে তা নির্ধারণ করতে পারেন বিডের অনুরোধ পেয়েছেন: BidRequest.dsa.dsa_support এবং BidRequest.dsa.publisher_rendering_support Google অনুমোদিত ক্রেতা প্রোটোকলের জন্য এবং BidRequest.regs.dsa.required এবং BidRequest.dsa.pubrender OpenRTB প্রোটোকলের জন্য।

প্রোটেক্টেড অডিয়েন্স এপিআই নিলামে অংশগ্রহণ করতে ইচ্ছুক একজন দরদাতা যখন বিডের অনুরোধে সিগন্যাল পান যে সুরক্ষিত দর্শক এপিআই-এর মাধ্যমে প্রদত্ত বিজ্ঞাপনগুলির জন্য DSA স্বচ্ছতা অবশ্যই প্রদর্শিত হবে, তাদের মূল্যায়ন করা উচিত যে তারা যথাযথভাবে প্রয়োজনীয় তথ্য প্রদর্শন করতে পারে কিনা এবং BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render Google অনুমোদিত ক্রেতা প্রোটোকলের জন্য BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render অথবা OpenRTB প্রোটোকলের জন্য BidResponse.ext.igbid.igbuyer.dsaadrender । অন্যথায়, ক্রেতাকে সুরক্ষিত দর্শক API নিলামে অন্তর্ভুক্ত করা হবে না।

ডিজিটাল পরিষেবা আইন বিজ্ঞাপনের স্বচ্ছতা সম্পর্কে আরও তথ্যের জন্য, সহায়তা কেন্দ্র নিবন্ধটি দেখুন: ডিজিটাল পরিষেবা আইনকে সমর্থন করা

বিড ফিল্টারিং

Google অন-ডিভাইস নিলামের সময় প্রকাশক নিয়ন্ত্রণ এবং বিজ্ঞাপন নীতি প্রয়োগ করে।

ইন-ব্রাউজার নিলামের পর

নিলামের ফলাফল ক্রেতাকে জানান: reportWin()

Google নিম্নলিখিত আর্গুমেন্টগুলি পূরণ করে না:

  • auctionSignals
  • sellerSignals

নিলামের ফলাফল ক্রেতাকে জানাতে reportWin() ব্যবহার করুন।

আরও তথ্যের জন্য প্রোটেক্টেড অডিয়েন্স API ব্যাখ্যাকারীর রেন্ডার এবং বিজ্ঞাপন ইভেন্টের উপর ক্রেতার প্রতিবেদন দেখুন।

ম্যাক্রো

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

${GDPR} GDPR প্রযোজ্য না হলে 0 বা GDPR প্রযোজ্য হলে 1-এ প্রসারিত হয়। ডকুমেন্টেশন দেখুন।
${GDPR_CONSENT_XXXX} অনুরোধের সাথে যুক্ত স্বচ্ছতা ও সম্মতি (TC) স্ট্রিং- এ প্রসারিত হয়। স্বচ্ছতা ও সম্মতি (TC) স্ট্রিং ফাঁকা বা অবৈধ হলে, এই ম্যাক্রোটি প্রসারিত হয় না।

একটি URL-এ IAB GVL-নিবন্ধিত বিক্রেতার কাছে TC স্ট্রিং পাস করতে এই ম্যাক্রো ব্যবহার করুন। IAB GVL-নিবন্ধিত বিক্রেতার IAB GVL ID দিয়ে XXXX প্রতিস্থাপন করুন। TC স্ট্রিং ফাঁকা বা অবৈধ হলে, এই ম্যাক্রো প্রসারিত হয় না।

${GDPR_CONSENT_XXXX} ম্যাক্রো সহ ক্রিয়েটিভগুলি ব্লক হয়ে যেতে পারে যদি আপনার ঢোকানো IAB GVL আইডির সাথে যুক্ত IAB GVL-নিবন্ধিত বিক্রেতার ব্যবহারকারীর সম্মতি না থাকে।

${GDPR_CONSENT_XXXX} ম্যাক্রোটি renderUrl মধ্যে শুধুমাত্র একবার হওয়া উচিত।
${ADDL_CONSENT} অনুরোধের সাথে যুক্ত অতিরিক্ত সম্মতি (AC) স্ট্রিং -এ প্রসারিত হয়।
${AD_WIDTH}, ${AD_HEIGHT) এই ম্যাক্রো বিজ্ঞাপন স্লট প্রস্থ এবং উচ্চতা সন্নিবেশ.
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

বিড প্রতিক্রিয়াতে নির্দিষ্ট রেন্ডার-টাইম ক্রেতা সংকেত ধারণকারী ম্যাক্রো।

buyer.origin.example স্থানধারককে আগ্রহ গ্রুপ ক্রেতার উৎপত্তির সাথে প্রতিস্থাপন করুন, যা বিড প্রতিক্রিয়াতে interest_group_buyers.origin এর সাথে মিল থাকা উচিত। আপনি তিনটি ভিন্ন রেন্ডারিং সংকেত মান প্রদান করতে একটি _OPTIONAL_SUFFIX অন্তর্ভুক্ত করতে পারেন।

ছাপ গণনা

RTB অংশীদারদের সাথে প্রোটেক্টেড অডিয়েন্স এপিআই পরীক্ষার সময়, যখন ব্রাউজার তার reportResult() ফাংশনকে কল করে এবং পরবর্তীতে sendReportTo() এ কলে Google এর রিপোর্টিং URL নিয়ে আসে তখন Google ইম্প্রেশন গণনা করবে।

যেহেতু প্রোটেক্টেড অডিয়েন্স ইন-ব্রাউজার নিলামে ইম্প্রেশন গণনা করার জন্য Google দ্বারা ব্যবহৃত ইভেন্টটি তার RTB ক্রেতা অংশীদারদের দ্বারা ইম্প্রেশন গণনার জন্য ব্যবহৃত ইভেন্ট থেকে ভিন্ন হতে পারে, তাই ইম্প্রেশনের সংখ্যা ভিন্ন হতে পারে।

সুরক্ষিত শ্রোতা API পরীক্ষা করার জন্য Google এর লক্ষ্যগুলির মধ্যে একটি হল এই অসঙ্গতিগুলি সনাক্ত করা এবং হ্রাস করা৷

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

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

দৈনিক বাজেট ক্যাপ

সুরক্ষিত শ্রোতা API পরীক্ষার সময়, প্রতিটি অ্যাকাউন্টে একটি অ্যাকাউন্ট-স্তরের সুরক্ষিত দর্শকের ব্যয় দৈনিক বাজেটের ক্যাপ থাকে। দৈনিক বাজেট ক্যাপ ইন-ব্রাউজার নিলাম পরিবেশে ঝুঁকি সীমিত করে। একবার দৈনিক বাজেটের সীমা পৌঁছে গেলে, অ্যাকাউন্টটি আর সুরক্ষিত দর্শক-যোগ্য বিড অনুরোধগুলি পায় না।

অ্যাকাউন্টটি সুরক্ষিত শ্রোতা ক্যাপে পৌঁছানোর পরে সার্ভার-সাইড প্রাসঙ্গিক নিলামে অংশগ্রহণ করা চালিয়ে যেতে পারে। উদাহরণ স্বরূপ, একটি বিডার অ্যাকাউন্ট যেটি সুরক্ষিত শ্রোতাদের ক্যাপে পৌঁছায় auction_environment = SERVER_SIDE_AUCTION (OpenRTB: 0 ) সহ একটি বিড অনুরোধ পেতে পারে, এমনকি যদি বিড অনুরোধটি সুরক্ষিত দর্শক নিলামের জন্য যোগ্য হয়।

রিয়েল-টাইম প্রতিক্রিয়া এবং জিততে ন্যূনতম বিড

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

  • ফিডব্যাক অবজেক্টের ফিডব্যাক প্রকার হবে INTEREST_GROUP_BUYER_FEEDBACK
  • সুদ গোষ্ঠী ক্রেতার উৎপত্তি।
  • সামগ্রিক নিলামে জয়ী হওয়ার জন্য স্বার্থ গোষ্ঠীর ক্রেতার জন্য জিততে ন্যূনতম বিড।
  • সামগ্রিক নিলামের সার্ভার সাইড কম্পোনেন্ট থেকে সর্বোচ্চ র‌্যাঙ্কড বিডকে হারাতে স্বার্থ গ্রুপ ক্রেতার জন্য জিততে ন্যূনতম বিড।
  • স্বার্থ গ্রুপ ক্রেতার স্ট্যাটাস কোড. সম্ভাব্য স্ট্যাটাস কোড ইন্টারেস্ট-গ্রুপ-বায়ার-স্ট্যাটাস-কোডস .txt-এ সংজ্ঞায়িত করা হয়েছে।

নির্দিষ্ট ক্ষেত্রের নামের জন্য অনুমোদিত ক্রেতাদের RTB এবং OpenRTB এক্সটেনশনের প্রোটোকল ডকুমেন্টেশন পড়ুন।

বিড প্রতিক্রিয়া বিজ্ঞপ্তি

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

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

  • %%GOOGLE_QUERY_ID%% : এই ম্যাক্রোটি Google কোয়েরি আইডি (অনুমোদিত ক্রেতা প্রোটোকলে BidRequest.google_query_id এবং OpenRTB প্রোটোকলে BidRequest.ext.google_query_id ) দ্বারা প্রতিস্থাপিত হয়েছে যা সুরক্ষিত দর্শক-সক্ষম প্রাসঙ্গিক বিড অনুরোধে পাঠানো হয়েছিল।
  • %%INTEREST_GROUP_OWNER%% : স্বার্থ গোষ্ঠীর মালিকের উৎপত্তি৷
  • %%BID_CPM%% : CPM-এ বিড মূল্য যা ক্রেতার দ্বারা generateBid() ফাংশনে নির্দিষ্ট করা হয়েছিল।
  • %%RENDER_URL%% : সৃজনশীলের রেন্ডার URL।
  • %%STATUS%% : একটি স্ট্যাটাস কোড যদি বিডটি scoreAd() মধ্যে প্রত্যাখ্যাত হয়। মান হল সৃজনশীল স্ট্যাটাস কোড

এখানে একটি নমুনা স্ট্যাটিক URL রয়েছে যা একজন দরদাতা তাদের অ্যাকাউন্ট ম্যানেজার প্রদান করতে পারে:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

বিড ফিডব্যাক বিজ্ঞপ্তি হল একটি অস্থায়ী বৈশিষ্ট্য যা Chrome-এর অস্থায়ী ForDebuggingOnly API-এর উপর নির্ভর করে।

পণ্য-স্তরের TURTLEDOVE

প্রোটেক্টেড অডিয়েন্স API পরীক্ষার সময় Google RTB অংশীদারদের জন্য একাধিক টুকরা বা পণ্য-স্তরের TURTLEDOVE (PLTD) দিয়ে তৈরি বিজ্ঞাপনগুলি সমর্থিত। আপনি যদি PLTD পরীক্ষা করার পরিকল্পনা করেন তাহলে ইন্টিগ্রেশনের সময় আপনার অ্যাকাউন্ট ম্যানেজারকে জানান, কারণ অতিরিক্ত সংস্থান এবং কনফিগারেশন প্রয়োজন।

অনবোর্ডিং

আপনি কীভাবে সুরক্ষিত শ্রোতা API পরীক্ষা করতে পারেন তা এখানে:

ধাপ

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

সৃজনশীল পর্যালোচনা

প্রোটেক্টেড অডিয়েন্স এপিআই নিলামে পণ্য-স্তরের বিজ্ঞাপন ( একাধিক টুকরো দিয়ে গঠিত বিজ্ঞাপন ) দিয়ে বিড করার জন্য, এই প্রয়োজনীয়তাগুলি অনুসরণ করুন:

  • সৃজনশীল পর্যালোচনার সময় শীর্ষ-স্তরের renderUrls আলাদা করতে উপাদান বিজ্ঞাপনের ধারকটির জন্য renderUrl &pltd=True ক্যোয়ারী প্যারামিটারটি অন্তর্ভুক্ত করুন (এটি শীর্ষ-স্তরের renderUrl বলা হয়)।
  • Google দ্বারা সৃজনশীল পর্যালোচনার জন্য উপাদান বিজ্ঞাপনের ধারকটি আনা হলে একটি প্রতিনিধি সৃজনশীল রেন্ডার করুন৷ একটি প্রতিনিধি বিজ্ঞাপন রেন্ডারিং কখন ফেরত দেওয়া উচিত তা বোঝার জন্য, আপনি Google সৃজনশীল পর্যালোচনা সিস্টেম দ্বারা সেট করা validation=True ক্যোয়ারী প্যারামিটারটি উল্লেখ করতে পারেন।

ইন্টিগ্রেশন চেকলিস্ট

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

পরীক্ষার পর্যায়

পর্যায় 1: ম্যানুয়াল পরীক্ষা

এখানে কীভাবে ম্যানুয়ালি একটি সুরক্ষিত দর্শক নিলাম ট্রিগার করবেন, বিজ্ঞাপনটি রেন্ডার করা যাবে তা নিশ্চিত করুন এবং ইমপ্রেশন রেকর্ড করুন:

  1. Chrome 101 বা তার পরে ব্যবহার করুন।
  2. chrome://flags/#privacy-sandbox-ads-apis এবং chrome://flags/#enable-fenced-frames ব্যবহার করে গোপনীয়তা স্যান্ডবক্স API এবং বেড়াযুক্ত ফ্রেম সক্ষম করুন৷ গোপনীয়তা স্যান্ডবক্স পরীক্ষায় আরও দেখুন।
  3. রিয়েল-টাইম বিডিং API ব্যবহার করে অনুমোদনের জন্য একটি সৃজনশীল জমা দিন।
  4. দরদাতা-প্রদত্ত বিজ্ঞাপনদাতা পৃষ্ঠা ব্যবহার করুন দরদাতার মালিকানাধীন স্বার্থ গ্রুপে একটি ব্রাউজার যোগ করতে।
  5. একটি সুরক্ষিত শ্রোতা নিলাম ট্রিগার করতে নিম্নলিখিত Google-প্রদত্ত পরীক্ষা প্রকাশক পৃষ্ঠাটি ব্যবহার করুন:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

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

  6. নিম্নলিখিত যাচাই করুন:

    1. প্রত্যাশিত বিজয়ী বিজ্ঞাপন রেন্ডার করা হয়।
    2. নিলামের ফলাফল সার্ভার-সাইডে পাঠানো হয়—অর্থাৎ একজন বিজয়ী দরদাতা reportWin() থেকে পিং ব্যাক পায়।
    3. পরীক্ষা প্রকাশক পৃষ্ঠা কনসোল নিম্নলিখিত তথ্য সহ প্রতিটি বিডের জন্য একটি ডিবাগ বার্তা লগ করে:
      • renderUrl : বিডের রেন্ডার ইউআরএল।
      • interestGroupOwner : বিডের স্বার্থ গোষ্ঠীর মালিক।
      • accepted : বিড গৃহীত হলে এই ক্ষেত্রটি true এবং scoreAd() দ্বারা বিড প্রত্যাখ্যান হলে false
      • externalBidStatus : একটি স্ট্যাটাস কোড যদি বিডটি scoreAd() মধ্যে প্রত্যাখ্যাত হয়। মান হল সৃজনশীল স্ট্যাটাস কোড

পর্যায় 2: (ঐচ্ছিক) নন-রেন্ডারিং পরীক্ষা

Google এবং অংশীদার ম্যানুয়ালি যাচাই করার পরে যে অংশীদার সুরক্ষিত শ্রোতা নিলামে অংশ নিতে পারে, Google পরবর্তী পর্যায়ে পরীক্ষার জন্য অংশীদারকে সক্ষম করে।

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

আপনি প্রস্তুত হলে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন বা অনুমোদিত ক্রেতা সহায়তা কেন্দ্রের মাধ্যমে একটি টিকিট ফাইল করুন৷ Google এই পর্যায়ের জন্য অ্যাকাউন্ট সক্রিয় করবে।

পর্যায় 3: রেন্ডারিং পরীক্ষা

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

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

অতিরিক্ত বৈশিষ্ট্য

নিম্নলিখিত বৈশিষ্ট্যগুলি মূল প্রোটোকলের এক্সটেনশন।

সমান্তরালকরণ

সমান্তরালকরণ হ'ল একটি অপ্টিমাইজেশন যা trustedBiddingSignalsUrl -তে নির্দিষ্ট ক্রেতা বিশ্বস্ত সার্ভারগুলির অনুরোধগুলির সাথে সমান্তরালে প্রাসঙ্গিক বিজ্ঞাপন অনুরোধটি শুরু করে শেষ থেকে শেষের নিলামের বিলম্বকে হ্রাস করে।

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

পরিবেশন প্রবাহ সারাংশ

এখানে সমান্তরাল নিলাম প্রবাহের সংক্ষিপ্তসার: Flow diagram

অন-ডিভাইস সুদের গ্রুপ ক্রেতার যোগ্যতা

সমান্তরাল নিলামের জন্য, navigator.runAdAuction এর কলটি প্রাসঙ্গিক বিজ্ঞাপন প্রতিক্রিয়া ফিরে আসার আগে ঘটে। ক্রেতার বিশ্বস্ত সার্ভার কলগুলি শুরু করার জন্য, navigator.runAdAuction জন্য প্রয়োজন যে interestGroupBuyers প্যারামিটারটি অবশ্যই একটি মান হিসাবে পাস করা উচিত, যখন বাকি নিলামের পরামিতিগুলি জাভাস্ক্রিপ্ট প্রতিশ্রুতিগুলি গ্রহণ করে যা প্রাসঙ্গিক বিজ্ঞাপন প্রতিক্রিয়ার পরে সমাধান করা যেতে পারে। যেহেতু প্রাসঙ্গিক বিজ্ঞাপন প্রতিক্রিয়ার আগে interestGroupBuyers পাস করা হয়, তাই প্রদত্ত অনুরোধের জন্য কোন ক্রেতারা সমান্তরাল নিলামে অংশ নেয় তা চয়ন করতে প্রাসঙ্গিক বিজ্ঞাপন প্রতিক্রিয়া (বিড প্রতিক্রিয়া সহ) ব্যবহার করা যায় না। পরিবর্তে গুগলের প্রকাশক ট্যাগ ক্যাশে, ব্যবহারকারীর ব্রাউজারে, পূর্বের navigator.runAdAuction থেকে interestGroupBuyers প্যারামিটার an একই ডোমেনে রুনাডাকশন মৃত্যুদন্ড কার্যকর করা।

সমান্তরালকরণের বেশ কয়েকটি গুরুত্বপূর্ণ বিবেচনা রয়েছে:

  1. নিলাম সংকেতগুলি যা ক্রেতার বিশ্বস্ত সার্ভার অনুরোধগুলির জন্য যেমন প্রয়োজন হয় না, যেমন perBuyerSignals , অ-সমান্তরাল নিলামের মতো একইভাবে আরটিবি বিড প্রতিক্রিয়াগুলিতে নির্দিষ্ট করা যেতে পারে। একবার এই সংকেতগুলির প্রতিশ্রুতিগুলি সমাধান হয়ে গেলে, অন-ডিভাইস নিলামের অবশিষ্ট পদক্ষেপগুলি সমান্তরাল নিলাম প্রবাহের মতো একই পদ্ধতিতে সম্পূর্ণ হবে।

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

  3. যদি কোনও দরদাতাদের জন্য কমপক্ষে একজন ক্রেতা বর্তমান প্রকাশক ডোমেনের জন্য ক্যাশে করা হয় তবে গুগল একটি সমান্তরাল নিলাম চালাবে, যা বিডের অনুরোধে নির্দেশিত হবে:

    • গুগল আরটিবি প্রোটোকল: BidRequest.adslot.interest_group_auction.parallelized
    • ওপেনআরটিবি: BidRequest.imp.ext.interest_group_auction.parallelized
  4. সমান্তরাল নিলামে অন্তর্ভুক্ত থাকা প্রদত্ত দরদাতার জন্য প্রতিটি নিবন্ধিত সুদ গোষ্ঠী ক্রেতা উত্সের সাথে সম্পর্কিত ParallelAuctionBuyer রয়েছে:

    • গুগল আরটিবি প্রোটোকল: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • ওপেনআরটিবি: BidRequest.imp.ext.interest_group_auction.pbuyer
  5. যদি একটি সমান্তরাল নিলাম চালানো হয় তবে একটি নির্দিষ্ট ক্রেতা উত্স ক্যাশে উপস্থিত না থাকে, তবে সেই প্রদত্ত ক্রেতা বর্তমান অন-ডিভাইস নিলামে যুক্ত করা যায় না। এটি parallelized=True সাথে একটি অনুরোধ দ্বারা নির্দেশিত হয়েছে যা প্রদত্ত সুদের গ্রুপ ক্রেতা উত্সের জন্য ParallelAuctionBuyer প্রবেশের অভাব রয়েছে। যাইহোক, দরদাতাদের তাদের বিড প্রতিক্রিয়াতে বৈধ এবং যোগ্য InterestGroupBuyer (গুলি) অন্তর্ভুক্ত করে আগ্রহের ইঙ্গিত দেয় এমন ক্যাশে যুক্ত করা সুদের গ্রুপ ক্রেতা উত্সগুলি যুক্ত থাকবে এবং সেই উত্সগুলি একই ব্রাউজার এবং ডোমেনের ভবিষ্যতের সমান্তরাল অনুরোধগুলির জন্য যোগ্য হবে। আগ্রহের গ্রুপ নিলামে অংশ নেওয়ার অভিপ্রায় নিম্নলিখিত ক্ষেত্রগুলিতে নির্দেশিত হতে পারে:

    • গুগল আরটিবি প্রোটোকল: BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • ওপেনআরটিবি: BidResponse.ext.igbid.igbuyer
  6. ক্যাশেড ক্রেতার উত্স (যা সমান্তরাল নিলামের interestGroupBuyers প্যারামিটারে অন্তর্ভুক্ত রয়েছে) যার জন্য একজন দরদাতারা তাদের বিড প্রতিক্রিয়াতে অংশ নেওয়ার অভিপ্রায় নির্দেশ করে না তবে কোনও ক্রেতা বিশ্বস্ত সার্ভার কল পেতে পারে তবে সমান্তরাল নিলামে অংশ নেবে না।