زمانی که یک کلیک یا مشاهده تبلیغات منجر به تبدیل می شود، اندازه گیری کنید، مانند خرید در سایت تبلیغ کننده.
این برای کیست؟
در اینجا شما اصول اولیه Attribution Reporting و برخی مفاهیم زیربنایی را خواهید یافت، اما جزئیات فنی چندانی ندارند.
- اگر در زمینه تبلیغات یا فناوری تبلیغات کار می کنید، با نحوه ارائه این API قابلیت هایی که توسط کوکی های شخص ثالث فعال می شوند آشنا خواهید شد. موارد استفاده API را بررسی کنید که جزئیات بیشتری از نحوه تولید گزارش ها دارد.
- اگر یک برنامهنویس یا مهندس نرمافزار هستید، به مرور کلی یا آزمایش کامل سیستم بروید و در API شرکت کنید .
تبلیغکنندگان و ناشرانی که برای اندازهگیری تبدیل به پلتفرمهای فناوری تبلیغات متکی هستند، نیازی به استفاده مستقیم از API ندارند. اگر فناوری تبلیغات شما قصد دارد با این API ادغام شود، ممکن است علاقه مند به درک نحوه عملکرد Attribution Reporting باشید.
Attribution Reporting API چیست؟
امروزه، اندازهگیری تبدیل تبلیغات اغلب به کوکیهای شخص ثالث متکی است. مرورگرها دسترسی به کوکیهای شخص ثالث را محدود میکنند زیرا این کوکیها میتوانند برای ردیابی کاربران در سراسر سایتها و مانع از حفظ حریم خصوصی کاربر استفاده شوند.
Attribution Reporting API این اندازهگیریها را به روشی حفظ حریم خصوصی، بدون کوکیهای شخص ثالث فعال میکند.
این API به تبلیغکنندگان و ارائهدهندگان فناوری تبلیغات امکان میدهد تا تبدیلها را در موارد زیر اندازهگیری کنند:
- کلیک ها و بازدیدهای تبلیغاتی
- تبلیغات در iframe شخص ثالث ، مانند تبلیغات در یک سایت ناشر که از یک ارائه دهنده فناوری تبلیغات شخص ثالث استفاده می کند.
- تبلیغات در زمینه شخص اول ، مانند تبلیغات در یک شبکه اجتماعی یا صفحه نتایج موتور جستجو، یا ناشر که تبلیغات خود را ارائه می دهد.
اگر با برخی از این اصطلاحات یا مفاهیم آشنا نیستید، به واژه نامه Privacy Sandbox مراجعه کنید.
API را امتحان کنید
- به صورت محلی در مرورگر خود تست کنید. یک پرچم تنظیم کنید که به مرورگر Chrome میگوید ویژگیهای آزمایشی خاصی را فعال کند.
اگر علاقه مند به آزمایش API هستید، به گزارش Attribution بروید: آزمایش کنید و شرکت کنید .
API تغییر می کند
- تغییرات API را پیگیری کنید.
- بیاموزید که چرا API گزارش Attribution را در نیمه اول سال 2023 ارسال کردیم.
در دسترس بودن
提案 | 状态 |
---|---|
转化历程:应用到网站 网站说明和 Android 说明 邮寄名单通告 |
适用于 Chrome 和 Android 的源试用 |
转化历程:跨设备 说明 |
此提案已归档。目前没有实施计划。 |
使用报告验证功能防止可汇总报告无效 说明 |
此提案已归档。我们改为为此用例实现了 trigger_context_id 。 |
Attribution Reporting API Permissions-Policy 的默认许可名单将保持不变 * 邮寄名单通告 |
2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
2023 年第 4 季度在 Chrome 中推出 |
可汇总报告载荷的填充 更新了说明 |
2023 年第 4 季度在 Chrome 中推出 |
灵活事件级 “灵活事件级配置”说明 |
将于 2023 年第 4 季度在 Chrome 中推出
可自定义归因报告的数量以及报告期的数量/时长。 将于 2024 年第 1 季度在 Chrome 中推出 能够自定义触发器数据的位数。 |
支持不依赖于第三方 Cookie 的 Attribution Reporting 详细调试报告 说明 |
2024 年第 3 季度在 Chrome 中推出 |
支持 Google Cloud 的 Attribution Reporting API 和汇总服务 Attribution Reporting API 说明 汇总服务说明 |
2023 年下半年在 Chrome 中推出 |
灵活的贡献过滤 说明 |
2024 年第 3 季度在 Chrome 中推出 |
归因前过滤:归因范围 说明 |
2024 年第 4 季度在 Chrome 中推出 |
از موارد و ویژگی ها استفاده کنید
Attribution Reporting API با دو نوع گزارش که میتواند برای یک تبلیغکننده یا یک ارائهدهنده فناوری تبلیغاتی شخص ثالث ارسال شود، به انواع مختلف بینش دسترسی میدهد. این دو نوع گزارش می توانند به طور همزمان مورد استفاده قرار گیرند و مکمل هم هستند.
- گزارشهای سطح رویداد، یک کلیک یا مشاهده آگهی خاص (در سمت آگهی) را با دادههای سمت تبدیل مرتبط میکنند. داده های سمت تبدیل بسیار محدود است و داده ها نویز دارند (به این معنی که برای درصد کمی از موارد، داده های تصادفی به جای گزارش های واقعی ارسال می شود). این امر با جلوگیری از پیوستن هویت کاربر در بین سایتها، حریم خصوصی کاربر را حفظ میکند. به عنوان یک محافظت اضافی از حریم خصوصی، گزارش ها با تاخیر ارسال می شوند.
- گزارشهای خلاصه به یک رویداد خاص در سمت تبلیغ مرتبط نیستند. این گزارشها دادههای تبدیل غنیتر و با وفاداری بالاتر را نسبت به گزارشهای سطح رویداد ارائه میدهند. ترکیبی از تکنیک های حفظ حریم خصوصی به کاهش خطر پیوستن هویت در بین سایت ها کمک می کند.
گزارش های سطح رویداد
گزارشهای سطح رویداد، کلیک یا مشاهده آگهی را با دادههای تبدیل درشت مرتبط میکنند.

news.example
(ضمیمه شده به شناسه کاربر Bob_Doe در news.example
) منجر به خرید در shop.example
شده است.گزارشهای سطح رویداد برای موارد زیر مناسب هستند:
- بهینه سازی . به سؤالاتی مانند "چگونه می توانم بازده سرمایه خود را بهبود بخشم؟" پاسخ دهید. به طور خاص، از این گزارشها میتوان برای بهینهسازی قرار دادن تبلیغات استفاده کرد، زیرا شناسههای منحصربهفرد سمت آگهی را میتوان در گزارشها در دسترس قرار داد. گزارشهای سطح رویداد میتوانند دادههای آموزشی را برای مدلهای یادگیری ماشین ارائه دهند.
- گزارش درشت ، که در آن اطلاعات بسیار کمی در مورد تبدیل مورد نیاز است. محدودیت فعلی 3 بیت داده تبدیل برای کلیک است⏤به این معنی است که یک تبدیل را می توان یکی از هشت دسته و 1 بیت برای بازدیدها اختصاص داد. رمزگذاری دادههای گرانول سمت تبدیل، مانند قیمت یا زمان تبدیل خاص، در گزارشهای سطح رویداد پشتیبانی نمیشود.
- کشف تقلب . دادههای موجود در برخی گزارشها میتواند برای شناسایی و تجزیه و تحلیل تقلب در تبلیغات مفید باشد، زیرا به شما امکان میدهد الگوهایی را درک کنید که میتوانند برای شناسایی فعالیتهای هرزنامه یا نامعتبر استفاده شوند.
گزارش های خلاصه
گزارشهای خلاصه (که قبلا به عنوان گزارشهای انبوه شناخته میشد) دادههای تبدیل دقیقتر و انعطافپذیری بیشتری را برای پیوستن به دادههای کلیک یا مشاهده و دادههای تبدیل ارائه میدهند.
درباره گزارش های خلاصه بیشتر بدانید.

news.example
منجر به 518 تبدیل در shoes.example
شده است و در مجموع 38174 دلار هزینه کرده است. نیمی از تبدیل ها از کاربران نیویورک، ایالات متحده آمریکا بود.گزارشهای خلاصه برای گزارش موارد استفاده مناسب هستند. این گزارش ها به پاسخ به سوالاتی مانند: "بازده سرمایه من چقدر است؟"
استفاده از گزارشهای خلاصه برای بهینهسازی - به عنوان مثال، برای بهینهسازی برای یک ارزش خرید، که توسط گزارشهای سطح رویداد پشتیبانی نمیشود (زیرا دادههای تبدیل بیش از حد درشت هستند) - حوزه تحقیقات فعال است.
ویژگی های دیگر
سایر ویژگی های این API عبارتند از:
- انتساب برنامه به وب : آگهی را در یک برنامه ببینید یا کلیک کنید و در وب تبدیل کنید.
پشتیبانی از مرورگر
- فایرفاکس و اج سیگنالهای مشترکی ندارند .
- Safari and Webkit منفی است و یک API متفاوت برای اندازهگیری تبدیلهای تبلیغاتی به نام اندازهگیری کلیک خصوصی پیشنهاد کرده است.
اگرچه این دو API متفاوت هستند، Chrome و WebKit در فضای باز با هم کار میکنند تا تجربه توسعهدهنده را سادهتر کنند، برای مثال با تراز کردن نامهای ویژگی و ساختار JSON برای گزارشها .
مجموعه ویژگی های API Reporting Attribution متفاوت از API Private Click Measurement پیشنهاد شده توسط Safari و WebKit است. مهمتر از همه، با Attribution Reporting API:
- اندازه گیری نمایش از طریق پشتیبانی می شود.
- گزارش های سطح رویداد می تواند ارائه شود.
- گزارشهای خلاصه حاوی اطلاعات غنی در سمت کلیک/مشاهده و سمت تبدیل هستند.
- اشخاص ثالث مانند پلتفرمهای فناوری تبلیغات میتوانند گزارشهایی را از طرف ناشران و تبلیغکنندگان دریافت کنند.
پیکربندی مرورگر
- کاربران میتوانند با تنظیمات کاربر در
chrome://settings/adPrivacy
از API انصراف دهند. - API در حالت ناشناس فعال نیست.
چگونه سایت ها می توانند دسترسی را کنترل کنند؟
اگر API در یک مرورگر مشخص در دسترس باشد، به طور پیشفرض در هر سایتی، هم در اسناد و اسکریپتهای سطح بالا و هم در iframeهای با منبع یکسان، در دسترس است.
اشخاص ثالث خودسر - به عنوان مثال، iframeهای تبلیغاتی متقاطع که با اسکریپتی که دسترسی سطح بالایی دارد به صفحه اضافه نشدهاند - نمیتوانند بدون اطلاع ناشر یا تبلیغکننده از API استفاده کنند: در این iframeها، API گزارش Attribution باید بهصراحت با خطمشی مجوزها فعال شود.
<iframe src="..." allow="attribution-reporting"></iframe>
اشخاص ثالث با دسترسی سطح بالا که iframe های متقاطع را به صفحه اضافه می کنند نیز می توانند API گزارش انتساب با خط مشی مجوزها را فعال کنند.
یک سایت میتواند API گزارش Attribution را برای همه طرفها، از جمله اسکریپتهایی با دسترسی سطح بالا، با ارسال سرصفحه پاسخ HTTP غیرفعال کند:
Permissions-Policy: attribution-reporting=()
Attribution Reporting API چگونه کار می کند؟
Attribution Reporting API اندازهگیری دو رویدادی را که به هم مرتبط هستند امکانپذیر میکند: یک رویداد در وبسایت ناشر، مانند مشاهده یا کلیک کاربر بر روی آگهی، و تبدیل بعدی در سایت تبلیغکننده.
گزارش های سطح رویداد

مرورگر کلیکها یا بازدیدها را با دادههای تبدیل تعریفشده توسط فناوری تبلیغات مطابقت میدهد.
بعداً، مرورگر گزارش های به دست آمده را با کمی تأخیر و نویز به یک نقطه پایانی از پیش تعریف شده ارسال می کند.
گزارش های خلاصه

گزارش های خلاصه به شرح زیر تولید می شوند:
- کاربر روی یک تبلیغ با پیکربندی خاص کلیک یا مشاهده می کند. مرورگر - در دستگاه محلی کاربر - این رویداد را همراه با داده های پیکربندی انتساب از پیش تعیین شده ثبت می کند.
- بعداً، وقتی کاربر تبدیل میکند، مرورگر این رویداد کلیک یا مشاهده دقیق (معروف به رویداد منبع انتساب ) را با دادههای تبدیل دقیق (معروف به دادههای راهانداز انتساب ) مطابقت میدهد. ابعاد جزئیات ثبت شده توسط یک شرکت فناوری تبلیغات از پیش تعریف شده است و مرورگر از منطق خاصی پیروی می کند که توسط فناوری تبلیغات تعریف شده است. مرورگر این داده ها را در یک گزارش جمع آوری خروجی می دهد.
- گزارشهای جمعآوریشده توسط مرورگر رمزگذاری شده و به یک سرور فناوری تبلیغات ارسال میشوند. از سرور فناوری تبلیغات، گزارشهای جمعآوریشده به سرویس تجمیع ارسال میشوند تا یک گزارش خلاصه تهیه کنند.
- سپس گزارش های خلاصه در دسترس فناوری تبلیغات قرار می گیرد. توجه داشته باشید که گزارشهای خلاصه به اندازه گزارشهای سطح رویداد تأخیر ندارند.
درباره گزارش های خلاصه بیشتر بخوانید.
حریم خصوصی
برخلاف کوکیهای شخص ثالث، Attribution Reporting API به شرکتهای تبلیغاتی اجازه میدهد بدون ردیابی فعالیت افراد در سایتها، بینشهایی درباره تبدیلها کسب کنند.
بیایید شخصی به نام باب را در نظر بگیریم. باب هنگام خواندن اخبار در news.example
یک تبلیغ می بیند. یک هفته بعد، باب کفش روی shoes.example
می خرد. مثال.
امروزه، این تبدیل توسط یک کوکی شخص ثالث که به عنوان شناسه بین سایتی استفاده میشود، ردیابی میشود. با کوکیهای شخص ثالث، یک شرکت فناوری تبلیغات میتواند به جزئیات زیادی درباره فعالیت باب در news.example
و shoes.example
دسترسی پیدا کند. فناوری تبلیغات میتواند این اطلاعات را با هم ادغام کند تا نمایهای دقیق از باب ایجاد کند، از جمله موقعیت مکانی باب، عادتهای مرور و خواندن ترجیحی در news.example
. این نمایه همچنین میتواند شامل اطلاعات خرید، فعالیت و کارت اعتباری در shoes.example
باشد. این مشترک بین سایتی برای اندازه گیری تبدیل تبلیغات مفید است. اما مانع از حفظ حریم خصوصی کاربر می شود: فعالیت باب در سراسر سایت ها با سطح بالایی از جزئیات ردیابی می شود.

مقدار کمی از اطلاعات در بین سایتها به هم متصل میشود - برای اندازهگیری تبدیلها کافی است، اما برای ردیابی جزئیات فعالیت باب در بین سایتها کافی نیست. فعالیت باب در news.example
و در shoes.example
جدا باقی می ماند.
حفاظت در هر نوع گزارش
گزارشهای سطح رویداد، یک شناسه سمت آگهی را با مقدار کمی از دادههای سمت تبدیل مرتبط میکند. در حالی که آنها اطلاعات متقاطع سایتی را در مورد یک تبدیل ارائه می دهند، اطلاعات سمت تبدیل برای پیوستن به هویت کاربر در سراسر سایت ها بسیار درشت است.
گزارشهای خلاصه، بینشهای دقیقی را ارائه میدهند، اما فقط در سطح انبوه. از آنجایی که محتویات این گزارشهای جمعآوریشده هنگام ارسال به فناوری تبلیغات رمزگذاری میشوند، فناوری تبلیغات نمیتواند بدون استفاده از سرویس تجمیع اطلاعاتی از گزارشها دریافت کند. سرویس تجمیع فقط دسترسی به دانه های پر سر و صدا را فراهم می کند.
حفاظتهای حریم خصوصی اضافی مانند محدودیتهای نرخ هم بر گزارشهای سطح رویداد و هم بر گزارشهای انبوه اعمال میشود.

در جزئیات: گزارشهای سطح رویداد و حریم خصوصی
گزارشهای سطح رویداد با پیروی از مکانیسمهای حفظ حریم خصوصی زیر، بینشهای تبدیل را بدون ردیابی کاربران در سراسر سایتها ارائه میکنند:
- هیچ شناسه متقابل سایتی استفاده نمی شود و هیچ فعالیت دقیق مرور بین سایتی از دستگاه خارج نمی شود.
- گزارشهای سطح رویداد، 64 بیت اطلاعات در سمت آگهی (
news.example
) را با تنها 1 بیت یا 3 بیت در سمت تبدیل (shop.example
) مرتبط میکنند. 64 بیت اطلاعات کافی برای نگاشت به یک شناسه کاربر منفرد هستند، اما این 64 بیت فقط با اطلاعات متقاطع سایت بسیار کمی می توانند مرتبط شوند: 1 بیت یا 3 بیت، که برای نگهداری یک شناسه کافی نیستند.- 64 بیت سمت آگهی اطلاعات جدیدی نیستند. شناسه کاربری میتواند از امروز در سمت آگهی در دسترس باشد.
news.example
یاadtech.example
از قبل از فعالیت یک کاربر خاص درnews.example
مطلع است.
- 64 بیت سمت آگهی اطلاعات جدیدی نیستند. شناسه کاربری میتواند از امروز در سمت آگهی در دسترس باشد.
- حفاظت های اضافی برای جلوگیری از سوء استفاده و ردیابی بین سایتی اعمال می شود:
- گزارش ها با تاخیر ارسال می شوند.
- دادههای تبدیل نویز میشوند: در درصد معینی از مواقع، گزارشهای جعلی تولید میشوند.
- تعداد گزارشهای تبدیل منتسب به ازای هر کلیک یا مشاهده محدود است.
در جزئیات: گزارش های خلاصه و حریم خصوصی
گزارش های خلاصه یک کلیک یا مشاهده رویداد را با داده های تبدیل دقیق مرتبط می کند. آنها با استفاده از مکانیسم های حفظ حریم خصوصی زیر، بینش تبدیل را بدون ردیابی کاربران در سراسر سایت ها ارائه می دهند:
- هیچ شناسه بین سایتی استفاده نمی شود.
- هر انتساب می تواند مشارکت های متعددی در یک گزارش خلاصه حاصل داشته باشد. هر کاربر معینی میتواند چندین منبع را برای یک کلیک (یا مشاهده) و تبدیل ایجاد کند.
- داده ها تا سطح بسیاری از رویدادها (بسیاری از کاربران) جمع می شوند و هیچ رویداد فردی را نمی توان به طور دقیق مشاهده کرد. هنگامی که به داده های انبوه نگاه می کنیم، با افزایش سطح جزئیات، نویز نسبی آن داده نیز افزایش می یابد. تکههایی از دادهها که رویدادها و کاربران زیادی را جمعآوری میکنند، برای حفظ سودمندی دقیقتر هستند.
- گزارشهای خامی که یک رویداد کلیک یا مشاهده دقیق را با دادههای تبدیل دقیق مرتبط میکنند، رمزگذاری شدهاند و توسط شرکت فناوری تبلیغات قابل خواندن نیستند. این داده ها را فقط می توان توسط سرویس تجمیع خواند.
- حفاظت های اضافی برای جلوگیری از سوء استفاده و ردیابی بین سایتی اعمال می شود:
- گزارش ها با تاخیر تصادفی ارسال می شوند.
- پرس و جوها در برش های مختلف داده با نرخ محدود هستند.
مشارکت کنید و بازخورد را به اشتراک بگذارید
- برای سؤالات در مورد API: یک مشکل در مخزن API ایجاد کنید .
- بهروزرسانیها و اطلاعیههای API را در فهرست پستی Attribution Reporting دنبال کنید.
- اگر سؤال فنی دارید، یک اشکال Chromium را ثبت کنید .
- برای پیادهسازی، یکپارچهسازی، و سوالات کلی بهترین عملکرد: یک مشکل در مخزن پشتیبانی توسعهدهنده Privacy Sandbox ایجاد کنید .