شروع به کار با سیگنال‌های امن

پلاتفرم را انتخاب کنید: HTML5 Android iOS tvOS

سیگنال‌های امن داده‌های کدگذاری‌شده‌ای هستند که در دستگاه مشتری جمع‌آوری می‌شوند و با پیشنهاددهندگان منتخب هم‌رسانی می‌شوند. این راهنما به شما نشان می‌دهد که چگونه بااستفاده از IMA SDK، سیگنال‌های امن را جمع‌آوری و به Google Ad Manager ارسال کنید.

میانای برنامه‌سازی کاربردی سیگنال‌های امن به نسخه ۳.۲۹.۰ یا بالاتر از کیت توسعه نرم‌افزار IMA برای Android نیاز دارد.

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

استفاده از ارائه‌دهنده سیگنال طرف سوم

برای استفاده از سیگنال‌های امن، باید کلاس آداپتور جمع‌آوری سیگنال را در برنامه‌تان پیاده‌سازی کنید تا سیگنال‌ها را جمع‌آوری کند، آن‌ها را کدگذاری کند، و به کیت توسعه نرم‌افزار IMA ارسال کند.

دستورالعمل‌های ارائه‌دهنده طرف سوم را برای راه‌اندازی حساب با آن‌ها دنبال کنید، وابستگی‌های ساخت را اضافه کنید، و آداپتور سیگنال‌های امن آن‌ها را در برنامه‌تان راه‌اندازی کنید.

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

در اینجا مثالی از نحوه افزودن آداپتور سیگنال‌های امن به پروژه آورده شده است:

ارسال داده‌های سفارشی

علاوه‌بر استفاده از ارائه‌دهنده سیگنال شخص ثالث، می‌توانید سیگنال‌ها را با داده‌های سفارشی جمع‌آوری، کدگذاری، و ارسال کنید. قبل‌از اینکه بتوانید سیگنال‌های امن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در «مدیر آگهی» روشن کنید.

برای هر درخواست آگهی، کارهای زیر را انجام دهید:

  1. یک شیء SecureSignals حاوی داده‌های سفارشی کدبندی‌شده خود را به‌صورت رشته ایجاد کنید.
  2. با فراخوانی روش adsRequest.setSecureSignals()، شیء SecureSignals را به درخواست آگهی‌تان اضافه کنید:

private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
  SecureSignals signal = SecureSignals.create(secureSignalsString);
  adsRequest.setSecureSignals(signal);
}