سیگنال‌های امن، داده‌های رمزگذاری‌شده‌ای هستند که در دستگاه کلاینت جمع‌آوری شده و با پیشنهاددهندگان منتخب به اشتراک گذاشته می‌شوند. این راهنما به شما نشان می‌دهد که چگونه با استفاده از IMA SDK، سیگنال‌های امن را جمع‌آوری و به Google Ad Manager ارسال کنید.
برای انتخاب سیگنال‌ها و پیشنهاددهندگان و فعال کردن اشتراک‌گذاری امن سیگنال، به اشتراک‌گذاری سیگنال‌های امن با پیشنهاددهندگان مراجعه کنید.
از یک ارائه دهنده سیگنال شخص ثالث استفاده کنید
برای استفاده از سیگنال‌های امن، باید یک اسکریپت جمع‌آوری سیگنال در سایت خود مستقر کنید تا سیگنال‌ها را جمع‌آوری، کدگذاری و به IMA SDK منتقل کند.
شما اسکریپت‌های سیگنال‌های امن را به صورت خودکار یا دستی پیاده‌سازی می‌کنید.
استقرار خودکار
هنگام انتخاب ارائه‌دهندگان سیگنال در 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>
استقرار دستی
اگر گزینه « از گوگل بخواهید اسکریپت جمع‌آوری سیگنال را از طرف شما مستقر کند» را در 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>
ارسال داده‌های سفارشی
علاوه بر استفاده از ارائه‌دهنده سیگنال شخص ثالث، می‌توانید سیگنال‌ها را با داده‌های سفارشی نیز جمع‌آوری، رمزگذاری و ارسال کنید. قبل از اینکه بتوانید سیگنال‌های امن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در Ad Manager فعال کنید.
مراحل انجام پروژه‌های HTML5 به شرح زیر است:
- یک شیء با این ویژگی‌ها ایجاد کنید:
networkCodeوcollectorFunction. - ویژگی
networkCodeرا با کد شبکه خود پر کنید. - ویژگی
collectorFunctionرا با تابعی پر کنید که promiseای را برمی‌گرداند که به سیگنال‌های کدگذاری شده شما تبدیل می‌شود.
قبل از ایجاد نمونه `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);