به‌روزرسانی‌های Attribution Reporting در ژوئن 2022

پیشنهاد Attribution Reporting برای نسخه 104 Chrome با مکانیسم‌های API جدید، عملکرد و به‌روزرسانی‌های سرویس تجمیع در حال تغییر است.

این آپدیت ها برای چه کسانی هستند؟

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

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

اگر به تازگی با این API شروع کرده اید و/یا هنوز آن را آزمایش نکرده اید، به جای آن مستقیماً به مقدمه API بروید.

به‌روزرسانی‌های API Reporting Attribution

نسخه نمایشی Attribution Reporting برای منعکس کردن آخرین تغییرات در API سمت مشتری Attribution Reporting به روز شده است.

اکثر تغییرات نیازی به اقدام ندارند. مواردی که برای پیاده سازی شما نیاز به به روز رسانی دارند در زیر برجسته شده اند.

(اقدام لازم است) سرصفحه های یکپارچه برای ثبت نام

سرصفحه ها یکپارچه شده اند. اکنون فقط یک سرصفحه برای منابع و یکی برای محرک‌ها وجود دارد که در JSON قالب‌بندی شده است.

  • برای ثبت منابع انتساب، می توانید به درخواست های ثبت نام با عنوان Attribution-Reporting-Register-Source پاسخ دهید.
  • برای تکمیل ثبت نام، سرصفحه Attribution-Reporting-Register-Trigger را تنظیم کنید.

این تغییر نیاز به اقدام دارد. برای اطلاعات بیشتر به راهنمای توسعه دهنده API مراجعه کنید.

(اقدام لازم است) کلیدهای تجمیع اکنون یک فرهنگ لغت هستند

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

مثلا:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

این تغییر نیاز به اقدام دارد. برای اطلاعات بیشتر به راهنمای API مراجعه کنید.

تولید گزارش

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

تنظیم یکپارچه کلید اشکال زدایی

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

ثبت منابع انتساب

برچسب‌های اسکریپت اکنون می‌توانند برای ثبت منابع انتساب، مشابه پشتیبانی از تگ <img> استفاده شوند.

به روز رسانی های بیشتر API

تغییرات دیگری که در کتابچه راهنمای API ایجاد و ذکر شده است عبارتند از:

  • منابع را می توان با APIهای درخواست جاوا اسکریپت ثبت کرد.
  • window.registerSource حذف شد.
  • اکنون اختیاری است که هنگام ثبت منابع، مقداری برای attributionsrc لحاظ شود.
  • عنوان Attribution-Reporting-Eligible به درخواست های ثبت منبع ورودی اضافه شد.
  • تغییر جزئی در encodeURIComponent وجود داشت.
  • کلید بودجه حریم خصوصی از قسمت shared_info در گزارش‌های جمع‌آوری‌شده حذف شد .

پشتیبانی از سرویس تجمع

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

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

  • بررسی اجمالی نویز در تولید گزارش خلاصه
  • توضیح دقیق ابعاد، کلیدها و مقادیر
  • کلیدهای تجمع در عمل، از جمله نقشه ساختار کلید
  • ارزش‌های جمع‌آوری‌شده در عمل، و پیامدهای بودجه مشارکت
  • راهنمای آزمایش با اپسیلون

در مورد به روز رسانی ها بیشتر بخوانید

تصویر هدر از دیانا پولخینا در Unsplash است.