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

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

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

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

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

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

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

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

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

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

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

<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>

استقرار دستی

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

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

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

<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>

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

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

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

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

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

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

console.log("initializing IMA");
videoElement = document.getElementById('video');
adUiElement = document.getElementById('adUi');

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
});

streamManager = new google.ima.dai.api.StreamManager(videoElement, adUiElement);