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

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

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

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

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

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

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

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

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

مراحل بعدی

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

راه اندازی

پس زمینه

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

برنامه ریزی

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