مرجع GPT

این مرجع از نماد TypeScript برای توصیف انواع استفاده می کند. جدول زیر با مثال توضیح مختصری ارائه می دهد.

برای اطلاعات بیشتر در مورد انواع پشتیبانی شده و عبارات نوع، به راهنمای TypeScript مراجعه کنید.

حاشیه نویسی را تایپ کنید

دو نقطه بعد از یک متغیر، نام پارامتر، نام ویژگی یا امضای تابع نشان دهنده یک نوع حاشیه نویسی است. حاشیه نویسی نوع، انواعی را که عنصر در سمت چپ کولون می تواند بپذیرد یا برگرداند، توصیف می کند. جدول زیر نمونه هایی از حاشیه نویسی نوع را نشان می دهد که ممکن است در این مرجع مشاهده کنید.

---

تعاریف را تایپ کنید

انواع Enum

---

googletag . enums . OutOfPageFormat

• فرمت های خارج از صفحه که توسط GPT پشتیبانی می شوند.

• همچنین ببینید

  • defineOutOfPageSlot

• ارزش ها
  BOTTOM_ANCHOR	قالب لنگر که در آن شکاف به پایین درگاه دید می چسبد.
  INTERSTITIAL	قالب خلاق بینابینی وب.
  LEFT_SIDE_RAIL	فرمت ریل سمت چپ.
  REWARDED	قالب پاداش.
  RIGHT_SIDE_RAIL	فرمت ریل سمت راست.
  TOP_ANCHOR	قالب لنگر که در آن شکاف به بالای درگاه دید می چسبد.

---

googletag . enums . TrafficSource

• منابع ترافیک پشتیبانی شده توسط GPT.

• همچنین ببینید

  • PrivacySettingsConfig.trafficSource

• ارزش ها
  ORGANIC	ورود مستقیم URL، جستجوی سایت، یا دانلود برنامه.
  PURCHASED	ترافیک هدایت‌شده از دارایی‌هایی غیر از مالکیت (فعالیت اکتسابی یا مشوق‌های دیگر).

---

googletag

فضای نام جهانی که تگ Google Publisher برای API خود استفاده می کند.

---

googletag . CommandArray

آرایه فرمان دنباله ای از توابع را می پذیرد و آنها را به ترتیب فراخوانی می کند. در نظر گرفته شده است که جایگزین یک آرایه استاندارد شود که برای قرار دادن توابع در صف قرار دادن به محض بارگذاری GPT استفاده می شود.

---

googletag . CompanionAdsService

سرویس تبلیغات همراه. این سرویس توسط تبلیغات ویدیویی برای نمایش تبلیغات همراه استفاده می شود.

همچنین ببینید

• تبلیغات همراه برای ویدیو و صدا

---

googletag . PrivacySettingsConfig

شی پیکربندی برای تنظیمات حریم خصوصی.

همچنین ببینید

• تنظیمات حریم خصوصی را پیکربندی کنید

---

googletag . PubAdsService

سرویس تبلیغات ناشر. این سرویس برای واکشی و نمایش تبلیغات از حساب Google Ad Manager شما استفاده می شود.

---

googletag . ResponseInformation

شیئی که نشان دهنده یک پاسخ آگهی واحد است.

همچنین ببینید

• Slot.getResponseInformation

---

googletag . RewardedPayload

شیئی که نشان دهنده پاداش مرتبط با یک تبلیغ پاداش است

همچنین ببینید

• نمایش یک تبلیغ با پاداش

---

googletag . SafeFrameConfig

شیء پیکربندی برای ظروف SafeFrame .

همچنین ببینید

• PubAdsService.setSafeFrameConfig

---

googletag . Service

کلاس سرویس پایه که شامل متدهای مشترک برای همه سرویس ها است.

---

googletag . SizeMappingBuilder

سازنده برای اشیاء مشخصات نقشه برداری اندازه. این سازنده برای کمک به ساخت آسان مشخصات اندازه ارائه شده است.

همچنین ببینید

• اندازه تبلیغات: تبلیغات واکنش گرا

---

googletag . Slot

Slot یک شی است که نشان دهنده یک جایگاه آگهی در یک صفحه است.

---

googletag . config . AdExpansionConfig

تنظیمات برای کنترل گسترش تبلیغات.

مثال

جاوا اسکریپت

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

جاوا اسکریپت (میراث)

// 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

شیئی که حراج یک جزء را در یک حراج تبلیغاتی روی دستگاه نشان می دهد.

همچنین ببینید

• راهنمای فروشنده API مخاطب محافظت شده: حراج های تبلیغاتی را اجرا کنید

---

googletag . config . InterstitialConfig

شیئی که رفتار یک جایگاه آگهی بینابینی را مشخص می کند.

---

googletag . config . PageSettingsConfig

رابط پیکربندی اصلی برای تنظیمات سطح صفحه.

به تنظیم چندین ویژگی با یک تماس API اجازه می دهد.

تمام ویژگی های فهرست شده در زیر نمونه هستند و ویژگی های واقعی که از 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).

مثال

جاوا اسکریپت

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'
    },
  },
});

جاوا اسکریپت (میراث)

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'
    },
  },
});

همچنین ببینید

• درباره سیگنال های ارائه شده توسط ناشر (بتا)
• طبقه بندی مخاطب IAB 1.1
• طبقه بندی محتوای IAB 2.2

---

googletag . config . SlotSettingsConfig

رابط پیکربندی اصلی برای تنظیمات سطح اسلات.

به تنظیم چندین ویژگی با یک تماس API برای یک اسلات اجازه می دهد.

تمام ویژگی های فهرست شده در زیر نمونه هستند و ویژگی های واقعی که از setConfig استفاده می کنند را منعکس نمی کنند. برای مجموعه ویژگی‌ها، فیلدهای نوع SlotSettingsConfig را در زیر ببینید.

مثال ها:

• فقط ویژگی های مشخص شده در تماس 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 . ImpressionViewableEvent

این رویداد زمانی فعال می‌شود که یک نمایش بر اساس معیارهای نمای فعال قابل مشاهده باشد.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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 استفاده کنید.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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

این رویداد زمانی فعال می شود که برای مشاهده یک تبلیغ دارای پاداش، جایزه اعطا شود. اگر آگهی قبل از رعایت معیارهای اعطای جایزه بسته شود، این رویداد فعال نمی شود.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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

این رویداد زمانی فعال می شود که یک تبلیغ پاداش آماده نمایش باشد. ناشر موظف است گزینه ای را برای مشاهده آگهی قبل از نمایش به کاربر ارائه دهد.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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 اجرا نمی شود.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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 در نظر بگیرید.SlotOnloadEvent.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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

این رویداد زمانی فعال می شود که تبلیغی برای یک جایگاه خاص درخواست شده باشد.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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

این رویداد زمانی فعال می شود که یک پاسخ آگهی برای یک اسلات خاص دریافت شده باشد.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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 میلی‌ثانیه شلیک نمی‌شود.

مثال

جاوا اسکریپت

// 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.
  }
});

جاوا اسکریپت (میراث)

// 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

سیگنال ایمن را برای یک پیشنهاد دهنده خاص برمی گرداند.

ارائه‌دهنده سیگنال امن مناقصه از 2 بخش تشکیل شده است:

1. یک تابع جمع کننده، که یک Promise برمی گرداند که به یک سیگنال ایمن حل می شود.
2. id که پیشنهاد دهنده مرتبط با سیگنال را مشخص می کند.

مثال

جاوا اسکریپت

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

جاوا اسکریپت (میراث)

// 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

سیگنال ایمن را برای یک ناشر خاص برمی گرداند.

یک ارائه دهنده سیگنال ناشر از 2 بخش تشکیل شده است:

1. یک تابع جمع کننده، که یک Promise برمی گرداند که به یک سیگنال ایمن حل می شود.
2. یک networkCode که ناشر مرتبط با سیگنال را شناسایی می کند.

مثال

جاوا اسکریپت

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

جاوا اسکریپت (میراث)

// 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

یک رابط برای مدیریت سیگنال های امن.