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

اندازه‌گیری اسناد تبدیل می‌تواند شامل چندین طرف باشد، اعم از ناشر، تبلیغ‌کننده، خدمات فناوری تبلیغات (موجودی که تبلیغ را ارائه می‌دهد)، ارائه‌دهنده اندازه‌گیری، و موارد دیگر. در این سند، سناریوهای رایج اندازه‌گیری تبدیل را نشان می‌دهیم، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از 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 را در سطح بالا شرح می دهد:

مراحل مسئولیت کار مثال ها
مرحله 1: منبع انتساب را برای خلاقیت های موجود و کد اندازه گیری فعال کنید نهاد مسئول اجرای رویدادهای impression یا مدیریت رویدادهای کلیک، ویژگی attributionsrc را اضافه می کند. برای رویدادهای کلیکی، معمولاً یک خریدار (سرور تبلیغات DSP/تبلیغ کننده) که خلاقیت را ارائه می کند، ویژگی را اضافه می کند.

برای رویدادهای نمایش، پلتفرم سمت تقاضا (DSP)، پلتفرم سمت عرضه (SSP)، ناشر، سرور تبلیغات، یا ارائه‌دهنده اندازه‌گیری این ویژگی را اضافه می‌کند و این ویژگی به تنظیمات ناشر بستگی دارد.

برای تبلیغات ویدیویی با استفاده از فرمت VAST، ناشر و SDK ویدیو این ویژگی را اضافه می‌کنند.

مرحله 2: گزارش Attribution را برای منابع شخص ثالث فعال کنید اگر از یک مسیر تغییر مسیر موجود با 302 تغییر مسیر استفاده کنید، این کار خارج از چارچوب است.

اگر نمی توان از تغییر مسیرهای 302 استفاده کرد، از ویژگی attributionsrc می توان برای فهرست کردن چندین سرور فناوری تبلیغات استفاده کرد.

 به طور کلی، تا زمانی که ویژگی 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 = {...}
window.fetch("[IMPRESSION_URL]", options);		 const options = {
attributionReporting: {
eventSourceEligible: true,
triggerEligible: false,
},
...
};
window.fetch("[IMPRESSION_URL]", 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 باید باعث شوند که همه رویدادهای فهرست‌شده به‌طور پیش‌فرض در هنگام شلیک پینگ رویداد واجد شرایط ثبت نام باشند. برای مثال، هنگام شلیک نشانی وب رویداد <Impression> ، ویژگی (خالی) attributionsrc باید در عنصر <img> مورد استفاده برای ارسال درخواست (یا معادل آن در تماس واکشی) استفاده شود تا همیشه به طرف گیرنده اجازه داده شود به طور بالقوه آن رویداد را با Attribution Reporting API ثبت کنید.

مرحله 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 باشد که خلاقیت را در سایت ناشر ارائه می‌کند و محصول گزارش‌دهی خود را دارد. ارائه‌دهنده اندازه‌گیری شخص ثالث می‌تواند نهادی باشد که تبلیغ‌کننده از آن برای گزارش تبدیل استفاده می‌کند.

A diagram that describes how the first-party registers the source, then the third-party registers the

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

  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 به‌عنوان راه‌حل جایگزین فهرست کنید.

تنظیمات موجود شما با اصلاح 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 به همان روشی که برای ثبت منبع، چندین راه‌انداز را از یک عنصر پیکسلی ثبت کنید. رویدادهای منبع و رویدادهای ماشه ای که توسط مبداهای یکسانی ایجاد شده اند مطابقت داده می شوند.

،

اندازه‌گیری اسناد تبدیل می‌تواند شامل چندین طرف باشد، اعم از ناشر، تبلیغ‌کننده، خدمات فناوری تبلیغات (موجودی که تبلیغ را ارائه می‌دهد)، ارائه‌دهنده اندازه‌گیری، و موارد دیگر. در این سند، سناریوهای رایج اندازه‌گیری تبدیل را نشان می‌دهیم، اما به طور کلی هر طرفی که مایل به دریافت گزارش انتساب از 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 را در سطح بالا شرح می دهد:

مراحل مسئولیت کار مثال ها
مرحله 1: منبع انتساب را برای خلاقیت های موجود و کد اندازه گیری فعال کنید نهاد مسئول اجرای رویدادهای impression یا مدیریت رویدادهای کلیک، ویژگی attributionsrc را اضافه می کند. برای رویدادهای کلیکی، معمولاً یک خریدار (سرور تبلیغات DSP/تبلیغ کننده) که خلاقیت را ارائه می کند، ویژگی را اضافه می کند.

برای رویدادهای نمایش، پلتفرم سمت تقاضا (DSP)، پلتفرم سمت عرضه (SSP)، ناشر، سرور تبلیغات، یا ارائه‌دهنده اندازه‌گیری این ویژگی را اضافه می‌کند و این ویژگی به تنظیمات ناشر بستگی دارد.

برای تبلیغات ویدیویی با استفاده از فرمت VAST، ناشر و SDK ویدیو این ویژگی را اضافه می‌کنند.

مرحله 2: گزارش Attribution را برای منابع شخص ثالث فعال کنید اگر از یک مسیر تغییر مسیر موجود با 302 تغییر مسیر استفاده کنید، این کار خارج از چارچوب است.

اگر نمی توان از تغییر مسیرهای 302 استفاده کرد، از ویژگی attributionsrc می توان برای فهرست کردن چندین سرور فناوری تبلیغات استفاده کرد.

 به طور کلی، تا زمانی که ویژگی 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 = {...}
window.fetch("[IMPRESSION_URL]", options);		 const options = {
attributionReporting: {
eventSourceEligible: true,
triggerEligible: false,
},
...
};
window.fetch("[IMPRESSION_URL]", 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 باید باعث شوند که همه رویدادهای فهرست‌شده به‌طور پیش‌فرض در هنگام شلیک پینگ رویداد واجد شرایط ثبت نام باشند. برای مثال، هنگام شلیک نشانی وب رویداد <Impression> ، ویژگی (خالی) attributionsrc باید در عنصر <img> مورد استفاده برای ارسال درخواست (یا معادل آن در تماس واکشی) استفاده شود تا همیشه به طرف گیرنده اجازه داده شود به طور بالقوه آن رویداد را با Attribution Reporting API ثبت کنید.

مرحله 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 باشد که خلاقیت را در سایت ناشر ارائه می‌کند و محصول گزارش‌دهی خود را دارد. ارائه دهنده اندازه گیری شخص ثالث می تواند موجودی باشد که تبلیغ کننده برای گزارش تبدیل از آن استفاده می کند.

A diagram that describes how the first-party registers the source, then the third-party registers the

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

  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 به عنوان یک راه حل جایگزین ذکر کنید.

راه اندازی موجود شما با اصلاح 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 Clickthrough نیز واجد شرایط ثبت منابع انتساب است.

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

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

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

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

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