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

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

این برای کیست؟

در اینجا شما اصول اولیه Attribution Reporting و برخی مفاهیم زیربنایی را خواهید یافت، اما جزئیات فنی چندانی ندارند.

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

تبلیغ‌کنندگان و ناشرانی که برای اندازه‌گیری تبدیل به پلتفرم‌های فناوری تبلیغات متکی هستند، نیازی به استفاده مستقیم از API ندارند. اگر فناوری تبلیغات شما قصد دارد با این API ادغام شود، ممکن است علاقه مند به درک نحوه عملکرد Attribution Reporting باشید.

Attribution Reporting API چیست؟

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

Attribution Reporting API این اندازه‌گیری‌ها را به روشی حفظ حریم خصوصی، بدون کوکی‌های شخص ثالث فعال می‌کند.

این API به تبلیغ‌کنندگان و ارائه‌دهندگان فناوری تبلیغات امکان می‌دهد تا تبدیل‌ها را در موارد زیر اندازه‌گیری کنند:

  • کلیک ها و بازدیدهای تبلیغاتی
  • تبلیغات در iframe شخص ثالث ، مانند تبلیغات در یک سایت ناشر که از یک ارائه دهنده فناوری تبلیغات شخص ثالث استفاده می کند.
  • تبلیغات در زمینه شخص اول ، مانند تبلیغات در یک شبکه اجتماعی یا صفحه نتایج موتور جستجو، یا ناشر که تبلیغات خود را ارائه می دهد.

اگر با برخی از این اصطلاحات یا مفاهیم آشنا نیستید، به واژه نامه Privacy Sandbox مراجعه کنید.

API را امتحان کنید

  • به صورت محلی در مرورگر خود تست کنید. یک پرچم تنظیم کنید که به مرورگر Chrome می‌گوید ویژگی‌های آزمایشی خاصی را فعال کند.

اگر علاقه مند به آزمایش API هستید، به گزارش Attribution بروید: آزمایش کنید و شرکت کنید .

API تغییر می کند

در دسترس بودن

建议 状态
转化历程:从应用到网站
网站铺垫消息Android 铺垫消息
邮寄名单公告
在 Chrome 和 Android 中可用,以进行源试用
转化历程:跨设备
说明
该提案已归档。目前没有实施计划。
使用报告验证功能防止无效的可汇总报告
说明
预计于 2024 年上半年在 Chrome 中推出
Attribution Reporting API 权限政策的默认许可名单将保留 *
邮寄名单通知
将于 2023 年第 1 季度在 Chrome 中推出
可配置的事件级报告 epsilon
GitHub 问题
将于 2023 年第 4 季度在 Chrome 中提供
可汇总报告载荷的内边距
更新了解释器
将于 2023 年第 4 季度在 Chrome 中提供
第 1 阶段精简版灵活事件级
灵活事件级配置说明说明
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。

2024 年第 1 季度在 Chrome 中推出
可自定义触发器数据的位数。
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试
在 GitHub 上提供反馈
预计于 2024 年上半年在 Chrome 中推出
针对 Google Cloud Attribution Reporting API 和汇总服务的支持
Attribution Reporting API 说明
汇总服务说明
Chrome 将于 2023 年下半年推出

از موارد و ویژگی ها استفاده کنید

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

  • گزارش‌های سطح رویداد، یک کلیک یا مشاهده آگهی خاص (در سمت آگهی) را با داده‌های سمت تبدیل مرتبط می‌کنند. داده های سمت تبدیل بسیار محدود است و داده ها نویز دارند (به این معنی که برای درصد کمی از موارد، داده های تصادفی به جای گزارش های واقعی ارسال می شود). این امر با جلوگیری از پیوستن هویت کاربر در بین سایت‌ها، حریم خصوصی کاربر را حفظ می‌کند. به عنوان یک محافظت اضافی از حریم خصوصی، گزارش ها با تاخیر ارسال می شوند.
  • گزارش‌های خلاصه به یک رویداد خاص در سمت تبلیغ مرتبط نیستند. این گزارش‌ها داده‌های تبدیل غنی‌تر و با وفاداری بالاتر را نسبت به گزارش‌های سطح رویداد ارائه می‌دهند. ترکیبی از تکنیک های حفظ حریم خصوصی به کاهش خطر پیوستن هویت در بین سایت ها کمک می کند.

گزارش های سطح رویداد

گزارش‌های سطح رویداد، کلیک یا مشاهده آگهی را با داده‌های تبدیل درشت مرتبط می‌کنند.

گزارش در سطح رویداد
گزارش نمونه در سطح رویداد: روی شناسه 200400600 کلیک کنید در news.example (ضمیمه شده به شناسه کاربر Bob_Doe در news.example ) منجر به خرید در shop.example شده است.

گزارش‌های سطح رویداد برای موارد زیر مناسب هستند:

  • بهینه سازی . به سؤالاتی مانند "چگونه می توانم بازده سرمایه خود را بهبود بخشم؟" پاسخ دهید. به طور خاص، از این گزارش‌ها می‌توان برای بهینه‌سازی قرار دادن تبلیغات استفاده کرد، زیرا شناسه‌های منحصربه‌فرد سمت آگهی را می‌توان در گزارش‌ها در دسترس قرار داد. گزارش‌های سطح رویداد می‌توانند داده‌های آموزشی را برای مدل‌های یادگیری ماشین ارائه دهند.
  • گزارش درشت ، که در آن اطلاعات بسیار کمی در مورد تبدیل مورد نیاز است. محدودیت فعلی 3 بیت داده تبدیل برای کلیک است⏤به این معنی است که یک تبدیل را می توان یکی از هشت دسته و 1 بیت برای بازدیدها اختصاص داد. رمزگذاری داده‌های گرانول سمت تبدیل، مانند قیمت یا زمان تبدیل خاص، در گزارش‌های سطح رویداد پشتیبانی نمی‌شود.
  • کشف تقلب . داده‌های موجود در برخی گزارش‌ها می‌تواند برای شناسایی و تجزیه و تحلیل تقلب در تبلیغات مفید باشد، زیرا به شما امکان می‌دهد الگوهایی را درک کنید که می‌توانند برای شناسایی فعالیت‌های هرزنامه یا نامعتبر استفاده شوند.

گزارش های خلاصه

گزارش‌های خلاصه (که قبلا به عنوان گزارش‌های انبوه شناخته می‌شد) داده‌های تبدیل دقیق‌تر و انعطاف‌پذیری بیشتری را برای پیوستن به داده‌های کلیک یا مشاهده و داده‌های تبدیل ارائه می‌دهند.

درباره گزارش های خلاصه بیشتر بدانید.

نمونه ای از بینش از گزارش های خلاصه.
در اینجا نمونه‌ای از اطلاعات حاصل از گزارش‌های خلاصه آورده شده است: CampaignID 1234567 در news.example منجر به 518 تبدیل در shoes.example شده است و در مجموع 38174 دلار هزینه کرده است. نیمی از تبدیل ها از کاربران نیویورک، ایالات متحده آمریکا بود.

گزارش‌های خلاصه برای گزارش موارد استفاده مناسب هستند. این گزارش ها به پاسخ به سوالاتی مانند: "بازده سرمایه من چقدر است؟"

استفاده از گزارش‌های خلاصه برای بهینه‌سازی - به عنوان مثال، برای بهینه‌سازی برای یک ارزش خرید، که توسط گزارش‌های سطح رویداد پشتیبانی نمی‌شود (زیرا داده‌های تبدیل بیش از حد درشت هستند) - حوزه تحقیقات فعال است.

ویژگی های دیگر

سایر ویژگی های این API عبارتند از:

پشتیبانی از مرورگر

اگرچه این دو API متفاوت هستند، Chrome و WebKit در فضای باز با هم کار می‌کنند تا تجربه توسعه‌دهنده را ساده‌تر کنند، برای مثال با تراز کردن نام‌های ویژگی و ساختار JSON برای گزارش‌ها .

مجموعه ویژگی های API Reporting Attribution متفاوت از API Private Click Measurement پیشنهاد شده توسط Safari و WebKit است. مهمتر از همه، با Attribution Reporting API:

  • اندازه گیری نمایش از طریق پشتیبانی می شود.
  • گزارش های سطح رویداد می تواند ارائه شود.
  • گزارش‌های خلاصه حاوی اطلاعات غنی در سمت کلیک/مشاهده و سمت تبدیل هستند.
  • اشخاص ثالث مانند پلتفرم‌های فناوری تبلیغات می‌توانند گزارش‌هایی را از طرف ناشران و تبلیغ‌کنندگان دریافت کنند.

پیکربندی مرورگر

  • کاربران می‌توانند با تنظیمات کاربر در chrome://settings/adPrivacy از API انصراف دهند.
  • API در حالت ناشناس فعال نیست.
  • وقتی کوکی‌های شخص ثالث غیرفعال هستند، API فعال نیست.

چگونه سایت ها می توانند دسترسی را کنترل کنند؟

اگر API در یک مرورگر مشخص در دسترس باشد، به طور پیش‌فرض در هر سایتی، هم در اسناد و اسکریپت‌های سطح بالا و هم در iframe‌های با منبع یکسان، در دسترس است.

اشخاص ثالث خودسر - برای مثال، iframe‌های تبلیغاتی با منبع متقاطع که با اسکریپتی که دسترسی سطح بالایی دارد به صفحه اضافه نشده‌اند - نمی‌توانند از API بدون اطلاع ناشر یا تبلیغ‌کننده استفاده کنند: در این iframe‌ها، Attribution Reporting API باید به طور صریح با خط مشی مجوزها فعال شود.

<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 مطلع است.
  • حفاظت های اضافی برای جلوگیری از سوء استفاده و ردیابی بین سایتی اعمال می شود:
    • گزارش ها با تاخیر ارسال می شوند.
    • داده‌های تبدیل نویز می‌شوند: در درصد معینی از مواقع، گزارش‌های جعلی تولید می‌شوند.
    • تعداد گزارش‌های تبدیل منتسب به ازای هر کلیک یا مشاهده محدود است.

در جزئیات: گزارش های خلاصه و حریم خصوصی

گزارش های خلاصه یک کلیک یا مشاهده رویداد را با داده های تبدیل دقیق مرتبط می کند. آنها با استفاده از مکانیسم های حفظ حریم خصوصی زیر، بینش تبدیل را بدون ردیابی کاربران در سراسر سایت ها ارائه می دهند:

  • هیچ شناسه بین سایتی استفاده نمی شود.
  • هر انتساب می تواند مشارکت های متعددی در یک گزارش خلاصه حاصل داشته باشد. هر کاربر معینی می‌تواند چندین منبع را برای یک کلیک (یا مشاهده) و تبدیل ایجاد کند.
  • داده ها تا سطح بسیاری از رویدادها (بسیاری از کاربران) جمع می شوند و هیچ رویداد فردی را نمی توان به طور دقیق مشاهده کرد. هنگامی که به داده های انبوه نگاه می کنیم، با افزایش سطح جزئیات، نویز نسبی آن داده نیز افزایش می یابد. تکه‌هایی از داده‌ها که رویدادها و کاربران زیادی را جمع‌آوری می‌کنند، برای حفظ سودمندی دقیق‌تر هستند.
  • گزارش‌های خامی که یک رویداد کلیک یا مشاهده دقیق را با داده‌های تبدیل دقیق مرتبط می‌کنند، رمزگذاری شده‌اند و توسط شرکت فناوری تبلیغات قابل خواندن نیستند. این داده ها را فقط می توان توسط سرویس تجمیع خواند.
  • حفاظت های اضافی برای جلوگیری از سوء استفاده و ردیابی بین سایتی اعمال می شود:
    • گزارش ها با تاخیر تصادفی ارسال می شوند.
    • پرس و جوها در برش های مختلف داده با نرخ محدود هستند.

مشارکت کنید و بازخورد را به اشتراک بگذارید