اندازه گیری تبدیل را فعال کنید

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

اندازه‌گیری اسناد تبدیل می‌تواند شامل چندین طرف باشد، اعم از ناشر، تبلیغ‌کننده، خدمات فناوری تبلیغات (موجودی که تبلیغ را ارائه می‌دهد)، ارائه‌دهنده اندازه‌گیری، و موارد دیگر. در این سند، سناریوهای رایج اندازه‌گیری تبدیل را نشان می‌دهیم، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از API گزارش انتساب (ARA) است باید اطمینان حاصل کند که مراحل یکپارچه‌سازی شرح داده شده در این سند دنبال می‌شود.

برای مثال، معمول است که یک ناشر دارای یک یا چند فناوری تبلیغاتی مسئول ارائه آگهی باشد - این می‌تواند شامل طرف‌هایی باشد که مسئول ارائه نشانه‌گذاری برای آگهی خلاق هستند، طرف‌هایی که پیکسل‌های نمایش یا ردیابی آگهی را ارائه می‌کنند، و طرف‌هایی که SDK یا برچسب را برای جایگاه آگهی در صفحه ناشر ارائه می‌کنند. این فناوری‌های تبلیغاتی ممکن است بخواهند گزارش‌های انتساب را از ARA دریافت کنند یا نخواهند، اما برای اطمینان از اینکه فناوری‌های تبلیغات پایین‌دستی می‌توانند گزارش‌های انتساب را دریافت کنند، قرار گرفته‌اند.

علاوه بر این، ممکن است تبلیغ‌کننده از یک ارائه‌دهنده اندازه‌گیری تبدیل شخص ثالث برای انتساب بین شبکه‌ای و همچنین سایر قابلیت‌های گزارش‌دهی استفاده کند. تبلیغ‌کنندگان از این داده‌ها برای درک بازگشت سرمایه‌گذاری تبلیغات در چندین ناشر و کانال‌های منحصربه‌فرد استفاده می‌کنند، بنابراین مهم است که DSPها یا سرورهای آگهی بدانند چگونه API گزارش Attribution را برای پشتیبانی از این موارد استفاده فعال کنند. تبلیغ‌کنندگانی که می‌خواهند از شخص ثالث استفاده کنند، می‌توانند این کار را با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث یا با راه‌اندازی یک سرور داخلی برای ثبت‌نام و دریافت گزارش‌ها از API ادامه دهند.

Attribution Reporting API به چندین فناوری تبلیغات اجازه می‌دهد تا منابع و محرک‌های انتساب را برای یک نمایش یا تبدیل ثبت کنند و گزارش‌های جداگانه‌ای از API دریافت کنند. به عنوان مثال، یک DSP می‌تواند گزارش‌های انتساب خود را از Attribution Reporting API دریافت کند و همچنین اجازه گزارش جداگانه برای ارائه‌دهنده اندازه‌گیری شخص ثالث تبلیغ‌کننده را بدهد. یک فناوری تبلیغاتی برای دریافت گزارش‌ها از API باید هم منابع انتساب و هم محرک‌ها را ثبت کند، و انتساب در میان منابع انتساب و محرک‌هایی انجام می‌شود که فناوری آگهی به صورت جداگانه در API ثبت کرده است.

سناریوهای رایج اندازه گیری تبدیل

در این قسمت به بررسی دو سناریوی رایج برای اندازه گیری تبدیل می پردازیم.

سناریو 1: هم خدمات فناوری تبلیغات و هم ارائه‌دهنده اندازه‌گیری شخص ثالث باید گزارش‌هایی را از API گزارش Attribution دریافت کنند.

یک تبلیغ‌کننده می‌خواهد با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث، تبدیل‌ها را به موجودی آگهی نسبت دهد، و فناوری تبلیغاتی که میزبان خلاق است، می‌خواهد تبدیل‌ها را به موجودی آگهی نسبت دهد. این امر برای DSPها یا سرورهای تبلیغات تبلیغ‌کننده (سرور تبلیغات شخص ثالث - 3PAS) که نشانه‌گذاری را برای خلاقیت‌های تبلیغاتی ارائه می‌کنند، گزارش اسناد خود را انجام می‌دهند و با تبلیغ‌کنندگانی که با ارائه‌دهندگان اندازه‌گیری یا تجزیه و تحلیل شخص ثالث ادغام می‌شوند، رایج است.

در این مورد، فناوری تبلیغات ارائه دهنده نیز طرفی است که مسئول اجرای رویدادهای کلیک و نمایش در تنظیم فعلی است. فن‌آوری تبلیغات ارائه‌دهنده باید attributionsrc جدید را در مکان‌های مناسب تنظیم کند و مطمئن شود که تغییر مسیرها به درستی پیکربندی شده‌اند. همچنین، هم فناوری تبلیغات ارائه‌دهنده و هم ارائه‌دهنده اندازه‌گیری شخص ثالث باید اطمینان حاصل کنند که ثبت‌نام کرده‌اند و سرورهای آن‌ها آماده دریافت و پاسخ به درخواست‌های API Reporting Attribution هستند.

یک تنظیم کمپین معمولی می تواند به این صورت باشد:

1. سرور تبلیغات تبلیغ‌کننده (3PAS) نشانه‌گذاری خلاقیت آگهی را به DSP ارائه می‌کند، که شامل پیکسل‌های ردیابی نمایش و کلیک ارائه‌دهنده اندازه‌گیری شخص ثالث است. سرور آگهی باید اطمینان حاصل کند که attributionsrc در نشانه‌گذاری خلاقانه آگهی گنجانده شده است.

2. DSP قابلیت‌هایی را برای افزودن نمایش اندازه‌گیری اضافی و پیکسل‌های ردیابی کلیک ارائه می‌دهد، و باید مطمئن شود که attributionsrc در نشانه‌گذاری خلاق آگهی نهایی که با آن مناقصه می‌دهند گنجانده شده است.

سناریو 2: فقط ارائه‌دهنده اندازه‌گیری شخص ثالث باید گزارش‌هایی را از API گزارش Attribution دریافت کند.

یک تبلیغ‌کننده می‌خواهد با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث، تبدیل‌ها را در موجودی آگهی نسبت دهد، اما فناوری تبلیغاتی که میزبان خلاقیت است، هیچ الزامی برای اندازه‌گیری انتساب ندارد. این امر برای ناشران، SSPها یا سرورهای تبلیغاتی ناشر که میزبان خلاقیت هستند و نمی‌خواهند خودشان از گزارش انتساب استفاده کنند، معمول است، اما می‌خواهند API گزارش اسناد را برای شرکای DSP خود یا برای شرکت‌های برچسب‌گذاری اندازه‌گیری مانند سرورهای تبلیغات شخص ثالث، ارائه‌دهندگان اندازه‌گیری یا تجزیه و تحلیل فعال کنند.

در این مورد، طرفی که مسئول اجرای رویدادهای کلیک و نمایش در راه‌اندازی فعلی است، باید ویژگی attributionsrc جدید را به خلاقیت‌ها اضافه کند و اطمینان حاصل کند که تغییرمسیرها طبق برنامه کار می‌کنند. این به شدت به ادغام هر ناشر بستگی دارد، اما برای رویدادهای کلیکی، این می‌تواند SSP، خدمات فناوری تبلیغات یا خود ناشر باشد. برای رویدادهای نمایش، این معمولاً ارائه‌دهنده اندازه‌گیری شخص ثالث است.

در نمونه راه اندازی کمپین معمولی از سناریو 1، سرور تبلیغات ناشر، SSP یا خود ناشر ممکن است فقط نیاز داشته باشند که ویژگی attributionsrc ارائه شده توسط DSP را در صفحه ناشر قرار دهد.

جزئیات پیاده سازی

جدول زیر مراحل اجرای Attribution Reporting API را در سطح بالا شرح می دهد:

توجه داشته باشید که ویژگی‌های هر مرحله به نحوه ارائه و ارائه خلاقیت‌ها در صفحه ناشر و اینکه کدام نهادهای فناوری تبلیغات گزارش‌های ارسال شده توسط Attribution Reporting API را دریافت می‌کنند، بستگی دارد.

مرحله 1: منبع انتساب را برای خلاقیت های موجود و کد اندازه گیری فعال کنید

در مرحله اول، منابع انتساب فعال می شوند.

ویژگی attributionsrc چگونه کار می کند

ویژگی جدید attributionsrc مشخص می‌کند که درخواست‌های API گزارش Attribution به کجا ارسال می‌شوند. نهادی که مسئول ایجاد رویدادهای نمایش و کلیک است باید خلاقیت ها را با ویژگی attributionsrc به روز کند. attributionsrc باید به رویدادهای کلیک و نمایش موجود اضافه شود و می تواند خالی یا غیرخالی باشد.

برای رویدادهای کلیک با استفاده از تغییر مسیرها، ویژگی attributionsrc باید به پیمایش اضافه شود. هرگونه تغییر مسیر 302 بعد از پیمایش نیازی به افزودن ویژگی attributionsrc ندارد و تا زمانی که پیمایش اولیه attributionsrc اضافه کرده باشد، واجد شرایط ARA خواهد بود.

هنگامی که attributionsrc خالی است، درخواست‌های ARA به URL تعریف شده در ویژگی href تگ anchor (URL کلیک کنید) ارسال می‌شود. هنگامی که ویژگی attributionsrc تعریف می شود، درخواست های ARA به URL تعریف شده در ویژگی attributionsrc ارسال می شود. نشانی اینترنتی کلیک نیز برای ثبت منابع واجد شرایط است.

به طور کلی، اگر سرور میزبان URL کلیک می‌تواند درخواست‌های API Reporting Attribution را دریافت کند و به آن‌ها پاسخ دهد، از یک ویژگی خالی attributionsrc استفاده کنید. اگر می‌خواهید درخواست‌های API Reporting Attribution به سرور دیگری بروند، URL attributionsrc خود را تعریف کنید.

مثالی از ویژگی خالی attributionsrc :

وقتی مشخصه attributionsrc خالی باشد، درخواست‌های API Reporting Attribution به URL تعریف شده توسط ویژگی href تگ anchor ارسال می‌شود.

مثالی از ویژگی غیر خالی attributionsrc:

وقتی attributionsrc خالی نباشد، درخواست‌های Attribution Reporting API به URL تعریف‌شده توسط برچسب attributionsrc ارسال می‌شود. نشانی اینترنتی کلیک نیز برای ثبت منابع واجد شرایط است.

attributionsrc برای رویدادهای کلیک و نمایش اضافه کنید

• روی رویدادها کلیک کنید:
  • نهادی که مسئول افزودن attributionsrc است معمولاً فناوری ارائه دهنده آگهی است.
  • تگ‌های لنگر با رویدادهای کلیکی باید دارای ویژگی attributionsrc باشند.
  • کلیک‌ها با استفاده از window.open باید از آرگومان windowFeatures فراخوانی window.open برای تعیین منبع انتساب استفاده کنند.
• رویدادهای برداشت:
  • نهادی که مسئول افزودن attributionsrc است، معمولاً فناوری ارائه دهنده آگهی و ارائه دهنده(های) اندازه گیری است.
  • رویدادهای Impression ایجاد شده از تگ <img> یا تگ <script> باید شامل یک ویژگی attributionsrc باشد.
  • رویدادهای Impression با استفاده از Fetch API باید شامل یک شی attributionReporting در آرگومان گزینه‌های ارسال شده به فراخوانی fetch API باشد.

برای خلاصه تغییرات مورد نیاز برای رویدادهای کلیک و نمایش به جدول زیر مراجعه کنید:

ثبت منبع منبع را در حراج مخاطب محافظت شده فعال کنید

برای اندازه‌گیری تبدیل‌ها در حراج‌های مخاطب محافظت‌شده، به‌جای استفاده از attributionsrc ، می‌توانید از registerAdBeacon / registerAdMacro و setReportEventDataForAutomaticBeacons / reportEvent برای فعال کردن منابع انتساب استفاده کنید.

برای گزارش سیگنال های مخاطب محافظت شده، تابع registerAdBeacon در داخل Worklet های گزارش در دسترس است، و registerAdMacro در داخل Worklet گزارش برنده خریدار در دسترس است. سپس، داده‌های رویداد داخل قاب تبلیغات را می‌توان با توابع reportEvent و setReportEventDataForAutomaticBeacons در Fenced Frame Ads Reporting API به بیکن‌ها و ماکروهای ثبت‌شده اضافه کرد. این اجازه می دهد تا سیگنال های کارگروه گزارش مخاطب محافظت شده و بار رویداد قاب خلاقانه تبلیغات با یکدیگر مرتبط شوند.

هدر HTTP Attribution-Reporting-Eligible زمانی به درخواست اضافه می‌شود که چراغ‌ها و ماکروها با تماس reportEvent از یک فریم فعال شوند، یا چراغ‌های خودکار توسط مرورگر فعال شوند. برای ثبت منبع انتساب می توانید از پاسخ beacon استفاده کنید. ممکن است درخواست‌های beacon هدایت شوند تا امکان اندازه‌گیری شخص ثالث فراهم شود.

برای بررسی عمیق‌تر، به بخش پشتیبانی از گزارش انتساب توضیح‌دهنده API گزارش آگهی تبلیغاتی Fenced Frame مراجعه کنید.

فعال کردن گزارش انتساب برای قالب‌های VAST

VAST یک فرمت رایج برای ارائه و اندازه‌گیری موجودی آگهی‌های ویدیویی است، و بسیاری از رویدادهای تعریف‌شده در آن استاندارد باید رویدادهای منبع بالقوه واجد شرایط ثبت نام در API گزارش‌های Attribution را در نظر گرفت. ضمیمه VAST برای پشتیبانی گزارش انتساب این موضوع را با جزئیات پوشش می دهد، اما به طور خلاصه، همه رویدادهای <Tracking> ، <Impression> ، <*ClickThrough> و <*ClickTracking> رویدادهای منبع انتساب بالقوه هستند. همه پیاده سازی های VAST باید پوشش واجد شرایط بودن ثبت نام را برای این رویدادها فراهم کنند.

ضمیمه VAST ویژگی‌های جدیدی را برای این عناصر تعریف می‌کند تا امکان تنظیم یک URL ثانویه به‌طور خاص برای ثبت اسناد را فراهم کند. وقتی رویدادی حاوی attributiontype="DOUBLE_PING" و attributionsrc="[URL]" باشد، کدی که آن رویداد را فعال می‌کند باید از [URL] به عنوان مقدار ویژگی attributionsrc هنگام فعال کردن API گزارش انتساب استفاده کند. ضمیمه VAST شامل نمونه هایی برای هر سناریو است.

برای اطمینان از حداکثر پوشش، پیاده‌سازی‌های VAST باید باعث شوند که همه رویدادهای فهرست‌شده به‌طور پیش‌فرض در هنگام شلیک پینگ رویداد واجد شرایط ثبت نام باشند. به عنوان مثال، هنگام شلیک URL رویداد <Impression> ، باید از ویژگی (خالی) attributionsrc در عنصر <img> که برای ارسال درخواست استفاده می‌شود (یا معادل آن در تماس واکشی) استفاده شود تا همیشه به طرف گیرنده اجازه داده شود که به طور بالقوه آن رویداد را با API گزارش Attribution ثبت کند.

مرحله 2: گزارش Attribution را برای منابع شخص ثالث فعال کنید

برای اجازه دادن به اشخاص ثالث برای استفاده از Attribution Reporting API، می توانید از تغییر مسیرهای موجود استفاده کنید یا لیستی از اشخاص ثالث را به ویژگی attributionsrc اضافه کنید. در بیشتر موارد، هر فناوری تبلیغاتی ردیاب برداشت مستقل خود را دارد، بنابراین تغییر مسیرها برای ردیاب‌های کلیک مرتبط‌تر هستند.

منشاء شخص ثالث را در یک زنجیره تغییر مسیر موجود مدیریت کنید

در یک کلیک تبلیغاتی معمولی، بسیاری از ردیاب‌های کلیک ممکن است به‌عنوان زنجیره‌ای از 302 تغییر مسیر که به عنوان بخشی از پیمایش به صفحه فرود نهایی انجام می‌شود، وجود داشته باشد. اگر هدف کلیک اصلی با attributionsrc حاشیه‌نویسی شده باشد یا با registerAdBeacon/registerAdMacro در Protected Audience API ثبت شده باشد، هر درخواست در زنجیره تغییر مسیر واجد شرایط ثبت نام در API گزارش Attribution است. فناوری تبلیغات در زنجیره تغییر مسیر نیز باید ثبت شود .

توجه داشته باشید که بدنه درخواست اولیه در تغییر مسیرها ارسال نمی شود. برای حراج‌های مخاطب محافظت‌شده، اگر eventData به reportEvent منتقل شود و setReportEventDataForAutomaticBeacons باید به عنوان بخشی از تغییر مسیر استفاده شود، باید صریحاً به عنوان بخشی از URL تغییر مسیر داده شود.

در مثال زیر، ما از یک فناوری تبلیغاتی ارائه دهنده ( serving-adtech.example ) و یک ارائه دهنده اندازه گیری شخص ثالث ( 3p-measurement.example ) به عنوان دو موجودیت مجزا که به دنبال تولید و دریافت گزارش های انتساب هستند، استفاده خواهیم کرد. فناوری ارائه آگهی در این مثال می‌تواند یک DSP باشد که خلاقیت را در سایت ناشر ارائه می‌کند و محصول گزارش‌دهی خود را دارد. ارائه‌دهنده اندازه‌گیری شخص ثالث می‌تواند نهادی باشد که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

در زمان ثبت منبع، مراحل زیر انجام می شود:

1. serving-adtech.example ویژگی attributionsrc را در creative تنظیم می کند. کاربر از صفحه ناشر بازدید می کند و مرورگر درخواستی را به serving-adtech.example.
2. serving-adtech.example با سرصفحه Attribution-Reporting-Register-Source و سرصفحه Location پاسخ می دهد.
   1. serving-adtech.example از سرصفحه Attribution-Reporting-Register-Source برای پاسخ دادن با ابرداده در مورد منبعی که باید ثبت شود استفاده می کند.
   2. serving-adtech.example از سرصفحه Location برای اضافه کردن یک تغییر مسیر به 3p-measurement.example استفاده می کند. توجه داشته باشید که این احتمال وجود دارد که هدر Location در حال حاضر در جریان های ردیابی کلیک فعلی شما برای پشتیبانی از تغییر مسیرهای 302 به شخص ثالث استفاده شده باشد.
3. مرورگر پاسخ را از serving-adtech.example دریافت می کند و سرصفحه Attribution-Reporting-Register-Source تجزیه می کند. مرورگر رویداد منبع را با استفاده از serving-adtech.example به عنوان منبع گزارش ذخیره می کند.
4. از آنجایی که این درخواست یک تغییر مسیر است، مرورگر یک درخواست جدید به 3p-measurement.example نیز ارسال می کند.
5. 3p-measurement.example با پاسخی که حاوی سرصفحه Attribution-Reporting-Register-Source است پاسخ می دهد.
6. مرورگر این پاسخ را از 3p-measurement.example دریافت می کند و Attribution-Reporting-Register-Source می خواند. مرورگر رویداد منبع را با استفاده از 3p-measurement.example به عنوان مبدا گزارش ذخیره می کند.

از attributionsrc برای مبداهای شخص ثالث استفاده کنید نه در زنجیره تغییر مسیر

اگر چندین منبع گزارشگر می‌خواهند منبعی را در یک رویداد ناوبری ثبت کنند، اما به هر دلیلی نمی‌توانند در زنجیره تغییر مسیر ظاهر شوند، می‌توانید چندین سایت را به عنوان منابع انتساب در attributionsrc به‌عنوان راه‌حل جایگزین فهرست کنید.

در این مثال، درخواست‌های واجد شرایط API Reporting Attribution به هر دو REPORTING_URL_1 و. REPORTING_URL_2 . درخواست پیمایش ارسال شده به نشانی اینترنتی کلیک نیز واجد شرایط ثبت منابع انتساب است.

مرحله 3: پاسخ‌ها را برای درخواست‌های API Reporting Attribution تنظیم کنید

برای همه مبداهایی که درخواست API گزارش Attribution دریافت می‌کنند، مطمئن شوید که سرور با هدر Attribution-Reporting-Register-Source مناسب پاسخ می‌دهد. راهنمای منابع ثبت نام و توضیح دهنده را ببینید تا نحوه ایجاد پاسخ را بیاموزید.

چندین محرک را ثبت کنید

می‌توانید با افزودن چندین عنصر پیکسل در سمت تبدیل (یکی برای هر ماشه) چندین عامل انتساب را ثبت کنید. عنصر attributionsrc برای ثبت ماشه اختیاری است.

همچنین می‌توانید با استفاده از درخواست‌های تغییر مسیر یا فهرست کردن چندین URL در عنصر attributionsrc به همان روشی که برای ثبت منبع، چندین راه‌انداز را از یک عنصر پیکسلی ثبت کنید. رویدادهای منبع و رویدادهای ماشه ای که توسط مبداهای یکسانی ایجاد شده اند مطابقت داده می شوند.

اندازه‌گیری اسناد تبدیل می‌تواند شامل چندین طرف باشد، اعم از ناشر، تبلیغ‌کننده، خدمات فناوری تبلیغات (موجودی که تبلیغ را ارائه می‌دهد)، ارائه‌دهنده اندازه‌گیری، و موارد دیگر. در این سند، سناریوهای رایج اندازه‌گیری تبدیل را نشان می‌دهیم، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از API گزارش انتساب (ARA) است باید اطمینان حاصل کند که مراحل یکپارچه‌سازی شرح داده شده در این سند دنبال می‌شود.

برای مثال، معمول است که یک ناشر دارای یک یا چند فناوری تبلیغاتی مسئول ارائه آگهی باشد - این می‌تواند شامل طرف‌هایی باشد که مسئول ارائه نشانه‌گذاری برای آگهی خلاق هستند، طرف‌هایی که پیکسل‌های نمایش یا ردیابی آگهی را ارائه می‌کنند، و طرف‌هایی که SDK یا برچسب را برای جایگاه آگهی در صفحه ناشر ارائه می‌کنند. این فناوری‌های تبلیغاتی ممکن است بخواهند گزارش‌های انتساب را از ARA دریافت کنند یا نخواهند، اما برای اطمینان از اینکه فناوری‌های تبلیغات پایین‌دستی می‌توانند گزارش‌های انتساب را دریافت کنند، قرار گرفته‌اند.

علاوه بر این، ممکن است تبلیغ‌کننده از یک ارائه‌دهنده اندازه‌گیری تبدیل شخص ثالث برای انتساب بین شبکه‌ای و همچنین سایر قابلیت‌های گزارش‌دهی استفاده کند. تبلیغ‌کنندگان از این داده‌ها برای درک بازگشت سرمایه‌گذاری تبلیغات در چندین ناشر و کانال‌های منحصربه‌فرد استفاده می‌کنند، بنابراین مهم است که DSPها یا سرورهای آگهی بدانند چگونه API گزارش Attribution را برای پشتیبانی از این موارد استفاده فعال کنند. تبلیغ‌کنندگانی که می‌خواهند از شخص ثالث استفاده کنند، می‌توانند این کار را با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث یا با راه‌اندازی یک سرور داخلی برای ثبت‌نام و دریافت گزارش‌ها از API ادامه دهند.

Attribution Reporting API به چندین فناوری تبلیغات اجازه می‌دهد تا منابع و محرک‌های انتساب را برای یک نمایش یا تبدیل ثبت کنند و گزارش‌های جداگانه‌ای از API دریافت کنند. به عنوان مثال، یک DSP می‌تواند گزارش‌های انتساب خود را از Attribution Reporting API دریافت کند و همچنین اجازه گزارش جداگانه برای ارائه‌دهنده اندازه‌گیری شخص ثالث تبلیغ‌کننده را بدهد. یک فناوری تبلیغاتی برای دریافت گزارش‌ها از API باید هم منابع انتساب و هم محرک‌ها را ثبت کند، و انتساب در میان منابع انتساب و محرک‌هایی انجام می‌شود که فناوری آگهی به صورت جداگانه در API ثبت کرده است.

سناریوهای رایج اندازه گیری تبدیل

در این قسمت به بررسی دو سناریوی رایج برای اندازه گیری تبدیل می پردازیم.

سناریو 1: هم خدمات فناوری تبلیغات و هم ارائه‌دهنده اندازه‌گیری شخص ثالث باید گزارش‌هایی را از API گزارش Attribution دریافت کنند.

یک تبلیغ‌کننده می‌خواهد با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث، تبدیل‌ها را به موجودی آگهی نسبت دهد، و فناوری تبلیغاتی که میزبان خلاق است، می‌خواهد تبدیل‌ها را به موجودی آگهی نسبت دهد. این امر برای DSPها یا سرورهای تبلیغات تبلیغ‌کننده (سرور تبلیغات شخص ثالث - 3PAS) که نشانه‌گذاری را برای خلاقیت‌های تبلیغاتی ارائه می‌کنند، گزارش اسناد خود را انجام می‌دهند و با تبلیغ‌کنندگانی که با ارائه‌دهندگان اندازه‌گیری یا تجزیه و تحلیل شخص ثالث ادغام می‌شوند، رایج است.

در این مورد، فناوری تبلیغات ارائه دهنده نیز طرفی است که مسئول اجرای رویدادهای کلیک و نمایش در تنظیم فعلی است. فن‌آوری تبلیغات ارائه‌دهنده باید attributionsrc جدید را در مکان‌های مناسب تنظیم کند و مطمئن شود که تغییر مسیرها به درستی پیکربندی شده‌اند. همچنین، هم فناوری تبلیغات ارائه‌دهنده و هم ارائه‌دهنده اندازه‌گیری شخص ثالث باید اطمینان حاصل کنند که ثبت‌نام کرده‌اند و سرورهای آن‌ها آماده دریافت و پاسخ به درخواست‌های API Reporting Attribution هستند.

یک تنظیم کمپین معمولی می تواند به این صورت باشد:

1. سرور تبلیغات تبلیغ‌کننده (3PAS) نشانه‌گذاری خلاقیت آگهی را به DSP ارائه می‌کند، که شامل پیکسل‌های ردیابی نمایش و کلیک ارائه‌دهنده اندازه‌گیری شخص ثالث است. سرور آگهی باید اطمینان حاصل کند که attributionsrc در نشانه‌گذاری خلاقانه آگهی گنجانده شده است.

2. DSP قابلیت‌هایی را برای افزودن نمایش اندازه‌گیری اضافی و پیکسل‌های ردیابی کلیک ارائه می‌دهد، و باید مطمئن شود که attributionsrc در نشانه‌گذاری خلاق آگهی نهایی که با آن مناقصه می‌دهند گنجانده شده است.

سناریو 2: فقط ارائه‌دهنده اندازه‌گیری شخص ثالث باید گزارش‌هایی را از API گزارش Attribution دریافت کند.

یک تبلیغ‌کننده می‌خواهد با استفاده از یک ارائه‌دهنده اندازه‌گیری شخص ثالث، تبدیل‌ها را در موجودی آگهی نسبت دهد، اما فناوری تبلیغاتی که میزبان خلاقیت است، هیچ الزامی برای اندازه‌گیری انتساب ندارد. این امر برای ناشران، SSPها یا سرورهای تبلیغاتی ناشر که میزبان خلاقیت هستند و نمی‌خواهند خودشان از گزارش انتساب استفاده کنند، معمول است، اما می‌خواهند API گزارش اسناد را برای شرکای DSP خود یا برای شرکت‌های برچسب‌گذاری اندازه‌گیری مانند سرورهای تبلیغات شخص ثالث، ارائه‌دهندگان اندازه‌گیری یا تجزیه و تحلیل فعال کنند.

در این مورد، طرفی که مسئول اجرای رویدادهای کلیک و نمایش در راه‌اندازی فعلی است، باید ویژگی attributionsrc جدید را به خلاقیت‌ها اضافه کند و اطمینان حاصل کند که تغییرمسیرها طبق برنامه کار می‌کنند. این به شدت به ادغام هر ناشر بستگی دارد، اما برای رویدادهای کلیکی، این می‌تواند SSP، خدمات فناوری تبلیغات یا خود ناشر باشد. برای رویدادهای نمایش، این معمولاً ارائه‌دهنده اندازه‌گیری شخص ثالث است.

در نمونه راه اندازی کمپین معمولی از سناریو 1، سرور تبلیغات ناشر، SSP یا خود ناشر ممکن است فقط نیاز داشته باشند که ویژگی attributionsrc ارائه شده توسط DSP را در صفحه ناشر قرار دهد.

جزئیات پیاده سازی

جدول زیر مراحل اجرای Attribution Reporting API را در سطح بالا شرح می دهد:

توجه داشته باشید که ویژگی‌های هر مرحله به نحوه ارائه و ارائه خلاقیت‌ها در صفحه ناشر و اینکه کدام نهادهای فناوری تبلیغات گزارش‌های ارسال شده توسط Attribution Reporting API را دریافت می‌کنند، بستگی دارد.

مرحله 1: منبع انتساب را برای خلاقیت های موجود و کد اندازه گیری فعال کنید

در مرحله اول، منابع انتساب فعال می شوند.

ویژگی attributionsrc چگونه کار می کند

ویژگی جدید attributionsrc مشخص می‌کند که درخواست‌های API گزارش Attribution به کجا ارسال می‌شوند. نهادی که مسئول ایجاد رویدادهای نمایش و کلیک است باید خلاقیت ها را با ویژگی attributionsrc به روز کند. attributionsrc باید به رویدادهای کلیک و نمایش موجود اضافه شود و می تواند خالی یا غیرخالی باشد.

برای رویدادهای کلیک با استفاده از تغییر مسیرها، ویژگی attributionsrc باید به پیمایش اضافه شود. هرگونه تغییر مسیر 302 بعد از پیمایش نیازی به افزودن ویژگی attributionsrc ندارد و تا زمانی که پیمایش اولیه attributionsrc اضافه کرده باشد، واجد شرایط ARA خواهد بود.

هنگامی که attributionsrc خالی است، درخواست‌های ARA به URL تعریف شده در ویژگی href تگ anchor (URL کلیک کنید) ارسال می‌شود. هنگامی که ویژگی attributionsrc تعریف می شود، درخواست های ARA به URL تعریف شده در ویژگی attributionsrc ارسال می شود. نشانی اینترنتی کلیک نیز برای ثبت منابع واجد شرایط است.

به طور کلی، اگر سرور میزبان URL کلیک می‌تواند درخواست‌های API Reporting Attribution را دریافت کند و به آن‌ها پاسخ دهد، از یک ویژگی خالی attributionsrc استفاده کنید. اگر می‌خواهید درخواست‌های API Reporting Attribution به سرور دیگری بروند، URL attributionsrc خود را تعریف کنید.

مثالی از ویژگی خالی attributionsrc :

وقتی مشخصه attributionsrc خالی باشد، درخواست‌های API Reporting Attribution به URL تعریف شده توسط ویژگی href تگ anchor ارسال می‌شود.

مثالی از ویژگی غیر خالی attributionsrc:

وقتی attributionsrc خالی نباشد، درخواست‌های Attribution Reporting API به URL تعریف‌شده توسط برچسب attributionsrc ارسال می‌شود. نشانی اینترنتی کلیک نیز برای ثبت منابع واجد شرایط است.

attributionsrc برای رویدادهای کلیک و نمایش اضافه کنید

• روی رویدادها کلیک کنید:
  • نهادی که مسئول افزودن attributionsrc است معمولاً فناوری ارائه دهنده آگهی است.
  • تگ‌های لنگر با رویدادهای کلیکی باید دارای ویژگی attributionsrc باشند.
  • کلیک‌ها با استفاده از window.open باید از آرگومان windowFeatures فراخوانی window.open برای تعیین منبع انتساب استفاده کنند.
• رویدادهای برداشت:
  • نهادی که مسئول افزودن attributionsrc است، معمولاً فناوری ارائه دهنده آگهی و ارائه دهنده(های) اندازه گیری است.
  • رویدادهای Impression ایجاد شده از تگ <img> یا تگ <script> باید شامل یک ویژگی attributionsrc باشد.
  • رویدادهای Impression با استفاده از Fetch API باید شامل یک شی attributionReporting در آرگومان گزینه‌های ارسال شده به فراخوانی fetch API باشد.

برای خلاصه تغییرات مورد نیاز برای رویدادهای کلیک و نمایش به جدول زیر مراجعه کنید:

ثبت منبع منبع را در حراج مخاطب محافظت شده فعال کنید

برای اندازه‌گیری تبدیل‌ها در حراج‌های مخاطب محافظت‌شده، به‌جای استفاده از attributionsrc ، می‌توانید از registerAdBeacon / registerAdMacro و setReportEventDataForAutomaticBeacons / reportEvent برای فعال کردن منابع انتساب استفاده کنید.

برای گزارش سیگنال های مخاطب محافظت شده، تابع registerAdBeacon در داخل Worklet های گزارش در دسترس است، و registerAdMacro در داخل Worklet گزارش برنده خریدار در دسترس است. سپس، داده‌های رویداد داخل قاب تبلیغات را می‌توان با توابع reportEvent و setReportEventDataForAutomaticBeacons در Fenced Frame Ads Reporting API به بیکن‌ها و ماکروهای ثبت‌شده اضافه کرد. این اجازه می دهد تا سیگنال های کارگروه گزارش مخاطب محافظت شده و بار رویداد قاب خلاقانه تبلیغات با یکدیگر مرتبط شوند.

هدر HTTP Attribution-Reporting-Eligible زمانی به درخواست اضافه می‌شود که چراغ‌ها و ماکروها با تماس reportEvent از یک فریم فعال شوند، یا چراغ‌های خودکار توسط مرورگر فعال شوند. برای ثبت منبع انتساب می توانید از پاسخ beacon استفاده کنید. ممکن است درخواست‌های beacon هدایت شوند تا امکان اندازه‌گیری شخص ثالث فراهم شود.

برای بررسی عمیق‌تر، به بخش پشتیبانی از گزارش انتساب توضیح‌دهنده API گزارش آگهی تبلیغاتی Fenced Frame مراجعه کنید.

فعال کردن گزارش انتساب برای قالب‌های VAST

VAST یک فرمت رایج برای ارائه و اندازه‌گیری موجودی آگهی‌های ویدیویی است، و بسیاری از رویدادهای تعریف‌شده در آن استاندارد باید رویدادهای منبع بالقوه واجد شرایط ثبت نام در API گزارش‌های Attribution را در نظر گرفت. ضمیمه VAST برای پشتیبانی گزارش انتساب این موضوع را با جزئیات پوشش می دهد، اما به طور خلاصه، همه رویدادهای <Tracking> ، <Impression> ، <*ClickThrough> و <*ClickTracking> رویدادهای منبع انتساب بالقوه هستند. همه پیاده سازی های VAST باید پوشش واجد شرایط بودن ثبت نام را برای این رویدادها فراهم کنند.

ضمیمه VAST ویژگی‌های جدیدی را برای این عناصر تعریف می‌کند تا امکان تنظیم یک URL ثانویه به‌طور خاص برای ثبت اسناد را فراهم کند. وقتی رویدادی حاوی attributiontype="DOUBLE_PING" و attributionsrc="[URL]" باشد، کدی که آن رویداد را فعال می‌کند باید از [URL] به عنوان مقدار ویژگی attributionsrc هنگام فعال کردن API گزارش انتساب استفاده کند. ضمیمه VAST شامل نمونه هایی برای هر سناریو است.

برای اطمینان از حداکثر پوشش، پیاده‌سازی‌های VAST باید باعث شوند که همه رویدادهای فهرست‌شده به‌طور پیش‌فرض در هنگام شلیک پینگ رویداد واجد شرایط ثبت نام باشند. به عنوان مثال، هنگام شلیک URL رویداد <Impression> ، باید از ویژگی (خالی) attributionsrc در عنصر <img> که برای ارسال درخواست استفاده می‌شود (یا معادل آن در تماس واکشی) استفاده شود تا همیشه به طرف گیرنده اجازه داده شود که به طور بالقوه آن رویداد را با API گزارش Attribution ثبت کند.

مرحله 2: گزارش Attribution را برای منابع شخص ثالث فعال کنید

برای اجازه دادن به اشخاص ثالث برای استفاده از Attribution Reporting API، می توانید از تغییر مسیرهای موجود استفاده کنید یا لیستی از اشخاص ثالث را به ویژگی attributionsrc اضافه کنید. در بیشتر موارد، هر فناوری تبلیغاتی ردیاب برداشت مستقل خود را دارد، بنابراین تغییر مسیرها برای ردیاب‌های کلیک مرتبط‌تر هستند.

منشاء شخص ثالث را در یک زنجیره تغییر مسیر موجود مدیریت کنید

در یک کلیک تبلیغاتی معمولی، بسیاری از ردیاب‌های کلیک ممکن است به‌عنوان زنجیره‌ای از 302 تغییر مسیر که به عنوان بخشی از پیمایش به صفحه فرود نهایی انجام می‌شود، وجود داشته باشد. اگر هدف کلیک اصلی با attributionsrc حاشیه‌نویسی شده باشد یا با registerAdBeacon/registerAdMacro در Protected Audience API ثبت شده باشد، هر درخواست در زنجیره تغییر مسیر واجد شرایط ثبت نام در API گزارش Attribution است. فناوری تبلیغات در زنجیره تغییر مسیر نیز باید ثبت شود .

توجه داشته باشید که بدنه درخواست اولیه در تغییر مسیرها ارسال نمی شود. برای حراج‌های مخاطب محافظت‌شده، اگر eventData به reportEvent منتقل شود و setReportEventDataForAutomaticBeacons باید به عنوان بخشی از تغییر مسیر استفاده شود، باید صریحاً به عنوان بخشی از URL تغییر مسیر داده شود.

در مثال زیر، ما از یک فناوری تبلیغاتی ارائه دهنده ( serving-adtech.example ) و یک ارائه دهنده اندازه گیری شخص ثالث ( 3p-measurement.example ) به عنوان دو موجودیت مجزا که به دنبال تولید و دریافت گزارش های انتساب هستند، استفاده خواهیم کرد. فناوری ارائه آگهی در این مثال می‌تواند یک DSP باشد که خلاقیت را در سایت ناشر ارائه می‌کند و محصول گزارش‌دهی خود را دارد. ارائه دهنده اندازه گیری شخص ثالث می تواند موجودی باشد که تبلیغ کننده برای گزارش تبدیل از آن استفاده می کند.

در زمان ثبت نام منبع ، مراحل زیر انجام می شود:

1. serving-adtech.example ویژگی attributionsrc در خلاق تنظیم می کند. کاربر از صفحه ناشر بازدید می کند و مرورگر درخواست را برای serving-adtech.example.
2. serving-adtech.example با Attribution-Reporting-Register-Source و هدر Location پاسخ می دهد.
   1. serving-adtech.example از عنوان Attribution-Reporting-Register-Source استفاده می کند تا با ابرداده در مورد منبع ثبت شده پاسخ دهد.
   2. serving-adtech.example از عنوان Location استفاده می کند تا شامل یک تغییر مسیر به 3p-measurement.example . توجه داشته باشید که این احتمال وجود دارد که از هدر Location در جریان جریان های موجود در جریان شما استفاده شود تا از 302 تغییر مسیر به شخص ثالث پشتیبانی کند.
3. مرورگر پاسخی را از serving-adtech.example دریافت می کند و Attribution-Reporting-Register-Source تجزیه می کند. مرورگر با استفاده از serving-adtech.example به عنوان منشأ گزارش ، رویداد منبع را ذخیره می کند.
4. از آنجا که این درخواست یک تغییر مسیر است ، مرورگر همچنین درخواست جدیدی را برای 3p-measurement.example گیری می کند.
5. 3p-measurement.example با پاسخی پاسخ می دهد که حاوی عنوان Attribution-Reporting-Register-Source است.
6. مرورگر این پاسخ را از 3p-measurement.example دریافت می کند Attribution-Reporting-Register-Source مرورگر رویداد منبع را با استفاده از 3p-measurement.example به عنوان منشأ گزارش ذخیره می کند.

attributionsrc برای ریشه های شخص ثالث استفاده نکنید نه در یک زنجیره تغییر مسیر

اگر منشأ گزارشگر متعدد بخواهند منبع را در یک رویداد ناوبری ثبت کنند ، اما به هر دلیلی نمی توانید در یک زنجیره تغییر مسیر ظاهر شوید ، می توانید چندین سایت را به عنوان منبع انتساب در attributionsrc به عنوان یک راه حل جایگزین ذکر کنید.

در این مثال ، گزارش های مربوط به گزارش های API برای هر دو REPORTING_URL_1 و به آنها ارسال می شود. REPORTING_URL_2 . درخواست ناوبری ارسال شده به URL Clickthrough نیز واجد شرایط ثبت منابع انتساب است.

مرحله 3: پاسخ هایی را برای درخواست API گزارش انتساب تنظیم کنید

برای کلیه منشاء دریافت درخواست API گزارش انتساب ، اطمینان حاصل کنید که سرور با عنوان مناسب Attribution-Reporting-Register-Source پاسخ می دهد. برای یادگیری نحوه ساخت پاسخ ، به راهنمای منابع ثبت و توضیح دهنده مراجعه کنید.

چندین محرک را ثبت کنید

با افزودن چندین عنصر پیکسل در سمت تبدیل (یک در هر ماشه) می توانید چندین محرک انتساب را ثبت کنید. عنصر attributionsrc برای ثبت نام ماشه اختیاری است.

همچنین می توانید چندین محرک را از یک عنصر پیکسل واحد با استفاده از درخواست های تغییر مسیر یا ذکر چندین URL در عنصر attributionsrc به همان روش برای ثبت نام منبع ثبت کنید. رویدادهای منبع و وقایع محرک که با همین منشأ ایجاد شده اند با هم مطابقت دارند.

اندازه گیری انتساب تبدیل می تواند شامل چندین طرف باشد ، از ناشر ، تبلیغ کننده ، خدمت به فناوری تبلیغاتی (موجودی که تبلیغ را ارائه می دهد) ، ارائه دهنده اندازه گیری و موارد دیگر. در این سند ، ما سناریوهای اندازه گیری تبدیل مشترک را نشان می دهیم ، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از API گزارش انتساب (ARA) باشد ، باید اطمینان حاصل کند که مراحل ادغام شرح داده شده در این سند دنبال می شود.

به عنوان مثال ، معمول است که یک ناشر یک یا چند فناوری تبلیغاتی را که مسئول خدمت به تبلیغات هستند ، داشته باشد - این می تواند شامل طرفین مسئول تهیه نشانه برای خلاقیت ، طرفین ارائه دهنده تصور یا پیگیری پیکسل در خلاقیت باشد و طرفین تهیه SDK یا برچسب را برای اسلات تبلیغ در صفحه ناشر ارائه دهند. این فناوری های تبلیغاتی ممکن است یا ممکن است بخواهند گزارش های انتساب را از ARA دریافت کنند ، اما برای اطمینان از اینکه فناوری های تبلیغاتی پایین دست می توانند گزارش های انتساب دریافت کنند ، قرار دارند.

علاوه بر این ، تبلیغ کننده همچنین ممکن است از یک ارائه دهنده اندازه گیری تبدیل شخص ثالث برای انتساب شبکه متقابل و همچنین سایر قابلیت های گزارشگری استفاده کند. تبلیغ کنندگان از این داده ها برای درک بازده سرمایه گذاری در تبلیغات در چندین ناشر و کانال های منحصر به فرد استفاده می کنند ، بنابراین مهم است که DSP ها یا سرورهای AD درک کنند که چگونه می توانند API گزارشگر را برای پشتیبانی از این موارد استفاده کنند. تبلیغ کننده هایی که می خواهند از شخص ثالث استفاده کنند ، می توانند این کار را ادامه دهند ، یا با استفاده از ارائه دهنده اندازه گیری شخص ثالث یا با تنظیم سرور داخلی برای ثبت نام و دریافت گزارش از API.

API گزارشگر انتساب به چندین فناوری تبلیغاتی اجازه می دهد تا منابع انتساب را ثبت کنند و باعث ایجاد همان تصور یا تبدیل شوند و گزارش های جداگانه ای را از API دریافت کنند. به عنوان مثال ، DSP می تواند گزارش های مربوط به انتساب خود را از API گزارش انتساب دریافت کند و همچنین گزارش جداگانه ای را برای ارائه دهنده اندازه گیری شخص ثالث تبلیغ کننده فراهم کند. یک فناوری تبلیغاتی باید هر دو منبع انتساب و محرک های دریافت گزارش از API را ثبت کند ، و انتساب در بین منابع انتساب انجام می شود و باعث می شود که فناوری تبلیغ به طور جداگانه در API ثبت شده باشد.

سناریوهای اندازه گیری تبدیل مشترک

در این بخش ، دو سناریوی مشترک برای اندازه گیری تبدیل را بررسی خواهیم کرد.

سناریو 1: هر دو خدمت به فناوری تبلیغاتی و ارائه دهنده اندازه گیری شخص ثالث نیاز به دریافت گزارش از API گزارش انتساب دارند

یک تبلیغ کننده می خواهد با استفاده از ارائه دهنده اندازه گیری شخص ثالث ، و تکنیک تبلیغاتی که میزبان Creative Dishists برای نسبت به تبدیل ها در موجودی تبلیغاتی است ، تبدیل به موجودی AD را نسبت دهد. این معمول برای سرورهای تبلیغاتی DSP یا تبلیغ کننده (سرور تبلیغاتی شخص ثالث-3PA) است که نشانه هایی را برای خلاقیت های تبلیغاتی ارائه می دهند ، گزارش انتساب خود را انجام می دهند و با تبلیغ کننده هایی که با ارائه دهندگان اندازه گیری شخص ثالث یا تجزیه و تحلیل ادغام می شوند ، همکاری می کنند.

در این حالت ، فناوری تبلیغاتی نیز طرفی است که مسئولیت شلیک وقایع کلیک و تصور در مجموعه فعلی را بر عهده دارد. فناوری تبلیغاتی باید New attributionsrc در مکان های مناسب تنظیم کرده و اطمینان حاصل کند که تغییر مسیر به درستی پیکربندی شده است. همچنین ، هم فناوری تبلیغاتی و هم ارائه دهنده اندازه گیری شخص ثالث باید از ثبت نام آنها اطمینان حاصل کند و سرورهای آنها آماده دریافت و پاسخگویی به درخواست های API گزارش انتساب هستند.

یک راه اندازی کمپین معمولی می تواند به نظر برسد:

1. Advertiser Ad Server (3PAS) نشانه گذاری تبلیغات خلاق را به DSP ارائه می دهد ، که شامل برداشت ارائه دهنده اندازه گیری شخص ثالث و روی پیگیری پیکسل ها است. سرور AD باید اطمینان حاصل کند که attributionsrc در نشانه Creative Creative گنجانده شده است.

2. DSP قابلیت هایی را برای افزودن برداشت اندازه گیری اضافی و پیگیری پیکسل ها ارائه می دهد ، و باید اطمینان حاصل کند که attributionsrc در علامت تبلیغاتی نهایی خلاق که با آنها پیشنهاد می دهند گنجانده شده است.

سناریو 2: فقط ارائه دهنده اندازه گیری شخص ثالث باید گزارش هایی را از API گزارش انتساب دریافت کند

یک تبلیغ کننده می خواهد با استفاده از ارائه دهنده اندازه گیری شخص ثالث ، تبدیل به موجودی AD را نسبت دهد ، اما AD Tech Hosting Creative هیچ گونه نیاز به اندازه گیری انتساب ندارد. این امر برای ناشران ، SSP ها یا سرورهای تبلیغاتی ناشر که میزبان خلاقیت هستند و قصد ندارند از خود گزارش دهند ، اما کسانی که می خواهند API گزارشگر انتساب را برای شرکای DSP خود یا برای شرکت های اندازه گیری اندازه گیری مانند سرورهای تبلیغاتی شخص ثالث ، اندازه گیری یا ارائه دهندگان تجزیه و تحلیل فعال کنند ، معمول است.

در این حالت ، طرفی که وظیفه شلیک و برداشت رویدادها را در مجموعه فعلی دارد ، باید ویژگی جدید attributionsrc را به خلاقان اضافه کند و اطمینان حاصل کند که تغییر مسیر مانند آنچه در نظر گرفته شده است. این به یکپارچه سازی هر ناشر بسیار وابسته است ، اما برای رویدادهای کلیک ، این می تواند SSP ، خدمت به فناوری تبلیغاتی یا خود ناشر باشد. برای وقایع برداشت ، این معمولاً ارائه دهنده اندازه گیری شخص ثالث است.

در مثال تنظیم کمپین معمولی از سناریو 1 ، خود ناشر AD Server ، SSP یا خود ناشر فقط ممکن است نیاز به اطمینان از ویژگی attributionsrc که توسط DSP ارائه شده است ، آن را بر روی صفحه ناشر قرار دهد.

جزئیات پیاده سازی

در جدول زیر مراحل اجرای API گزارش انتساب در سطح بالا توضیح داده شده است:

توجه داشته باشید که مشخصات هر مرحله به نحوه ارائه و ارائه خدمات خلاق در صفحه ناشر بستگی دارد و کدام یک از اشخاص فناوری تبلیغاتی گزارش های ارسال شده توسط API گزارش انتساب را دریافت می کنند.

مرحله 1: منبع انتساب را برای خلاقان موجود و کد اندازه گیری فعال کنید

در مرحله اول ، منابع انتساب فعال می شوند.

چگونه ویژگی attributionsrc کار می کند

ویژگی جدید attributionsrc مشخص می کند که درخواست های API گزارش انتساب به کجا ارسال می شود. موجودی که وظیفه شلیک برداشت و کلیک بر روی رویدادها را بر عهده دارد ، باید خلاقان را با ویژگی attributionsrc به روز کند. attributionsrc باید به رویدادهای کلیک و برداشت موجود اضافه شود و می تواند خالی یا غیر خالی باشد.

برای رویدادهای کلیک با استفاده از Redirects ، ویژگی attributionsrc باید به ناوبری اضافه شود. هر 302 تغییر مسیر پس از ناوبری نیازی به اضافه کردن ویژگی attributionsrc ندارد و تا زمانی که ناوبری اولیه attributionsrc اضافه کند ، واجد شرایط ARA خواهد بود.

هنگامی که attributionsrc خالی است ، درخواست های ARA به URL تعریف شده در ویژگی href از برچسب Anchor (URL Clickthrough) ارسال می شود. هنگامی که ویژگی attributionsrc تعریف می شود ، درخواست های ARA به URL تعریف شده در ویژگی attributionsrc ارسال می شود. URL Clickthrough نیز واجد شرایط ثبت منابع است.

به طور کلی ، اگر سرور میزبان URL Clickthrough می تواند درخواست های API گزارش انتساب را دریافت و پاسخ دهد ، از یک ویژگی خالی attributionsrc استفاده کنید. اگر می خواهید درخواست های API گزارش انتساب به سرور دیگری مراجعه کنید ، URL attributionsrc خود را تعریف کنید.

نمونه ای از یک ویژگی attributionsrc :

هنگامی که ویژگی attributionsrc خالی است ، درخواست های API گزارش انتساب به URL تعریف شده توسط ویژگی href از برچسب لنگر ارسال می شود.

نمونه ای از یک ویژگی غیر خالی از ویژگی های غیر خالی:

هنگامی که attributionsrc خالی نیست ، درخواست های API گزارش انتساب به URL تعریف شده توسط برچسب attributionsrc ارسال می شود. URL Clickthrough نیز واجد شرایط ثبت منابع است.

برای رویدادهای کلیک و تصور attributionsrc اضافه کنید

• روی رویدادها کلیک کنید:
  • نهاد مسئول اضافه کردن attributionsrc معمولاً فناوری تبلیغاتی است.
  • برچسب های لنگر با رویدادهای کلیک باید یک ویژگی attributionsrc را اضافه کند.
  • با استفاده از window.open باید از آرگومان windowFeatures از window.open Call استفاده کنید تا منبع انتساب را مشخص کنید.
• وقایع تصور:
  • نهاد مسئول افزودن attributionsrc معمولاً فناوری تبلیغاتی و ارائه دهنده (های) اندازه گیری است.
  • وقایع تصور شده از برچسب <img> یا برچسب <script> باید شامل یک ویژگی attributionsrc باشد.
  • رویدادهای Impression با استفاده از API Fetch باید شامل یک شیء attributionReporting در آرگومان گزینه های منتقل شده به تماس API Fetch باشد.

جدول زیر را برای خلاصه اصلاحات مورد نیاز برای رویدادهای کلیک و تصور مشاهده کنید:

ثبت نام منبع انتساب را در حراج مخاطبان محافظت شده فعال کنید

برای اندازه گیری تبدیل در حراج های مخاطبان محافظت شده ، به جای استفاده از attributionsrc ، می توانید از registerAdBeacon / registerAdMacro و setReportEventDataForAutomaticBeacons / reportEvent استفاده کنید تا منابع ثبت نام را فعال کنید.

برای گزارش سیگنال های مخاطبان محافظت شده ، عملکرد registerAdBeacon در داخل کارگاه گزارشگری در دسترس است و registerAdMacro در داخل کار گزارشگری برنده خریدار در دسترس است. سپس ، داده های رویداد در داخل قاب تبلیغاتی را می توان به چراغهای ثبت شده و ماکروها با reportEvent و setReportEventDataForAutomaticBeacons مربوط به عملکردهای تبلیغاتی فریم حصارکشی API به Beacons و Macros اضافه کرد. این اجازه می دهد تا سیگنال های کارگاه های گزارش شده مخاطبان محافظت شده و بار بارگذاری رویداد Creative Frame با یکدیگر در ارتباط باشند.

هدر HTTP Attribution-Reporting-Eligible هنگامی که چراغها و ماکروها توسط تماس reportEvent از یک قاب انجام می شوند ، به درخواست اضافه می شوند ، یا چراغ های اتوماتیک توسط مرورگر ایجاد می شوند. می توانید از پاسخ Beacon برای ثبت یک منبع انتساب استفاده کنید. درخواست های چراغ ممکن است هدایت شود تا اندازه گیری شخص ثالث امکان پذیر باشد.

برای یک شیرجه عمیق تر ، به بخش پشتیبانی از انتساب از API گزارشگر AP -AD Frame Ad Ad ، پشتیبانی کنید.

گزارش انتساب را برای قالب های وسیع فعال کنید

وسیع یک قالب مشترک برای خدمت و اندازه گیری موجودی تبلیغاتی ویدیویی است ، و بسیاری از رویدادهای تعریف شده در آن استاندارد باید رویدادهای منبع بالقوه واجد شرایط ثبت نام با API گزارش انتساب در نظر گرفته شوند. ضمیمه وسیع برای پشتیبانی گزارش انتساب این مقاله را به طور مفصل پوشش می دهد ، اما به طور خلاصه ، همه <Tracking> ، <Impression> ، <*ClickThrough> و <*ClickTracking> رویدادها رویدادهای منبع انتساب بالقوه هستند. کلیه پیاده سازی های گسترده باید پوشش صلاحیت ثبت نام را برای این رویدادها فراهم کند.

ضمیمه وسیع ویژگی های جدیدی را برای این عناصر تعریف می کند تا امکان ایجاد یک URL ثانویه به طور خاص برای ثبت انتساب فراهم شود. هنگامی که یک رویداد حاوی attributiontype="DOUBLE_PING" و attributionsrc="[URL]" است ، شلیک کد آن رویداد باید از [URL] به عنوان مقدار ویژگی attributionsrc هنگام فعال کردن API گزارش انتساب استفاده کند. ضمیمه وسیع حاوی نمونه هایی برای هر سناریو است.

برای اطمینان از حداکثر پوشش ، پیاده سازی های گسترده باید باعث شود که کلیه رویدادهای ذکر شده ثبت نام به طور پیش فرض هنگام شلیک پینگ های رویداد واجد شرایط باشد. به عنوان مثال ، هنگام شلیک URL رویداد <Impression> ، از ویژگی (خالی) attributionsrc باید در عنصر <img> استفاده شود که برای ارسال درخواست (یا معادل آن در تماس واکشی) استفاده می شود ، همیشه اجازه می دهد تا شخص دریافت کننده به طور بالقوه آن رویداد را با API گزارش انتساب ثبت کند.

مرحله 2: گزارش انتساب برای منشأ شخص ثالث را فعال کنید

برای اینکه به شخص ثالث اجازه استفاده از API گزارش انتساب را بدهید ، می توانید از تغییر مسیر موجود استفاده کنید یا لیستی از شخص ثالث را به ویژگی attributionsrc اضافه کنید. در بیشتر موارد ، هر فناوری تبلیغاتی ردیاب تأثیر مستقل خود را دارد ، بنابراین تغییر مسیر برای ردیاب های کلیک اهمیت بیشتری دارد.

منشأ شخص ثالث را در یک زنجیره تغییر مسیر موجود کنترل کنید

در یک کلیک معمولی ، بسیاری از ردیاب های کلیک ممکن است به عنوان زنجیره ای از 302 تغییر مسیر ساخته شده به عنوان بخشی از ناوبری به صفحه فرود نهایی حضور داشته باشند. اگر هدف کلیک اصلی با attributionsrc حاشیه نویسی شود یا در registerAdBeacon/registerAdMacro در API مخاطبان محافظت شده ثبت شود ، هر درخواست در زنجیره تغییر مسیر واجد شرایط ثبت نام با API گزارش انتساب است. فناوری تبلیغاتی در زنجیره تغییر مسیر نیز باید ثبت نام کند .

توجه داشته باشید که جسد درخواست اولیه در تغییر مسیر ارسال نمی شود. برای حراج های محافظت شده مخاطبان ، اگر eventData به reportEvent و setReportEventDataForAutomaticBeacons منتقل شود ، باید به عنوان بخشی از تغییر مسیر مورد استفاده قرار گیرد ، باید صریحاً به عنوان بخشی از URL تغییر مسیر منتقل شود.

در مثال زیر ، ما از یک فناوری تبلیغاتی ( serving-adtech.example ) و یک ارائه دهنده اندازه گیری شخص ثالث ( 3p-measurement.example ) به عنوان دو نهاد مجزا که به دنبال تولید و دریافت گزارش های انتساب هستند ، استفاده خواهیم کرد. فناوری تبلیغاتی در این مثال می تواند DSP باشد که خلاقیت را در سایت ناشر ارائه می دهد و محصول گزارشگری خود را دارد. ارائه دهنده اندازه گیری شخص ثالث می تواند موجودی باشد که تبلیغ کننده برای گزارش تبدیل از آن استفاده می کند.

در زمان ثبت نام منبع ، مراحل زیر انجام می شود:

1. serving-adtech.example ویژگی attributionsrc در خلاق تنظیم می کند. کاربر از صفحه ناشر بازدید می کند و مرورگر درخواست را برای serving-adtech.example.
2. serving-adtech.example با Attribution-Reporting-Register-Source و هدر Location پاسخ می دهد.
   1. serving-adtech.example از عنوان Attribution-Reporting-Register-Source استفاده می کند تا با ابرداده در مورد منبع ثبت شده پاسخ دهد.
   2. serving-adtech.example از عنوان Location استفاده می کند تا شامل یک تغییر مسیر به 3p-measurement.example . توجه داشته باشید که این احتمال وجود دارد که از هدر Location در جریان جریان های موجود در جریان شما استفاده شود تا 302 تغییر مسیر به شخص ثالث پشتیبانی کند.
3. مرورگر پاسخی را از serving-adtech.example دریافت می کند و Attribution-Reporting-Register-Source تجزیه می کند. مرورگر با استفاده از serving-adtech.example به عنوان منشأ گزارش ، رویداد منبع را ذخیره می کند.
4. از آنجا که این درخواست یک تغییر مسیر است ، مرورگر همچنین درخواست جدیدی را برای 3p-measurement.example گیری می کند.
5. 3p-measurement.example با پاسخی پاسخ می دهد که حاوی عنوان Attribution-Reporting-Register-Source است.
6. مرورگر این پاسخ را از 3p-measurement.example دریافت می کند Attribution-Reporting-Register-Source مرورگر رویداد منبع را با استفاده از 3p-measurement.example به عنوان منشأ گزارش ذخیره می کند.

attributionsrc برای ریشه های شخص ثالث استفاده نکنید نه در یک زنجیره تغییر مسیر

اگر منشأ گزارشگر متعدد بخواهند منبع را در یک رویداد ناوبری ثبت کنند ، اما به هر دلیلی نمی توانید در یک زنجیره تغییر مسیر ظاهر شوید ، می توانید چندین سایت را به عنوان منبع انتساب در attributionsrc به عنوان یک راه حل جایگزین ذکر کنید.

در این مثال ، گزارش های مربوط به گزارش های API برای هر دو REPORTING_URL_1 و به آنها ارسال می شود. REPORTING_URL_2 . درخواست ناوبری ارسال شده به URL Clickthrough نیز واجد شرایط ثبت منابع انتساب است.

مرحله 3: پاسخ هایی را برای درخواست API گزارش انتساب تنظیم کنید

برای کلیه منشاء دریافت درخواست API گزارش انتساب ، اطمینان حاصل کنید که سرور با عنوان مناسب Attribution-Reporting-Register-Source پاسخ می دهد. برای یادگیری نحوه ساخت پاسخ ، به راهنمای منابع ثبت و توضیح دهنده مراجعه کنید.

چندین محرک را ثبت کنید

با افزودن چندین عنصر پیکسل در سمت تبدیل (یک در هر ماشه) می توانید چندین محرک انتساب را ثبت کنید. عنصر attributionsrc برای ثبت نام ماشه اختیاری است.

همچنین می توانید چندین محرک را از یک عنصر پیکسل واحد با استفاده از درخواست های تغییر مسیر یا ذکر چندین URL در عنصر attributionsrc به همان روش برای ثبت نام منبع ثبت کنید. رویدادهای منبع و وقایع محرک که با همین منشأ ایجاد شده اند با هم مطابقت دارند.

اندازه گیری انتساب تبدیل می تواند شامل چندین طرف باشد ، از ناشر ، تبلیغ کننده ، خدمت به فناوری تبلیغاتی (موجودی که تبلیغ را ارائه می دهد) ، ارائه دهنده اندازه گیری و موارد دیگر. در این سند ، ما سناریوهای اندازه گیری تبدیل مشترک را نشان می دهیم ، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از API گزارش انتساب (ARA) باشد ، باید اطمینان حاصل کند که مراحل ادغام شرح داده شده در این سند دنبال می شود.

به عنوان مثال ، معمول است که یک ناشر یک یا چند فناوری تبلیغاتی را که مسئول خدمت به تبلیغات هستند ، داشته باشد - این می تواند شامل طرفین مسئول تهیه نشانه برای خلاقیت ، طرفین ارائه دهنده تصور یا پیگیری پیکسل در خلاقیت باشد و طرفین تهیه SDK یا برچسب را برای اسلات تبلیغ در صفحه ناشر ارائه دهند. این فناوری های تبلیغاتی ممکن است یا ممکن است بخواهند گزارش های انتساب را از ARA دریافت کنند ، اما برای اطمینان از اینکه فناوری های تبلیغاتی پایین دست می توانند گزارش های انتساب دریافت کنند ، قرار دارند.

علاوه بر این ، تبلیغ کننده همچنین ممکن است از یک ارائه دهنده اندازه گیری تبدیل شخص ثالث برای انتساب شبکه متقابل و همچنین سایر قابلیت های گزارشگری استفاده کند. تبلیغ کنندگان از این داده ها برای درک بازده سرمایه گذاری در تبلیغات در چندین ناشر و کانال های منحصر به فرد استفاده می کنند ، بنابراین مهم است که DSP ها یا سرورهای AD درک کنند که چگونه می توانند API گزارشگر را برای پشتیبانی از این موارد استفاده کنند. تبلیغ کننده هایی که می خواهند از شخص ثالث استفاده کنند ، می توانند این کار را ادامه دهند ، یا با استفاده از ارائه دهنده اندازه گیری شخص ثالث یا با تنظیم سرور داخلی برای ثبت نام و دریافت گزارش از API.

API گزارشگر انتساب به چندین فناوری تبلیغاتی اجازه می دهد تا منابع انتساب را ثبت کنند و باعث ایجاد همان تصور یا تبدیل شوند و گزارش های جداگانه ای را از API دریافت کنند. به عنوان مثال ، DSP می تواند گزارش های مربوط به انتساب خود را از API گزارش انتساب دریافت کند و همچنین گزارش جداگانه ای را برای ارائه دهنده اندازه گیری شخص ثالث تبلیغ کننده فراهم کند. یک فناوری تبلیغاتی باید هر دو منبع انتساب و محرک های دریافت گزارش از API را ثبت کند ، و انتساب در بین منابع انتساب انجام می شود و باعث می شود که فناوری تبلیغ به طور جداگانه در API ثبت شده باشد.

سناریوهای اندازه گیری تبدیل مشترک

در این بخش ، دو سناریوی مشترک برای اندازه گیری تبدیل را بررسی خواهیم کرد.

سناریو 1: هر دو خدمت به فناوری تبلیغاتی و ارائه دهنده اندازه گیری شخص ثالث نیاز به دریافت گزارش از API گزارش انتساب دارند

یک تبلیغ کننده می خواهد با استفاده از ارائه دهنده اندازه گیری شخص ثالث ، و تکنیک تبلیغاتی که میزبان Creative Dishists برای نسبت به تبدیل ها در موجودی تبلیغاتی است ، تبدیل به موجودی AD را نسبت دهد. این معمول برای سرورهای تبلیغاتی DSP یا تبلیغ کننده (سرور تبلیغاتی شخص ثالث-3PA) است که نشانه هایی را برای خلاقیت های تبلیغاتی ارائه می دهند ، گزارش انتساب خود را انجام می دهند و با تبلیغ کننده هایی که با ارائه دهندگان اندازه گیری شخص ثالث یا تجزیه و تحلیل ادغام می شوند ، همکاری می کنند.

در این حالت ، فناوری تبلیغاتی نیز طرفی است که مسئولیت شلیک وقایع کلیک و تصور در مجموعه فعلی را بر عهده دارد. فناوری تبلیغاتی باید New attributionsrc در مکان های مناسب تنظیم کرده و اطمینان حاصل کند که تغییر مسیر به درستی پیکربندی شده است. همچنین ، هم فناوری تبلیغاتی و هم ارائه دهنده اندازه گیری شخص ثالث باید از ثبت نام آنها اطمینان حاصل کند و سرورهای آنها آماده دریافت و پاسخگویی به درخواست های API گزارش انتساب هستند.

یک راه اندازی کمپین معمولی می تواند به نظر برسد:

1. Advertiser Ad Server (3PAS) نشانه گذاری تبلیغات خلاق را به DSP ارائه می دهد ، که شامل برداشت ارائه دهنده اندازه گیری شخص ثالث و روی پیگیری پیکسل ها است. سرور AD باید اطمینان حاصل کند که attributionsrc در نشانه Creative Creative گنجانده شده است.

2. DSP قابلیت هایی را برای افزودن برداشت اندازه گیری اضافی و پیگیری پیکسل ها ارائه می دهد ، و باید اطمینان حاصل کند که attributionsrc در علامت تبلیغاتی نهایی خلاق که با آنها پیشنهاد می دهند گنجانده شده است.

سناریو 2: فقط ارائه دهنده اندازه گیری شخص ثالث باید گزارش هایی را از API گزارش انتساب دریافت کند

یک تبلیغ کننده می خواهد با استفاده از ارائه دهنده اندازه گیری شخص ثالث ، تبدیل به موجودی AD را نسبت دهد ، اما AD Tech Hosting Creative هیچ گونه نیاز به اندازه گیری انتساب ندارد. این امر برای ناشران ، SSP ها یا سرورهای تبلیغاتی ناشر که میزبان خلاقیت هستند و قصد ندارند از خود گزارش دهند ، اما کسانی که می خواهند API گزارشگر انتساب را برای شرکای DSP خود یا برای شرکت های اندازه گیری اندازه گیری مانند سرورهای تبلیغاتی شخص ثالث ، اندازه گیری یا ارائه دهندگان تجزیه و تحلیل فعال کنند ، معمول است.

در این حالت ، طرفی که وظیفه شلیک و برداشت رویدادها را در مجموعه فعلی دارد ، باید ویژگی جدید attributionsrc را به خلاقان اضافه کند و اطمینان حاصل کند که تغییر مسیر مانند آنچه در نظر گرفته شده است. این به یکپارچه سازی هر ناشر بسیار وابسته است ، اما برای رویدادهای کلیک ، این می تواند SSP ، خدمت به فناوری تبلیغاتی یا خود ناشر باشد. برای وقایع برداشت ، این معمولاً ارائه دهنده اندازه گیری شخص ثالث است.

در مثال تنظیم کمپین معمولی از سناریو 1 ، خود ناشر AD Server ، SSP یا خود ناشر فقط ممکن است نیاز به اطمینان از ویژگی attributionsrc که توسط DSP ارائه شده است ، آن را بر روی صفحه ناشر قرار دهد.

جزئیات پیاده سازی

در جدول زیر مراحل اجرای API گزارش انتساب در سطح بالا توضیح داده شده است:

توجه داشته باشید که مشخصات هر مرحله به نحوه ارائه و ارائه خدمات خلاق در صفحه ناشر بستگی دارد و کدام یک از اشخاص فناوری تبلیغاتی گزارش های ارسال شده توسط API گزارش انتساب را دریافت می کنند.

مرحله 1: منبع انتساب را برای خلاقان موجود و کد اندازه گیری فعال کنید

در مرحله اول ، منابع انتساب فعال می شوند.

چگونه ویژگی attributionsrc کار می کند

ویژگی جدید attributionsrc مشخص می کند که درخواست های API گزارش انتساب به کجا ارسال می شود. موجودی که وظیفه شلیک برداشت و کلیک بر روی رویدادها را بر عهده دارد ، باید خلاقان را با ویژگی attributionsrc به روز کند. attributionsrc باید به رویدادهای کلیک و برداشت موجود اضافه شود و می تواند خالی یا غیر خالی باشد.

برای رویدادهای کلیک با استفاده از Redirects ، ویژگی attributionsrc باید به ناوبری اضافه شود. هر 302 تغییر مسیر پس از ناوبری نیازی به اضافه کردن ویژگی attributionsrc ندارد و تا زمانی که ناوبری اولیه attributionsrc اضافه کند ، واجد شرایط ARA خواهد بود.

هنگامی که attributionsrc خالی است ، درخواست های ARA به URL تعریف شده در ویژگی href از برچسب Anchor (URL Clickthrough) ارسال می شود. هنگامی که ویژگی attributionsrc تعریف می شود ، درخواست های ARA به URL تعریف شده در ویژگی attributionsrc ارسال می شود. URL Clickthrough نیز واجد شرایط ثبت منابع است.

به طور کلی ، اگر سرور میزبان URL Clickthrough می تواند درخواست های API گزارش انتساب را دریافت و پاسخ دهد ، از یک ویژگی خالی attributionsrc استفاده کنید. اگر می خواهید درخواست های API گزارش انتساب به سرور دیگری مراجعه کنید ، URL attributionsrc خود را تعریف کنید.

نمونه ای از یک ویژگی attributionsrc :

هنگامی که ویژگی attributionsrc خالی است ، درخواست های API گزارش انتساب به URL تعریف شده توسط ویژگی href از برچسب لنگر ارسال می شود.

نمونه ای از یک ویژگی غیر خالی از ویژگی های غیر خالی:

هنگامی که attributionsrc خالی نیست ، درخواست های API گزارش انتساب به URL تعریف شده توسط برچسب attributionsrc ارسال می شود. URL Clickthrough نیز واجد شرایط ثبت منابع است.

برای رویدادهای کلیک و تصور attributionsrc اضافه کنید

• روی رویدادها کلیک کنید:
  • نهاد مسئول اضافه کردن attributionsrc معمولاً فناوری تبلیغاتی است.
  • برچسب های لنگر با رویدادهای کلیک باید یک ویژگی attributionsrc را اضافه کند.
  • با استفاده از window.open باید از آرگومان windowFeatures از window.open Call استفاده کنید تا منبع انتساب را مشخص کنید.
• وقایع تصور:
  • نهاد مسئول افزودن attributionsrc معمولاً فناوری تبلیغاتی و ارائه دهنده (های) اندازه گیری است.
  • وقایع تصور شده از برچسب <img> یا برچسب <script> باید شامل یک ویژگی attributionsrc باشد.
  • رویدادهای Impression با استفاده از API Fetch باید شامل یک شیء attributionReporting در آرگومان گزینه های منتقل شده به تماس API Fetch باشد.

جدول زیر را برای خلاصه اصلاحات مورد نیاز برای رویدادهای کلیک و تصور مشاهده کنید:

ثبت نام منبع انتساب را در حراج مخاطبان محافظت شده فعال کنید

برای اندازه گیری تبدیل در حراج های مخاطبان محافظت شده ، به جای استفاده از attributionsrc ، می توانید از registerAdBeacon / registerAdMacro و setReportEventDataForAutomaticBeacons / reportEvent استفاده کنید تا منابع ثبت نام را فعال کنید.

برای گزارش سیگنال های مخاطبان محافظت شده ، عملکرد registerAdBeacon در داخل کارگاه گزارشگری در دسترس است و registerAdMacro در داخل کار گزارشگری برنده خریدار در دسترس است. سپس ، داده های رویداد در داخل قاب تبلیغاتی را می توان به چراغهای ثبت شده و ماکروها با reportEvent و setReportEventDataForAutomaticBeacons مربوط به عملکردهای تبلیغاتی فریم حصارکشی API به Beacons و Macros اضافه کرد. این اجازه می دهد تا سیگنال های کارگاه های گزارش شده مخاطبان محافظت شده و بار بارگذاری رویداد Creative Frame با یکدیگر در ارتباط باشند.

هدر HTTP Attribution-Reporting-Eligible هنگامی که چراغها و ماکروها توسط تماس reportEvent از یک قاب انجام می شوند ، به درخواست اضافه می شوند ، یا چراغ های اتوماتیک توسط مرورگر ایجاد می شوند. می توانید از پاسخ Beacon برای ثبت یک منبع انتساب استفاده کنید. درخواست های چراغ ممکن است هدایت شود تا اندازه گیری شخص ثالث امکان پذیر باشد.

For a deeper dive, see the Support for Attribution Reporting section of the Fenced Frame Ad Reporting API explainer.

Enable attribution reporting for VAST formats

VAST is a common format for serving and measuring video ad inventory, and many of the events defined in that standard should be considered potential source events eligible for registration with the Attribution Reporting API. The VAST Addendum for Attribution Reporting Support covers this in detail, but in short, all <Tracking> , <Impression> , <*ClickThrough> , and <*ClickTracking> events are potential attribution source events. All VAST implementations should provide registration eligibility coverage for these events.

The VAST addendum defines new attributes for these elements to allow for setting a secondary URL specifically for attribution registration. When an event contains attributiontype="DOUBLE_PING" and attributionsrc="[URL]" , the code firing that event should use [URL] as the value of the attributionsrc attribute when enabling the Attribution Reporting API. The VAST addendum contains examples for each scenario.

To ensure maximum coverage, VAST implementations should make all events listed are registration eligible by default when firing event pings. For example, when firing an <Impression> event URL, the (empty) attributionsrc attribute should be used on the <img> element used to send the request (or the equivalent on the fetch call), to always allow for the receiving party to potentially register that event with the Attribution Reporting API.

Step 2: Enable Attribution Reporting for third-party origins

To allow third-parties to use the Attribution Reporting API, you can use existing redirects or add a list of third-parties to the attributionsrc attribute. In most cases, each ad tech has their own independent impression tracker, so redirects are more relevant for click trackers.

Handle third-party origins in an existing redirect chain

In a typical ad clickthrough, many click trackers may be present as a chain of 302 redirects made as part of the navigation to the final landing page. Every request in the redirect chain is eligible for registration with the Attribution Reporting API if the original click target was annotated with attributionsrc or registered with registerAdBeacon/registerAdMacro in Protected Audience API . The ad tech in the redirect chain must be also enrolled .

Note that the initial request's body is not sent on redirects. For Protected Audience auctions, if eventData passed in to reportEvent and setReportEventDataForAutomaticBeacons needs to be used as part of the redirect, it must be explicitly passed on as part of the redirect URL.

In the following example, we will use a serving ad tech ( serving-adtech.example ) and a third-party measurement provider ( 3p-measurement.example ) as two distinct entities that are looking to generate and receive attribution reports. The serving ad tech in this example can be a DSP that renders the creative on the publisher site, and has their own reporting product. The third-party measurement provider can be an entity that the advertiser uses for conversion reporting.

At source registration time, the following steps take place:

1. serving-adtech.example sets the attributionsrc attribute in the creative.The user visits the publisher page, and the browser sends a request to serving-adtech.example.
2. serving-adtech.example responds with the Attribution-Reporting-Register-Source header and the Location header.
   1. serving-adtech.example uses the Attribution-Reporting-Register-Source header to respond with metadata about the source to be registered.
   2. serving-adtech.example uses the Location header to include a redirect to 3p-measurement.example . Note that it's likely that the Location header is already being used in your existing clicktracking flows to support 302 redirects to a third-party.
3. The browser receives the response from serving-adtech.example and parses the Attribution-Reporting-Register-Source header. The browser stores the source event, using serving-adtech.example as the reporting origin.
4. Because this request is a redirect, the browser also makes a new request to 3p-measurement.example .
5. 3p-measurement.example responds with a response that contains the Attribution-Reporting-Register-Source header.
6. The browser receives this response from 3p-measurement.example and reads the Attribution-Reporting-Register-Source . The browser stores the source event, using 3p-measurement.example as the reporting origin.

Use attributionsrc for third-party origins not in a redirect chain

If multiple reporter origins want to register a source on a navigation event, but can't appear in a redirect chain for any reason, you can list multiple sites as attribution sources in attributionsrc as an alternative solution.

In this example, Attribution Reporting API-eligible requests will be sent to both REPORTING_URL_1 and. REPORTING_URL_2 . The navigation request sent to the clickthrough URL is also eligible to register attribution sources.

Step 3: Set up responses for Attribution Reporting API requests

For all origins receiving an Attribution Reporting API request, ensure that the server responds with the appropriate Attribution-Reporting-Register-Source header. See the Register sources guide and the explainer to learn how the response should be constructed.

Register multiple triggers

You can register multiple attribution triggers by adding multiple pixel elements on the conversion side (one per trigger). The attributionsrc element is optional for trigger registration .

You can also register multiple triggers from a single pixel element by using redirect requests or listing multiple URLs in the attributionsrc element in the same way as for source registration. Source events and trigger events that have been generated by the same origins will be matched.