با Attribution Reporting شروع کنید

در اینجا باید از کجا شروع کرد، از جمله راه اندازی و یک نمای کلی سریع.

نوع گزارش را انتخاب کنید

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

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

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

事件级报告：将（广告端）的特定广告点击或观看与转化端数据相关联。为了通过限制跨网站联接用户身份来保护用户隐私，转化端数据非常有限，并且数据非常嘈杂。

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

Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。

پیاده سازی

می توانید با آزمایش مراحل زیر شروع کنید.

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

تولید گزارش در سطح رویداد

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

  1. ثبت منبع برای دستورالعمل ها به منابع ارجاع ثبت نام مراجعه کنید. توجه داشته باشید که مراحل برای کلیک ها و مشاهده ها متفاوت است.

  2. یک ماشه ثبت کنید . برای دستورالعمل ها به ثبت محرک های انتساب مراجعه کنید.

  3. یک نقطه پایانی را با URL زیر تنظیم کنید :
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution .
    برای مشاهده روش POST به کد مثال در adtech.js و برای اطلاعات بیشتر در مورد .well-known به ویکی‌پدیا مراجعه کنید.

جزئیات بیشتر در توضیح گزارش سطح رویداد موجود است.

تولید گزارش خلاصه

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

  1. ثبت منبع برای دستورالعمل ها به منابع ارجاع ثبت نام مراجعه کنید. توجه داشته باشید که مراحل برای کلیک ها و مشاهده ها متفاوت است. جزئیات بیشتر را می توان در ثبت منبع Attribution یافت.

  2. یک ماشه ثبت کنید . برای دستورالعمل ها به ثبت محرک های انتساب مراجعه کنید.

  3. با URL زیر یک نقطه پایانی برای گزارش‌های قابل جمع‌آوری تنظیم کنید :
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution .
    برای مشاهده روش POST به کد مثال در adtech.js و برای اطلاعات بیشتر در مورد .well-known به ویکی‌پدیا مراجعه کنید.

  4. گزارش‌ها را دسته‌بندی کرده و برای پردازش بیشتر توسط سرویس جمع‌آوری که گزارش‌های خلاصه تولید می‌کند ارسال کنید. به گزارش های جمع آوری دسته ای مراجعه کنید.

جزئیات بیشتر در توضیح گزارش انبوه موجود است.

با نحوه تنظیم گزارش‌های اشکال‌زدایی در مجموعه اشکال‌زدایی گزارش Attribution آشنا شوید.

خلاصه مفاهیم اضافی را گزارش می کند

علاوه بر درک مراحل پیاده سازی در اینجا، مفاهیم زیر به شما در برنامه ریزی استراتژی گزارش خلاصه کمک می کند:

مراحل اختیاری

  1. تنظیم فیلترها (اختیاری) :
    1. دستورالعمل های موجود در تعریف قوانین سفارشی با استفاده از فیلترها را دنبال کنید.
    2. جزئیات مربوط به فیلترها را برای گزارش‌های جمع‌آوری‌شده در بخش محرک‌های توضیح‌دهنده مرور کنید.

تشخیص ویژگی را فراموش نکنید

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

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

اگر این بررسی تشخیص ویژگی درست را برگرداند، API در زمینه (صفحه) جایی که بررسی اجرا می شود مجاز است.

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

مراحل بعدی

اگر آماده شروع پیاده سازی هستید، این اسناد را بررسی کنید:

راه اندازی

پس زمینه

دموها و ابزارها

برنامه ریزی

اگر هنوز در مرحله برنامه ریزی هستید، به این اسناد نگاهی بیندازید: