سیگنال‌های امن، داده‌های رمزگذاری‌شده‌ای هستند که در دستگاه کلاینت جمع‌آوری شده و با پیشنهاددهندگان منتخب به اشتراک گذاشته می‌شوند. این راهنما به شما نشان می‌دهد که چگونه با استفاده از IMA SDK، سیگنال‌های امن را جمع‌آوری و به Google Ad Manager ارسال کنید.
API سیگنال‌های امن به نسخه ۳.۲۹.۰ یا بالاتر از IMA SDK برای اندروید نیاز دارد.
برای انتخاب سیگنال‌ها و پیشنهاددهندگان و فعال کردن اشتراک‌گذاری امن سیگنال، به اشتراک‌گذاری سیگنال‌های امن با پیشنهاددهندگان مراجعه کنید.
از یک ارائه دهنده سیگنال شخص ثالث استفاده کنید
برای استفاده از سیگنال‌های امن، باید یک کلاس آداپتور جمع‌کننده سیگنال را در برنامه خود مستقر کنید تا سیگنال‌ها را جمع‌آوری، رمزگذاری و به IMA SDK منتقل کند.
دستورالعمل‌های ارائه‌دهنده شخص ثالث خود را برای ایجاد حساب کاربری با آنها، اضافه کردن وابستگی‌های ساخت و تنظیم آداپتور سیگنال‌های امن آنها در برنامه خود دنبال کنید.
کیت توسعه نرم‌افزار IMA برای اندروید، بدون هیچ تغییر اضافی در کد شما، به طور خودکار هر آداپتور سیگنال امن را مقداردهی اولیه می‌کند.
در اینجا مثالی از نحوه اضافه کردن یک آداپتور سیگنال امن به پروژه شما آورده شده است:
ارسال داده‌های سفارشی
علاوه بر استفاده از ارائه‌دهنده سیگنال شخص ثالث، می‌توانید سیگنال‌ها را با داده‌های سفارشی نیز جمع‌آوری، رمزگذاری و ارسال کنید. قبل از اینکه بتوانید سیگنال‌های امن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در Ad Manager فعال کنید.
برای هر درخواست پخش زنده، موارد زیر را انجام دهید:
- یک شیء
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);
}