به‌عنوان بخشی از جعبه ایمنی حریم خصوصی ، Chrome API مخاطب محافظت‌شده را پیشنهاد کرد - یک API درون مرورگر که به تبلیغ‌کنندگان و شرکت‌های فناوری تبلیغات اجازه می‌دهد بدون اتکا به کوکی‌های شخص ثالث، تبلیغات هدف‌مند گروه‌های علاقه‌مند را نشان دهند و در عین حال از کاربران در برابر ردیابی بین‌سایتی محافظت می‌کند.
در Protected Audience API، هنگامی که یک تبلیغ بازاریابی مجدد برنده حراج می شود، URL رندر آگهی برای رندر به یک قاب حصاردار ارسال می شود. یک قاب حصاردار یک عنصر HTML پیشنهادی برای محتوای جاسازی شده است، شبیه به iframe. برخلاف iframes، یک قاب حصاردار ارتباط با زمینه تعبیه‌شده خود را محدود می‌کند تا به قاب اجازه دسترسی به داده‌های بین سایتی را بدون اشتراک‌گذاری آن با زمینه تعبیه‌شده بدهد. برای جزئیات بیشتر، به توضیح موارد استفاده از قاب های حصاردار مراجعه کنید.
Display & Video 360 از لیستی از ماکروها برای ارائه دهنده اندازه گیری پشتیبانی می کند تا از آنها برای ردیابی نمایش و کلیک استفاده کند. تنها زیر مجموعه کوچکی از این ماکروها را می توان به عنوان بخشی از رندر خلاق جایگزین کرد، زیرا سیگنال های متنی و حراجی وجود ندارد. برای مثال، ${PUBLISHER_ID} بدون تغییر در برچسب‌های ارائه‌دهنده اندازه‌گیری شکسته می‌شود.
این راهنما برای شرکای اندازه‌گیری آگهی طراحی شده است که رویدادهای تبلیغ‌کنندگانی را که از Display & Video 360 استفاده می‌کنند، ردیابی می‌کنند .
ثبت نام
از آگوست 2023، ارائه‌دهندگان اندازه‌گیری ممکن است برای ثبت نام خود برای استفاده از APIهای گزارش قاب محصور در API مخاطبان محافظت‌شده، لازم باشد مراحل زیر را دنبال کنند.
جزئیات در مورد اینکه چگونه و چه کسی باید ثبت نام کند
یکپارچه سازی
برچسب‌های نمایش ارائه‌دهنده اندازه‌گیری
دستورالعمل راه اندازی:
| برچسب های اسکریپت | مثال<script src='https://tracking.com/a.js'>xxx</script> reportEvent API برای ردیابی برداشت (به راهنمایی زیر مراجعه کنید). |
|---|---|
| برچسب های img | مثال<img src='https://tracking.com/'> reportEvent API برای ردیابی برداشت. |
ReportEvent API
API پیشنهاد شده بود که فقط برای ردیابی پس از رندر استفاده شود. API شامل دو بخش است: registerAdMacro و reportEvent .
- Display & Video 360 دارای تابع
registerAdMacroدرreportWinاست. این تابع قبل از فراخوانی، جفت‌های کلید-مقدار کلان را در مرورگر ثبت می‌کند. - بسته به نوع برچسب، Display & Video 360 یا ارائه‌دهندگان اندازه‌گیری مالک تغییرات برچسب‌های 3PAT برای استفاده از
reportEventAPI هستند.
reportEvent فقط 1 ورودی 'destinationURL' می گیرد که به سرورهای ارائه دهنده اندازه گیری اشاره می کند. می‌تواند حاوی هر ماکرو فهرست‌شده در Display & Video 360 Help Center باشد. به عنوان مثال:
window.fence.reportEvent({
'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});
وقتی Chrome پینگ URL را در تابع اجرا می‌کند، قبل از ارسال درخواست HTTP GET به https://adtech.example ماکروهای ثبت‌شده را جستجو کرده و مقادیر را جایگزین آنها می‌کند.
مراحل به روز رسانی تگ های اسکریپت
هیچ تغییری در برچسب‌های خلاق موجود نخواهد بود. Display & Video 360 همچنان برچسب‌های ارائه‌دهنده اندازه‌گیری را بدون تغییر به عنوان بخشی از بار خلاقانه ارائه می‌کند. هنگامی که ارائه‌دهندگان اندازه‌گیری پینگ‌های نمایش را از زمینه API مخاطب محافظت‌شده دریافت می‌کنند، باید مراحل زیر را برای ردیابی برداشت‌ها دنبال کنند:
یک URL نمایش ارائه دهنده اندازه گیری برای پذیرش پینگ های نمایش آماده کنید. به عنوان مثال:
https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123هنگام پاسخ دادن به اسکریپتی از Protected Audience API،
reportEventJS را اضافه کنید. به عنوان مثال:window.fence.reportEvent({ 'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123' });هنگام دریافت پینگ از نشانی اینترنتی نمایش پیکربندی شده در مرحله 1، نمایش‌های نمایش را ثبت کنید.
برچسب های کلیکی ارائه دهنده اندازه گیری
برچسب کلیک ارائه‌دهنده اندازه‌گیری موجود برای نمایش‌های مخاطب محافظت‌شده به کار خود ادامه می‌دهد. Display & Video 360 از فانوس reserved.top_navigation API گزارش‌دهی آگهی‌های Fenced Frames برای ثبت کلیک‌ها استفاده می‌کند و همه ردیاب‌های کلیک ارائه‌دهنده اندازه‌گیری را به‌عنوان تغییرمسیر زنجیره‌ای خواهد کرد. برای جزئیات بیشتر، به اسناد Chrome برای Fenced Frame Ads Reporting API مراجعه کنید.