الإشارات الآمنة

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

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

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

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

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

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

عند اختيار مقدّمي الإشارات في "مدير إعلانات 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. املأ الموقع networkCode باستخدام رمز الشبكة.
3. املأ السمة collectorFunction بدالة تعرض وعدًا يؤدي إلى إشاراتك المشفّرة.

ادفع العنصر إلى مصفوفة googletag.secureSignalProviders قبل إنشاء adsLoader حتى تتمكّن حزمة تطوير البرامج IMA SDK من الوصول إليه لاسترداد إشارة التشفير ونقلها.

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

ads.js

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

const NETWORK_CODE = '12345678901';
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);
...