اندازهگیری اسناد تبدیل میتواند شامل چندین طرف باشد، اعم از ناشر، تبلیغکننده، خدمات فناوری تبلیغات (موجودی که تبلیغ را ارائه میدهد)، ارائهدهنده اندازهگیری، و موارد دیگر. در این سند، سناریوهای رایج اندازهگیری تبدیل را نشان میدهیم، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از 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 هستند.
یک تنظیم کمپین معمولی می تواند به این صورت باشد:
سرور تبلیغات تبلیغکننده (3PAS) نشانهگذاری خلاقیت آگهی را به DSP ارائه میکند، که شامل پیکسلهای ردیابی نمایش و کلیک ارائهدهنده اندازهگیری شخص ثالث است. سرور آگهی باید مطمئن باشد که
attributionsrcدر نشانهگذاری خلاقانه آگهی گنجانده شده است.DSP قابلیتهایی را برای افزودن نمایش اندازهگیری اضافی و پیکسلهای ردیابی کلیک ارائه میدهد، و باید مطمئن شود که
attributionsrcدر نشانهگذاری خلاق آگهی نهایی که با آن مناقصه میدهند گنجانده شده است.
سناریو 2: فقط ارائهدهنده اندازهگیری شخص ثالث باید گزارشهایی را از API گزارش Attribution دریافت کند.
یک تبلیغکننده میخواهد با استفاده از یک ارائهدهنده اندازهگیری شخص ثالث، تبدیلها را در موجودی آگهی نسبت دهد، اما فناوری تبلیغاتی که میزبان خلاقیت است، هیچ الزامی برای اندازهگیری انتساب ندارد. این امر برای ناشران، SSPها یا سرورهای تبلیغاتی ناشر که میزبان خلاقیت هستند و نمیخواهند خودشان از گزارش انتساب استفاده کنند، معمول است، اما میخواهند API گزارش اسناد را برای شرکای DSP خود یا برای شرکتهای برچسبگذاری اندازهگیری مانند سرورهای تبلیغات شخص ثالث، ارائهدهندگان اندازهگیری یا تجزیه و تحلیل فعال کنند.
در این حالت، طرفی که مسئول اجرای رویدادهای کلیک و نمایش در راهاندازی فعلی است، باید ویژگی جدید attributionsrc را به خلاقیتها اضافه کند و تأیید کند که تغییرمسیرها طبق خواسته کار میکنند. این به شدت به ادغام هر ناشر بستگی دارد، اما برای رویدادهای کلیکی، این میتواند SSP، خدمات فناوری تبلیغات یا خود ناشر باشد. برای رویدادهای نمایش، این معمولاً ارائهدهنده اندازهگیری شخص ثالث است.
در نمونه راهاندازی کمپین معمولی از سناریو 1، سرور تبلیغات ناشر، SSP یا خود ناشر ممکن است فقط نیاز داشته باشند که ویژگی attributionsrc را که توسط DSP ارائه شده است، به صفحه ناشر وارد میکند.
جزئیات پیاده سازی
جدول زیر مراحل اجرای Attribution Reporting API را در سطح بالا شرح می دهد:
| مراحل | مسئولیت کار | نمونه ها |
|---|---|---|
| مرحله 1: منبع انتساب را برای خلاقیت های موجود و کد اندازه گیری فعال کنید | نهاد مسئول اجرای رویدادهای impression یا مدیریت رویدادهای کلیک، ویژگی attributionsrc را اضافه می کند. | برای رویدادهای کلیکی، معمولاً یک خریدار (سرور تبلیغات DSP/تبلیغ کننده) که خلاقیت را ارائه می کند، ویژگی را اضافه می کند. برای رویدادهای نمایش، پلتفرم سمت تقاضا (DSP)، پلتفرم سمت عرضه (SSP)، ناشر، سرور تبلیغات، یا ارائهدهنده اندازهگیری این ویژگی را اضافه میکند و این ویژگی به تنظیمات ناشر بستگی دارد. برای تبلیغات ویدیویی با استفاده از فرمت VAST، ناشر و SDK ویدیو این ویژگی را اضافه میکنند. |
| مرحله 2: گزارش Attribution را برای منابع شخص ثالث فعال کنید | اگر از یک مسیر تغییر مسیر موجود با 302 تغییر مسیر استفاده کنید، این کار خارج از چارچوب است. اگر نمی توان از تغییر مسیرهای 302 استفاده کرد، از ویژگی | به طور کلی، تا زمانی که ویژگی attributionsrc به خلاقیت اضافه شود، تغییر مسیرهای شخص ثالث باید تماسهای API گزارش Attribution را دریافت کنند. |
| مرحله 3: پاسخها را برای درخواستهای API Reporting Attribution تنظیم کنید | هر نهادی که میخواهد گزارشهایی را از Attribution Reporting API دریافت کند | DSP و ارائهدهنده اندازهگیری شخص ثالث که توسط تبلیغکننده استفاده میشود |
توجه داشته باشید که ویژگیهای هر مرحله به نحوه ارائه و ارائه خلاقیتها در صفحه ناشر و اینکه کدام نهادهای فناوری تبلیغات گزارشهای ارسال شده توسط 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 :
| تنظیمات موجود شما | با یکپارچه سازی ARA |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a> |
وقتی مشخصه attributionsrc خالی باشد، درخواستهای API Reporting Attribution به URL تعریف شده توسط ویژگی href تگ anchor ارسال میشود.
مثالی از ویژگی غیر خالی attributionsrc:
| تنظیمات موجود شما | با یکپارچه سازی ARA |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a> |
وقتی 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 باشد.
- نهادی که مسئول افزودن
برای خلاصه تغییرات مورد نیاز برای رویدادهای کلیک و نمایش به جدول زیر مراجعه کنید:
| رویداد | برچسب بزنید | تنظیمات موجود شما | پس از ادغام ARA |
|---|---|---|---|
| کلیک کنید | HTML | <a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a> |
| جاوا اسکریپت | window.open("[CLICKTHROUGH_URL]", "_blank"); | window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc"); | |
| برداشت | تگ <img> HTML | <img src="[IMPRESSION_URL]"> | <img src="[IMPRESSION_URL]" attributionsrc> |
تگ <script> HTML | <script src="[IMPRESSION_URL]"></script> | <script src="[IMPRESSION_URL]" attributionsrc></script> | |
| جاوا اسکریپت | const options = {...} | const options = { |
ثبت منبع منبع را در حراج مخاطب محافظت شده فعال کنید
برای اندازهگیری تبدیلها در حراجهای مخاطب محافظتشده، بهجای استفاده از 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 باشد که خلاقیت را در سایت ناشر ارائه میکند و محصول گزارشدهی خود را دارد. ارائهدهنده اندازهگیری شخص ثالث میتواند نهادی باشد که تبلیغکننده از آن برای گزارش تبدیل استفاده میکند.

در زمان ثبت منبع، مراحل زیر انجام می شود:
-
serving-adtech.exampleویژگیattributionsrcرا در creative تنظیم می کند. کاربر از صفحه ناشر بازدید می کند و مرورگر درخواستی را بهserving-adtech.example. -
serving-adtech.exampleبا سرصفحهAttribution-Reporting-Register-Sourceو سرصفحهLocationپاسخ می دهد.-
serving-adtech.exampleاز سرصفحهAttribution-Reporting-Register-Sourceبرای پاسخ دادن با ابرداده در مورد منبعی که باید ثبت شود استفاده می کند. -
serving-adtech.exampleاز سرصفحهLocationبرای اضافه کردن یک تغییر مسیر به3p-measurement.exampleاستفاده می کند. توجه داشته باشید که این احتمال وجود دارد که هدرLocationدر حال حاضر در جریان های ردیابی کلیک فعلی شما برای پشتیبانی از تغییر مسیرهای302به شخص ثالث استفاده شده باشد.
-
- مرورگر پاسخ را از
serving-adtech.exampleدریافت می کند و سرصفحهAttribution-Reporting-Register-Sourceتجزیه می کند. مرورگر رویداد منبع را با استفاده ازserving-adtech.exampleبه عنوان منبع گزارش ذخیره می کند. - از آنجایی که این درخواست یک تغییر مسیر است، مرورگر یک درخواست جدید به
3p-measurement.exampleنیز ارسال می کند. -
3p-measurement.exampleبا پاسخی که حاوی سرصفحهAttribution-Reporting-Register-Sourceاست پاسخ می دهد. - مرورگر این پاسخ را از
3p-measurement.exampleدریافت می کند وAttribution-Reporting-Register-Sourceمی خواند. مرورگر رویداد منبع را با استفاده از3p-measurement.exampleبه عنوان مبدا گزارش ذخیره می کند.
از attributionsrc برای مبداهای شخص ثالث استفاده کنید نه در زنجیره تغییر مسیر
اگر چندین منبع گزارشگر میخواهند منبعی را در یک رویداد ناوبری ثبت کنند، اما به هر دلیلی نمیتوانند در زنجیره تغییر مسیر ظاهر شوند، میتوانید چندین سایت را به عنوان منابع انتساب در attributionsrc بهعنوان راهحل جایگزین فهرست کنید.
| تنظیمات موجود شما | با اصلاح ARA |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a> |
در این مثال، درخواستهای واجد شرایط API Reporting Attribution به هر دو REPORTING_URL_1 و. REPORTING_URL_2 . درخواست پیمایش ارسال شده به نشانی اینترنتی کلیک نیز واجد شرایط ثبت منابع انتساب است.
مرحله 3: پاسخها را برای درخواستهای API Reporting Attribution تنظیم کنید
برای همه مبداهایی که درخواست API گزارش Attribution دریافت میکنند، بررسی کنید که سرور با هدر Attribution-Reporting-Register-Source مناسب پاسخ میدهد. راهنمای منابع ثبت نام و توضیح دهنده را ببینید تا نحوه ایجاد پاسخ را بیاموزید.
چندین محرک را ثبت کنید
میتوانید با افزودن چندین عنصر پیکسل در سمت تبدیل (یکی برای هر ماشه) چندین عامل انتساب را ثبت کنید. عنصر attributionsrc برای ثبت ماشه اختیاری است.
همچنین میتوانید با استفاده از درخواستهای تغییر مسیر یا فهرست کردن چندین URL در عنصر attributionsrc به همان روشی که برای ثبت منبع، چندین راهانداز را از یک عنصر پیکسلی ثبت کنید. رویدادهای منبع و رویدادهای ماشه ای که توسط مبداهای یکسانی ایجاد شده اند مطابقت داده می شوند.