ادغام کردن آداپتورهای نشان‌های ایمن

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

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

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

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

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

دستورگان‌های سیگنال‌های ایمن را به‌صورت خودکار یا دستی پیاده‌سازی می‌کنید.

پیاده‌سازی خودکار

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

در اینجا مثالی از آنچه ممکن است در واسط کاربر Ad Manager ببینید آورده شده است:

در اینجا نمونه‌ای از آنچه ممکن است در فایل index.html سایتتان ببینید آورده شده است:

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load gpt.js, which autoloads all signal provider scripts configured to be
  deployed by Google. -->
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="ads.js"></script>

استقرار دستی

اگر گزینه از Google بخواهید تا پلاتفرم جمع‌آوری نشان را ازطرف شما پیاده کند را در Ad Manager نمی‌بینید یا اگر این گزینه را روشن نمی‌کنید، باید پیوند پلاتفرم را از ارائه‌دهنده نشان‌های امن خود دریافت کنید و آن را به‌صورت دستی در پروژه‌تان بگنجانید.

در اینجا نمونه‌ای از آنچه ممکن است در واسط کاربر Ad Manager ببینید آورده شده است:

در اینجا نمونه‌ای از آنچه ممکن است در فایل index.html سایتتان ببینید آورده شده است:

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load signal provider scripts manually, using the unique instructions given by each
  signal provider. -->
<script src="//cdn.provider1.com/files/a/e/5/4/7/signalCollector.js"></script>
<script src="//provider2.co.uk/ads/signalcollector/script.min.js"></script>
<script src="/local/path/to/third_party_signal_provider_3.js"></script>
<script src="ads.js"></script>

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

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

مراحل پروژه‌های HTML5 در اینجا آمده است:

  1. شیئی با این ویژگی‌ها ایجاد کنید: networkCode و collectorFunction.
  2. مشخصه networkCode را با کد شبکه خود پر کنید.
  3. دارایی collectorFunction را با تابعی که یک وعده برمی‌گرداند که به سیگنال‌های کدبندی‌شده شما تبدیل می‌شود پر کنید.

قبل‌از ایجاد نمونه `adsLoader` ، شیء را به آرایه googletag.secureSignalProviders ارسال کنید تا IMA SDK بتواند برای بازیابی و انتقال سیگنال‌های کدگذاری‌شده شما به آن دسترسی داشته باشد:

در اینجا مثالی از جاوا اسکریپت آورده شده است:

console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);

const NETWORK_CODE = '21775744923';

/**
 * Sample signal collector function.
 * @return {!Promise<string>} A promise that resolves to the encoded signals.
 */
const signalCollector = () => {
 return new Promise((resolve, reject) => {
   resolve("My encoded signal string");
 });
};
if (!googletag) googletag = {};
if (!googletag.secureSignalProviders) googletag.secureSignalProviders = [];
googletag.secureSignalProviders.push({
 networkCode: NETWORK_CODE,
 collectorFunction: signalCollector
});

adsLoader = new google.ima.AdsLoader(adDisplayContainer);