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

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

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

در اینجا اصول اولیه گزارش‌دهی انتسابی و برخی مفاهیم اساسی را خواهید یافت، اما جزئیات فنی زیادی در مورد آن وجود ندارد.

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

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

API گزارش‌دهی انتساب چیست؟

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

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

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

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

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

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

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

اگر علاقه‌مند به آزمایش با API هستید، به بخش Attribution Reporting: experiment and participants مراجعه کنید.

تغییرات API

• تغییرات API را پیگیری کنید.
• بدانید که چرا API گزارش‌دهی انتساب را در نیمه اول سال 2023 منتشر کردیم.

در دسترس بودن

موارد استفاده و ویژگی‌ها

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

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

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

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

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

• بهینه‌سازی . به سوالاتی مانند «چگونه می‌توانم بازگشت سرمایه‌ام را بهبود بخشم؟» پاسخ دهید. به طور خاص، این گزارش‌ها می‌توانند برای بهینه‌سازی جایگاه تبلیغات استفاده شوند، زیرا شناسه‌های منحصر به فرد سمت تبلیغات را می‌توان در گزارش‌ها در دسترس قرار داد. گزارش‌های سطح رویداد می‌توانند داده‌های آموزشی را برای مدل‌های یادگیری ماشین فراهم کنند.
• گزارش‌دهی جزئی ، که در آن اطلاعات بسیار کمی در مورد تبدیل مورد نیاز است. محدودیت فعلی ۳ بیت داده تبدیل برای کلیک‌ها است - این بدان معناست که می‌توان به یک تبدیل یکی از هشت دسته را اختصاص داد - و ۱ بیت برای بازدیدها. رمزگذاری داده‌های جزئی سمت تبدیل، مانند قیمت خاص یا زمان تبدیل، در گزارش‌های سطح رویداد پشتیبانی نمی‌شود.
• تشخیص کلاهبرداری . داده‌های موجود در برخی گزارش‌ها می‌توانند برای تشخیص و تحلیل کلاهبرداری تبلیغاتی مفید باشند، زیرا به شما امکان می‌دهند الگوهایی را که می‌توانند برای شناسایی فعالیت‌های اسپم یا نامعتبر استفاده شوند، درک کنید.

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

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

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

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

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

سایر ویژگی‌ها

از دیگر ویژگی‌های این API می‌توان به موارد زیر اشاره کرد:

• انتساب برنامه به وب : دیدن یا کلیک روی یک تبلیغ در یک برنامه و تبدیل آن در وب.

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

• فایرفاکس و اج سیگنال‌های خود را به اشتراک نگذاشته‌اند .
• سافاری و وب‌کیت نظر منفی دارند و یک API متفاوت برای اندازه‌گیری تبدیل تبلیغات به نام «اندازه‌گیری کلیک خصوصی» پیشنهاد داده‌اند.

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

مجموعه ویژگی‌های API گزارش‌دهی نسبت‌دهی با API اندازه‌گیری کلیک خصوصی که توسط سافاری و وب‌کیت ارائه شده است، متفاوت است. مهم‌ترین ویژگی API گزارش‌دهی نسبت‌دهی:

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

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

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

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

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

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

<iframe src="..." allow="attribution-reporting"></iframe>

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

یک سایت می‌تواند با ارسال هدر پاسخ HTTP، API گزارش‌دهی انتساب را برای همه طرف‌ها، از جمله اسکریپت‌هایی با دسترسی سطح بالا، غیرفعال کند:

Permissions-Policy: attribution-reporting=()

رابط برنامه‌نویسی کاربردی گزارش‌دهی انتساب چگونه کار می‌کند؟

رابط برنامه‌نویسی کاربردی گزارش‌دهی انتساب، اندازه‌گیری دو رویداد مرتبط با هم را امکان‌پذیر می‌کند: یک رویداد در وب‌سایت ناشر، مانند مشاهده یا کلیک کاربر روی یک تبلیغ، و متعاقباً تبدیل در سایت تبلیغ‌کننده.

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

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

گزارش‌های خلاصه به شرح زیر تهیه می‌شوند:

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

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

حریم خصوصی

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

بیایید شخصی به نام باب را در نظر بگیریم. باب هنگام خواندن اخبار در news.example یک تبلیغ می‌بیند. یک هفته بعد، باب کفش‌هایی را در shoes.example می‌خرد.

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

مقدار کمی از اطلاعات بین سایت‌ها ادغام شده است - برای اندازه‌گیری تبدیل‌ها کافی است، اما برای ردیابی دقیق فعالیت باب در سایت‌های مختلف کافی نیست. فعالیت باب در news.example و shoes.example از هم جدا باقی می‌ماند.

محافظت‌ها در هر نوع گزارش

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

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

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

با جزئیات: گزارش‌های سطح رویداد و حریم خصوصی

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

• هیچ شناسه بین سایتی استفاده نمی‌شود و هیچ فعالیت مرور بین سایتی دقیقی از دستگاه خارج نمی‌شود.
• گزارش‌های سطح رویداد، ۶۴ بیت اطلاعات را در سمت تبلیغ ( news.example ) با تنها ۱ یا ۳ بیت در سمت تبدیل ( shop.example ) مرتبط می‌کنند. ۶۴ بیت اطلاعات کافی برای نگاشت به یک شناسه کاربر شخصی است، اما این ۶۴ بیت فقط می‌توانند با اطلاعات بین سایتی بسیار کمی مرتبط شوند: ۱ یا ۳ بیت، که برای نگهداری یک شناسه کافی نیستند.
  • ۶۴ بیتِ سمت تبلیغات اطلاعات جدیدی نیستند. یک شناسه کاربری می‌تواند از قبل در سمت تبلیغات موجود باشد. news.example یا adtech.example از قبل از فعالیت یک کاربر خاص در news.example اطلاع دارند.
• برای جلوگیری از سوءاستفاده و ردیابی بین سایتی، محافظت‌های بیشتری اعمال می‌شود:
  • گزارش‌ها با تأخیر ارسال می‌شوند.
  • داده‌های تبدیل دارای نویز هستند: درصد مشخصی از زمان، گزارش‌های جعلی تولید می‌شوند.
  • تعداد گزارش‌های تبدیل نسبت داده شده به ازای هر کلیک یا مشاهده محدود است.

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

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

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

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

• برای سوالات مربوط به API: در مخزن API یک مشکل ایجاد کنید .
• به‌روزرسانی‌ها و اطلاعیه‌های API را در فهرست پستی گزارش‌های انتساب دنبال کنید.
• اگر سؤال فنی دارید، یک «اشکال کرومیوم» ثبت کنید .