Attribution Reporting API: راهنمای ادغام، Attribution Reporting API: راهنمای ادغام

همانطور که در اسناد Android Sandbox Privacy می خوانید، از دکمه Developer Preview یا Beta برای انتخاب نسخه برنامه ای که با آن کار می کنید استفاده کنید، زیرا ممکن است دستورالعمل ها متفاوت باشد.


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

  • گزارش‌های سطح رویداد شامل داده‌های تبدیل با وفاداری پایین است. تعداد کمی از مقادیر تبدیل به خوبی کار می کنند.
  • گزارش‌های جمع‌آوری‌شده شامل داده‌های تبدیل با وفاداری بالاتر است. راه حل های شما باید کلیدهای تجمیع را بر اساس نیازهای تجاری شما و محدودیت 128 بیتی طراحی کنند.
  • مدل‌های داده و پردازش راه‌حل شما باید محدودیت‌های نرخ برای محرک‌های موجود ، تأخیرهای زمانی برای ارسال رویدادهای ماشه و نویز اعمال‌شده توسط API را در نظر بگیرد.

برای کمک به برنامه‌ریزی یکپارچه‌سازی، این راهنما نمای جامعی را ارائه می‌کند که ممکن است شامل ویژگی‌هایی باشد که هنوز در مرحله فعلی Privacy Sandbox در پیش‌نمایش برنامه‌نویس Android پیاده‌سازی نشده‌اند. در این موارد، راهنمای جدول زمانی ارائه می شود.

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

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

نمودار گردش کار یکپارچه سازی اسناد

شکل 1. گردش کار ادغام اسناد.

پیش نیازها و راه اندازی

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

با API آشنا شوید

  1. پیشنهاد طراحی را بخوانید تا با Attribution Reporting API و قابلیت های آن آشنا شوید.
  2. راهنمای توسعه‌دهنده را بخوانید تا یاد بگیرید که چگونه کدها و فراخوان‌های API را که برای موارد استفاده خود به آن نیاز دارید، به کار ببرید.
  3. هر گونه بازخوردی که برای مستندات دارید، به خصوص در مورد سؤالات باز ارسال کنید .
  4. برای دریافت به‌روزرسانی‌های Attribution Reporting API ثبت‌نام کنید . این به شما کمک می‌کند تا در مورد ویژگی‌های جدیدی که در نسخه‌های آینده معرفی می‌شوند، در جریان باشید.

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

  1. هنگامی که آماده شروع ادغام خود شدید، خود را با آخرین پیش نمایش برنامه نویس در Android Studio راه اندازی کنید.
  2. برای ثبت رویدادها و تحویل گزارش، نقاط پایانی سرور ساختگی را تنظیم کنید. ما مدل‌هایی را ارائه کرده‌ایم که می‌توانید با ابزارهای آنلاین موجود از آنها استفاده کنید.
  3. کد را در برنامه نمونه ما دانلود و اجرا کنید تا با منابع و محرک های ثبت نام آشنا شوید.
    1. پنجره زمانی ارسال گزارش را تنظیم کنید. API از پنجره های 2 روزه، 7 روزه یا یک دوره سفارشی بین 2 تا 30 روز پشتیبانی می کند.
    2. پس از اینکه با اجرا و استفاده از برنامه نمونه، منابع و محرک‌ها را ثبت کردید، و دوره زمانی تعیین‌شده سپری شد، بررسی کنید که یک گزارش در سطح رویداد و یک گزارش انبوه رمزگذاری شده دریافت کرده‌اید. اگر به اشکال‌زدایی گزارش‌ها نیاز دارید، می‌توانید با اجرای اجباری کارهای گزارش‌دهی، آنها را سریع‌تر تولید کنید.
    3. نتایج را برای انتساب برنامه به برنامه مرور کنید. تأیید کنید که داده‌های این نتایج برای موارد آخرین لمس و پس از نصب مطابق انتظار است.

  4. پس از اینکه احساس کردید که API مشتری و سرور چگونه با هم کار می کنند، از برنامه نمونه به عنوان مثال برای هدایت یکپارچه سازی خود استفاده کنید. سرور تولید خود را راه اندازی کنید و تماس های ثبت رویداد را به برنامه های خود اضافه کنید.

پیش ادغام

سازمان خود را با Privacy Sandbox در Android ثبت کنید . این ثبت‌نام برای جلوگیری از تکراری غیرضروری پلتفرم‌های فناوری تبلیغات طراحی شده است، که امکان دسترسی به اطلاعات بیشتر از حد لازم در مورد فعالیت‌های کاربر را فراهم می‌کند.

مشارکت شریک

شرکای فناوری تبلیغات (MMP/SSP/DSP) اغلب راه‌حل‌های اسناد یکپارچه ایجاد می‌کنند. مراحل این بخش به شما کمک می کند تا برای موفقیت در تعامل با شرکای تبلیغاتی خود آماده شوید.

  1. برای بحث در مورد آزمایش و پذیرش Attribution Reporting API، بحثی را با شرکای برتر سنجش خود برنامه ریزی کنید. شرکای اندازه‌گیری می‌توانند شامل شبکه‌های فناوری تبلیغات، SSPها، DSPها، تبلیغ‌کنندگان یا هر شریک دیگری باشد که در حال حاضر با آن کار می‌کنید یا می‌خواهید با آن کار کنید.
  2. با شرکای اندازه گیری خود برای تعریف جدول زمانی برای ادغام، از آزمایش اولیه تا پذیرش، همکاری کنید.
  3. با شرکای اندازه گیری خود روشن کنید که هر کدام از شما در طراحی اسناد چه حوزه هایی را پوشش می دهد.
  4. کانال‌های ارتباطی بین شرکای اندازه‌گیری برای همگام‌سازی در جدول‌های زمانی و آزمایش سرتاسر ایجاد کنید.
  5. طراحی جریان داده های سطح بالا در سراسر شرکای اندازه گیری. ملاحظات کلیدی شامل موارد زیر است:
    • شرکای اندازه گیری چگونه منابع انتساب را با API گزارش انتساب ثبت می کنند؟
    • چگونه شبکه‌های فناوری تبلیغات، محرک‌ها را با Attribution Reporting API ثبت می‌کنند؟
    • چگونه هر فناوری تبلیغاتی درخواست‌های API را تأیید می‌کند و پاسخ‌ها را برای تکمیل ثبت منبع و راه‌اندازی برمی‌گرداند؟
    • آیا گزارش‌هایی وجود دارد که باید بین شرکای خارج از API گزارش اسناد به اشتراک گذاشته شود؟
    • آیا نقاط ادغام یا همسویی دیگری بین شرکا مورد نیاز است؟ به عنوان مثال، آیا شما و شرکایتان باید روی حذف کردن تبدیل‌ها کار کنید یا روی کلیدهای تجمیع تراز کنید؟
  6. اگر انتساب برنامه به وب قابل اجرا است، یک بحث با شرکای اندازه گیری در وب برای بحث در مورد طراحی، آزمایش و پذیرش API گزارش انتساب برنامه ریزی کنید. هنگام شروع گفتگو با شرکای وب، به سؤالات مرحله قبل مراجعه کنید.

نمونه اولیه اسناد سطح رویداد برنامه به برنامه

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

  1. یک سرور مجموعه برای سوابق رویدادها راه اندازی کنید. می توانید این کار را با استفاده از مشخصات ارائه شده برای تولید یک سرور ساختگی انجام دهید یا سرور خود را با نمونه کد سرور راه اندازی کنید.
  2. هنگام نمایش تبلیغات ، تماس‌های رویداد منبع ثبت را به SDK یا برنامه خود اضافه کنید.
    • ملاحظات انتقادی شامل موارد زیر است:
      • مطمئن شوید که شناسه‌های رویداد منبع در دسترس هستند و به درستی به تماس‌های API ثبت منبع ارسال می‌شوند.
      • مطمئن شوید که می‌توانید یک «InputEvent» را نیز برای ثبت منابع کلیک ارسال کنید.
      • نحوه پیکربندی اولویت منبع برای انواع مختلف رویدادها را تعیین کنید. برای مثال، به رویدادهایی که ارزش بالایی در نظر گرفته می‌شوند، اولویت بالایی اختصاص دهید، مانند کلیک‌ها روی بازدیدها.
      • مقدار پیش فرض برای انقضا برای آزمایش OK است. همچنین، می‌توان پنجره‌های انقضای مختلفی را پیکربندی کرد .
      • فیلترها و پنجره های انتساب را می توان به عنوان پیش فرض برای آزمایش گذاشت.
    • ملاحظات اختیاری شامل موارد زیر است:
      • اگر برای آنها آماده هستید، کلیدهای تجمیع را طراحی کنید.
      • هنگامی که نحوه کار با سایر شرکای اندازه گیری را مشخص می کنید، استراتژی تغییر مسیر خود را در نظر بگیرید.
  3. برای ثبت رویدادهای تبدیل ، رویدادهای محرک ثبت را به SDK یا برنامه خود اضافه کنید.
    • ملاحظات انتقادی شامل موارد زیر است:
    • ملاحظات اختیاری شامل موارد زیر است:
      • تا زمانی که در حال انجام تست های دقت نباشید، از ایجاد کلیدهای deduplication صرفنظر کنید.
      • تا زمانی که پشتیبانی آزمایش شبیه سازی آماده شود، از ایجاد کلیدها و مقادیر تجمیع صرفنظر کنید.
      • از تغییر مسیرها صرفنظر کنید تا زمانی که نحوه کار با سایر شرکای اندازه گیری را مشخص کنید.
      • اولویت ماشه برای آزمایش ضروری نیست.
      • فیلترها احتمالاً برای آزمایش اولیه نادیده گرفته می شوند.
  4. آزمایش کنید که رویدادهای منبع برای تبلیغات ایجاد می‌شوند، و اینکه محرک‌ها برای ایجاد گزارش رویداد پیشرو هستند.

تست شبیه سازی

این بخش شما را با آزمایش تأثیری که انتقال تبدیل‌های فعلی شما به گزارش‌های رویداد و جمع‌آوری احتمالاً بر سیستم‌های گزارش‌دهی و بهینه‌سازی خواهد داشت، راهنمایی می‌کند. این به شما این امکان را می دهد که قبل از اتمام یکپارچه سازی، آزمایش ضربه را شروع کنید.

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

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

  1. کتابخانه شبیه سازی اندازه گیری را روی یک ماشین محلی راه اندازی کنید .
  2. مشخصات نحوه فرمت داده های تبدیل شما را بخوانید تا با تولید کننده گزارش شبیه سازی شده سازگار باشد.
  3. کلیدهای تجمیع خود را بر اساس نیازهای تجاری طراحی کنید.
    • ملاحظات انتقادی شامل موارد زیر است:
      • ابعاد مهمی را که مشتریان یا شرکای شما برای جمع آوری و تمرکز ارزیابی خود بر روی آن ها نیاز دارند، در نظر بگیرید.
      • حداقل تعداد ابعاد و کاردینالیته های کل مورد نیاز برای نیازهای خود را تعیین کنید.
      • اطمینان حاصل کنید که قطعات کلید سمت منبع و ماشه بیش از 128 بیت نباشد.
      • اگر راه‌حل‌های شما شامل کمک به چندین مقدار در هر رویداد ماشه است، مطمئن شوید که مقادیر را در برابر حداکثر بودجه مشارکت، L1، مقیاس کنید. این به کاهش تاثیر نویز کمک می کند.
      • در اینجا مثالی وجود دارد که جزئیات تنظیم یک کلید برای جمع‌آوری تبدیل کل در سطح کمپین و کلیدی برای جمع‌آوری ارزش‌های خرید کل در سطح جغرافیایی است.
  4. مولد گزارش را برای ایجاد گزارش های رویداد و جمع آوری اجرا کنید.
  5. گزارش های جمع آوری را از طریق سرورهای تجمیع شبیه سازی شده اجرا کنید تا گزارش های خلاصه را دریافت کنید.
  6. انجام آزمایش های کاربردی:
    • برای تعیین دقت گزارش تبدیل، مجموع تبدیل‌ها را از گزارش‌های سطح رویداد و خلاصه با داده‌های تبدیل تاریخی مقایسه کنید. برای بهترین نتایج، آزمایش‌ها و مقایسه‌های گزارش‌دهی را بر روی بخش وسیعی از پایگاه تبلیغ‌کننده اجرا کنید.
    • مدل‌های خود را بر اساس داده‌های گزارش سطح رویداد و داده‌های گزارش خلاصه بالقوه دوباره آموزش دهید. دقت را با مدل های ساخته شده بر اساس داده های آموزشی تاریخی مقایسه کنید.
    • استراتژی‌های دسته‌بندی مختلف را امتحان کنید و ببینید که چگونه بر نتایج شما تأثیر می‌گذارند.
      • ملاحظات انتقادی شامل موارد زیر است:
      • به موقع بودن گزارش های خلاصه برای تعدیل پیشنهادات.
      • متوسط ​​فراوانی رویدادهای قابل انتساب در دستگاه. به عنوان مثال، کاربران از کار افتاده بر اساس داده‌های رویدادهای خرید تاریخی بازمی‌گردند.
      • سطح نویز. دسته های بیشتر به معنای تجمع کوچکتر است و تجمع کوچکتر به معنای ایجاد نویز بیشتر است.

انتساب سرور تجمیع نمونه اولیه: راه اندازی

این مراحل تضمین می‌کند که می‌توانید گزارش‌های انبوهی از منبع و رویدادهای راه‌انداز خود را دریافت کنید.

  1. سرور تجمیع خود را راه اندازی کنید:
  2. کلیدهای تجمیع خود را بر اساس نیازهای تجاری طراحی کنید. اگر قبلاً این کار را در بخش سطح رویداد برنامه به برنامه انجام داده اید، می توانید از این مرحله رد شوید.
  3. یک سرور مجموعه برای گزارش های جمع آوری شده راه اندازی کنید. اگر قبلاً یکی را در بخش سطح رویداد برنامه به برنامه ایجاد کرده‌اید، می‌توانید دوباره از آن استفاده کنید.

انتساب سرور تجمع نمونه اولیه: یکپارچه سازی

برای گذر از این مرحله، باید قسمت Prototype aggregation server etribution: Setup یا بخش Prototype App to App Event-Level Attribution ** را تکمیل کرده باشید.

  1. داده‌های کلید تجمیع را به منبع خود اضافه کنید و رویدادها را راه‌اندازی کنید. این احتمالاً مستلزم ارسال داده‌های بیشتری درباره رویداد تبلیغاتی، مانند شناسه کمپین، به SDK یا برنامه شما برای گنجاندن در کلید تجمیع است.
  2. گزارش‌های انبوه برنامه به برنامه را از منبع جمع‌آوری کنید و رویدادهایی را که با داده‌های کلید تجمیع ثبت کرده‌اید، راه‌اندازی کنید.
  3. در حین اجرای این گزارش‌های جمع‌آوری‌شده از طریق سرور تجمیع، استراتژی‌های دسته‌بندی مختلف را آزمایش کنید و ببینید که چگونه بر نتایج شما تأثیر می‌گذارند.

طراحی تکراری با ویژگی های اختیاری

موارد زیر ویژگی های اضافی است که می توانید در راه حل اندازه گیری خود بگنجانید.

  1. تنظیم یک کلید اشکال زدایی به شما این امکان را می دهد که یک گزارش بدون تغییر از یک منبع یا رویداد محرک همراه با گزارش های تولید شده توسط Attribution Reporting API دریافت کنید. می توانید از کلیدهای اشکال زدایی برای مقایسه گزارش ها و یافتن اشکالات در حین ادغام استفاده کنید.

رفتارهای اسناد را سفارشی کنید

  1. ارجاع برای محرک‌های پس از نصب
    • این ویژگی می‌تواند در مواردی استفاده شود که محرک‌های پس از نصب باید به همان منبع انتسابی نسبت داده شوند که نصب را هدایت کرده است، حتی اگر منابع اسناد واجد شرایط دیگری وجود داشته باشند که اخیراً رخ داده‌اند.
    • به عنوان مثال، ممکن است موردی وجود داشته باشد که کاربر روی تبلیغی کلیک کند که نصب را هدایت می کند. پس از نصب، کاربر روی تبلیغ دیگری کلیک کرده و اقدام به خرید می کند. در این مورد، شرکت فناوری تبلیغات ممکن است بخواهد که خرید به جای کلیک مجدد، به اولین کلیک نسبت داده شود.
  2. از فیلترها برای تنظیم دقیق داده ها در گزارش های سطح رویداد خود استفاده کنید
    • فیلترهای تبدیل را می‌توان طوری تنظیم کرد که محرک‌های انتخابی را نادیده بگیرد و آنها را از گزارش‌های رویداد حذف کند. از آنجایی که محدودیت‌هایی برای تعداد راه‌اندازها به ازای هر منبع انتساب وجود دارد، فیلترها به شما اجازه می‌دهند فقط محرک‌هایی را که مفیدترین اطلاعات را ارائه می‌دهند در گزارش‌های رویداد خود بگنجانید.
    • همچنین می‌توان از فیلترها برای فیلتر کردن انتخابی برخی از محرک‌ها و نادیده گرفتن آنها استفاده کرد. برای مثال، اگر کمپینی دارید که نصب‌های برنامه را هدف قرار می‌دهد، ممکن است بخواهید محرک‌های پس از نصب را از نسبت دادن به منابع آن کمپین فیلتر کنید.
    • همچنین می توان از فیلترها برای سفارشی کردن داده های ماشه بر اساس داده های منبع استفاده کرد. به عنوان مثال، یک منبع می تواند "product" : ["1234"] که محصول کلید فیلتر و 1234 مقدار است. هر ماشه ای با کلید فیلتر "محصول" که مقداری غیر از "1234" داشته باشد نادیده گرفته می شود.
  3. منبع سفارشی و اولویت ماشه
    • در موردی که می‌توان چندین منبع انتساب را با یک ماشه مرتبط کرد، یا چندین تریگر را می‌توان به یک منبع نسبت داد، می‌توانید از یک عدد صحیح 64 بیتی امضا شده برای اولویت‌بندی منابع/مشهد مشخص نسبت به دیگران استفاده کنید.

کار با MMP و دیگران

  1. برای رویدادهای منبع و ماشه به سایر اشخاص ثالث هدایت می شود
    • می‌توانید URLهای تغییر مسیر را تنظیم کنید تا به چندین پلتفرم فناوری تبلیغات اجازه ثبت درخواست را بدهید. این را می توان برای فعال کردن حذف مجدد بین شبکه ای در انتساب استفاده کرد.
  2. کلیدهای تکراری
    • هنگامی که یک تبلیغ‌کننده از چندین پلت‌فرم فناوری تبلیغاتی برای ثبت یک رویداد محرک استفاده می‌کند، می‌توان از یک کلید حذف تکراری برای رفع ابهام این گزارش‌های مکرر استفاده کرد. اگر کلید حذف تکراری ارائه نشده باشد، محرک های تکراری ممکن است به هر پلتفرم فناوری تبلیغات به عنوان منحصر به فرد گزارش شوند.

کار با اندازه گیری کراس پلت فرم

  1. تخصیص بین برنامه و وب (در اواخر سه ماهه چهارم موجود است)
    • موارد استفاده را پشتیبانی می کند که در آن کاربر تبلیغی را در یک برنامه می بیند، سپس در مرورگر موبایل یا برنامه تبدیل می کند یا برعکس.
{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}