زمانی که یک کلیک یا مشاهده تبلیغات منجر به تبدیل می شود، اندازه گیری کنید، مانند خرید در سایت تبلیغ کننده.
این برای کیست؟
در اینجا شما اصول اولیه 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 ارسال کردیم .
در دسترس بودن
پیشنهاد | وضعیت |
---|---|
سفر تبدیل: برنامه به وب توضیح دهنده وب و توضیح دهنده اندروید اعلام لیست پستی | در کروم و اندروید برای آزمایش اصلی موجود است |
سفر تبدیل: بین دستگاهی توضیح دهنده | این پیشنهاد بایگانی شده است. در حال حاضر هیچ برنامه ای برای اجرا وجود ندارد. |
جلوگیری از گزارش های انباشته نامعتبر با استفاده از تأیید گزارش توضیح دهنده | این پیشنهاد بایگانی شده است. به جای آن، trigger_context_id برای این مورد استفاده کرده ایم. |
فهرست مجاز پیشفرض برای مجوزهای API Reporting Attribution همچنان باقی خواهد ماند * اعلام لیست پستی | در سه ماهه اول 2023 در کروم موجود است |
اپسیلون گزارش سطح رویداد قابل تنظیم مشکل GitHub | در Q4 2023 در Chrome موجود است |
بالشتک برای بار گزارش های جمع آوری توضیح دهنده به روز شده | در کروم در Q4 2023 موجود است |
مرحله 1 lite انعطاف پذیر رویداد-سطح توضیح دهنده پیکربندی های سطح رویداد انعطاف پذیر | در کروم در Q4 2023 موجود است امکان سفارشی کردن تعداد گزارش های اسناد و تعداد/طول پنجره های گزارش. در سه ماهه اول 2024 در کروم موجود است توانایی سفارشی کردن تعداد بیت های داده های ماشه. |
پشتیبانی از Attribution Reporting گزارشهای اشکالزدایی مفصل که به کوکیهای شخص ثالث وابسته نیستند توضیح دهنده | در اوایل سه ماهه سوم 2024 در کروم مورد انتظار است |
پشتیبانی از Attribution Reporting API و Aggregation Service برای Google Cloud Attribution Reporting API Explainer توضیح دهنده سرویس تجمع | در کروم در H2 2023 موجود است |
فیلتر مشارکت انعطاف پذیر توضیح دهنده | در کروم در Q3 2024 مورد انتظار است |
فیلتر قبل از اسناد: محدوده های اسناد توضیح دهنده | در کروم در Q3 2024 مورد انتظار است |
از موارد و ویژگی ها استفاده کنید
Attribution Reporting API با دو نوع گزارش که میتواند برای یک تبلیغکننده یا یک ارائهدهنده فناوری تبلیغاتی شخص ثالث ارسال شود، به انواع مختلف بینش دسترسی میدهد. این دو نوع گزارش می توانند به طور همزمان مورد استفاده قرار گیرند و مکمل هم هستند.
- گزارشهای سطح رویداد، یک کلیک یا مشاهده آگهی خاص (در سمت آگهی) را با دادههای سمت تبدیل مرتبط میکنند. داده های سمت تبدیل بسیار محدود است و داده ها نویز دارند (به این معنی که برای درصد کمی از موارد، داده های تصادفی به جای گزارش های واقعی ارسال می شود). این امر با جلوگیری از پیوستن هویت کاربر در بین سایتها، حریم خصوصی کاربر را حفظ میکند. به عنوان یک محافظت اضافی از حریم خصوصی، گزارش ها با تاخیر ارسال می شوند.
- گزارشهای خلاصه به یک رویداد خاص در سمت تبلیغ مرتبط نیستند. این گزارشها دادههای تبدیل غنیتر و با وفاداری بالاتر را نسبت به گزارشهای سطح رویداد ارائه میدهند. ترکیبی از تکنیک های حفظ حریم خصوصی به کاهش خطر پیوستن هویت در بین سایت ها کمک می کند.
گزارش های سطح رویداد
گزارشهای سطح رویداد، کلیک یا مشاهده آگهی را با دادههای تبدیل درشت مرتبط میکنند.
![گزارش در سطح رویداد](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?hl=fa)
news.example
(ضمیمه شده به شناسه کاربر Bob_Doe در news.example
) منجر به خرید در shop.example
شده است.گزارشهای سطح رویداد برای موارد زیر مناسب هستند:
- بهینه سازی . به سؤالاتی مانند "چگونه می توانم بازده سرمایه خود را بهبود بخشم؟" پاسخ دهید. به طور خاص، از این گزارشها میتوان برای بهینهسازی قرار دادن تبلیغات استفاده کرد، زیرا شناسههای منحصربهفرد سمت آگهی را میتوان در گزارشها در دسترس قرار داد. گزارشهای سطح رویداد میتوانند دادههای آموزشی را برای مدلهای یادگیری ماشین ارائه دهند.
- گزارش درشت ، که در آن اطلاعات بسیار کمی در مورد تبدیل مورد نیاز است. محدودیت فعلی 3 بیت داده تبدیل برای کلیک است⏤به این معنی است که یک تبدیل را می توان یکی از هشت دسته و 1 بیت برای بازدیدها اختصاص داد. رمزگذاری دادههای گرانول سمت تبدیل، مانند قیمت یا زمان تبدیل خاص، در گزارشهای سطح رویداد پشتیبانی نمیشود.
- کشف تقلب . دادههای موجود در برخی گزارشها میتواند برای شناسایی و تجزیه و تحلیل تقلب در تبلیغات مفید باشد، زیرا به شما امکان میدهد الگوهایی را درک کنید که میتوانند برای شناسایی فعالیتهای هرزنامه یا نامعتبر استفاده شوند.
گزارش های خلاصه
گزارشهای خلاصه (که قبلا به عنوان گزارشهای انبوه شناخته میشد) دادههای تبدیل دقیقتر و انعطافپذیری بیشتری را برای پیوستن به دادههای کلیک یا مشاهده و دادههای تبدیل ارائه میدهند.
درباره گزارش های خلاصه بیشتر بدانید.
![نمونه ای از بینش از گزارش های خلاصه.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?hl=fa)
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 فعال نیست.
چگونه سایت ها می توانند دسترسی را کنترل کنند؟
اگر 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 اندازهگیری دو رویدادی را که به هم مرتبط هستند امکانپذیر میکند: یک رویداد در وبسایت ناشر، مانند مشاهده یا کلیک کاربر بر روی آگهی، و تبدیل بعدی در سایت تبلیغکننده.
گزارش های سطح رویداد
![گزارش در سطح رویداد](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?hl=fa)
مرورگر کلیکها یا بازدیدها را با دادههای تبدیل تعریفشده توسط فناوری تبلیغات مطابقت میدهد.
بعداً، مرورگر گزارش های به دست آمده را با کمی تأخیر و نویز به یک نقطه پایانی از پیش تعریف شده ارسال می کند.
گزارش های خلاصه
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?hl=fa)
گزارش های خلاصه به شرح زیر تولید می شوند:
- کاربر روی یک تبلیغ با پیکربندی خاص کلیک یا مشاهده می کند. مرورگر - در دستگاه محلی کاربر - این رویداد را همراه با داده های پیکربندی انتساب از پیش تعیین شده ثبت می کند.
- بعداً، وقتی کاربر تبدیل میکند، مرورگر این رویداد کلیک یا مشاهده دقیق (معروف به رویداد منبع انتساب ) را با دادههای تبدیل دقیق (معروف به دادههای راهانداز انتساب ) مطابقت میدهد. ابعاد جزئیات ثبت شده توسط یک شرکت فناوری تبلیغات از پیش تعریف شده است و مرورگر از منطق خاصی پیروی می کند که توسط فناوری تبلیغات تعریف شده است. مرورگر این داده ها را در یک گزارش جمع آوری خروجی می دهد.
- گزارشهای جمعآوریشده توسط مرورگر رمزگذاری شده و به یک سرور فناوری تبلیغات ارسال میشوند. از سرور فناوری تبلیغات، گزارشهای جمعآوریشده به سرویس تجمیع ارسال میشوند تا یک گزارش خلاصه تهیه کنند.
- سپس گزارش های خلاصه در دسترس فناوری تبلیغات قرار می گیرد. توجه داشته باشید که گزارشهای خلاصه به اندازه گزارشهای سطح رویداد تأخیر ندارند.
درباره گزارش های خلاصه بیشتر بخوانید.
حریم خصوصی
برخلاف کوکیهای شخص ثالث، Attribution Reporting API به شرکتهای تبلیغاتی اجازه میدهد بدون ردیابی فعالیت افراد در سایتها، بینشهایی درباره تبدیلها کسب کنند.
بیایید شخصی به نام باب را در نظر بگیریم. باب هنگام خواندن اخبار در news.example
یک تبلیغ می بیند. یک هفته بعد، باب کفش روی shoes.example
می خرد. مثال.
امروزه، این تبدیل توسط یک کوکی شخص ثالث که به عنوان شناسه بین سایتی استفاده میشود، ردیابی میشود. با کوکیهای شخص ثالث، یک شرکت فناوری تبلیغات میتواند به جزئیات زیادی درباره فعالیت باب در news.example
و shoes.example
دسترسی پیدا کند. فناوری تبلیغات میتواند این اطلاعات را با هم ادغام کند تا نمایهای دقیق از باب ایجاد کند، از جمله موقعیت مکانی باب، عادتهای مرور و خواندن ترجیحی در news.example
. این نمایه همچنین میتواند شامل اطلاعات خرید، فعالیت و کارت اعتباری در shoes.example
باشد. این مشترک بین سایتی برای اندازه گیری تبدیل تبلیغات مفید است. اما مانع از حفظ حریم خصوصی کاربر می شود: فعالیت باب در سراسر سایت ها با سطح بالایی از جزئیات ردیابی می شود.
![نمای کنار هم از وب امروز (هویت پیوسته) و وب فردا (هویت پارتیشن بندی شده)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?hl=fa)
مقدار کمی از اطلاعات در بین سایتها به هم متصل میشود - برای اندازهگیری تبدیلها کافی است، اما برای ردیابی جزئیات فعالیت باب در بین سایتها کافی نیست. فعالیت باب در news.example
و در shoes.example
جدا باقی می ماند.
حفاظت در هر نوع گزارش
گزارشهای سطح رویداد، یک شناسه سمت آگهی را با مقدار کمی از دادههای سمت تبدیل مرتبط میکند. در حالی که آنها اطلاعات متقاطع سایتی را در مورد یک تبدیل ارائه می دهند، اطلاعات سمت تبدیل برای پیوستن به هویت کاربر در سراسر سایت ها بسیار درشت است.
گزارشهای خلاصه، بینشهای دقیقی را ارائه میدهند، اما فقط در سطح انبوه. از آنجایی که محتویات این گزارشهای جمعآوریشده هنگام ارسال به فناوری تبلیغات رمزگذاری میشوند، فناوری تبلیغات نمیتواند بدون استفاده از سرویس تجمیع اطلاعاتی از گزارشها دریافت کند. سرویس تجمیع فقط دسترسی به دانه های پر سر و صدا را فراهم می کند.
حفاظتهای حریم خصوصی اضافی مانند محدودیتهای نرخ هم بر گزارشهای سطح رویداد و هم بر گزارشهای انبوه اعمال میشود.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?hl=fa)
در جزئیات: گزارشهای سطح رویداد و حریم خصوصی
گزارشهای سطح رویداد با پیروی از مکانیسمهای حفظ حریم خصوصی زیر، بینشهای تبدیل را بدون ردیابی کاربران در سراسر سایتها ارائه میکنند:
- هیچ شناسه متقابل سایتی استفاده نمی شود و هیچ فعالیت دقیق مرور بین سایتی از دستگاه خارج نمی شود.
- گزارشهای سطح رویداد، 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 ایجاد کنید .