সুরক্ষিত দর্শক (পূর্বে FLEDGE নামে পরিচিত) ইন্টিগ্রেশন এবং এসএসপিগুলির জন্য টেস্টিং গাইড

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

SSPs Protected Audience API এর সাথে Display & Video 360 এবং Google Ads পরীক্ষা করতে পারে:

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

নিম্নলিখিত নির্দেশিকা একটি SSP এবং Display & Video 360 এবং Google বিজ্ঞাপনগুলির মধ্যে ইন্টিগ্রেশনের বিশদ বিবরণ দেয়৷ একটি পরীক্ষা সমন্বয় করতে আগ্রহী SSPদের তাদের Display & Video 360 অংশীদারি প্রতিনিধির সাথে যোগাযোগ করা উচিত।

তালিকাভুক্তি

সুরক্ষিত দর্শক এপিআই ব্যবহার করার জন্য SSP-দের নিজেদের নিবন্ধন করা উচিত।

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

নিম্নলিখিত চিত্রটি Chrome, SSP, Display & Video 360 এবং Google বিজ্ঞাপনগুলির মধ্যে প্রধান ইন্টারঅ্যাকশন পয়েন্টগুলির রূপরেখা দিয়ে জেনেরিক প্রবাহ দেখায়৷

ইন্টিগ্রেশন অপশন

বিকল্প 1: সরাসরি / একক-বিক্রেতা

পদক্ষেপ:

1. SSP বিজ্ঞাপন ট্যাগ SSP সার্ভারে বিজ্ঞাপনের অনুরোধ পাঠায় যা নির্দেশ করে যে ব্রাউজারটি Protected Audience API সমর্থন করে।
2. এসএসপি সার্ভার ডিএসপিকে প্রাসঙ্গিক OpenRTB বিড অনুরোধ পাঠায় যা নির্দেশ করে যে ব্রাউজারটি সুরক্ষিত দর্শক API সমর্থন করে
3. ডিএসপি একটি OpenRTB বিড প্রতিক্রিয়া সহ ডিভাইসে নিলামের জন্য সংকেত সহ প্রতিক্রিয়া জানায়৷
4. SSP সার্ভার SSP বিজ্ঞাপন ট্যাগে নিলাম কনফিগারেশন সহ বিজ্ঞাপন প্রতিক্রিয়া পাঠায়।
5. SSP বিজ্ঞাপন ট্যাগ runAdAuction() কল করে ডিভাইসে নিলাম শুরু করে, যা perBuyerSignals এর মাধ্যমে DSP-এর openRTB বিড প্রতিক্রিয়া থেকে সংকেত দেয়।
6. রিয়েল-টাইম বিডিং সিগন্যাল আনতে Chrome কী/মান বিশ্বস্ত DSP বিডিং সার্ভারে কল করে।
7. ক্রোম প্রতিটি অংশগ্রহণকারী আগ্রহ গোষ্ঠীর জন্য generateBid() ডিএসপি জাভাস্ক্রিপ্ট ফাংশন কল করে।
8. ক্রোম রিয়েল-টাইম স্কোরিং সংকেত আনতে কী/মান বিশ্বস্ত SSP স্কোরিং সার্ভারকে কল করে।
9. Chrome প্রতিটি অংশগ্রহণকারী আগ্রহ গোষ্ঠীর জন্য scoreAd() SSP জাভাস্ক্রিপ্ট ফাংশন কল করে।
10. ক্রোম reportWin() ডিএসপি জাভাস্ক্রিপ্ট ফাংশনকে ডিএসপিকে বিজয়ীর রিপোর্ট করতে কল করে।
11. ক্রোম reportResult() এসএসপি জাভাস্ক্রিপ্ট ফাংশনকে এসএসপি-তে বিজয়ীর রিপোর্ট করতে কল করে।

SSP দিকে ন্যূনতম পরিবর্তন

• SSP বিজ্ঞাপন ট্যাগ আপডেট করা প্রয়োজন

  • ব্রাউজার সুরক্ষিত শ্রোতা API সমর্থন করে কিনা তা সনাক্ত করুন
  • SSP সার্ভারে বিজ্ঞাপনের অনুরোধের অংশ হিসাবে সেই তথ্য পাঠান [1]
  • DSP-এর OpenRTB বিড রেসপন্স থেকে সংকেত পাস করে runAdAuction() কল করে একটি অন-ডিভাইস নিলাম শুরু করুন [5] (নীচে বিড অনুরোধ এবং প্রতিক্রিয়া কাঠামোর ক্রেতার ডেটা ক্ষেত্র দেখুন)।

• এসএসপি সার্ভার প্রয়োজন

  • ওপেনআরটিবি বিড রিকোয়েস্টের ফিল্ডের মাধ্যমে ডিএসপি-তে প্রোটেক্টেড অডিয়েন্স এপিআই সমর্থন সম্পর্কে তথ্য প্রচার করুন [2] (নীচের বিড অনুরোধ এবং প্রতিক্রিয়া কাঠামোর বিভাগ দেখুন)।
  • SSP বিজ্ঞাপন ট্যাগের OpenRTB বিড রেসপন্সে DSP-এর ক্রেতার সংকেত প্রচার করুন (নীচে বিড রিকোয়েস্ট/বিড রেসপন্স স্ট্রাকচারের অংশ দেখুন) [4]

• [Optional] বিজ্ঞাপনের গুণমান পরীক্ষা, প্রকাশক সেটিংস প্রয়োগকে সমর্থন করার জন্য রিয়েলটাইম স্কোরিং সংকেত আনতে SSP-কে বিশ্বস্ত SSP সার্ভার প্রয়োগ করতে হবে [8]

• SSP কে "scoreAd(...)" এবং "reportResult(...)" ফাংশন সহ জাভাস্ক্রিপ্ট প্রয়োগ করতে হবে [9] , [11]

বিকল্প 2: বহু-বিক্রেতা

পদক্ষেপ:

1. SSP অ্যাডাপ্টার SSP সার্ভারে বিজ্ঞাপনের অনুরোধ পাঠায় যা নির্দেশ করে যে ব্রাউজারটি প্রোটেক্টেড অডিয়েন্স API সমর্থন করে।
2. এসএসপি সার্ভার ডিএসপিকে প্রাসঙ্গিক ওপেনআরটিবি বিডের অনুরোধ পাঠায় যা নির্দেশ করে যে ব্রাউজারটি প্রোটেক্টেড অডিয়েন্স API সমর্থন করে,
3. ডিএসপি সার্ভার ওপেনআরটিবি বিড প্রতিক্রিয়া সহ ডিভাইসে নিলামের জন্য সংকেত সহ সাড়া দেয়।
4. SSP সার্ভার SSP বিজ্ঞাপন ট্যাগে নিলাম কনফিগারেশন সহ বিজ্ঞাপন প্রতিক্রিয়া পাঠায়।
5. SSP প্রিবিড অ্যাডাপ্টার প্রকাশক বিজ্ঞাপন সার্ভার ট্যাগে উপাদান নিলাম কনফিগারেশন প্রদান করে।
6. প্রকাশক বিজ্ঞাপন সার্ভার ট্যাগ প্রকাশক বিজ্ঞাপন সার্ভার সার্ভারে বিজ্ঞাপন অনুরোধ পাঠায়।
7. Publisher Ad Server ট্যাগ runAdAuction(...) API কল করে অন-ডিভাইস নিলাম শুরু করে।
8. রিয়েল-টাইম বিডিং সিগন্যাল আনতে Chrome কী/মান বিশ্বস্ত DSP বিডিং সার্ভারে কল করে।
9. ক্রোম প্রতিটি অংশগ্রহণকারী আগ্রহ গোষ্ঠীর জন্য generateBid() ডিএসপি জাভাস্ক্রিপ্ট ফাংশন কল করে।
10. ক্রোম রিয়েল-টাইম স্কোরিং সংকেত আনতে কী/মান বিশ্বস্ত SSP স্কোরিং সার্ভারকে কল করে।
11. Chrome প্রতিটি অংশগ্রহণকারী আগ্রহ গোষ্ঠীর জন্য scoreAd() SSP জাভাস্ক্রিপ্ট ফাংশন কল করে।
12. ক্রোম reportWin() ডিএসপি জাভাস্ক্রিপ্ট ফাংশনকে ডিএসপিকে বিজয়ীর রিপোর্ট করতে কল করে।
13. ক্রোম reportResult() এসএসপি জাভাস্ক্রিপ্ট ফাংশনকে এসএসপি-তে বিজয়ীর রিপোর্ট করতে কল করে।

SSP দিকে ন্যূনতম পরিবর্তন

• SSP অ্যাডাপ্টার আপডেট করা প্রয়োজন

  • ব্রাউজার সুরক্ষিত দর্শক সমর্থন করে কিনা তা সনাক্ত করুন
  • SSP সার্ভারে বিজ্ঞাপনের অনুরোধের অংশ হিসাবে সেই তথ্য পাঠান [1]
  • প্রকাশক বিজ্ঞাপন সার্ভার বিজ্ঞাপন ট্যাগে উপাদান নিলাম কনফিগারেশন প্রদান করুন [5] ।
  • যদি Google Ad Manager হয় প্রকাশক বিজ্ঞাপন সার্ভার, তাহলে SSP হয় * প্রিবিড প্রোটেক্টেড অডিয়েন্স মডিউল ব্যবহার করতে পারে * একাধিক বিক্রেতার সাথে Google Ad Manager বিজ্ঞাপন ট্যাগ setConfig() API কল করতে পারে

• এসএসপি সার্ভার প্রয়োজন

  • ওপেনআরটিবি বিড রিকোয়েস্টের ফিল্ডের মাধ্যমে ডিএসপিকে সুরক্ষিত শ্রোতা সমর্থন সম্পর্কে তথ্য প্রচার করুন [2] (নীচের বিড অনুরোধ এবং প্রতিক্রিয়া কাঠামোর বিভাগ দেখুন)।
  • SSP বিজ্ঞাপন ট্যাগের OpenRTB বিড প্রতিক্রিয়াতে DSP-এর ক্রেতার সংকেত প্রচার করুন (নীচে বিড অনুরোধ / বিড প্রতিক্রিয়া কাঠামোর বিভাগ দেখুন) [4]

• [Optional] বিজ্ঞাপনের গুণমান পরীক্ষা, প্রকাশক সেটিংস প্রয়োগকে সমর্থন করার জন্য রিয়েলটাইম স্কোরিং সংকেত আনতে SSP-কে বিশ্বস্ত SSP সার্ভার প্রয়োগ করতে হবে [10]

• SSP-কে scoreAd() এবং reportResult() ফাংশন [11] , [14] সহ জাভাস্ক্রিপ্ট প্রকাশ করতে হবে।

বিডিং এবং নিলাম পরিষেবা

আমরা বিডিং অ্যান্ড অকশন সার্ভিসেস (বিএন্ডএ) proposal ঘনিষ্ঠভাবে মূল্যায়ন করছি।

যখন Display & Video 360 B&A-এর সাথে সুরক্ষিত শ্রোতা API পরীক্ষা করার জন্য প্রস্তুত, তখন আমরা আরও বিশদ বিবরণের সাথে যোগাযোগ করব।

OpenRTB প্রোটোকল

বিড অনুরোধ

শুধুমাত্র স্ট্যান্ডার্ড সার্ভার-সাইড এক্সচেঞ্জ নিলামকে সমর্থন করে এমন ইম্প্রেশন সুযোগগুলির মধ্যে পার্থক্য করার জন্য যা প্রোটেক্টেড অডিয়েন্স API অন-ডিভাইস নিলাম সমর্থন করে, OpenRTB-তে Imp অবজেক্টের এক্সটেনশন হিসাবে "নিলাম পরিবেশ" এর জন্য ae নামে একটি নতুন enum ক্ষেত্র যোগ করা উচিত। প্রদত্ত ইম্প্রেশন স্লট দ্বারা কোন নিলাম পরিবেশ সমর্থিত তা উল্লেখ করার জন্য বিড অনুরোধ। ae enum এর নিম্নলিখিত মান থাকতে পারে:

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

{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

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

প্রাসঙ্গিক বিডগুলি ছাড়াও, একটি বিড প্রতিক্রিয়া ডিসপ্লে এবং ভিডিও 360 এবং সুরক্ষিত দর্শক API আগ্রহ গ্রুপ নিলামে Google বিজ্ঞাপনের অংশগ্রহণের সাথে সম্পর্কিত তথ্য পাস করতেও ব্যবহৃত হয়। নিম্নরূপ স্বার্থ গ্রুপ নিলাম সমর্থন করার জন্য বিড প্রতিক্রিয়া আপডেট করা হয়েছে:

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

নিম্নলিখিত পরিস্থিতিতে সমর্থিত.

• পরিস্থিতি 1: Display & Video 360 এবং Google Ads শুধুমাত্র একটি প্রাসঙ্গিক নিলামে অংশগ্রহণ করতে চায়। এই পরিস্থিতিতে কোন igbid ক্ষেত্র উপস্থিত নেই.

• দৃশ্যকল্প 2: Display & Video 360 এবং Google Ads শুধুমাত্র একটি স্বার্থ গোষ্ঠীর নিলামে অংশগ্রহণ করতে চায়। এই পরিস্থিতিতে Display & Video 360 এবং Google Ads বিডের প্রতিক্রিয়ায় সিটবিড ফিল্ড ছেড়ে দেবে এবং শুধুমাত্র igbid তথ্য ফেরত দেবে। অন্য কথায়, igbid ক্ষেত্রের উপস্থিতি ইঙ্গিত করে যে Display & Video 360 এবং Google Ads তাদের আগ্রহের গোষ্ঠীগুলিকে ডিভাইসের নিলামে অংশগ্রহণ করতে চায়।

• দৃশ্যকল্প 3: Display & Video 360 এবং Google Ads প্রাসঙ্গিক এবং আগ্রহের গোষ্ঠী উভয় নিলামে অংশগ্রহণ করতে চায়। এই পরিস্থিতিতে Display & Video 360 এবং Google Ads বিড প্রতিক্রিয়া এবং igbid তথ্য উভয় আসনবিড ফিল্ড ফিরিয়ে দেবে।

বিজ্ঞাপন বিড সহ মেটাডেটা

প্রোটেক্টেড অডিয়েন্স API generateBid() ফাংশন থেকে বিজ্ঞাপন সম্পর্কে passing arbitrary metadata অনুমতি দেয়।

Display & Video 360 বিজ্ঞাপন মেটাডেটার জন্য নিম্নলিখিত specification উপর নির্ভর করার পরিকল্পনা করছে: সুরক্ষিত দর্শক API এবং OpenRTB।

যেমন Display & Video 360 বিজ্ঞাপন অবজেক্টের অংশ হিসাবে নিম্নলিখিত ক্ষেত্রগুলি ফিরিয়ে দেবে:

PA বৈশিষ্ট্য	টাইপ	OpenRTB বর্ণনা
বিজ্ঞাপন আসন	স্ট্রিং; প্রয়োজনীয়	ক্রেতা আসনের আইডি (যেমন, বিজ্ঞাপনদাতা, সংস্থা) যার পক্ষে এই বিড করা হয়েছে।
ad.adomain	স্ট্রিং[]	ব্লক তালিকা পরীক্ষা করার জন্য বিজ্ঞাপনদাতা ডোমেন (যেমন, "ford.com")। এটি ঘূর্ণায়মান ক্রিয়েটিভের ক্ষেত্রে একটি অ্যারে হতে পারে। এক্সচেঞ্জগুলি আদেশ দিতে পারে যে শুধুমাত্র একটি ডোমেন অনুমোদিত৷
ad.cid	স্ট্রিং	বিজ্ঞাপনের গুণমান পরীক্ষায় সহায়তা করার জন্য প্রচারাভিযানের আইডি।
ad.crid	স্ট্রিং	বিজ্ঞাপনের গুণমান পরীক্ষায় সহায়তা করার জন্য ক্রিয়েটিভ আইডি।
ad.language	স্ট্রিং	ISO-639-1-আলফা-2 ব্যবহার করে সৃজনশীলের ভাষা। সৃজনশীলের কোনো ভাষাগত বিষয়বস্তু না থাকলে (যেমন, শুধুমাত্র একটি কোম্পানির লোগো সহ একটি ব্যানার) নন-স্ট্যান্ডার্ড কোড "xx" ব্যবহার করা যেতে পারে। শুধুমাত্র একটি ভাষা বা ল্যাঙ্গব উপস্থিত থাকতে হবে।
ad.w	পূর্ণসংখ্যা	ডিভাইস স্বাধীন পিক্সেলে ক্রিয়েটিভের প্রস্থ (DIPS)।
ad.h	পূর্ণসংখ্যা	ডিভাইস স্বাধীন পিক্সেলে ক্রিয়েটিভের উচ্চতা (DIPS)।

উদাহরণ

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

ইভেন্ট রিপোর্টিং

Protected Audience API এই GitHub পোস্টে বর্ণিত একটি ইভেন্ট-লেভেল রিপোর্টিং API প্রদান করে: Fenced Frame Ads Reporting । যদিও নামটি বলে বেড়াযুক্ত ফ্রেম বিজ্ঞাপন প্রতিবেদন করা এপিআই বেড়াযুক্ত ফ্রেম এবং আইফ্রেম উভয়েই উপলব্ধ (বিস্তারিত here দেখুন)।

SSP তাদের reportResult ফাংশনে ব্রাউজারের সাথে registerAdBeacon() API কল করে একটি URL নিবন্ধন করতে পারে।

ডিসপ্লে এবং ভিডিও 360 ইম্প্রেশন এবং ক্লিক ইভেন্টগুলি রিপোর্ট করতে ক্রিয়েটিভের মধ্যে থেকে গন্তব্য 'কম্পোনেন্ট-সেলার' সহ reportEvent() API কল করবে। এর ফলে নিবন্ধিত URL-এ একটি বীকন পাঠানো হবে।

মনে রাখবেন যে Display & Video 360 খালি পোস্ট ডেটা সহ ইম্প্রেশন এবং ক্লিকের জন্য reportEvent() API কল করবে।

উদাহরণ

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

কুকি অবচয় পরীক্ষার লেবেল

Display & Video 360 থার্ড-পার্টি কুকি অবলুপ্তির Chrome-facilitated testing অংশগ্রহণ করতে যাচ্ছে। পরীক্ষাটি করতে সক্ষম হওয়ার জন্য আমরা অংশীদারদেরকে নিম্নলিখিত specification অনুযায়ী OpenRTB বিড অনুরোধে Chrome লেবেল পাস করতে বলি:

অবজেক্ট: Device.ext

বৈশিষ্ট্য	টাইপ	বর্ণনা
cdep	স্ট্রিং	Chrome বা আপস্ট্রিম অংশীদার থেকে প্রাপ্ত লেবেল।

সম্পর্কিত নথি

• ক্রোম ডেভেলপারদের সুরক্ষিত শ্রোতা API
• GitHub-এ প্রথম পরীক্ষা