سیگنال‌های امن داده‌های کدگذاری‌شده‌ای هستند که در دستگاه کارخواه جمع‌آوری می‌شوند و با پیشنهاددهندگان منتخب هم‌رسانی می‌شوند. این راهنما نحوه جمع‌آوری و ارسال سیگنال‌های ایمن به Google Ad Manager را بااستفاده از IMA SDK نشان می‌دهد.
«میانای برنامه کاربردی سیگنال‌های امن» به نسخه ۳.۲۹.۰ یا بالاتر از «کیت توسعه نرم‌افزار IMA برای Android» نیاز دارد.
برای انتخاب نشان‌ها و پیشنهاددهندگان قیمت و فعال کردن هم‌رسانی نشان امن، به هم‌رسانی نشان‌های امن با پیشنهاددهندگان قیمت مراجعه کنید.
استفاده از ارائه‌دهنده سیگنال طرف سوم
برای استفاده از سیگنال‌های امن، باید کلاس آداپتور جمع‌آوری سیگنال را در برنامه‌تان پیاده‌سازی کنید تا سیگنال‌ها را جمع‌آوری کند، آن‌ها را کدگذاری کند، و به IMA SDK ارسال کند.
برای راه‌اندازی حساب نزد ارائه‌دهنده طرف سوم، دستورالعمل‌های او را دنبال کنید، وابستگی‌های ساخت را اضافه کنید، و آداپتور نشان‌های امن او را در برنامه‌تان راه‌اندازی کنید.
«کیت توسعه نرم‌افزار IMA برای Android» به‌طور خودکار هر آداپتور سیگنال‌های امن را بدون نیاز به هیچ تغییر اضافه‌ای در کد شما مقداردهی اولیه می‌کند.
در اینجا نمونه‌ای از نحوه افزودن یک آداپتور سیگنال‌های امن به پروژه آورده شده است:
ارسال داده‌های سفارشی
علاوه‌بر استفاده از ارائه‌دهنده نشان شخص ثالث، می‌توانید نشان‌ها را با داده‌های سفارشی نیز جمع‌آوری، رمزگذاری، و ارسال کنید. قبل‌از اینکه بتوانید سیگنال‌های ایمن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در Ad Manager روشن کنید.
برای هر درخواست آگهی، موارد زیر را انجام دهید:
- یک شیء
SecureSignalsحاوی داده‌های سفارشی کدبندی‌شده خود را به‌صورت رشته ایجاد کنید. - با فراخواندن روش
adsRequest.setSecureSignals()، شیءSecureSignalsرا به درخواست آگهی‌تان اضافه کنید:
private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
SecureSignals signal = SecureSignals.create(secureSignalsString);
adsRequest.setSecureSignals(signal);
}