اندازهگیری نسبت تبدیل میتواند شامل چندین طرف باشد، از ناشر، تبلیغکننده، فناوری تبلیغات ارائهدهنده (نهادی که تبلیغ را ارائه میدهد)، ارائهدهنده اندازهگیری و موارد دیگر. در این سند، سناریوهای رایج اندازهگیری تبدیل را نشان میدهیم، اما بهطورکلی هر طرفی که مایل به دریافت گزارش نسبت از API گزارشدهی نسبت (ARA) است، باید مطمئن شود که مراحل ادغام شرح داده شده در این سند رعایت میشود.
برای مثال، معمول است که یک ناشر یک یا چند تکنسین تبلیغات را مسئول ارائه تبلیغ خود داشته باشد - این میتواند شامل طرفهایی باشد که مسئول تأمین نشانهگذاری برای تبلیغ خلاقانه، طرفهایی که پیکسل نمایش یا ردیابی را روی تبلیغ خلاقانه تأمین میکنند، و طرفهایی که SDK یا برچسب را برای جایگاه تبلیغ در صفحه ناشر تأمین میکنند. این تکنسینهای تبلیغات ممکن است بخواهند یا نخواهند گزارشهای انتساب را از ARA دریافت کنند، اما در موقعیتی قرار دارند که مطمئن شوند تکنسینهای تبلیغات پاییندستی میتوانند گزارشهای انتساب را دریافت کنند.
علاوه بر این، تبلیغکننده ممکن است از یک ارائهدهنده اندازهگیری تبدیل شخص ثالث برای انتساب بین شبکهای و همچنین سایر قابلیتهای گزارشدهی استفاده کند. تبلیغکنندگان از این دادهها برای درک بازگشت سرمایه تبلیغات در چندین ناشر و کانال منحصر به فرد استفاده میکنند، بنابراین مهم است که DSPها یا سرورهای تبلیغاتی بدانند که چگونه API گزارشدهی انتساب را برای پشتیبانی از این موارد استفاده فعال کنند. تبلیغکنندگانی که میخواهند از یک شخص ثالث استفاده کنند، میتوانند به این کار ادامه دهند، یا با استفاده از یک ارائهدهنده اندازهگیری شخص ثالث یا با راهاندازی یک سرور داخلی برای ثبت و دریافت گزارشها از API.
API گزارشدهی نسبتدهی به چندین تکنسین تبلیغات اجازه میدهد تا منابع نسبتدهی و محرکها را برای یک نمایش یا تبدیل یکسان ثبت کنند و گزارشهای جداگانهای از API دریافت کنند. به عنوان مثال، یک DSP میتواند گزارشهای نسبتدهی خود را از API گزارشدهی نسبتدهی دریافت کند و همچنین گزارشهای جداگانهای را برای ارائهدهنده اندازهگیری شخص ثالث تبلیغکننده فراهم کند. یک تکنسین تبلیغات باید هم منابع نسبتدهی و هم محرکها را ثبت کند تا گزارشها را از API دریافت کند و نسبتدهی در میان منابع نسبتدهی و محرکهایی انجام میشود که تکنسین تبلیغات به صورت جداگانه در API ثبت کرده است.
سناریوهای رایج اندازهگیری تبدیل
در این بخش، دو سناریوی رایج برای اندازهگیری تبدیل را بررسی خواهیم کرد.
سناریو ۱: هم فناوری تبلیغات در حال ارائه و هم ارائهدهنده اندازهگیری شخص ثالث، نیاز به دریافت گزارش از API گزارشدهی انتساب دارند.
یک تبلیغکننده میخواهد با استفاده از یک ارائهدهنده اندازهگیری شخص ثالث، تبدیلها را به موجودی تبلیغات نسبت دهد و فناوری تبلیغاتی که میزبان خلاقیت است، میخواهد تبدیلها را به موجودی تبلیغات نسبت دهد. این امر برای DSPها یا سرورهای تبلیغاتی تبلیغکننده (سرور تبلیغاتی شخص ثالث - 3PAS) که نشانهگذاری را برای خلاقیتهای تبلیغاتی ارائه میدهند، گزارشهای انتساب خود را انجام میدهند و با تبلیغکنندگانی کار میکنند که با ارائهدهندگان اندازهگیری یا تجزیه و تحلیل شخص ثالث ادغام میشوند، رایج است.
در این حالت، فناوری تبلیغات ارائه دهنده، طرفی است که مسئول ایجاد رویدادهای کلیک و نمایش در تنظیمات فعلی است. فناوری تبلیغات ارائه دهنده باید attributionsrc جدید را در مکانهای مناسب تنظیم کند و تأیید کند که تغییر مسیرها به درستی پیکربندی شدهاند. همچنین، هم فناوری تبلیغات ارائه دهنده و هم ارائه دهنده اندازهگیری شخص ثالث باید تأیید کنند که ثبتنام شدهاند و سرورهای آنها آماده دریافت و پاسخ به درخواستهای API گزارشدهی Attribution هستند.
یک چیدمان کمپین معمولی میتواند به این شکل باشد:
سرور تبلیغات تبلیغکننده (3PAS) نشانهگذاری (markup) برای آگهی تبلیغاتی را به DSP ارائه میدهد، که شامل پیکسلهای ردیابی نمایش و کلیک ارائهدهنده اندازهگیری شخص ثالث میشود. سرور تبلیغات باید مطمئن شود که
attributionsrcدر نشانهگذاری آگهی تبلیغاتی گنجانده شده است.DSP قابلیتهایی را برای افزودن پیکسلهای اندازهگیری اضافی برای نمایش و ردیابی کلیک ارائه میدهد و باید مطمئن شود که
attributionsrcدر نشانهگذاری خلاقانه تبلیغ نهایی که با آن پیشنهاد میدهند، گنجانده شده است.
سناریو ۲: فقط ارائهدهنده اندازهگیری شخص ثالث نیاز به دریافت گزارشها از API گزارشدهی انتساب دارد
یک تبلیغکننده میخواهد تبدیلها را در موجودی تبلیغات با استفاده از یک ارائهدهنده اندازهگیری شخص ثالث نسبت دهد، اما فناوری تبلیغاتی که میزبان آگهی تبلیغاتی است، هیچ الزام اندازهگیری انتساب ندارد. این امر برای ناشران، SSPها یا سرورهای تبلیغاتی ناشر که میزبان آگهیهای تبلیغاتی هستند و قصد ندارند خودشان از گزارش انتساب استفاده کنند، اما میخواهند API گزارش انتساب را برای شرکای DSP خود یا برای شرکتهای برچسبگذاری اندازهگیری مانند سرورهای تبلیغاتی شخص ثالث، ارائهدهندگان اندازهگیری یا تجزیه و تحلیل فعال کنند، رایج است.
در این حالت، طرفی که مسئول ایجاد رویدادهای کلیک و نمایش در تنظیمات فعلی است، باید ویژگی جدید attributionsrc را به بخش خلاقیت اضافه کند و تأیید کند که تغییر مسیرها طبق برنامه کار میکنند. این امر به شدت به ادغام هر ناشر بستگی دارد، اما برای رویدادهای کلیک، این میتواند SSP، ارائه دهنده خدمات تبلیغاتی یا خود ناشر باشد. برای رویدادهای نمایش، این معمولاً ارائه دهنده اندازهگیری شخص ثالث است.
در مثال معمول راهاندازی کمپین از سناریوی ۱، سرور تبلیغات ناشر، SSP یا خود ناشر ممکن است فقط نیاز داشته باشند که تأیید کنند ویژگی attributionsrc که توسط DSP ارائه شده است، در صفحه ناشر قرار میگیرد.
جزئیات پیادهسازی
جدول زیر مراحل پیادهسازی API گزارشدهی انتساب را در سطح بالا شرح میدهد:
| مراحل | مسئولیت پذیری کار | مثالها |
|---|---|---|
| مرحله ۱: منبع انتساب را برای آگهیهای تبلیغاتی موجود و کد اندازهگیری فعال کنید | موجودیتی که مسئول ایجاد رویدادهای نمایش یا مدیریت رویدادهای کلیک است، ویژگی attributionsrc را اضافه میکند. | برای رویدادهای کلیک، معمولاً یک خریدار (DSP/سرور تبلیغات تبلیغکننده) که تبلیغ را ارائه میدهد، این ویژگی را اضافه میکند. برای رویدادهای نمایش، پلتفرم سمت تقاضا (DSP)، پلتفرم سمت عرضه (SSP)، ناشر، سرور تبلیغات یا ارائهدهندهی اندازهگیری، این ویژگی را اضافه میکنند و این ویژگی به تنظیمات ناشر بستگی دارد. برای تبلیغات ویدیویی با استفاده از فرمت VAST، ناشر و SDK ویدیو این ویژگی را اضافه میکنند. |
| مرحله ۲: گزارش انتساب را برای منابع شخص ثالث فعال کنید | اگر از یک مسیر ریدایرکت موجود با ریدایرکتهای 302 استفاده کنید، این روش به صورت پیشفرض کار میکند. اگر امکان استفاده از ریدایرکتهای ۳۰۲ وجود نداشته باشد، میتوان از ویژگی | به طور کلی، تا زمانی که ویژگی attributionsrc به خلاقیت اضافه شود، ریدایرکتهای شخص ثالث باید فراخوانیهای API گزارشدهی Attribution را دریافت کنند. |
| مرحله ۳: تنظیم پاسخها برای درخواستهای API گزارشدهی انتساب | هر نهادی که میخواهد گزارشهایی از API گزارشدهی انتساب دریافت کند | DSP و ارائه دهنده اندازهگیری شخص ثالث مورد استفاده تبلیغکننده |
توجه داشته باشید که جزئیات هر مرحله به نحوه ارائه و ارائه آگهیهای تبلیغاتی در صفحه ناشر و اینکه کدام نهادهای فناوری تبلیغات گزارشهای ارسالی توسط API گزارشدهی انتساب را دریافت میکنند، بستگی دارد.
مرحله ۱: منبع انتساب را برای آگهیهای تبلیغاتی موجود و کد اندازهگیری فعال کنید
در مرحله اول، منابع انتساب فعال میشوند.
نحوهی عملکرد ویژگی attributionsrc
ویژگی جدید attributionsrc مشخص میکند که درخواستهای API گزارشدهی Attribution به کجا ارسال شوند. موجودیتی که مسئول اجرای رویدادهای نمایش و کلیک است، باید آگهیها را با ویژگی attributionsrc بهروزرسانی کند. attributionsrc باید به رویدادهای کلیک و نمایش موجود اضافه شود و میتواند خالی یا غیرخالی باشد.
برای رویدادهای کلیک با استفاده از ریدایرکتها، ویژگی attributionsrc باید به ناوبری اضافه شود. هر ریدایرکت 302 پس از ناوبری نیازی به اضافه کردن ویژگی attributionsrc ندارد و تا زمانی که ناوبری اولیه attributionsrc اضافه کرده باشد، واجد شرایط دریافت ARA خواهد بود.
وقتی attributionsrc خالی باشد، درخواستهای ARA به URL تعریف شده در ویژگی href تگ anchor (clickthrough URL) ارسال میشوند. وقتی ویژگی attributionsrc تعریف شده باشد، درخواستهای ARA به URL تعریف شده در ویژگی attributionsrc ارسال میشوند. clickthrough URL همچنین واجد شرایط ثبت منابع است.
به طور کلی، اگر سرور میزبان URL کلیک میتواند درخواستهای API گزارشدهی Attribution را دریافت و پاسخ دهد، از یک ویژگی attributionsrc خالی استفاده کنید. اگر میخواهید درخواستهای API گزارشدهی Attribution به سرور دیگری ارسال شوند، URL attributionsrc خود را تعریف کنید.
مثالی از یک ویژگی attributionsrc خالی:
| تنظیمات موجود شما | با ادغام ARA |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a> |
وقتی ویژگی attributionsrc خالی باشد، درخواستهای API گزارشدهی Attribution به URL تعریفشده توسط ویژگی href تگ anchor ارسال میشوند.
مثالی از یک ویژگی attributionsrc غیر تهی:
| تنظیمات موجود شما | با ادغام ARA |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a> | <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a> |
وقتی attributionsrc خالی نباشد، درخواستهای API گزارشدهی Attribution به URL تعریفشده توسط تگ attributionsrc ارسال میشوند. URL کلیکگذر نیز واجد شرایط ثبت منابع است.
برای رویدادهای کلیک و نمایش attributionsrc اضافه کنید
- رویدادهای کلیک:
- نهاد مسئول اضافه کردن
attributionsrcمعمولاً فناوری تبلیغات ارائه دهنده است. - تگهای لنگر با رویدادهای کلیک باید دارای ویژگی
attributionsrcباشند. - کلیکهایی که از
window.openاستفاده میکنند باید از آرگومانwindowFeaturesدر فراخوانیwindow.openبرای مشخص کردن منبع انتساب استفاده کنند.
- نهاد مسئول اضافه کردن
- رویدادهای برداشت:
- نهاد مسئول اضافه کردن
attributionsrcمعمولاً فناوری تبلیغاتی ارائه دهنده و ارائه دهنده (ارائه دهندگان) اندازهگیری است. - رویدادهای نمایش که از تگ
<img>یا تگ<script>اجرا میشوند، باید شامل یک ویژگیattributionsrcباشند. - رویدادهای نمایش (impression events) که از Fetch API استفاده میکنند، باید شامل یک شیء
attributionReportingدر آرگومان options ارسالی به فراخوانی fetch API باشند.
- نهاد مسئول اضافه کردن
برای خلاصهای از تغییرات مورد نیاز برای رویدادهای کلیک و نمایش، به جدول زیر مراجعه کنید:
| رویداد | برچسب | تنظیمات موجود شما | پس از ادغام ARA |
|---|---|---|---|
| کلیک | اچتیامال | <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 برای فعال کردن ثبت منابع attribution استفاده کنید.
برای گزارش سیگنالهای مخاطبان محافظتشده، تابع registerAdBeacon در داخل workletهای گزارشدهی موجود است و registerAdMacro در داخل worklet گزارشدهی خریدار در دسترس است. سپس، دادههای رویداد داخل فریم تبلیغ را میتوان با توابع reportEvent و setReportEventDataForAutomaticBeacons از Fenced Frame Ads Reporting API به beaconها و ماکروهای ثبتشده اضافه کرد. این امر به سیگنالهای workletهای گزارشدهی مخاطبان محافظتشده و payload رویداد فریم خلاق تبلیغ اجازه میدهد تا با یکدیگر مرتبط شوند.
هدر HTTP Attribution-Reporting-Eligible زمانی به درخواست اضافه میشود که beaconها و ماکروها توسط فراخوانی reportEvent از یک فریم فعال شوند، یا beaconهای خودکار توسط مرورگر فعال شوند. میتوانید از پاسخ beacon برای ثبت یک منبع انتساب استفاده کنید. درخواستهای beacon ممکن است برای امکان اندازهگیری توسط شخص ثالث، تغییر مسیر داده شوند.
برای بررسی عمیقتر، به بخش «پشتیبانی از گزارشدهی انتساب» در توضیح API گزارشدهی تبلیغاتی Fenced Frame مراجعه کنید.
گزارش انتساب را برای قالبهای VAST فعال کنید
VAST یک قالب رایج برای ارائه و اندازهگیری موجودی تبلیغات ویدیویی است و بسیاری از رویدادهای تعریفشده در آن استاندارد باید به عنوان رویدادهای منبع بالقوه واجد شرایط برای ثبت در API گزارشدهی انتساب در نظر گرفته شوند. ضمیمه VAST برای پشتیبانی از گزارشدهی انتساب ، این موضوع را به تفصیل پوشش میدهد، اما به طور خلاصه، همه رویدادهای <Tracking> ، <Impression> ، <*ClickThrough> و <*ClickTracking> رویدادهای منبع انتساب بالقوه هستند. همه پیادهسازیهای VAST باید پوشش واجد شرایط بودن ثبت را برای این رویدادها فراهم کنند.
ضمیمه VAST ویژگیهای جدیدی را برای این عناصر تعریف میکند تا امکان تنظیم یک URL ثانویه به طور خاص برای ثبت انتساب فراهم شود. هنگامی که یک رویداد شامل attributiontype="DOUBLE_PING" و attributionsrc="[URL]" باشد، کدی که آن رویداد را اجرا میکند باید هنگام فعال کردن API گزارشدهی انتساب، از [URL] به عنوان مقدار ویژگی attributionsrc استفاده کند. ضمیمه VAST شامل مثالهایی برای هر سناریو است.
برای پوشش حداکثری، پیادهسازیهای VAST باید بهطور پیشفرض، تمام رویدادهای فهرستشده را هنگام ارسال پینگ رویداد، واجد شرایط ثبت کنند. بهعنوانمثال، هنگام ارسال یک URL رویداد <Impression> ، باید از ویژگی (خالی) attributionsrc در عنصر <img> مورد استفاده برای ارسال درخواست (یا معادل آن در فراخوانی fetch) استفاده شود تا همیشه به طرف گیرنده اجازه داده شود تا آن رویداد را بهطور بالقوه با API گزارشدهی Attribution ثبت کند.
مرحله ۲: گزارش انتساب را برای منابع شخص ثالث فعال کنید
برای اینکه به اشخاص ثالث اجازه دهید از API گزارشدهی Attribution استفاده کنند، میتوانید از ریدایرکتهای موجود استفاده کنید یا لیستی از اشخاص ثالث را به ویژگی attributionsrc اضافه کنید. در بیشتر موارد، هر شرکت تبلیغاتی ردیاب نمایش مستقل خود را دارد، بنابراین ریدایرکتها برای ردیابهای کلیک مرتبطتر هستند.
مدیریت ریشههای شخص ثالث در یک زنجیره تغییر مسیر موجود
در یک کلیکریتوری معمولی، بسیاری از ردیابهای کلیک ممکن است به عنوان زنجیرهای از ریدایرکتهای 302 که به عنوان بخشی از ناوبری به صفحه فرود نهایی انجام میشوند، حضور داشته باشند. هر درخواست در زنجیره ریدایرکت، در صورتی که هدف کلیک اصلی با attributionsrc حاشیهنویسی شده باشد یا با registerAdBeacon/registerAdMacro در Protected Audience API ثبت شده باشد، واجد شرایط ثبت در Attribution Reporting API است. فناوری تبلیغاتی موجود در زنجیره ریدایرکت نیز باید ثبت شود .
توجه داشته باشید که بدنه درخواست اولیه در ریدایرکتها ارسال نمیشود. برای مزایدههای مخاطب محافظتشده، اگر 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_URL_1 و REPORTING_URL_2 ارسال میشوند. درخواست ناوبری ارسال شده به URL کلیک نیز واجد شرایط ثبت منابع انتساب است.
مرحله ۳: تنظیم پاسخها برای درخواستهای API گزارشدهی انتساب
برای همه مبداهایی که درخواست API گزارشدهی نسبتدهی (Attribution Reporting API) دریافت میکنند، تأیید کنید که سرور با هدر Attribution-Reporting-Register-Source مناسب پاسخ میدهد. برای آشنایی با نحوه ساخت پاسخ، به راهنمای منابع ثبت و توضیح آن مراجعه کنید.
ثبت چندین تریگر
شما میتوانید با اضافه کردن چندین عنصر پیکسل در سمت تبدیل (یکی برای هر تریگر)، چندین تریگر انتساب را ثبت کنید. عنصر attributionsrc برای ثبت تریگر اختیاری است.
شما همچنین میتوانید چندین تریگر را از یک عنصر پیکسلی واحد با استفاده از درخواستهای تغییر مسیر یا فهرست کردن چندین URL در عنصر attributionsrc به همان روشی که برای ثبت منبع انجام دادید، ثبت کنید. رویدادهای منبع و رویدادهای تریگر که توسط ریشههای یکسان ایجاد شدهاند، با هم تطبیق داده میشوند.