همانطور که مستندات Privacy Sandbox را در اندروید مطالعه میکنید، از دکمه Developer Preview یا Beta برای انتخاب نسخه برنامهای که با آن کار میکنید استفاده کنید، زیرا دستورالعملها ممکن است متفاوت باشند.
API گزارشدهی انتساب به گونهای طراحی شده است که از موارد استفاده کلیدی برای اندازهگیری انتساب و تبدیل در برنامهها و وب بدون تکیه بر شناسههای کاربری بینطرفی پشتیبانی کند. در مقایسه با طرحهای رایج امروزی، پیادهسازیکنندگان API گزارشدهی انتساب باید برخی ملاحظات مهم سطح بالا را در نظر بگیرند:
- گزارشهای سطح رویداد شامل دادههای تبدیل با دقت پایین هستند. تعداد کمی از مقادیر تبدیل به خوبی کار میکنند.
- گزارشهای قابل تجمیع شامل دادههای تبدیل با دقت بالاتر هستند. راهکارهای شما باید کلیدهای تجمیع را بر اساس الزامات تجاری و محدودیت ۱۲۸ بیتی طراحی کنند.
- مدلهای داده و پردازش راهحل شما باید محدودیتهای سرعت برای محرکهای موجود ، تأخیرهای زمانی برای ارسال رویدادهای محرک و نویز اعمال شده توسط API را در نظر بگیرند.
برای کمک به شما در برنامهریزی ادغام، این راهنما یک دیدگاه جامع ارائه میدهد که ممکن است شامل ویژگیهایی باشد که هنوز در مرحله فعلی پیشنمایش توسعهدهندگان Privacy Sandbox در Android پیادهسازی نشدهاند. در این موارد، راهنمای جدول زمانی ارائه شده است.
در این صفحه، ما از منبع (source) برای نمایش کلیک یا نمایش و از تریگر (trigger) برای نمایش تبدیل (conversion) استفاده میکنیم.
نمودار زیر گزینههای مختلف گردش کار برای ادغام تخصیص منابع را نشان میدهد. بخشهای فهرستشده در یک ستون (با دایره سبز مشخص شدهاند) میتوانند به صورت موازی کار شوند؛ برای مثال، مشارکت شرکا میتواند همزمان با تخصیص منابع در سطح رویداد از برنامه به برنامه انجام شود.
پیشنیازها و تنظیمات
مراحل این بخش را برای بهبود درک خود از API گزارشدهی انتساب تکمیل کنید. این مراحل شما را برای جمعآوری نتایج معنادار هنگام استفاده از API در اکوسیستم فناوری تبلیغات آماده میکند.
آشنایی با API
- برای آشنایی با API گزارشدهی انتساب و قابلیتهای آن ، طرح پیشنهادی را مطالعه کنید.
- برای یادگیری نحوهی گنجاندن کد و فراخوانیهای API مورد نیاز برای موارد استفادهی خود، راهنمای توسعهدهنده را مطالعه کنید.
- برای دریافت بهروزرسانیها در مورد API گزارشدهی انتساب، ثبتنام کنید . این به شما کمک میکند تا از ویژگیهای جدیدی که در نسخههای آینده معرفی میشوند، مطلع شوید.
برنامه نمونه را تنظیم و آزمایش کنید
- زمانی که برای شروع ادغام آماده شدید، آخرین نسخه پیشنمایش توسعهدهندگان را در اندروید استودیو نصب کنید.
- نقاط پایانی سرور آزمایشی را برای ثبت رویدادها و ارائه گزارش تنظیم کنید. ما نمونههای آزمایشی را ارائه کردهایم که میتوانید همزمان با ابزارهای آنلاین موجود از آنها استفاده کنید.
- کد را دانلود و در برنامه نمونه ما اجرا کنید تا با ثبت منابع و تریگرها آشنا شوید.
- بازه زمانی ارسال گزارشها را تنظیم کنید. API از بازههای زمانی ۲ روزه، ۷ روزه یا یک دوره سفارشی بین ۲ تا ۳۰ روزه پشتیبانی میکند.
- پس از اینکه منابع و تریگرها را با اجرا و استفاده از برنامه نمونه ثبت کردید و دوره زمانی تعیینشده گذشت، تأیید کنید که یک گزارش در سطح رویداد و یک گزارش رمزگذاریشده قابل جمعآوری دریافت کردهاید. اگر نیاز به اشکالزدایی گزارشها دارید، میتوانید با اجرای اجباری کارهای گزارشدهی ، آنها را سریعتر تولید کنید.
- نتایج مربوط به انتساب برنامه به برنامه را بررسی کنید. تأیید کنید که دادههای این نتایج برای هر دو مورد آخرین لمس و پس از نصب مطابق انتظار است.
- بعد از اینکه با نحوهی کار API کلاینت و سرور آشنا شدید، از برنامهی نمونه به عنوان مثال برای راهنمایی در ادغام خود استفاده کنید. سرور تولید خود را راهاندازی کنید و فراخوانیهای ثبت رویداد را به برنامههای خود اضافه کنید.
پیش ادغام
سازمان خود را در Privacy Sandbox در اندروید ثبت کنید . این ثبت نام به منظور جلوگیری از کپیبرداری غیرضروری از پلتفرمهای فناوری تبلیغات طراحی شده است، که امکان دسترسی به اطلاعات بیش از حد لازم در مورد فعالیتهای کاربر را فراهم میکند.
مشارکت شرکا
شرکای فناوری تبلیغات (MMP/SSP/DSP) اغلب راهکارهای یکپارچهی انتساب ایجاد میکنند. مراحل این بخش به شما کمک میکند تا برای موفقیت در تعامل با شرکای فناوری تبلیغات خود آماده شوید.
- برای بحث در مورد آزمایش و پذیرش API گزارشدهی انتساب، با شرکای برتر اندازهگیری خود جلسهای ترتیب دهید. شرکای اندازهگیری میتوانند شامل شبکههای فناوری تبلیغات، SSPها، DSPها، تبلیغکنندگان یا هر شریک دیگری باشند که با آنها کار میکنید یا مایل به همکاری با آنها هستید.
- با شرکای سنجش خود همکاری کنید تا جدول زمانی برای ادغام، از آزمایش اولیه تا پذیرش، تعریف کنید.
- با شرکای اندازهگیری خود مشخص کنید که هر یک از شما در طراحی تخصیص، کدام حوزهها را پوشش خواهید داد.
- کانالهای ارتباطی بین شرکای اندازهگیری ایجاد کنید تا جدول زمانی و آزمایشهای سرتاسری را همگامسازی کنید.
- جریانهای داده سطح بالا را در بین شرکای اندازهگیری طراحی کنید. ملاحظات کلیدی شامل موارد زیر است:
- شرکای اندازهگیری چگونه منابع انتساب را در API گزارش انتساب ثبت میکنند؟
- شبکههای فناوری تبلیغات چگونه محرکها را با API گزارشدهی انتساب ثبت میکنند؟
- چگونه هر تکنسین تبلیغات، درخواستهای API را اعتبارسنجی میکند و پاسخها را برای تکمیل ثبت منبع و فعالسازی برمیگرداند؟
- آیا گزارشهایی وجود دارد که لازم باشد خارج از API گزارشدهی انتساب، بین شرکا به اشتراک گذاشته شوند؟
- آیا نکات ادغام یا هماهنگی دیگری بین شرکا مورد نیاز است؟ به عنوان مثال، آیا شما و شرکایتان باید روی کاهش تبدیلهای تکراری کار کنید یا روی کلیدهای تجمیع هماهنگی ایجاد کنید؟
- اگر انتساب از طریق برنامه به وب امکانپذیر است، برای بحث در مورد طراحی، آزمایش و پذیرش API گزارشدهی انتساب، با شرکای اندازهگیری در وب جلسهای ترتیب دهید. هنگام شروع گفتگو با شرکای وب، به سوالات مرحله قبل مراجعه کنید.
نمونه اولیه انتساب رویداد در سطح برنامه به برنامه
این بخش به شما کمک میکند تا یک انتساب اولیه برنامه به برنامه را با گزارشهای سطح رویداد در برنامه یا SDK خود تنظیم کنید. تکمیل این بخش قبل از شروع نمونهسازی اولیه انتساب سرور تجمیع الزامی است.
- یک سرور جمعآوری برای رکوردهای رویداد راهاندازی کنید. میتوانید این کار را با استفاده از مشخصات ارائه شده برای تولید یک سرور آزمایشی انجام دهید، یا سرور خودتان را با کد سرور نمونه راهاندازی کنید.
- هنگام نمایش تبلیغات، فراخوانیهای رویداد منبع ثبت را به SDK یا برنامه خود اضافه کنید.
- ملاحظات انتقادی شامل موارد زیر است:
- تأیید کنید که شناسههای رویداد منبع در دسترس هستند و به درستی به فراخوانیهای API ثبت منبع ارسال میشوند.
- تأیید کنید که میتوانید یک «InputEvent» نیز برای ثبت منابع کلیک ارسال کنید.
- تعیین کنید که چگونه اولویت منبع را برای انواع مختلف رویدادها پیکربندی خواهید کرد. به عنوان مثال، به رویدادهایی که ارزش بالایی دارند، مانند کلیکها نسبت به بازدیدها، اولویت بالایی اختصاص دهید.
- مقدار پیشفرض برای انقضا برای آزمایش مناسب است. به عنوان یک جایگزین، میتوان پنجرههای انقضای متفاوتی را پیکربندی کرد .
- فیلترها و پنجرههای انتساب میتوانند به عنوان پیشفرض برای آزمایش باقی بمانند.
- ملاحظات اختیاری شامل موارد زیر است:
- اگر برای کلیدهای تجمیع آماده هستید، آنها را طراحی کنید.
- هنگام تعیین نحوه همکاری با سایر شرکای اندازهگیری، استراتژی تغییر مسیر خود را در نظر بگیرید.
- ملاحظات انتقادی شامل موارد زیر است:
- رویدادهای trigger ثبت را به SDK یا برنامه خود اضافه کنید تا رویدادهای تبدیل را ثبت کنید.
- ملاحظات انتقادی شامل موارد زیر است:
- با توجه به محدودیت وفاداری بازگشتی ، دادههای محرک را تعریف کنید: چگونه میخواهید تعداد انواع تبدیل مورد نیاز تبلیغکنندگان خود را برای ۳ بیت موجود برای کلیکها و ۱ بیت موجود برای بازدیدها کاهش دهید؟
- محدودیتهای مربوط به محرکهای موجود در گزارشهای رویداد : چگونه قصد دارید تعداد کل تبدیلها را به ازای هر منبعی که میتوانید در گزارشهای رویداد دریافت کنید، کاهش دهید؟
- ملاحظات اختیاری شامل موارد زیر است:
- تا زمانی که تستهای دقت را انجام ندادهاید، از ایجاد کلیدهای حذف دادههای تکراری صرف نظر کنید.
- تا زمانی که پشتیبانی از تست شبیهسازی آماده نشده است، از ایجاد کلیدها و مقادیر تجمیع صرف نظر کنید.
- تا زمانی که مشخص نکردهاید چگونه میخواهید با سایر شرکای اندازهگیری همکاری کنید، از تغییر مسیرها صرف نظر کنید.
- اولویت شروع برای آزمایش ضروری نیست.
- احتمالاً میتوان فیلترها را برای آزمایش اولیه نادیده گرفت.
- ملاحظات انتقادی شامل موارد زیر است:
- بررسی کنید که رویدادهای منبع برای تبلیغات ایجاد میشوند و محرکها برای ایجاد گزارشهای رویداد پیشرو هستند.
آزمایش شبیهسازی
این بخش شما را در آزمایش تأثیر انتقال تبدیلهای فعلیتان به گزارشهای رویداد و قابل جمعآوری بر سیستمهای گزارشدهی و بهینهسازی راهنمایی میکند. این به شما امکان میدهد قبل از اتمام یکپارچهسازی، آزمایش تأثیر را آغاز کنید.
آزمایش با شبیهسازی تولید گزارشهای رویداد و قابل تجمیع بر اساس سوابق تبدیل تاریخی شما و سپس دریافت نتایج تجمیعشده از یک سرور تجمیع شبیهسازیشده انجام میشود. این نتایج را میتوان با اعداد تبدیل تاریخی مقایسه کرد تا ببینیم دقت گزارشدهی چگونه تغییر میکند.
مدلهای بهینهسازی، مانند محاسبات نرخ تبدیل پیشبینیشده، میتوانند بر اساس این گزارشها آموزش داده شوند تا دقت این مدلها در مقایسه با مدلهای ساختهشده بر اساس دادههای فعلی مقایسه شود. این همچنین فرصتی برای آزمایش ساختارهای کلیدی تجمیع مختلف و تأثیر آنها بر نتایج است.
- کتابخانه شبیهسازی اندازهگیری را روی یک دستگاه محلی راهاندازی کنید .
- مشخصات مربوط به نحوه قالببندی دادههای تبدیل شما برای سازگاری با مولد گزارش شبیهسازی شده را مطالعه کنید.
- کلیدهای تجمیع خود را بر اساس الزامات تجاری طراحی کنید.
- ملاحظات انتقادی شامل موارد زیر است:
- ابعاد حیاتی که مشتریان یا شرکای شما باید جمعآوری کنند را در نظر بگیرید و ارزیابی خود را بر روی آنها متمرکز کنید.
- حداقل تعداد ابعاد و کاردینالیتیهای سنگدانه مورد نیاز برای نیازهای خود را تعیین کنید.
- تأیید کنید که قطعات کلید سمت منبع و ماشه از ۱۲۸ بیت تجاوز نکنند.
- اگر راهحلهای شما شامل مشارکت در چندین ارزش در هر رویداد محرک است، حتماً ارزشها را در مقایسه با حداکثر بودجه مشارکت، L1، مقیاسبندی کنید. این به حداقل رساندن تأثیر نویز کمک میکند.
- در اینجا مثالی آورده شده است که جزئیات تنظیم یک کلید برای جمعآوری تعداد تبدیلهای کلی در سطح کمپین و یک کلید برای جمعآوری مقادیر خرید کلی در سطح جغرافیایی را شرح میدهد.
- ملاحظات انتقادی شامل موارد زیر است:
- برای ایجاد گزارشهای رویداد و گزارشهای تجمیعی، تولیدکننده گزارش را اجرا کنید.
- گزارشهای تجمیعی را از طریق سرورهای تجمیع شبیهسازیشده اجرا کنید تا گزارشهای خلاصه دریافت کنید.
- انجام آزمایشهای کاربردی:
- برای تعیین دقت گزارش تبدیل، مجموع تبدیلها را از گزارشهای سطح رویداد و خلاصه با دادههای تبدیل تاریخی مقایسه کنید. برای بهترین نتیجه، آزمایشها و مقایسههای گزارشدهی را روی بخش وسیعی از پایگاه تبلیغکنندگان انجام دهید.
- مدلهای خود را بر اساس دادههای گزارش سطح رویداد و احتمالاً دادههای گزارش خلاصه، مجدداً آموزش دهید. دقت را با مدلهای ساخته شده بر اساس دادههای آموزشی تاریخی مقایسه کنید.
- استراتژیهای مختلف دستهبندی را امتحان کنید و ببینید که چگونه بر نتایج شما تأثیر میگذارند.
- ملاحظات انتقادی شامل موارد زیر است:
- به موقع بودن گزارشهای خلاصه برای تنظیم پیشنهادها.
- میانگین فراوانی رویدادهای قابل انتساب در دستگاه. به عنوان مثال، بازگشت کاربران قدیمی بر اساس دادههای رویدادهای خرید قبلی.
- سطح نویز. دستههای بیشتر به معنای تجمیع کوچکتر است و تجمیع کوچکتر به معنای اعمال نویز بیشتر است.
انتساب سرور تجمیع نمونه اولیه: راهاندازی
این مراحل تضمین میکند که شما قادر به دریافت گزارشهای تجمیعی از منبع و رویدادهای محرک خود هستید.
- سرور تجمیع خود را راهاندازی کنید:
- حساب کاربری AWS خود را تنظیم کنید.
- با هماهنگکننده خود در سرویس تجمیع ثبتنام کنید.
- سرور تجمیع خود را از فایلهای باینری ارائه شده روی AWS راهاندازی کنید .
- کلیدهای تجمیع خود را بر اساس الزامات تجاری طراحی کنید. اگر قبلاً این کار را در بخش سطح رویداد برنامه به برنامه انجام دادهاید، میتوانید از این مرحله صرف نظر کنید.
- یک سرور جمعآوری برای گزارشهای قابل جمعآوری راهاندازی کنید. اگر قبلاً یکی را در بخش سطح رویداد برنامه به برنامه ایجاد کردهاید، میتوانید دوباره از آن استفاده کنید.
انتساب سرور تجمیع نمونه اولیه: ادغام
برای عبور از این مرحله، باید بخش «تنظیمات: انتساب سرور تجمیع نمونه اولیه» یا بخش «انتساب سطح رویداد برنامه به برنامه نمونه اولیه» را تکمیل کرده باشید.**
- دادههای کلید تجمیع را به منبع خود اضافه کنید و رویدادها را فعال کنید. این احتمالاً نیاز به ارسال دادههای بیشتر در مورد رویداد تبلیغ، مانند شناسه کمپین، به SDK یا برنامه شما برای گنجاندن در کلید تجمیع دارد.
- گزارشهای قابل تجمیع برنامه به برنامه را از منبع جمعآوری کنید و رویدادهایی را که با دادههای کلیدی تجمیع ثبت کردهاید، فعال کنید.
- همزمان با اجرای این گزارشهای تجمیعی از طریق سرور تجمیع، استراتژیهای مختلف دستهبندی را آزمایش کنید و ببینید که چگونه بر نتایج شما تأثیر میگذارند.
طراحی تکراری با ویژگیهای اختیاری
موارد زیر ویژگیهای اضافی هستند که میتوانید در راهکار اندازهگیری خود بگنجانید.
استفاده از Debug API برای تولید کلیدهای اشکالزدایی (اکیدا توصیه میشود)
- تنظیم کلید اشکالزدایی به شما این امکان را میدهد که یک گزارش بدون تغییر از یک منبع یا رویداد محرک را به همراه گزارشهای تولید شده توسط API گزارشدهی نسبتدهی دریافت کنید. میتوانید از کلیدهای اشکالزدایی برای مقایسه گزارشها و یافتن اشکالات در طول ادغام استفاده کنید.
رفتارهای انتسابی را سفارشی کنید
- انتساب برای تریگرهای پس از نصب
- این ویژگی میتواند در مواردی استفاده شود که محرکهای پس از نصب باید به همان منبع انتساب که نصب را هدایت کرده است، نسبت داده شوند، حتی اگر منابع انتساب واجد شرایط دیگری وجود داشته باشند که اخیراً رخ دادهاند.
- برای مثال، ممکن است موردی پیش بیاید که کاربر روی تبلیغی کلیک کند که منجر به نصب برنامه شود. پس از نصب، کاربر روی تبلیغ دیگری کلیک کرده و خرید انجام میدهد. در این حالت، شرکت فناوری تبلیغات ممکن است بخواهد خرید به جای کلیک مجدد، به اولین کلیک نسبت داده شود.
- از فیلترها برای تنظیم دقیق دادهها در گزارشهای سطح رویداد خود استفاده کنید
- فیلترهای تبدیل را میتوان طوری تنظیم کرد که محرکهای انتخابشده را نادیده بگیرند و آنها را از گزارشهای رویداد حذف کنند. از آنجا که محدودیتهایی در تعداد محرکها به ازای هر منبع ارجاع وجود دارد، فیلترها به شما این امکان را میدهند که فقط محرکهایی را که مفیدترین اطلاعات را در گزارشهای رویداد شما ارائه میدهند، لحاظ کنید.
- فیلترها همچنین میتوانند برای فیلتر کردن انتخابی برخی از محرکها و نادیده گرفتن مؤثر آنها استفاده شوند. به عنوان مثال، اگر کمپینی دارید که نصب اپلیکیشن را هدف قرار میدهد، ممکن است بخواهید محرکهای پس از نصب را از نسبت دادن به منابع آن کمپین فیلتر کنید.
- فیلترها همچنین میتوانند برای سفارشیسازی دادههای تریگر بر اساس دادههای منبع استفاده شوند. برای مثال، یک منبع میتواند
"product" : ["1234"]که در آن product کلید فیلتر و 1234 مقدار است. هر تریگری با کلید فیلتر "product" که مقداری غیر از "1234" داشته باشد، نادیده گرفته میشود.
- منبع سفارشی و اولویت ماشه
- در صورتی که چندین منبع انتساب بتوانند با یک تریگر مرتبط شوند، یا چندین تریگر به یک منبع نسبت داده شوند، میتوانید از یک عدد صحیح ۶۴ بیتی امضا شده برای اولویتبندی منابع یا تریگرهای خاص نسبت به سایرین استفاده کنید.
کار با MMPها و دیگران
- برای رویدادهای منبع و محرک به اشخاص ثالث دیگر هدایت میشود
- شما میتوانید URL های تغییر مسیر را تنظیم کنید تا به چندین پلتفرم فناوری تبلیغات اجازه ثبت یک درخواست را بدهید. این میتواند برای فعال کردن حذف دادههای تکراری بین شبکهای در انتساب استفاده شود.
- کلیدهای حذف دادههای تکراری
- وقتی یک تبلیغکننده از چندین پلتفرم فناوری تبلیغات برای ثبت یک رویداد محرک یکسان استفاده میکند، میتوان از یک کلید حذف دادههای تکراری برای رفع ابهام از این گزارشهای تکراری استفاده کرد. اگر هیچ کلید حذف دادههای تکراری ارائه نشود، ممکن است محرکهای تکراری به هر پلتفرم فناوری تبلیغات به عنوان یکتا گزارش شوند.
کار با اندازهگیری بین پلتفرمی
- انتساب بین اپلیکیشنی و وب (در اواخر سهماهه چهارم در دسترس است)
- از مواردی پشتیبانی میکند که کاربر تبلیغی را در یک اپلیکیشن میبیند، سپس در مرورگر موبایل یا اپلیکیشن به مشتری تبدیل میشود یا برعکس.
برای شما توصیه میشود
- توجه: متن لینک زمانی نمایش داده میشود که جاوا اسکریپت غیرفعال باشد.
- گزارش انتساب
- گزارش انتساب: اندازهگیری بین اپلیکیشنی و وب