سیگنال‌های امن داده‌های کدگذاری‌شده‌ای هستند که در دستگاه کارخواه جمع‌آوری می‌شوند و با پیشنهاددهندگان منتخب هم‌رسانی می‌شوند. این راهنما به شما نشان می‌دهد که چگونه بااستفاده از IMA SDK، سیگنال‌های امن را جمع‌آوری و به Google Ad Manager ارسال کنید.
API سیگنال‌های امن به نسخه ۳.۲۹.۰ یا بالاتر از IMA SDK برای Android نیاز دارد.
برای انتخاب کردن نشان‌ها و پیشنهاددهندگان و فعال کردن هم‌رسانی امن نشان، به هم‌رسانی نشان‌های امن با پیشنهاددهندگان مراجعه کنید.
استفاده از ارائه‌دهنده سیگنال طرف سوم
برای استفاده از سیگنال‌های امن، باید کلاس آداپتور جمع‌آوری سیگنال را در برنامه‌تان پیاده‌سازی کنید تا سیگنال‌ها را جمع‌آوری کند، آن‌ها را کدگذاری کند، و به IMA SDK ارسال کند.
دستورالعمل‌های ارائه‌دهنده طرف سوم را برای راه‌اندازی حساب با آن‌ها دنبال کنید، وابستگی‌های ساخت را اضافه کنید، و آداپتور سیگنال‌های امن آن‌ها را در برنامه‌تان راه‌اندازی کنید.
کیت توسعه نرم‌افزار IMA برای Android به‌طور خودکار هر آداپتور سیگنال‌های امن را بدون هیچ تغییر اضافی در کد شما مقداردهی اولیه می‌کند.
در اینجا مثالی از نحوه افزودن آداپتور سیگنال‌های امن به پروژه‌تان آورده شده است:
ارسال داده‌های سفارشی
علاوه‌بر استفاده از ارائه‌دهنده سیگنال شخص ثالث، می‌توانید سیگنال‌ها را با داده‌های سفارشی جمع‌آوری، کدگذاری، و ارسال کنید. قبل‌از اینکه بتوانید سیگنال‌های امن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در «مدیر آگهی» روشن کنید.
برای هر درخواست جاری‌سازی، کارهای زیر را انجام دهید:
- یک شیء
SecureSignalsحاوی داده‌های سفارشی کدبندی‌شده خود را به‌عنوان یک رشته ایجاد کنید. - با فراخوانی روش
streamRequest.setSecureSignals()، شیءSecureSignalsرا به درخواست جاری‌سازی‌تان اضافه کنید:
app/src/main/java/com/example/project name/SampleAdsWrapper.java
public void requestAndPlayAds() {
adsLoader.addAdErrorListener(this);
adsLoader.addAdsLoadedListener(this);
StreamRequest request = buildStreamRequest();
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
request.setFormat(StreamFormat.HLS);
adsLoader.requestStream(request);
}