تجنُّب الأخطاء الشائعة في التنفيذ

// Incorrect: Accessing these files from an unofficial source
<script async src="https://www.example.com/tag/js/gpt.js"></script>

// Correct: Access these files from a Google domain
<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
// Also correct, if using Limited Ads
<script src="https://pagead2.googlesyndication.com/tag/js/gpt.js" async></script>

var tag = document.createElement('script');
tag.type = 'text/javascript';
tag.src = (useSSL ? 'https:' : 'http:') +
        '//www.googletagservices.com/tag/js/gpt.js';
// Incorrect: Attaching a callback to the script's onload event.
tag.onload = callback;
var node = document.getElementsByTagName('script')[0];
node.parentNode.insertBefore(tag, node);

// Make sure that googletag.cmd exists.
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
// Correct: Queueing the callback on the command queue.
googletag.cmd.push(callback);

// Incorrect: Relying on the presence of the googletag object
// as a check for the GPT API.
if (typeof googletag != 'undefined') {
 functionProcessingGPT();
}

// Correct: Relying on googletag.apiReady as a check for the GPT API.
if (window.googletag && googletag.apiReady) {
 functionProcessingGPT();
}

// Incorrect: Relying on an obfuscated property.
if (googletag.pubads().a != null) {
 functionProcessingGPT();
}

// Correct: Relying on public GPT API methods
// (i.e. googletag.pubadsReady in this case).
if(window.googletag && googletag.pubadsReady) {
 functionProcessingGPT();
}

// Incorrect: Haphazardly overwriting a googletag.* property.
googletag.cmd = [];

// Correct: Never overwrite googletag.* properties if they already exist.
// Always check before assigning to them.
googletag.cmd = googletag.cmd || [];

// Incorrect: Setting page-level key-value targeting after calling
// googletag.enableServices().
googletag.enableServices();
googletag.defineSlot(...);
googletag.pubads().setTargeting(e, a);

// Correct: Setting page-level key-value targeting before calling
// googletag.enableServices().
googletag.pubads().setTargeting(e, a);
googletag.defineSlot(...);
googletag.enableServices();

• تحديد-تفعيل-الشبكة الإعلانية
  1. تحديد الإعدادات على مستوى الصفحة
  2. تحديد الخانات
  3. enableServices()‎
  4. خانات العرض
• تفعيل تحديد الإعلانات على الشبكة الإعلانية
  1. تحديد الإعدادات على مستوى الصفحة
  2. enableServices()‎
  3. تحديد الخانات
  4. خانات العرض

// Incorrect: Variable x is declared outside the anonymous function
// but referenced within it.
for (var x = 0; x < slotCount; x++) {
 window.googletag.cmd.push(
  function(){
    // If GPT is not yet loaded, this code will be executed subsequently when
    // the command queue is processed. Every queued function will use the last value
    // assigned to x (most likely slotCount).
    // This is because the function closure captures the reference to x,
    // not the current value of x.
    window.googletag.display(slot[x]);
  })
 }
}

window.googletag.cmd.push(
 function(){
  // Correct: We both declare and reference x inside the context of the function.
  for (var x = 0; x < slotCount; x++){
   window.googletag.display(slot[x]);
  }
 }
)

في JavaScript، تلتقط الدوالّ المغلقة المتغيّرات بالاستناد إلى المرجع بدلاً من القيمة. وهذا يعني أنّه في حال إعادة تعيين متغيّر، سيتم استخدام قيمته الجديدة عند تنفيذ العنصر المغلق للدالة الذي تمّ الاحتفاظ به لاحقًا. ومن ثم سيكون سلوك الرمز في الإغلاق اعتمادًا على ما إذا يتم تنفيذ معاودة الاتصال على الفور أو تأخيرها.

في حال تحميل علامة "ناشر Google" بشكل غير متزامن، استنادًا إلى سرعة تحميل علامة "ناشر Google"، قد يتم تنفيذ عمليات الاستدعاء في قائمة الأوامر على الفور أو لا. في المثال السابق ، يؤدي ذلك إلى تغيير سلوك الأوامر التي تم وضعها في "قائمة الانتظار".

لتجنب أي مشكلات، يجب كتابة التعليمات البرمجية دون افتراض أن الدوال الموضوعة في قائمة انتظار الأوامر على الفور، ويجب توخي الحذر بخصوص تحديد نطاق قواعد JavaScript.

// Incorrect: Moving slot containers after calling display
googletag.defineSlot("/1234/travel/asia", [728, 90], "div-gpt-ad-123456789-0");
googletag.enableServices();
googletag.display("div-gpt-ad-123456789-0");
...
// Inserting another element before the slot container, pushing the slot container down the page.
document.body.insertBefore(someOtherElement, document.getElementById("div-gpt-ad-123456789-0"));

// Correct: Make any DOM order changes before calling display

document.body.insertBefore(someOtherElement, document.getElementById("div-gpt-ad-123456789-0"));
...
googletag.defineSlot("/1234/travel/asia", [728, 90], "div-gpt-ad-123456789-0");
googletag.enableServices();
googletag.display("div-gpt-ad-123456789-0");

// Incorrect: Overwriting window.fetch
const { fetch: originalFetch } = window;
window.fetch = (...args) => {
 console.log('Fetching!');
 return originalFetch(resource, config);
};

// Correct: Avoid making changes to browser APIs.
// If you need custom logic, consider leaving the browser API intact.
const myFetch = (...args) => {
  console.log('Fetching!');
  return window.fetch(...args);
}