دمج محوِّلات الإشارات الآمنة

اختيار النظام الأساسي: HTML5 Android iOS tvOS

الإشارات الآمنة هي بيانات مشفّرة يتم جمعها على جهاز العميل ومشاركتها مع مقدّمي عروض أسعار محدّدين. يوضّح لك هذا الدليل كيفية جمع الإشارات الآمنة وإرسالها إلى "مدير إعلانات Google" باستخدام "حزمة تطوير البرامج للإعلانات التفاعلية".

لاختيار الإشارات ومقدّمي عروض الأسعار وتفعيل ميزة مشاركة الإشارات الآمنة، يُرجى الاطّلاع على مقالة مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار.

استخدام مقدّم إشارات تابع لجهة خارجية

لاستخدام الإشارات الآمنة، عليك نشر نص برمجي لجمع الإشارات على موقعك الإلكتروني لجمع الإشارات وتشفيرها وتمريرها إلى "حزمة تطوير البرامج للإعلانات التفاعلية".

يمكنك نشر النصوص البرمجية للإشارات الآمنة تلقائيًا أو يدويًا.

النشر تلقائيًا

عند اختيار مقدّمي الإشارات في "مدير إعلانات Google"، قد يظهر لك الخيار اطلب من Google نشر النص البرمجي لجمع الإشارات نيابةً عنك ، وذلك حسب مقدّمي الإشارات الذين اخترتهم. إذا اخترت هذا الخيار وكان موقعك الإلكتروني يتضمّن علامات Google لناشر المحتوى، يتم تحميل النصوص البرمجية لجمع الإشارات التي اخترتها تلقائيًا.

في ما يلي مثال على ما قد يظهر لك في واجهة مستخدم مدير إعلانات Google:

في ما يلي مثال على ما قد يظهر لك في ملف 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 نشر النص البرمجي لجمع الإشارات نيابةً عنك في "مدير إعلانات Google" أو إذا لم تفعِّل هذا الخيار، عليك الحصول على رابط نص برمجي من مقدّم الإشارات الآمنة وإدراجه يدويًا في مشروعك.

في ما يلي مثال على ما قد يظهر لك في واجهة مستخدم مدير إعلانات Google:

في ما يلي مثال على ما قد يظهر لك في ملف 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>

إرسال بيانات مخصّصة

بالإضافة إلى استخدام مقدّم إشارات تابع لجهة خارجية، يمكنك أيضًا جمع الإشارات وتشفيرها وإرسالها مع بيانات مخصّصة. قبل أن تتمكّن من إرسال إشارات آمنة مع بيانات مخصّصة، عليك تفعيل الإشارات المخصّصة في "مدير إعلانات Google".

في ما يلي خطوات مشاريع HTML5:

  1. أنشئ عنصرًا يتضمّن السمتَين التاليتَين: networkCode وcollectorFunction.
  2. عبِّئ الس0/} السمة بمعرِّف شبكتك .networkCode
  3. عبِّئ السمة collectorFunction بدالة تعرض وعدًا يتم تنفيذه لعرض إشاراتك المشفّرة.

أرسِل العنصر إلى المصفوفة googletag.secureSignalProviders قبل إنشاء مثيل `adsLoader` ليتمكّن "حزمة تطوير البرامج للإعلانات التفاعلية" من الوصول إليه لاسترداد إشاراتك المشفّرة ونقلها:

في ما يلي مثال على JavaScript:

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