مرجع علامة "ناشر Google"

يستخدم هذا المرجع ترميز TypeScript لوصف الأنواع. يقدم الجدول التالي شرح موجز بالمثال.

لمزيد من المعلومات حول الأنواع وتعبيرات النوع المتاحة، راجع كتيب TypeScript .

كتابة التعليقات التوضيحية

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

---

تعريفات الأنواع

أنواع التعداد

---

googletag.enums.OutOfPageFormat

• تنسيقات الإعلانات خارج الصفحة المتوافقة مع جدول تقسيم المعرّف الفريد العمومي.

• انظر أيضًا

  • defineOutOfPageSlot

• القيم
  BOTTOM_ANCHOR	تنسيق ثابت حيث تلتزِم الخانة بالجزء السفلي من إطار العرض.
  GAME_MANUAL_INTERSTITIAL	شكل الإعلان البيني اليدوي للعبة. ملاحظة: الإعلان البيني اليدوي عن اللعبة هو شكل من أشكال الوصول المحدود.
  INTERSTITIAL	تنسيق تصميم الإعلان البيني على الويب.
  LEFT_SIDE_RAIL	تنسيق شريط جانبي أيسر.
  REWARDED	شكل الإعلان بمكافأة.
  RIGHT_SIDE_RAIL	تنسيق الشريط الجانبي الأيمن.
  TOP_ANCHOR	تنسيق ثابت حيث تلتزم الخانة بالجزء العلوي من إطار العرض

---

googletag.enums.TrafficSource

• مصادر الزيارات المتوافقة مع GPT.

• انظر أيضًا

  • PrivacySettingsConfig.trafficSource

• القيم
  ORGANIC	إدخال عنوان URL مباشر أو بحث في الموقع أو تنزيل تطبيق
  PURCHASED	الزيارات التي تمت إعادة توجيهها من مواقع أخرى غير المواقع المملوكة (الأنشطة المكتسبة أو المحفَّزة بطريقة أخرى)

---

googletag

مساحة الاسم العامة التي تستخدمها علامة "ناشر Google" لواجهة برمجة التطبيقات الخاصة بها

---

googletagCommandArray

تقبل صفيفة الأوامر تسلسل دوال وتستدعيها بالترتيب. والغرض منه هو استبدال صفيف عادي يُستخدَم لإدراج الدوال التي سيتم استدعاؤها بعد تحميل GPT.

---

googletagCompanionAdsService

خدمة الإعلانات المصاحبة. يتم استخدام هذه الخدمة بواسطة إعلانات الفيديو لعرض الإعلانات المصاحبة.

انظر أيضًا

• الإعلانات المصاحبة للفيديو والصوت

---

googletagPrivacySettingsConfig

عنصر ضبط لإعدادات الخصوصية

انظر أيضًا

• ضبط إعدادات الخصوصية

---

googletagPubAdsService

خدمة إعلانات الناشرين: تُستخدم هذه الخدمة لجلب الإعلانات وعرضها من حسابك على "مدير إعلانات Google".

---

googletagResponseInformation

عنصر يمثّل استجابة إعلان واحدة.

انظر أيضًا

• Slot.getResponseInformation

---

googletagRewardedPayload

عنصر يمثّل المكافأة المرتبطة بإعلان بمكافأة

انظر أيضًا

• عرض إعلان يضم مكافأة

---

googletagSafeFrameConfig

كائن ضبط لحاويات SafeFrame

انظر أيضًا

• PubAdsService.setSafeFrameConfig

---

googletagService

فئة الخدمة الأساسية التي تحتوي على طرق شائعة لجميع الخدمات.

---

googletagSizeMappingBuilder

أداة إنشاء عناصر مواصفات ربط المقاسات يتم توفير هذه المنصة للمساعدة في إنشاء مواصفات الحجم بسهولة.

انظر أيضًا

• أحجام الإعلانات: الإعلانات المتجاوبة

---

googletagSlot

الشريحة الإعلانية هي كائن يمثّل شريحة إعلانية واحدة على إحدى الصفحات.

---

googletag.config.AdExpansionConfig

إعدادات للتحكّم في توسيع الإعلان.

مثال

JavaScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

JavaScript (قديم)

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

TypeScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

---

googletag.config.ComponentAuctionConfig

عنصر يمثّل مزادًا مكوّنًا واحدًا في مزاد إعلانات على الجهاز فقط

انظر أيضًا

• دليل البائعين في Protected Audience API: إجراء مزادات الإعلانات

---

googletag.config.InterstitialConfig

كائن يحدد سلوك شريحة إعلانية بينية واحدة.

---

googletag.config.PageSettingsConfig

واجهة الإعداد الرئيسية للإعدادات على مستوى الصفحة.

تتيح ضبط ميزات متعددة باستخدام طلب بيانات واحد من واجهة برمجة التطبيقات.

جميع المواقع الواردة أدناه هي أمثلة ولا تعكس الميزات الفعلية التي تستخدم setConfig. للحصول على مجموعة من الميزات، يمكنك الاطّلاع على الحقول ضمن نوع PageSettingsConfig أدناه.

أمثلة:

• يتم فقط تعديل الميزات المحددة في استدعاء setConfig.

    // Configure feature alpha.
    googletag.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    googletag.setConfig({
       bravo: {...}
    });
  

• يتم تحديث جميع الإعدادات لميزة معينة مع كل طلب إلى setConfig.

    // Configure feature charlie to echo = 1, foxtrot = true.
    googletag.setConfig({
        charlie: {
            echo: 1,
            foxtrot: true,
        }
    });
  
    // Update feature charlie to echo = 2. Since foxtrot was not specified,
    // the value is cleared.
    googletag.setConfig({
        charlie: {
            echo: 2
        }
    });
  

• يمكن محو جميع إعدادات الميزة من خلال ضبط null.

    // Configure features delta, golf, and hotel.
    googletag.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    googletag.setConfig({
        delta: null,
        hotel: null,
    });
  

---

googletag.config.PrivacyTreatmentsConfig

إعدادات للتحكّم في عمليات معالجة خصوصية الناشرين

---

googletag.config.PublisherProvidedSignalsConfig

عنصر إعداد الإشارات المقدَّمة من الناشر (PPS)

مثال

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

JavaScript (قديم)

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

TypeScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

انظر أيضًا

• لمحة عن الإشارات المقدَّمة من الناشر (إصدار تجريبي)
• الإصدار 1.1 من تصنيف الجمهور الصادر عن مكتب IAB
• الإصدار 2.2 من تصنيف المحتوى الصادر عن مكتب IAB

---

googletag.config.SlotSettingsConfig

واجهة الإعداد الرئيسية للإعدادات على مستوى الخانة.

تتيح إعداد ميزات متعددة باستخدام طلب بيانات واحد من واجهة برمجة التطبيقات في خانة واحدة.

جميع المواقع الواردة أدناه هي أمثلة ولا تعكس الميزات الفعلية التي تستخدم setConfig. للاطّلاع على مجموعة الميزات، يمكنك الاطّلاع على الحقول ضمن نوع ScheduleSettingsConfig أدناه.

أمثلة:

• يتم فقط تعديل الميزات المحددة في استدعاء Slot.setConfig.

    const slot = googletag.defineSlot("/1234567/example", [160, 600]);
  
    // Configure feature alpha.
    slot.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    slot.setConfig({
       bravo: {...}
    });
  

• يتم تحديث جميع الإعدادات لميزة معينة مع كل طلب إلى Slot.setConfig.

    // Configure feature charlie to echo = 1, foxtrot = true.
    slot.setConfig({
        charlie: {
            echo: 1,
            foxtrot: true,
        }
    });
  
    // Update feature charlie to echo = 2. Since foxtrot was not specified,
    // the value is cleared.
    slot.setConfig({
        charlie: {
            echo: 2
        }
    });
  

• يمكن محو جميع إعدادات الميزة من خلال ضبط null.

    // Configure features delta, golf, and hotel.
    slot.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    slot.setConfig({
        delta: null,
        hotel: null,
    });
  

---

googletag.config.TaxonomyData

كائن يحتوي على قيم تصنيف واحد.

---

googletag.events.Event

الواجهة الأساسية لجميع أحداث GPT. ستحتوي جميع أحداث GPT أدناه على الحقول التالية.

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.EventTypeMap

وهذا نوع زائفة يربط اسم حدث بنوع كائن الحدث المقابل له في Service.addEventListener وService.removeEventListener. وقد تم توثيقها لأغراض تتعلّق بأمان النوع والإشارة فقط.

---

googletag.events.GameManualInterstitialSlotClosedEvent

يتم تنشيط هذا الحدث عندما يغلق المستخدم خانة بينية يدوية في اللعبة.

ملاحظة: الإعلان البيني اليدوي الخاص باللعبة هو شكل من أشكال الوصول المحدود.

مثال

JavaScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when a game manual interstial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات
• عرض إعلان بيني يدوي للعبة

---

googletag.events.GameManualInterstitialSlotReadyEvent

يتم تنشيط هذا الحدث عندما تكون هناك خانة بينية يدوية في اللعبة تكون جاهزة للعرض للمستخدم.

ملاحظة: الإعلان البيني اليدوي الخاص باللعبة هو شكل من أشكال الوصول المحدود.

مثال

JavaScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

  //Replace with custom logic.
  const displayGmiAd = true;
  if (displayGmiAd) {
    event.makeGameManualInterstitialVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

  //Replace with custom logic.
  var displayGmiAd = true;
  if (displayGmiAd) {
    event.makeGameManualInterstitialVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

  //Replace with custom logic.
  const displayGmiAd = true;
  if (displayGmiAd) {
    event.makeGameManualInterstitialVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات
• عرض إعلان بيني يدوي للعبة

---

googletag.events.ImpressionViewableEvent

يتم تشغيل هذا الحدث عندما تصبح مرة الظهور قابلة للعرض، وفقًا لمعايير العرض النشط.

مثال

JavaScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when an impression becomes viewable.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", function (event) {
  var slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.RewardedSlotClosedEvent

يتم تنشيط هذا الحدث عندما يغلق المستخدم خانة إعلانات تضم مكافأة. قد يتم تنشيطها إما قبل أو بعد منح المكافأة. لتحديد ما إذا تم منح مكافأة، استخدِم events.RewardedSlotGrantedEvent بدلاً من ذلك.

مثال

JavaScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when the user closes a rewarded ad slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات
• عرض إعلان يضم مكافأة

---

googletag.events.RewardedSlotGrantedEvent

يتم تنشيط هذا الحدث عندما يتم منح مكافأة مقابل مشاهدة إعلان بمكافأة. إذا تم إغلاق الإعلان قبل استيفاء معايير منح المكافأة، لن يتم تنشيط هذا الحدث.

مثال

JavaScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called whenever a reward is granted for a
// rewarded ad.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", function (event) {
  var _a, _b;
  var slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", (_a = event.payload) === null || _a === void 0 ? void 0 : _a.type);
  console.log(
    "Reward amount:",
    (_b = event.payload) === null || _b === void 0 ? void 0 : _b.amount
  );
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات
• عرض إعلان يضم مكافأة

---

googletag.events.RewardedSlotReadyEvent

يتم تنشيط هذا الحدث عندما يكون إعلان مكافأة جاهزًا للعرض. فالناشر مسؤول عن تزويد المستخدم بخيار مشاهدة الإعلان قبل عرضه.

مثال

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  var userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات
• عرض إعلان يضم مكافأة

---

googletag.events.SlotOnloadEvent

يتم تنشيط هذا الحدث عندما يطلق إطار iframe لتصميم الإعلان حدث التحميل. عند عرض إعلانات الوسائط الغنية في وضع العرض المتزامن، لا يتم استخدام إطار iframe، وبالتالي لن يتم تنشيط SlotOnloadEvent.

مثال

JavaScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when a creative iframe load event fires.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  var slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotRenderEndedEvent

يتم تنشيط هذا الحدث عند إدخال رمز تصميم الإعلان في خانة. سيحدث هذا الحدث قبل استرجاع موارد تصميم الإعلان، لذا قد لا يكون تصميم الإعلان مرئيًا بعد. إذا كنت تريد معرفة وقت انتهاء تحميل جميع موارد تصميمات الإعلانات لشريحة محدّدة، ننصحك باستخدام events.SlotOnloadEvent بدلاً من ذلك.

مثال

JavaScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when a slot has finished rendering.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", function (event) {
  var slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotRequestedEvent

يتم تنشيط هذا الحدث عندما يتم طلب إعلان لشريحة معيّنة.

مثال

JavaScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", function (event) {
  var slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotResponseReceived

يتم تنشيط هذا الحدث عند تلقي استجابة إعلان لخانة إعلانية معينة.

مثال

JavaScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called when an ad response has been received
// for a slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", function (event) {
  var slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotVisibilityChangedEvent

يتم تنشيط هذا الحدث كلما تغيرت النسبة المئوية على الشاشة لمنطقة الشريحة الإعلانية. يتم تقييد الحدث ولن يتم تنشيطه أكثر من مرة كل 200 ملي ثانية.

مثال

JavaScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (قديم)

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", function (event) {
  var slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", "".concat(event.inViewPercentage, "%"));
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.secureSignals.BidderSignalProvider

تعرِض إشارة آمنة لمقدِّم عرض سعر محدَّد.

يتكوّن موفِّر الإشارات الآمنة لمقدِّم عرض السعر من جزأين:

1. دالة التجميع التي تعرض Promise ويتحوّل إلى إشارة آمنة
2. تمثّل هذه السمة id الذي يحدّد مقدّم عرض السعر المرتبط بالإشارة.

مثال

JavaScript

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (قديم)

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// id is provided
googletag.secureSignalProviders!.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

انظر أيضًا

• مشاركة الإشارات الآمنة مع مقدِّمي عروض الأسعار

---

googletag.secureSignals.PublisherSignalProvider

تعرض إشارة آمنة لناشر محدّد.

يتكوّن مزوّد إشارات الناشر من جزأين:

1. دالة التجميع التي تعرض Promise ويتحوّل إلى إشارة آمنة
2. تمثّل هذه السمة networkCode الذي يعرّف عن الناشر المرتبط بالإشارة.

مثال

JavaScript

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (قديم)

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// networkCode is provided
googletag.secureSignalProviders!.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

انظر أيضًا

• مشاركة الإشارات الآمنة مع مقدِّمي عروض الأسعار

---

googletag.secureSignals.SecureSignalProvidersArray

واجهة لإدارة الإشارات الآمنة