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

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

كتابة التعبير
string نوع السلسلة الأساسية
string[] نوع مصفوفة، حيث يمكن أن تكون القيم سلاسل فقط.
number | string نوع موحّد، حيث يمكن أن تكون القيمة رقمًا أو سلسلة.
Array<number | string> نوع صفيف، حيث تكون القيم من النوع المركّب (اتحاد).
[number, string] نوع مجموعة، حيث تكون القيمة صفيفًا مكوّنًا من عنصرَين يجب أن يحتويَا على رقم وسلسلة بهذا الترتيب.
Slot نوع عنصر، حيث تكون القيمة مثيلًا من googletag.Slot.
() => void نوع دالة بدون وسيطات محدّدة وبدون قيمة عرض

لمزيد من المعلومات حول الأنواع وتعبيرات الأنواع المتوافقة، يُرجى الرجوع إلى دليل TypeScript .

التعليقات التوضيحية للأنواع

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

نوع التعليق التوضيحي
param: string يشير إلى أنّ param يقبل قيمة سلسلة أو يعرضها. تُستخدَم هذه البنية للمتغيّرات والمَعلمات والسمات وأنواع النتائج.
param?: number | string تشير إلى أنّ param اختياري، ولكنّه يقبل رقمًا أو سلسلة عند تحديده. تُستخدَم هذه البنية للمَعلمات والمواقع.
...params: Array<() => void> يشير إلى أنّ params هو مَعلمة rest تقبل الدوالّ. تقبل مَعلمات Rest عددًا غير محدود من قيم النوع المحدّد.

googletag

مساحة الاسم الشاملة التي تستخدِمها علامة الناشر من Google لواجهة برمجة التطبيقات
مساحات الاسم
config
واجهة الضبط الرئيسية للإعدادات على مستوى الصفحة
enums
هذه هي مساحة الاسم التي يستخدمها GPT لأنواع التعداد.
events
هذه هي مساحة الاسم التي يستخدمها نموذج GPT للأحداث.
secureSignals
هذه هي مساحة الاسم التي يستخدمها GPT لإدارة الإشارات الآمنة.
واجهات
CommandArray
يقبل صفيف الأوامر تسلسلاً من الدوالّ ويشغّلها بالترتيب.
CompanionAdsService
خدمة الإعلانات المصاحبة
PrivacySettingsConfig
عنصر الضبط لإعدادات الخصوصية
PubAdsService
خدمة "إعلانات الناشر"
ResponseInformation
عنصر يمثّل استجابة إعلان واحدة
RewardedPayload
عنصر يمثّل المكافأة المرتبطة بإعلان يضم مكافأة
SafeFrameConfig
عنصر الإعداد لحاويات SafeFrame
Service
فئة الخدمة الأساسية التي تحتوي على طرق شائعة لجميع الخدمات
SizeMappingBuilder
أداة إنشاء لعناصر مواصفات تعيين الحجم
Slot
خانة العرض هي عنصر يمثّل خانة إعلان واحدة على الصفحة.
الأسماء البديلة للبريد الإلكتروني
GeneralSize
إعداد حجم صالح لفتحة، ويمكن أن يكون حجمًا واحدًا أو أحجامًا متعددة.
MultiSize
قائمة بالأحجام الصالحة الفردية
NamedSize
الأحجام المُعنوَنة التي يمكن أن تتضمّنها خانة
SingleSize
حجم واحد صالح لخانة
SingleSizeArray
صفيف من رقمين يمثّلان [width, height]
SizeMapping
تعيين حجم إطار العرض إلى أحجام الإعلانات
SizeMappingArray
قائمة بعمليات ربط الأحجام
المتغيّرات
apiReady
علامة تشير إلى أنّه تم تحميل واجهة برمجة التطبيقات GPT API وأنّها جاهزة للاستخدام
cmd
إشارة إلى قائمة الانتظار العامة للأوامر لتنفيذ المكالمات ذات الصلة بعلامة "ناشر Google" بشكل غير متزامن
pubadsReady
علامة تشير إلى أنّ PubAdsService مفعَّل ومُحمَّل ويعمل بكامل طاقته
secureSignalProviders
إشارة إلى صفيف مقدّمي الإشارات الآمنة
الدوال
companionAds
لعرض مرجع إلى CompanionAdsService.
defineOutOfPageSlot
تُنشئ هذه الوظيفة خانة إعلان خارج الصفحة باستخدام مسار الوحدة الإعلانية المحدّد.
defineSlot
تُنشئ خانة إعلان باستخدام مسار وحدة إعلانية وحجم معيّنَين وتربطها برقم تعريف عنصر div على الصفحة التي ستحتوي على الإعلان.
destroySlots
يؤدي هذا الإجراء إلى تدمير الفتحات المحدّدة، وإزالة جميع العناصر والمراجع المرتبطة بهذه الفتحات من GPT.
disablePublisherConsole
إيقاف "وحدة تحكّم الناشر في Google"
display
يوجّه خدمات الفتحات إلى عرض الفتحة.
enableServices
تفعِّل هذه السمة جميع خدمات GPT التي تم تحديدها لمواضع الإعلانات على الصفحة.
getVersion
لعرض الإصدار الحالي من GPT.
openConsole
يؤدي هذا الإجراء إلى فتح "وحدة تحكّم الناشر" من Google.
pubads
لعرض مرجع إلى PubAdsService.
setAdIframeTitle
تُستخدَم لضبط عنوان جميع إطارات iframe لحاويات الإعلانات التي أنشأها PubAdsService، من هذه النقطة فصاعدًا.
setConfig
لضبط خيارات الإعداد العامة للصفحة.
sizeMapping
لإنشاء SizeMappingBuilder جديد.

الأسماء البديلة للبريد الإلكتروني

GeneralSize

GeneralSize: SingleSize | MultiSize
إعداد حجم صالح لفتحة، ويمكن أن يكون حجمًا واحدًا أو أحجامًا متعددة.

MultiSize

MultiSize: SingleSize[]
قائمة بالأحجام الصالحة الفردية

NamedSize

NamedSize: "fluid" | ["fluid"]
الأحجام المُعنوَنة التي يمكن أن تتضمّنها خانة في معظم الحالات، يكون الحجم مستطيلاً بحجم ثابت، ولكن هناك بعض الحالات التي نحتاج فيها إلى أنواع أخرى من مواصفات الحجم. في ما يلي الأحجام المُسمّاة الصالحة فقط:
  • سائل: تأخذ حاوية الإعلان عرض div الرئيسي بالكامل، ثمّ تعيد ضبط ارتفاعها ليناسب محتوى تصميم الإعلان. تشبه طريقة تصرف عناصر الكتل العادية على الصفحة. تُستخدَم للإعلانات المدمجة مع المحتوى (اطّلِع على المقالة ذات الصلة). يُرجى العِلم أنّ كلاً من fluid و['fluid'] هما شكلان مقبولان للإشارة إلى أنّ حجم خانة الإعلان متغير.

SingleSize

حجم واحد صالح لخانة

SingleSizeArray

SingleSizeArray: [number, number]
صفيف من رقمين يمثّلان [width, height]

SizeMapping

تعيين حجم إطار العرض إلى أحجام الإعلانات تُستخدَم للإعلانات المتجاوبة.

SizeMappingArray

SizeMappingArray: SizeMapping[]
قائمة بعمليات ربط الأحجام

المتغيّرات

Const apiReady

apiReady: boolean | undefined
علامة تشير إلى أنّه تم تحميل واجهة برمجة التطبيقات GPT API وأنّها جاهزة للاستخدام سيكون هذا المَعلمة ببساطة undefined إلى أن تصبح واجهة برمجة التطبيقات جاهزة.

يُرجى العلم أنّ الطريقة المُقترَحة للتعامل مع المهام غير المتزامنة هي استخدام googletag.cmd لإدراج طلبات الاستدعاء في قائمة الانتظار إلى أن تصبح علامة GPT جاهزة. ولا يلزم أن تتحقّق هذه الطلبات المُعاد الاتصال بها من googletag.apiReady لأنّه من المؤكد أن يتم تنفيذها بعد إعداد واجهة برمجة التطبيقات.

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray
إشارة إلى قائمة الانتظار الشاملة للأوامر لتنفيذ طلبات ذات صلة بعلامة "ناشر Google" بشكل غير متزامن.

يتمّ إعداد المتغيّر googletag.cmd على أنّه صفيف JavaScript فارغ من خلال بنية علامة "ناشر Google" على الصفحة، وcmd.push هي طريقة Array.push العادية التي تضيف عنصرًا إلى نهاية الصفيف. عند تحميل JavaScript في GPT، يبحث في الصفيف وينفّذ جميع الدوالّ بالترتيب. بعد ذلك، يستبدل النص البرمجي cmd بكائن CommandArray تم تحديد طريقة push له لتنفيذ وسيطة الدالة التي تم تمريرها إليه. تسمح هذه الآلية لعلامة GPT بتقليل وقت الاستجابة المُلاحظ من خلال جلب JavaScript بشكل غير متزامن مع السماح للمتصفّح بمواصلة عرض الصفحة.
مثال

JavaScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

JavaScript (الإصدار القديم)

googletag.cmd.push(function () {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

TypeScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
});

Const pubadsReady

pubadsReady: boolean | undefined
علامة تشير إلى أنّ PubAdsService مفعَّل ومُحمَّل ويعمل بكامل طاقته سيكون هذا المَعلمة undefined إلى أن يتمّ استدعاء enableServices وتحميل PubAdsService وإعداده.

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined
إشارة إلى صفيف مقدّمي الإشارات الآمنة.

يقبل صفيف مقدّمي الإشارات الآمنة تسلسلًا من دوالّ إنشاء الإشارات ويشغّلها بالترتيب. ويهدف إلى استبدال صفيف عادي يُستخدَم لإضافة دوالّ إنشاء الإشارات إلى "قائمة الانتظار" ليتمّ استدعاؤها بعد تحميل علامة GPT.
مثال

JavaScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});

JavaScript (الإصدار القديم)

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    return Promise.resolve("signal");
  },
});

TypeScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});
انظر أيضًا

الدوال

companionAds

companionAds(): CompanionAdsService
لعرض مرجع إلى CompanionAdsService.
المرتجعات
CompanionAdsServiceخدمة الإعلانات المصاحبة

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
تُنشئ هذه الدالة خانة إعلان خارج الصفحة باستخدام مسار الوحدة الإعلانية المحدّد.

بالنسبة إلى الإعلانات المخصّصة خارج الصفحة، يكون div هو رقم تعريف عنصر div الذي سيحتوي على الإعلان. اطّلِع على المقالة حول مواد العرض خارج الصفحة لمعرفة المزيد من التفاصيل.

بالنسبة إلى الإعلانات خارج الصفحة التي تديرها علامة "ناشر Google"‏ (GPT)، يُعدّ div OutOfPageFormat متوافقًا.
مثال

JavaScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

JavaScript (الإصدار القديم)

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

TypeScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
انظر أيضًا
المعلمات
adUnitPath: stringمسار الوحدة الإعلانية الكامل مع رمز الشبكة ورمز الوحدة الإعلانية
Optional div: string | OutOfPageFormatرقم تعريف div الذي سيحتوي على هذه الوحدة الإعلانية أو OutOfPageFormat
المرتجعات
Slot | nullخانة المواعيد التي تم إنشاؤها حديثًا، أو null إذا تعذّر إنشاء خانة مواعيد

defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null
تُنشئ هذه الوظيفة خانة إعلان باستخدام مسار وحدة إعلانية وحجم معيّنَين وتربطها برقم تعريف عنصر div على الصفحة التي ستحتوي على الإعلان.
مثال

JavaScript

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");

JavaScript (الإصدار القديم)

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");

TypeScript

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
انظر أيضًا
المعلمات
adUnitPath: stringمسار الوحدة الإعلانية الكامل مع رمز الشبكة ورمز الوحدة
size: GeneralSizeعرض وارتفاع الفتحة المُضافة هذا هو الحجم المستخدَم في طلب الإعلان في حال عدم توفّر تعيين حجم متوافق مع مختلف الأجهزة أو كان حجم إطار العرض أصغر من أصغر حجم متوفر في التعيين.
Optional div: stringرقم تعريف القسم الذي سيحتوي على هذه الوحدة الإعلانية.
المرتجعات
Slot | nullخانة المواعيد التي تم إنشاؤها حديثًا، أو null إذا تعذّر إنشاء خانة مواعيد

destroySlots

destroySlots(slots?: Slot[]): boolean
يؤدي هذا الإجراء إلى تدمير الفتحات المحدّدة، وإزالة جميع العناصر والمراجع المرتبطة بهذه الفتحات من GPT. لا تتوافق واجهة برمجة التطبيقات هذه مع خانات تسجيل الإحالات الناجحة و"الخانات المصاحبة".

عند طلب هذه الواجهة في خانة، يتم محو الإعلان وإزالة عنصر الخانة من الحالة الداخلية التي تحافظ عليها وحدات معالجة الإعلانات (GPT). سيؤدي استدعاء أيّ دوال أخرى على عنصر الفتحة إلى سلوك غير محدّد. يُرجى العِلم أنّ المتصفّح قد لا يُفرِّغ الذاكرة المرتبطة بهذه الفتحة إذا كانت صفحة الناشر تحتفظ بإشارة إليها. يؤدي استدعاء واجهة برمجة التطبيقات هذه إلى إتاحة div المرتبط بهذه الفتحة لإعادة الاستخدام.

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

JavaScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();

JavaScript (الإصدار القديم)

// The calls to construct an ad and display contents.
var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();

TypeScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();
المعلمات
Optional slots: Slot[]صفيف الفتحات المطلوب إزالتها الصفيف اختياري، وسيتم إتلاف جميع الفتحات في حال عدم تحديده.
المرتجعات
booleantrue إذا تمّت إزالة الفتحات، false بخلاف ذلك.

disablePublisherConsole

disablePublisherConsole(): void
إيقاف "وحدة تحكّم الناشر في Google"
انظر أيضًا

display

display(divOrSlot: string | Element | Slot): void
يوجّه خدمات الفتحات إلى عرض الفتحة. يجب عرض كل خانة إعلان مرّة واحدة فقط في كل صفحة. يجب تحديد جميع الفتحات وربطها بخدمة قبل عرضها. يجب ألا يتمّ عرض المكالمة إلّا بعد توفّر العنصر في DOM. الطريقة المعتادة لتحقيق ذلك هي وضعها ضمن كتلة نص برمجي داخل عنصر div الذي تم تسميته في استدعاء الطريقة.

في حال استخدام بنية الطلب الفردي (SRA)، سيتمّ جلب جميع المساحات الإعلانية غير التي تمّ جلبها في وقت استدعاء هذه الطريقة دفعةً واحدة. لمنع عرض خانة إعلان معيّنة، يجب إزالة div بالكامل.
انظر أيضًا
المعلمات
divOrSlot: string | Element | Slotإما معرّف عنصر div الذي يحتوي على خانة الإعلان أو عنصر div أو عنصر خانة الإعلان. في حال تقديم عنصر div، يجب أن يتضمّن سمة id تتطابق مع المعرّف الذي تم تمريره إلى defineSlot.

enableServices

enableServices(): void
تفعِّل هذه السمة جميع خدمات GPT التي تم تحديدها لمواضع الإعلانات على الصفحة.

getVersion

getVersion(): string
تعرِض هذه السمة الإصدار الحالي من علامة ناشر Google‏ (GPT).
انظر أيضًا
المرتجعات
stringسلسلة إصدار GPT التي يتم تنفيذها حاليًا.

openConsole

openConsole(div?: string): void
يؤدي هذا الإجراء إلى فتح "وحدة تحكّم الناشر" من Google.
مثال

JavaScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

JavaScript (الإصدار القديم)

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

TypeScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();
انظر أيضًا
المعلمات
Optional div: stringرقم تعريف div للّوحة الإعلانية هذه القيمة اختيارية. عند توفّر هذا الخيار، ستحاول "وحدة تحكّم الناشر" فتح تفاصيل مساحة الإعلان المحدّدة في العرض.

pubads

pubads(): PubAdsService
لعرض مرجع إلى PubAdsService.
المرتجعات
PubAdsServiceخدمة "إعلانات الناشر"

setAdIframeTitle

setAdIframeTitle(title: string): void
تُستخدَم لضبط عنوان جميع إطارات iframe لحاويات الإعلانات التي أنشأها PubAdsService، من هذه النقطة فصاعدًا.
مثال

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (الإصدار القديم)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");
المعلمات
title: stringالعنوان الجديد لجميع إطارات iframe لحاويات الإعلانات

setConfig

setConfig(config: PageSettingsConfig): void
لضبط خيارات الإعداد العامة للصفحة
المعلمات
config: PageSettingsConfig

sizeMapping

sizeMapping(): SizeMappingBuilder
لإنشاء SizeMappingBuilder جديد.
انظر أيضًا
المرتجعات
SizeMappingBuilderأداة إنشاء جديدة

googletag.CommandArray

يقبل صفيف الأوامر تسلسلاً من الدوالّ ويشغّلها بالترتيب. ويهدف إلى استبدال صفيف عادي يُستخدَم لإضافة الدوال إلى قائمة الانتظار ليتمّ استدعاؤها بعد تحميل علامة GPT.
الطُرق
push
تُنفِّذ تسلسل الدوالّ المحدّدة في الوسيطات بالترتيب.

الطُرق

الدفع

push(...f: ((this: typeof globalThis) => void)[]): number
تُنفِّذ تسلسل الدوالّ المحدّدة في الوسيطات بالترتيب.
مثال

JavaScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

JavaScript (الإصدار القديم)

googletag.cmd.push(function () {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

TypeScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
});
المعلمات
Rest ...f: ((this: typeof globalThis) => void)[]دالة JavaScript المطلوب تنفيذها سيكون الربط أثناء التشغيل دائمًا globalThis. ننصحك بتمرير دالة سهمية للاحتفاظ بقيمة this للسياق المعجمي المحيط.
المرتجعات
numberعدد الأوامر التي تمت معالجتها حتى الآن. وهذا متوافق مع القيمة المعروضة في Array.push (الطول الحالي للصفيف).

googletag.CompanionAdsService

تتمديد Service
خدمة الإعلانات المصاحبة وتستخدم إعلانات الفيديو هذه الخدمة لعرض إعلانات مصاحبة.
الطُرق
addEventListener
تسجِّل أداة معالجة الأحداث هذه مستمعًا يسمح لك بإعداد وظيفة JavaScript واستدعاؤها عند حدوث حدث GPT معيّن على الصفحة.
getSlots
الحصول على قائمة الفتحات المرتبطة بهذه الخدمة
removeEventListener
تزيل هذه الطريقة مستمعًا مسجَّلاً في السابق.
setRefreshUnfilledSlots
لتحديد ما إذا كان سيتم تلقائيًا ملء خانات الإعلانات المصاحبة التي لم يتم ملؤها.
انظر أيضًا

الطُرق

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void
لضبط ما إذا كان سيتم تلقائيًا إضافة بيانات سابقة إلى الفتحات الإعلانية المصاحبة التي لم يتم ملؤها.

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

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (الإصدار القديم)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);
المعلمات
value: booleantrue لإعادة ملء الفتحات غير المملوءة تلقائيًا، false لتركها بدون تغيير

googletag.PrivacySettingsConfig

عنصر الضبط لإعدادات الخصوصية
الخصائص
childDirectedTreatment?
limitedAds?
يتيح هذا الخيار عرض الإعلانات في وضع الإعلانات المحدودة للمساعدة في تلبية احتياجات الناشر المتعلقة بالامتثال التنظيمي.
nonPersonalizedAds?
يتيح هذا الخيار عرض الإعلانات في وضع الإعلانات غير المخصّصة للمساعدة في تلبية احتياجات الناشر في ما يتعلّق بالامتثال للّوائح التنظيمية.
restrictDataProcessing?
يتيح هذا الخيار عرض الإعلانات في وضع المعالجة المحدود للمساعدة في تلبية احتياجات الناشر المتعلقة بالامتثال التنظيمي.
trafficSource?
يشير إلى ما إذا كانت الطلبات تمثّل زيارات مدفوعة أو زيارات مجانية.
underAgeOfConsent?
يشير ذلك إلى ما إذا كان يجب وضع علامة على طلبات الإعلانات على أنّها واردة من مستخدمين دون سن الرشد.
انظر أيضًا

الخصائص

Optional childDirectedTreatment

childDirectedTreatment?: null | boolean
تشير إلى ما إذا كان يجب التعامل مع الصفحة على أنّها موجّهة إلى الأطفال. اضبط القيمة على null لمحو الإعدادات.

Optional limitedAds

limitedAds?: boolean
يتيح هذا الخيار عرض الإعلانات في وضع الإعلانات المحدودة للمساعدة في تلبية متطلبات الامتثال التنظيمي للناشر.

يمكنك توجيه GPT لطلب إعلانات محدودة بطريقتَين: لا يمكن ضبط الإعلانات المحدودة يدويًا إلا عند تحميل GPT من عنوان URL للإعلانات المحدودة. سيؤدي محاولة تعديل هذا الإعداد عند تحميل علامة GPT من عنوان URL العادي إلى ظهور تحذير في "وحدة تحكّم الناشر".

يُرجى العلم أنّه ليس من الضروري تفعيل الإعلانات المحدود يدويًا عند استخدام منصّة إدارة موافقة.
مثال

JavaScript

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

JavaScript (الإصدار القديم)

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

TypeScript

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});
انظر أيضًا

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean
يتيح هذا الخيار عرض الإعلانات في وضع الإعلانات غير المخصّصة للمساعدة في تلبية احتياجات الناشر في ما يتعلّق بالامتثال للّوائح التنظيمية.

Optional restrictDataProcessing

restrictDataProcessing?: boolean
يتيح هذا الخيار عرض الإعلانات في وضع المعالجة المحدود للمساعدة في تلبية احتياجات الناشر المتعلقة بالامتثال التنظيمي.

Optional trafficSource

trafficSource?: TrafficSource
يشير إلى ما إذا كانت الطلبات تمثّل زيارات مدفوعة أو زيارات مجانية. تملأ هذه القيمة سمة مصدر الزيارات في تقارير "مدير إعلانات Google". في حال عدم ضبط مصدر الزيارات، يتم ضبطه تلقائيًا على undefined في التقارير.
مثال

JavaScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

JavaScript (الإصدار القديم)

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

TypeScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

Optional underAgeOfConsent

underAgeOfConsent?: null | boolean
يشير ذلك إلى ما إذا كان يجب وضع علامة على طلبات الإعلانات على أنّها واردة من مستخدمين دون سن الرشد. اضبط القيمة على null لمحو الإعدادات.

googletag.PubAdsService

تتمديد Service
خدمة "إعلانات الناشر" تُستخدَم هذه الخدمة لجلب الإعلانات وعرضها من حسابك على "مدير إعلانات Google".
الطُرق
addEventListener
تسجِّل أداة معالجة الأحداث هذه مستمعًا يسمح لك بإعداد وظيفة JavaScript واستدعاؤها عند حدوث حدث GPT معيّن على الصفحة.
clear
تزيل الإعلانات من الفتحات المحدّدة وتستبدلها بمحتوى فارغ.
clearCategoryExclusions
تمحو هذه السمة جميع تصنيفات استبعاد فئات الإعلانات على مستوى الصفحة.
clearTargeting
يؤدي هذا الإجراء إلى محو مَعلمات الاستهداف المخصّصة لمفتاح معيّن أو لجميع المفاتيح.
collapseEmptyDivs
يتيح هذا الخيار تصغير divs للّقطات كي لا تشغل أي مساحة على الصفحة عندما لا يكون هناك محتوى إعلاني لعرضه.
disableInitialLoad
يوقف هذا الخيار طلبات الإعلانات عند تحميل الصفحة، ولكنه يسمح بطلب الإعلانات من خلال طلب PubAdsService.refresh.
display
تُنشئ هذه الدالة خانة إعلانية وتعرضها باستخدام مسار الوحدة الإعلانية وحجمها المحدّدَين.
enableLazyLoad
تفعِّل ميزة "التحميل البطيء" في GPT كما هو محدّد في كائن config.
enableSingleRequest
تفعيل وضع الطلب الفردي لجلب إعلانات متعددة في الوقت نفسه
enableVideoAds
إشارات إلى علامة Google Publisher Tag (GPT) بأنّ إعلانات الفيديو ستظهر على الصفحة
get
تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد.
getAttributeKeys
تعرِض مفاتيح السمات التي تم ضبطها على هذه الخدمة.
getSlots
الحصول على قائمة الفتحات المرتبطة بهذه الخدمة
getTargeting
تعرِض هذه السمة مَعلمة استهداف مخصّصة محدّدة على مستوى الخدمة تمّ ضبطها.
getTargetingKeys
تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة على مستوى الخدمة التي تمّ ضبطها.
isInitialLoadDisabled
تُرجع ما إذا تم إيقاف الطلبات الأولية للإعلانات بنجاح من خلال طلب سابق من PubAdsService.disableInitialLoad أم لا.
refresh
تُستخدَم هذه الوظيفة لجلب إعلانات جديدة وعرضها في خانات معيّنة أو جميع الخانات على الصفحة.
removeEventListener
تزيل مستمعًا مسجَّلاً في السابق.
set
تُستخدَم لضبط قيم لسمات AdSense التي تنطبق على جميع خانات الإعلانات ضمن خدمة "إعلانات الناشر".
setCategoryExclusion
تُستخدَم لضبط استبعاد فئة إعلان على مستوى الصفحة لاسم التصنيف المحدّد.
setCentering
تفعيل وضع الإعلانات في الوسط أفقيًا وإيقافه
setForceSafeFrame
لضبط ما إذا كان يجب فرض عرض جميع الإعلانات على الصفحة باستخدام حاوية SafeFrame
setLocation
تمرير معلومات الموقع الجغرافي من المواقع الإلكترونية حتى تتمكّن من استهداف المواقع الجغرافية للعناصر على مستوى الموقع الجغرافي إلى مواقع جغرافية معيّنة
setPrivacySettings
يتيح ضبط جميع إعدادات الخصوصية من واجهة برمجة تطبيقات واحدة باستخدام عنصر إعدادات.
setPublisherProvidedId
لضبط قيمة المعرّف الذي يوفّره الناشر
setSafeFrameConfig
تُستخدَم لضبط الإعدادات المفضّلة على مستوى الصفحة لإعدادات SafeFrame.
setTargeting
تُستخدَم لضبط مَعلمات استهداف مخصّصة لمفتاح معيّن تنطبق على جميع خانات الإعلانات في خدمة "إعلانات الناشر".
setVideoContent
لضبط معلومات محتوى الفيديو المطلوب إرسالها مع طلبات الإعلانات لأغراض الاستهداف واستبعاد المحتوى
updateCorrelator
يغيّر هذا المقياس المرتبط الذي يتم إرساله مع طلبات الإعلانات، ما يؤدي إلى بدء مشاهدة صفحة جديدة بشكل فعّال.

الطُرق

محو

clear(slots?: Slot[]): boolean
تزيل الإعلانات من الفتحات المحدّدة وتستبدلها بمحتوى فارغ. سيتم وضع علامة على الفتحات على أنّها لم يتم جلبها.

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

JavaScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();

JavaScript (الإصدار القديم)

var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();

TypeScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();
المعلمات
Optional slots: Slot[]صفيف الفتحات المطلوب محوها الصفيف اختياري، وسيتم محو جميع الفتحات في حال عدم تحديده.
المرتجعات
booleanتعرِض القيمة true إذا تم محو الفتحات، وfalse في الحالات الأخرى.

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService
تمحو هذه السمة جميع تصنيفات استبعاد فئات الإعلانات على مستوى الصفحة. يكون هذا الإجراء مفيدًا إذا كنت تريد إعادة تحميل البيانات في الخانة.
مثال

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.

JavaScript (الإصدار القديم)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.
انظر أيضًا
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

clearTargeting

clearTargeting(key?: string): PubAdsService
يؤدي هذا الإجراء إلى محو مَعلمات الاستهداف المخصّصة لمفتاح معيّن أو لجميع المفاتيح.
مثال

JavaScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

JavaScript (الإصدار القديم)

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

TypeScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.
انظر أيضًا
المعلمات
Optional key: stringمفتاح مَعلمة الاستهداف المفتاح اختياري، وسيتم محو جميع مَعلمات الاستهداف في حال عدم تحديده.
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
يتيح هذا الخيار تصغير divs المساحة بحيث لا تشغل أي مساحة على الصفحة عندما لا يكون هناك محتوى إعلاني لعرضه. يجب ضبط هذا الوضع قبل تفعيل الخدمة.
انظر أيضًا
المعلمات
Optional collapseBeforeAdFetch: booleanما إذا كان سيتم تصغير الفتحات حتى قبل جلب الإعلانات هذه المَعلمة اختيارية، وفي حال عدم تقديمها، سيتم استخدام false كقيمة تلقائية.
المرتجعات
booleanتعرِض هذه الطريقة القيمة true إذا كان وضع تصغير div مفعّلاً والقيمة false إذا كان من المستحيل تفعيل وضع التصغير لأنّه تمّ استدعاء الطريقة بعد تفعيل الخدمة.

disableInitialLoad

disableInitialLoad(): void
يوقف هذا الخيار طلبات الإعلانات عند تحميل الصفحة، ولكنه يسمح بطلب الإعلانات من خلال طلب PubAdsService.refresh. يجب ضبط هذا الإعداد قبل تفعيل الخدمة. يجب استخدام الوضع غير المتزامن، وإلا سيكون من المستحيل طلب الإعلانات باستخدام refresh.
انظر أيضًا

display

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
تُنشئ هذه الدالة خانة إعلانية وتعرضها باستخدام مسار الوحدة الإعلانية وحجمها المحدّدَين. لا تعمل هذه الطريقة مع وضع الطلب الواحد.

ملاحظة: عند استدعاء هذه الطريقة، يتم إنشاء لقطة شاشة للمساحة وحالة الصفحة لضمان الاتساق عند إرسال طلب الإعلان وعرض الاستجابة. إنّ أي تغييرات يتم إجراؤها على الفتحة أو حالة الصفحة بعد استدعاء هذه الطريقة (بما في ذلك الاستهداف وإعدادات الخصوصية وفرض SafeFrame وما إلى ذلك) لن تسري إلا على طلبات display() أو refresh() اللاحقة.
مثال

JavaScript

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");

JavaScript (الإصدار القديم)

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");

TypeScript

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
انظر أيضًا
المعلمات
adUnitPath: stringمسار الوحدة الإعلانية للمساحة التي سيتم عرضها.
size: GeneralSizeعرض الفتحة وارتفاعها
Optional div: string | Elementإما رقم تعريف div الذي يحتوي على الفتحة أو عنصر div نفسه.
Optional clickUrl: stringعنوان URL الذي يتم النقر عليه لاستخدامه في هذه الفتحة

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void
تفعِّل ميزة "التحميل البطيء" في GPT كما هو محدّد في كائن config. للحصول على أمثلة أكثر تفصيلاً، اطّلِع على نموذج التحميل الكسول.

ملاحظة: لا يعمل التحميل الكسول في SRA إلا إذا كانت جميع الفتحات خارج هامش الجلب.
مثال

JavaScript

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});

JavaScript (الإصدار القديم)

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});

TypeScript

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});
انظر أيضًا
المعلمات
Optional config: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}		يتيح عنصر الإعدادات تخصيص السلوك المُهمل. وستستخدم أيّ إعدادات تمّ حذفها إعدادات تلقائية تحدّدها Google وسيتمّ ضبطها بمرور الوقت. لإيقاف إعداد معيّن، مثل هامش الجلب، اضبط القيمة على -1.
  • fetchMarginPercent

    الحدّ الأدنى للمسافة التي يجب أن تكون بين الشريحة الإعلانية وإطار العرض الحالي قبل جلب الإعلان كنسبة مئوية من حجم إطار العرض تعني القيمة 0 "عندما تدخل الشريحة إطار العرض"، وتعني القيمة 100 "عندما يكون الإعلان على بُعد إطار عرض واحد"، وهكذا.
  • renderMarginPercent

    الحد الأدنى للمسافة التي يجب أن تكون بين الشريحة الإعلانية وإطار العرض الحالي قبل عرض إعلان. يتيح ذلك بدء تحميل الإعلان مسبقًا، ولكن مع الانتظار لعرض الموارد الفرعية الأخرى وتنزيلها. تعمل القيمة تمامًا مثل fetchMarginPercent كنسبة مئوية من مساحة العرض.
  • mobileScaling

    مُضاعِف يُطبَّق على الهوامش على الأجهزة الجوّالة. ويتيح ذلك اختلاف الهوامش على الأجهزة الجوّالة مقارنةً بأجهزة الكمبيوتر المكتبي. على سبيل المثال، ستؤدي القيمة 2.0 إلى ضرب جميع الهوامش في 2 على الأجهزة الجوّالة، ما يزيد الحد الأدنى للمسافة التي يمكن أن تكون فيها خانة قبل جلبها وعرضها.

enableSingleRequest

enableSingleRequest(): boolean
تفعيل وضع الطلب الفردي لجلب إعلانات متعددة في الوقت نفسه يتطلّب ذلك تحديد جميع خانات إعلانات الناشر وإضافتها إلى PubAdsService قبل تفعيل الخدمة. يجب ضبط وضع الطلب الواحد قبل تفعيل الخدمة.
انظر أيضًا
المرتجعات
booleanتُعرِض القيمة true إذا كان وضع الطلب الواحد مفعَّلاً وfalse إذا كان من المستحيل تفعيل وضع الطلب الواحد لأنّه تمّ استدعاء الطريقة بعد تفعيل الخدمة.

enableVideoAds

enableVideoAds(): void
إشارات إلى علامة Google Publisher Tag (GPT) بأنّ إعلانات الفيديو ستظهر على الصفحة ويؤدي ذلك إلى تفعيل قيود الاستبعاد التنافسي على الإعلانات الصورية وإعلانات الفيديو. إذا كان محتوى الفيديو معروفًا، يمكنك استدعاء PubAdsService.setVideoContent لتتمكّن من استخدام ميزة استبعاد المحتوى للإعلانات الصورية.

الحصول

get(key: string): null | string
تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد.
مثال

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (الإصدار القديم)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.
انظر أيضًا
المعلمات
key: stringاسم السمة المطلوب البحث عنها
المرتجعات
null | stringالقيمة الحالية لمفتاح السمة، أو null في حال عدم توفّر المفتاح

getAttributeKeys

getAttributeKeys(): string[]
تعرِض مفاتيح السمات التي تم ضبطها على هذه الخدمة.
مثال

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (الإصدار القديم)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].
المرتجعات
string[]صفيف مفاتيح السمات التي تم ضبطها على هذه الخدمة الطلب غير محدّد.

getTargeting

getTargeting(key: string): string[]
لعرض مَعلمة استهداف مخصّصة محدّدة على مستوى الخدمة تمّ ضبطها.
مثال

JavaScript

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).

JavaScript (الإصدار القديم)

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).

TypeScript

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).
المعلمات
key: stringمفتاح الاستهداف المطلوب البحث عنه.
المرتجعات
string[]القيم المرتبطة بهذا المفتاح، أو صفيف فارغ في حال عدم توفّر مفتاح كهذا

getTargetingKeys

getTargetingKeys(): string[]
تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة على مستوى الخدمة التي تمّ ضبطها.
مثال

JavaScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

JavaScript (الإصدار القديم)

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

TypeScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].
المرتجعات
string[]صفيف مفاتيح الاستهداف الطلب غير محدّد.

isInitialLoadDisabled

isInitialLoadDisabled(): boolean
تُرجع ما إذا تم إيقاف الطلبات الأولية للإعلانات بنجاح من خلال طلب سابق من PubAdsService.disableInitialLoad أم لا.
المرتجعات
booleanتُرجِع القيمة true إذا كانت المكالمة السابقة إلى PubAdsService.disableInitialLoad ناجحة، وfalse في حال عدم نجاحها.

إعادة تحميل

refresh(slots?: null | Slot[], options?: {
  changeCorrelator: boolean;
}): void
تُستخدَم هذه الوظيفة لجلب إعلانات جديدة وعرضها في خانات معيّنة أو جميع الخانات على الصفحة. لا تعمل إلا في وضع العرض غير المتزامن.

للحصول على السلوك الصحيح في جميع المتصفّحات، يجب أن يسبق استدعاء refresh استدعاء display لموضع الإعلان. في حال حذف الطلب إلى display، قد يتصرف الإجراء "إعادة تحميل البيانات" بشكل غير متوقّع. إذا أردت، يمكنك استخدام الطريقة PubAdsService.disableInitialLoad لمنع display من جلب إعلان.

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

JavaScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });

JavaScript (الإصدار القديم)

var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });

TypeScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });
انظر أيضًا
المعلمات
Optional slots: null | Slot[]الفتحات التي يجب إعادة تحميلها الصفيف اختياري، وسيتم إعادة تحميل جميع الفتحات في حال عدم تحديده.
Optional options: {
  changeCorrelator: boolean;
}		خيارات الضبط المرتبطة بطلبك لإعادة التحميل هذا
  • changeCorrelator

    يحدّد ما إذا كان سيتم إنشاء عامل ربط جديد لاسترداد الإعلانات أم لا. تحافظ خوادم الإعلانات على قيمة هذا المُعارِف لفترة قصيرة (30 ثانية حاليًا، ولكن يمكن أن تتغيّر)، بحيث يتم اعتبار الطلبات التي تتضمّن المعرّف نفسه والتي يتم تلقّيها بالقرب من بعضها مشاهدة صفحة واحدة. يتم تلقائيًا إنشاء عامل ربط جديد لكل عملية إعادة تحميل.

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

set

set(key: string, value: string): PubAdsService
تُستخدَم لضبط قيم لسمات AdSense تنطبق على جميع خانات الإعلانات ضمن خدمة "إعلانات الناشر".

سيؤدي استدعاء هذه الوظيفة أكثر من مرّة للمفتاح نفسه إلى إلغاء القيم التي تمّ ضبطها سابقًا لهذا المفتاح. يجب ضبط كل القيم قبل استدعاء display أو refresh.
مثال

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");

JavaScript (الإصدار القديم)

googletag.pubads().set("adsense_background_color", "#FFFFFF");

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
انظر أيضًا
المعلمات
key: stringاسم السمة.
value: stringقيمة السمة
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): PubAdsService
تُستخدَم لضبط استبعاد فئة إعلان على مستوى الصفحة لاسم التصنيف المحدّد.
مثال

JavaScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

JavaScript (الإصدار القديم)

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

TypeScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");
انظر أيضًا
المعلمات
categoryExclusion: stringتصنيف استبعاد فئة الإعلانات المطلوب إضافته
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setCentering

setCentering(centerAds: boolean): void
تفعيل وضع الإعلانات في الوسط أفقيًا وإيقافه تكون ميزة "المحاذاة في الوسط" غير مفعّلة تلقائيًا. في ملف gpt_mobile.js القديم، يكون وضع الإعلان في المنتصف مفعّلاً تلقائيًا.

يجب استدعاء هذه الطريقة قبل استدعاء display أو refresh لأنّه لن يتم وضع الإعلانات في المنتصف إلا بعد استدعاء هذه الطريقة.
مثال

JavaScript

// Make ads centered.
googletag.pubads().setCentering(true);

JavaScript (الإصدار القديم)

// Make ads centered.
googletag.pubads().setCentering(true);

TypeScript

// Make ads centered.
googletag.pubads().setCentering(true);
المعلمات
centerAds: booleantrue لمحاذاة الإعلانات في الوسط، false لمحاذاتها على اليسار

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
لضبط ما إذا كان يجب فرض عرض جميع الإعلانات على الصفحة باستخدام حاوية SafeFrame.

يُرجى مراعاة النقاط التالية أثناء استخدام واجهة برمجة التطبيقات هذه:
  • ولن يسري هذا الإعداد إلا على طلبات الإعلانات اللاحقة التي يتم إجراؤها للمواضع الإعلانية المعنية.
  • سيُلغي الإعداد على مستوى الشريحة، في حال تحديده، الإعداد على مستوى الصفحة.
  • في حال ضبط القيمة على true (على مستوى المساحة أو مستوى الصفحة)، سيتم عرض الإعلان دائمًا باستخدام حاوية SafeFrame بغض النظر عن الخيار الذي تمّ إجراؤه في واجهة مستخدِم "مدير إعلانات Google".
  • ومع ذلك، في حال ضبطه على false أو عدم تحديده، سيتم عرض الإعلان باستخدام حاوية SafeFrame استنادًا إلى نوع تصميم الإعلان والاختيار الذي تم إجراؤه في واجهة مستخدم "مدير إعلانات Google".
  • يجب استخدام واجهة برمجة التطبيقات هذه بحذر لأنّها قد تؤثّر في سلوك تصميمات الإعلانات التي تحاول الخروج من إطارات iframe أو تعتمد على عرضها مباشرةً في صفحة الناشر.
مثال

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (الإصدار القديم)

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");
انظر أيضًا
المعلمات
forceSafeFrame: booleantrue لإجبار عرض جميع الإعلانات على الصفحة في إطارات SafeFrames وfalse لتغيير الإعداد السابق إلى false. لن يؤدي ضبط هذا الخيار على false عندما لم يتم تحديده سابقًا إلى تغيير أي شيء.
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الدالة عليه.

setLocation

setLocation(address: string): PubAdsService
تمرير معلومات الموقع الجغرافي من المواقع الإلكترونية حتى تتمكّن من استهداف العناصر جغرافيًا في مواقع جغرافية معيّنة
مثال

JavaScript

// Postal code:
googletag.pubads().setLocation("10001,US");

JavaScript (الإصدار القديم)

// Postal code:
googletag.pubads().setLocation("10001,US");

TypeScript

// Postal code:
googletag.pubads().setLocation("10001,US");
المعلمات
address: stringعنوان بتنسيق حر
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService
يتيح ضبط جميع إعدادات الخصوصية من واجهة برمجة تطبيقات واحدة باستخدام عنصر إعدادات.
مثال

JavaScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

JavaScript (الإصدار القديم)

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

TypeScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});
انظر أيضًا
المعلمات
privacySettings: PrivacySettingsConfigعنصر يحتوي على إعدادات الخصوصية
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الدالة عليه.

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService
لضبط قيمة المعرّف الذي يوفّره الناشر
مثال

JavaScript

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");

JavaScript (الإصدار القديم)

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");

TypeScript

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
انظر أيضًا
المعلمات
ppid: stringمعرّف أبجدي رقمي يقدّمه الناشر يجب أن يتكوّن من 32 إلى 150 حرفًا.
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService
تُستخدَم لضبط الإعدادات المفضّلة على مستوى الصفحة لإعدادات SafeFrame. سيتم تجاهل أي مفاتيح غير معروفة في عنصر الإعدادات. سيتم تجاهل الإعدادات بالكامل في حال تم ضبط قيمة غير صالحة لمفتاح معروف.

سيتم إلغاء الإعدادات المفضّلة على مستوى الصفحة من خلال الإعدادات المفضّلة على مستوى الفتحة، إذا تم تحديدها.
مثال

JavaScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (الإصدار القديم)

googletag.pubads().setForceSafeFrame(true);

var pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");
انظر أيضًا
المعلمات
config: SafeFrameConfigعنصر الضبط
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService
تُستخدَم لضبط مَعلمات استهداف مخصّصة لمفتاح معيّن تنطبق على جميع خانات الإعلانات في خدمة "إعلانات الناشر". سيؤدي استدعاء هذه الطريقة عدة مرات للمفتاح نفسه إلى استبدال القيم القديمة. يتمّ تحديد هذه المفاتيح في حسابك على "مدير إعلانات Google".
مثال

JavaScript

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);

JavaScript (الإصدار القديم)

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);

TypeScript

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);
انظر أيضًا
المعلمات
key: stringمفتاح مَعلمة الاستهداف
value: string | string[]قيمة مَعلمة الاستهداف أو صفيف من القيم
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void
لضبط معلومات محتوى الفيديو المطلوب إرسالها مع طلبات الإعلانات لأغراض الاستهداف واستبعاد المحتوى. سيتم تلقائيًا تفعيل إعلانات الفيديو عند استدعاء هذه الطريقة. بالنسبة إلى videoContentId وvideoCmsId، استخدِم القيم المقدَّمة لخدمة نقل المحتوى في "مدير إعلانات Google".
انظر أيضًا
المعلمات
videoContentId: stringرقم تعريف محتوى الفيديو
videoCmsId: stringرقم تعريف نظام إدارة المحتوى للفيديو

updateCorrelator

updateCorrelator(): PubAdsService
يغيّر هذا المقياس المرتبط الذي يتم إرساله مع طلبات الإعلانات، ما يؤدي إلى بدء مشاهدة صفحة جديدة بشكل فعّال. يكون عامل الربط هو نفسه لجميع طلبات الإعلانات الواردة من مشاهدة صفحة واحدة، وهو فريد في جميع مشاهدات الصفحات. لا ينطبق إلا على الوضع غير المتزامن.

ملاحظة: لا يؤثّر ذلك في مشاهدة الصفحة التي تدوم طويلاً في GPT، والتي تعرض تلقائيًا الإعلانات الظاهرة على الصفحة ولا تتضمّن وقت انتهاء صلاحية.
مثال

JavaScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

JavaScript (الإصدار القديم)

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

TypeScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.
المرتجعات
PubAdsServiceعنصر الخدمة الذي تمّ استدعاء الدالة عليه.

googletag.ResponseInformation

عنصر يمثّل استجابة إعلان واحدة
الخصائص
advertiserId
رقم تعريف المعلِن.
campaignId
رقم تعريف الحملة.
creativeId
معرّف تصميم الإعلان.
creativeTemplateId
رقم تعريف نموذج الإعلان.
lineItemId
رقم تعريف السلعة.
انظر أيضًا

الخصائص

advertiserId

advertiserId: null | number
رقم تعريف المعلِن.

campaignId

campaignId: null | number
رقم تعريف الحملة.

creativeId

creativeId: null | number
معرّف تصميم الإعلان.

creativeTemplateId

creativeTemplateId: null | number
رقم تعريف نموذج الإعلان.

lineItemId

lineItemId: null | number
رقم تعريف السلعة.

googletag.RewardedPayload

عنصر يمثّل المكافأة المرتبطة بإعلان يضم مكافأة
الخصائص
amount
عدد السلع المضمّنة في المكافأة
type
نوع العنصر المضمّن في المكافأة (على سبيل المثال، "عملة").
انظر أيضًا

الخصائص

amount

amount: number
عدد السلع المضمّنة في المكافأة

type

type: string
نوع العنصر المضمّن في المكافأة (على سبيل المثال، "عملة").

googletag.SafeFrameConfig

عنصر الإعداد لحاويات SafeFrame
الخصائص
allowOverlayExpansion?
ما إذا كان يجب أن يسمح إطار SafeFrame بتوسيع محتوى الإعلان من خلال تداخله مع محتوى الصفحة
allowPushExpansion?
ما إذا كان يجب أن يسمح إطار SafeFrame بتوسيع محتوى الإعلان من خلال دفع محتوى الصفحة
sandbox?
ما إذا كان يجب أن يستخدم SafeFrame سمة وضع الحماية في HTML5 لمنع التنقّل في المستوى الأعلى بدون تفاعل المستخدم.
useUniqueDomain?
تمّ إيقاف هذا العمود نهائيًا. ما إذا كان يجب أن يستخدم SafeFrame نطاقات فرعية عشوائية لتصاميم الإعلانات القائمة على الحجز.
انظر أيضًا

الخصائص

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean
ما إذا كان يجب أن يسمح إطار SafeFrame بتوسيع محتوى الإعلان من خلال التراكب على محتوى الصفحة

Optional allowPushExpansion

allowPushExpansion?: boolean
ما إذا كان يجب أن يسمح إطار SafeFrame بتوسيع محتوى الإعلان من خلال دفع محتوى الصفحة

Optional وضع الحماية

sandbox?: boolean
ما إذا كان يجب أن يستخدم SafeFrame سمة وضع الحماية في HTML5 لمنع التنقّل في المستوى الأعلى بدون تفاعل المستخدم. القيمة الصالحة الوحيدة هي true (لا يمكن فرض القيمة false). يُرجى العلم أنّ سمة وضع الحماية المخصّص للتطبيقات تحظر الإضافات (مثل Flash).

Optional useUniqueDomain

useUniqueDomain?: null | boolean
ما إذا كان يجب أن يستخدم SafeFrame نطاقات فرعية عشوائية لتصاميم الإعلانات القائمة على الحجز أدخِل null لمحو القيمة المخزّنة.

ملاحظة: هذه الميزة مفعّلة تلقائيًا.
انظر أيضًا

googletag.Service

فئة الخدمة الأساسية التي تحتوي على طرق شائعة لجميع الخدمات
الطُرق
addEventListener
تسجِّل أداة معالجة الأحداث هذه مستمعًا يسمح لك بإعداد وظيفة JavaScript واستدعاؤها عند حدوث حدث GPT معيّن على الصفحة.
getSlots
الحصول على قائمة الفتحات المرتبطة بهذه الخدمة
removeEventListener
تزيل هذه الطريقة مستمعًا مسجَّلاً في السابق.

الطُرق

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service
تسجِّل أداة معالجة الأحداث هذه مستمعًا يسمح لك بإعداد وظيفة JavaScript واستدعائها عند حدوث حدث GPT معيّن على الصفحة. الأحداث التالية متاحة: يتم تمرير عنصر من نوع الحدث المناسب إلى أداة معالجة الأحداث عند استدعائها.
مثال

JavaScript

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", (event) => {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (الإصدار القديم)

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", function (event) {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", (event) => {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});
انظر أيضًا
المعلمات
eventType: Kسلسلة تمثّل نوع الحدث الذي أنشأه نموذج GPT أنواع الأحداث حسّاسة لحالة الأحرف.
listener: ((arg: EventTypeMap[K]) => void)دالة تستخدِم وسيطة واحدة لعنصر حدث.
المرتجعات
Serviceعنصر الخدمة الذي تمّ استدعاء الطريقة عليه.

getSlots

getSlots(): Slot[]
الحصول على قائمة الفتحات المرتبطة بهذه الخدمة
المرتجعات
Slot[]الفتحات بالترتيب الذي تمت إضافتها به إلى الخدمة

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((event: EventTypeMap[K]) => void)): void
تزيل مستمعًا مسجَّلاً سابقًا.
مثال

JavaScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

JavaScript (الإصدار القديم)

googletag.cmd.push(function () {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  var onViewableListener = function (event) {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(function () {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

TypeScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag
    .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")!
    .addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event: googletag.events.ImpressionViewableEvent) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});
المعلمات
eventType: Kسلسلة تمثّل نوع الحدث الذي أنشأه نموذج GPT أنواع الأحداث حسّاسة لحالة الأحرف.
listener: ((event: EventTypeMap[K]) => void)دالة تستخدِم وسيطة واحدة لعنصر حدث.

googletag.SizeMappingBuilder

أداة إنشاء لعناصر مواصفات تعيين الحجم يتم توفير هذا المُنشئ للمساعدة في إنشاء مواصفات الحجم بسهولة.
الطُرق
addSize
تُضيف تعيينًا من صفيف أحادي الحجم (يمثّل مساحة العرض) إلى صفيف أحادي الحجم أو متعدد الأحجام يمثّل الفتحة.
build
تُنشئ هذه الدالة مواصفات خريطة مقاسات من عمليات الربط التي تمت إضافتها إلى أداة الإنشاء هذه.
انظر أيضًا

الطُرق

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
تُضيف عملية الربط صفيفًا بحجم واحد (يمثّل مساحة العرض) إلى صفيف بحجم واحد أو متعدد يمثّل الفتحة.
مثال

JavaScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports &lt; 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

JavaScript (الإصدار القديم)

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports &lt; 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

TypeScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports &lt; 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]
المعلمات
viewportSize: SingleSizeArrayحجم إطار العرض لإدخال التعيين هذا
slotSize: GeneralSizeأحجام الفتحة لبيانات التعيين هذه
المرتجعات
SizeMappingBuilderإشارة إلى هذا المطوّر.

إنشاء

build(): null | SizeMappingArray
تُنشئ هذه الطريقة مواصفات خريطة مقاسات من عمليات الربط التي تمت إضافتها إلى هذا المُنشئ.

في حال تقديم أي عمليات ربط غير صالحة، ستُعرِض هذه الطريقة القيمة null. بخلاف ذلك، يتم عرض مواصفات بالتنسيق الصحيح لنقلها إلى Slot.defineSizeMapping.

ملاحظة: لا يمكن تحديد سلوك أداة الإنشاء بعد استدعاء هذه الطريقة.
المرتجعات
null | SizeMappingArrayالنتيجة التي أنشأها هذا المُنشئ يمكن أن يكون هذا الحقل فارغًا إذا تم تقديم عمليات ربط أحجام غير صالحة.

googletag.Slot

خانة العرض هي عنصر يمثّل خانة إعلان واحدة على الصفحة.
الطُرق
addService
تُضيف خدمة إلى هذا المربّع.
clearCategoryExclusions
يؤدي هذا الإجراء إلى محو جميع تصنيفات استبعاد فئات الإعلانات على مستوى المساحة الإعلانية لهذه المساحة.
clearTargeting
يؤدي هذا الإجراء إلى محو معلَمات استهداف مخصّصة معيّنة أو جميعها على مستوى الشريحة لهذه الشريحة.
defineSizeMapping
تُستخدَم لضبط صفيف من عمليات الربط من الحد الأدنى لحجم إطار العرض إلى حجم الفتحة لهذه الفتحة.
get
تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد لهذه الفتحة.
getAdUnitPath
تعرِض هذه السمة المسار الكامل للوحدة الإعلانية، مع رمز الشبكة ومسار الوحدة الإعلانية.
getAttributeKeys
تعرِض قائمة مفاتيح السمات التي تم ضبطها في هذه الفتحة.
getCategoryExclusions
تعرِض هذه السمة تصنيفات استبعاد فئات الإعلانات لهذه المساحة.
getResponseInformation
تعرِض هذه السمة معلومات استجابة الإعلان.
getSlotElementId
لعرض رقم تعريف خانة النسخ الاحتياطي div المقدَّم عند تحديد خانة النسخ الاحتياطي.
getTargeting
لعرض مَعلمة استهداف مخصّصة محدّدة تمّ ضبطها في هذا الموضع.
getTargetingKeys
تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة التي تم ضبطها في هذا الموضع.
set
تُستخدَم لضبط قيمة لسمة AdSense في خانة الإعلان هذه.
setCategoryExclusion
تُستخدَم لضبط تصنيف استبعاد فئة إعلان على مستوى المساحة الإعلانية في هذه المساحة.
setClickUrl
تُستخدَم لضبط عنوان URL الذي سيتمّ من خلاله إعادة توجيه المستخدِمين بعد النقر على الإعلان.
setCollapseEmptyDiv
لضبط ما إذا كان يجب إخفاء الشريحة div عندما لا يكون هناك إعلان في الشريحة
setConfig
لضبط خيارات الضبط العامة لهذه الفتحة
setForceSafeFrame
لضبط ما إذا كان يجب فرض عرض الإعلانات في هذا الموضع باستخدام حاوية SafeFrame.
setSafeFrameConfig
لضبط الإعدادات المفضّلة على مستوى الشريحة لإعدادات SafeFrame
setTargeting
تُستخدَم لضبط مَعلمة استهداف مخصّصة لهذه المساحة.
updateTargetingFromMap
تُستخدَم لضبط مَعلمات الاستهداف المخصّصة لهذه المساحة، من خريطة المفتاح:القيمة في عنصر JSON.

الطُرق

addService

addService(service: Service): Slot
تُضيف خدمة إلى هذا الموضع.
مثال

JavaScript

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

JavaScript (الإصدار القديم)

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

TypeScript

googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());
انظر أيضًا
المعلمات
service: Serviceالخدمة التي سيتمّ إضافتها
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

clearCategoryExclusions

clearCategoryExclusions(): Slot
يؤدي ذلك إلى محو جميع تصنيفات استبعاد فئات الإعلانات على مستوى المساحة الإعلانية لهذه المساحة الإعلانية.
مثال

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.

JavaScript (الإصدار القديم)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

clearTargeting

clearTargeting(key?: string): Slot
يؤدي ذلك إلى محو معلَمات استهداف مخصّصة معيّنة أو جميعها على مستوى الشريحة لهذه الشريحة.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.
انظر أيضًا
المعلمات
Optional key: stringمفتاح مَعلمة الاستهداف المفتاح اختياري، وسيتم محو جميع مَعلمات الاستهداف في حال عدم تحديده.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot
تُستخدَم لضبط صفيف من عمليات الربط من الحد الأدنى لحجم إطار العرض إلى حجم الفتحة لهذه الفتحة.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

var mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping!);
انظر أيضًا
المعلمات
sizeMapping: SizeMappingArrayصفيف عمليات ربط الأحجام يمكنك استخدام SizeMappingBuilder لإنشاء هذا العنصر. كلّ تعيين حجم هو صفيف من عنصرَين: SingleSizeArray وGeneralSize.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

الحصول

get(key: string): null | string
تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد لهذه الفتحة. للاطّلاع على السمات على مستوى الخدمة التي اكتسبتها هذه الفتحة، استخدِم PubAdsService.get.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.
انظر أيضًا
المعلمات
key: stringاسم السمة المطلوب البحث عنها
المرتجعات
null | stringالقيمة الحالية لمفتاح السمة، أو null في حال عدم توفّر المفتاح

getAdUnitPath

getAdUnitPath(): string
تعرِض هذه السمة المسار الكامل للوحدة الإعلانية، مع رمز الشبكة ومسار الوحدة الإعلانية.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.
المرتجعات
stringمسار الوحدة الإعلانية

getAttributeKeys

getAttributeKeys(): string[]
تعرِض قائمة مفاتيح السمات التي تم ضبطها في هذه الفتحة. للاطّلاع على مفاتيح السمات على مستوى الخدمة التي اكتسبتها هذه الفتحة، استخدِم PubAdsService.getAttributeKeys.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].
المرتجعات
string[]صفيف مفاتيح السمات الطلب غير محدّد.

getCategoryExclusions

getCategoryExclusions(): string[]
تعرِض هذه السمة تصنيفات استبعاد فئات الإعلانات لهذه المساحة.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].
المرتجعات
string[]تصنيفات استبعاد فئات الإعلانات لهذه الفتحة، أو صفيف فارغ إذا لم يتم ضبط أيّ منها

getResponseInformation

getResponseInformation(): null | ResponseInformation
تعرِض هذه السمة معلومات استجابة الإعلان. ويستند ذلك إلى آخر استجابة للإعلان في المساحة. في حال استدعاء هذه الدالة عندما لا تحتوي المساحة على إعلان، سيتمّ عرض null.
المرتجعات
null | ResponseInformationأحدث معلومات استجابة الإعلان، أو null إذا لم تتضمّن المساحة إعلانًا.

getSlotElementId

getSlotElementId(): string
لعرض رقم تعريف خانة المحتوى div المقدَّم عند تحديد خانة المحتوى.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.
المرتجعات
stringرقم تعريف المساحة الإضافية div

getTargeting

getTargeting(key: string): string[]
لعرض مَعلمة استهداف مخصّصة محدّدة تمّ ضبطها في هذا الموضع. لا يتمّ تضمين مَعلمات الاستهداف على مستوى الخدمة.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).
المعلمات
key: stringمفتاح الاستهداف المطلوب البحث عنه.
المرتجعات
string[]القيم المرتبطة بهذا المفتاح، أو صفيف فارغ إذا لم يكن هناك مفتاح مماثل

getTargetingKeys

getTargetingKeys(): string[]
تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة التي تم ضبطها في هذا الموضع. لا يتم تضمين مفاتيح الاستهداف على مستوى الخدمة.
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].
المرتجعات
string[]صفيف مفاتيح الاستهداف الطلب غير محدّد.

set

set(key: string, value: string): Slot
تُستخدَم لضبط قيمة لسمة AdSense في خانة الإعلان هذه. سيؤدي ذلك إلى إلغاء أي قيم تم ضبطها على مستوى الخدمة لهذا المفتاح.

سيؤدي استدعاء هذه الطريقة أكثر من مرة للمفتاح نفسه إلى إلغاء القيم التي تم ضبطها مسبقًا لهذا المفتاح. يجب ضبط كل القيم قبل استدعاء display أو refresh.
مثال

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

JavaScript (الإصدار القديم)

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());
انظر أيضًا
المعلمات
key: stringاسم السمة.
value: stringقيمة السمة
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot
تُستخدَم لضبط تصنيف استبعاد فئة إعلانية على مستوى المساحة الإعلانية في هذه المساحة الإعلانية.
مثال

JavaScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

JavaScript (الإصدار القديم)

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());
انظر أيضًا
المعلمات
categoryExclusion: stringتصنيف استبعاد فئة الإعلانات المطلوب إضافته
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setClickUrl

setClickUrl(value: string): Slot
لضبط عنوان URL للنقرة الذي ستتم إعادة توجيه المستخدِمين إليه بعد النقر على الإعلان.

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

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

JavaScript (الإصدار القديم)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());
المعلمات
value: stringعنوان URL للنقر المطلوب ضبطه.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
لضبط ما إذا كان يجب إخفاء الشريحة div عندما لا يكون هناك إعلان في الشريحة ويؤدي ذلك إلى إلغاء الإعدادات على مستوى الخدمة.
مثال

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

JavaScript (الإصدار القديم)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.
انظر أيضًا
المعلمات
collapse: booleanما إذا كان سيتم تصغير المربّع في حال عدم عرض أي إعلان.
Optional collapseBeforeAdFetch: booleanما إذا كان سيتم تصغير المساحة حتى قبل جلب إعلان يتم تجاهله إذا لم يكن العنصر المُدمَج هو true.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setConfig

setConfig(slotConfig: SlotSettingsConfig): void
لضبط خيارات الضبط العامة لهذه الفتحة
المعلمات
slotConfig: SlotSettingsConfigعنصر الضبط

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot
لضبط ما إذا كان يجب فرض عرض الإعلانات في هذا الموضع باستخدام حاوية SafeFrame.

يُرجى مراعاة النقاط التالية أثناء استخدام واجهة برمجة التطبيقات هذه:
  • ولن يسري هذا الإعداد إلا على طلبات الإعلانات اللاحقة التي يتم إجراؤها للمواضع الإعلانية المعنيّة.
  • سيُلغي الإعداد على مستوى الشريحة، في حال تحديده، الإعداد على مستوى الصفحة.
  • في حال ضبط القيمة على true (على مستوى المساحة أو مستوى الصفحة)، سيتم عرض الإعلان دائمًا باستخدام حاوية SafeFrame بغض النظر عن الخيار الذي تمّ إجراؤه في واجهة مستخدِم "مدير إعلانات Google".
  • ومع ذلك، في حال ضبطه على false أو عدم تحديده، سيتم عرض الإعلان باستخدام حاوية SafeFrame استنادًا إلى نوع تصميم الإعلان والاختيار الذي تم إجراؤه في واجهة مستخدم "مدير إعلانات Google".
  • يجب استخدام واجهة برمجة التطبيقات هذه بحذر لأنّها قد تؤثّر في سلوك تصميمات الإعلانات التي تحاول الخروج من إطارات iframe أو تعتمد على عرضها مباشرةً في صفحة الناشر.
مثال

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

JavaScript (الإصدار القديم)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setForceSafeFrame(true)
  .addService(googletag.pubads());
انظر أيضًا
المعلمات
forceSafeFrame: boolean‫true لإجبار جميع الإعلانات في هذا الموضع على عرضها في إطارات SafeFrames وfalse لإيقاف إعداد على مستوى الصفحة (إذا كان متوفّرًا). لن يؤدي ضبط هذا الإعداد على false في حال عدم تحديده على مستوى الصفحة إلى تغيير أي شيء.
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot
لضبط الإعدادات المفضّلة على مستوى الشريحة لإعدادات SafeFrame سيتم تجاهل أي مفاتيح غير معروفة في عنصر الإعدادات. سيتم تجاهل الإعدادات بالكامل في حال تم ضبط قيمة غير صالحة لمفتاح معروف.

ستلغي هذه الإعدادات المفضّلة على مستوى الفتحة، في حال تحديدها، أي إعدادات مفضّلة على مستوى الصفحة.
مثال

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (الإصدار القديم)

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");
انظر أيضًا
المعلمات
config: null | SafeFrameConfigعنصر الضبط
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

setTargeting

setTargeting(key: string, value: string | string[]): Slot
تُستخدَم لضبط مَعلمة استهداف مخصّصة لهذه المساحة. سيؤدي استدعاء هذه الطريقة عدة مرات للمفتاح نفسه إلى استبدال القيم القديمة. ستحلّ القيم التي يتم ضبطها هنا محلّ مَعلمات الاستهداف التي تم ضبطها على مستوى الخدمة. يتمّ تحديد هذه المفاتيح في حسابك على "مدير إعلانات Google".
مثال

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);

JavaScript (الإصدار القديم)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);
انظر أيضًا
المعلمات
key: stringمفتاح مَعلمة الاستهداف
value: string | string[]قيمة مَعلمة الاستهداف أو صفيف من القيم
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

updateTargetingFromMap

updateTargetingFromMap(map: {
  [adUnitPath: string]: string | string[];
}): Slot
تُستخدَم لضبط مَعلمات استهداف مخصّصة لهذه المساحة، من خريطة مفتاح/قيمة في عنصر JSON. وهذا يشبه استدعاء Slot.setTargeting لجميع قيم المفاتيح للكائن. يتمّ تحديد هذه المفاتيح في حسابك على "مدير إعلانات Google".

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

JavaScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

JavaScript (الإصدار القديم)

var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

TypeScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div")!;

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});
المعلمات
map: {
  [adUnitPath: string]: string | string[];
}		تعيين المفتاح والقيمة لمَعلمة الاستهداف
المرتجعات
Slotعنصر الفتحة الذي تمّ استدعاء الطريقة عليه

googletag.config

واجهة الضبط الرئيسية للإعدادات على مستوى الصفحة
واجهات
AdExpansionConfig
إعدادات للتحكّم في توسيع الإعلان
ComponentAuctionConfig
عنصر يمثّل مزاد مكوّن واحد في مزاد إعلانات على الجهاز
InterstitialConfig
عنصر يحدّد سلوك خانة إعلان بيني واحد
PageSettingsConfig
واجهة الضبط الرئيسية للإعدادات على مستوى الصفحة
PrivacyTreatmentsConfig
إعدادات للتحكّم في إجراءات حماية خصوصية الناشر
PublisherProvidedSignalsConfig
عنصر إعدادات "الإشارات المقدَّمة من الناشر"
SlotSettingsConfig
واجهة الضبط الرئيسية للإعدادات على مستوى الفتحة
TaxonomyData
عنصر يحتوي على قيم تصنيف واحد
الأسماء البديلة للبريد الإلكتروني
InterstitialTrigger
عوامل تشغيل الإعلانات البينية المتوافقة
PrivacyTreatment
إجراءات حماية الخصوصية المتاحة للناشرين
Taxonomy

الأسماء البديلة للبريد الإلكتروني

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"
عوامل تشغيل الإعلانات البينية المتوافقة

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"
إجراءات حماية الخصوصية المتاحة للناشرين

التصنيف

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"
التصنيفات المتوافقة للإشارات المقدَّمة من الناشر (PPS)
انظر أيضًا

googletag.config.AdExpansionConfig

إعدادات للتحكّم في توسيع الإعلان
الخصائص
enabled?
ما إذا كانت ميزة توسيع الإعلان مفعّلة أم غير مفعّلة
مثال

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

الخصائص

Optional مفعَّلة

enabled?: null | boolean
ما إذا كان توسيع نطاق الإعلان مفعّلاً أو غير مفعّل.

يؤدي ضبط هذه القيمة إلى إلغاء الإعداد التلقائي الذي تم ضبطه في "مدير إعلانات Google".
انظر أيضًا

googletag.config.ComponentAuctionConfig

عنصر يمثّل مزاد مكوّن واحد في مزاد إعلانات على الجهاز
الخصائص
auctionConfig
عنصر إعدادات مزاد لمزاد المكوّن هذا.
configKey
مفتاح الإعداد المرتبط بمزاد المكوّن هذا.
انظر أيضًا

الخصائص

auctionConfig

auctionConfig: null | {
  auctionSignals?: unknown;
  decisionLogicURL: string;
  interestGroupBuyers?: string[];
  perBuyerExperimentGroupIds?: {
    [buyer: string]: number;
  };
  perBuyerGroupLimits?: {
    [buyer: string]: number;
  };
  perBuyerSignals?: {
    [buyer: string]: unknown;
  };
  perBuyerTimeouts?: {
    [buyer: string]: number;
  };
  seller: string;
  sellerExperimentGroupId?: number;
  sellerSignals?: unknown;
  sellerTimeout?: number;
  trustedScoringSignalsURL?: string;
}
كائن إعدادات مزاد لمزاد المكوّن هذا.

في حال ضبط هذه القيمة على null، سيتم حذف أيّ إعدادات حالية للقيمة المحدّدة configKey.
مثال

JavaScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicURL's origin
  seller: "https://testSeller.com",
  decisionLogicURL: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

JavaScript (الإصدار القديم)

var componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicURL's origin
  seller: "https://testSeller.com",
  decisionLogicURL: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

var auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

TypeScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicURL's origin
  seller: "https://testSeller.com",
  decisionLogicURL: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600])!;

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});
انظر أيضًا

configKey

configKey: string
مفتاح الضبط المرتبط بمزاد المكوّن هذا.

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

googletag.config.InterstitialConfig

عنصر يحدّد سلوك خانة إعلان بيني واحد
الخصائص
requireStorageAccess?
ما إذا كانت موافقة التخزين على الجهاز مطلوبة لعرض هذا الإعلان البيني
triggers?
إعداد مشغّل الإعلان البيني لهذا الإعلان البيني.

الخصائص

Optional requireStorageAccess

requireStorageAccess?: null | boolean
ما إذا كانت موافقة التخزين على الجهاز مطلوبة لعرض هذا الإعلان البيني.

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

JavaScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

JavaScript (الإصدار القديم)

// Opt out of showing interstitials to users
// without local storage consent.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

TypeScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});
انظر أيضًا

Optional عوامل التشغيل

triggers?: null | Partial<Record<InterstitialTrigger, boolean>>
إعداد مشغّل الإعلانات البينية لهذا الإعلان البيني.

سيؤدي ضبط قيمة مشغّل الإعلانات البينية على true إلى تفعيله وسيؤدي ضبطها على false إلى إيقافه. سيؤدي ذلك إلى إلغاء القيم التلقائية المُعدّة في "مدير إعلانات Google".
مثال

JavaScript

// Define a GPT managed web interstitial ad slot.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

JavaScript (الإصدار القديم)

// Define a GPT managed web interstitial ad slot.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

// Enable optional interstitial triggers.
// Change this value to false to disable.
var enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

TypeScript

// Define a GPT managed web interstitial ad slot.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});
انظر أيضًا

googletag.config.PageSettingsConfig

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

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

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

أمثلة:
  • لا يتم تعديل سوى الميزات المحدّدة في طلب googletag.setConfig. 
      // Configure feature alpha.
  googletag.setConfig({
      alpha: {...}
  });

  // Configure feature bravo. Feature alpha is unchanged.
  googletag.setConfig({
     bravo: {...}
  });
  • يتم تعديل جميع إعدادات ميزة معيّنة مع كلّ طلب إلى googletag.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,
  });
الخصائص
adExpansion?
إعدادات للتحكّم في توسيع الإعلان
adYield?
تمّ إيقافه نهائيًا. 
pps?
إعدادات للتحكّم في الإشارات المقدَّمة من الناشر (PPS)
privacyTreatments?
إعدادات للتحكّم في إجراءات حماية خصوصية الناشر
threadYield?
إعداد للتحكّم في ما إذا كان يجب أن يعرض GPT سلسلة مهام JavaScript عند عرض المواد الإبداعية.

الخصائص

Optional adExpansion

adExpansion?: null | AdExpansionConfig
إعدادات للتحكّم في توسيع الإعلان

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

Optional pps

إعدادات للتحكّم في الإشارات المقدَّمة من الناشر (PPS)

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig
إعدادات للتحكّم في إجراءات حماية خصوصية الناشر

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
إعداد للتحكّم في ما إذا كان يجب أن تُخرج علامة GPT سلسلة مهام JavaScript عند عرض المواد الإبداعية.

لن تُخرج علامة GPT سلسلة المهام إلا للمتصفّحات التي تتيح واجهة برمجة التطبيقات Scheduler.postTask أو Scheduler.yield.

القيم المسموح بها:
  • null (الإعداد التلقائي): سيُنشئ GPT سلسلة مهام JavaScript للخانات خارج إطار العرض.
  • ENABLED_ALL_SLOTS: ستُرسِل GPT سلسلة JS لجميع الفتحات بغض النظر عمّا إذا كانت الفتحة ضمن إطار العرض.
  • DISABLED: لن تُظهر علامة GPT سلسلة محادثات JavaScript.
مثال

JavaScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

JavaScript (الإصدار القديم)

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

TypeScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });
انظر أيضًا

googletag.config.PrivacyTreatmentsConfig

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

الخصائص

المعالجات

treatments: null | "disablePersonalization"[]
مجموعة من إجراءات الخصوصية التي يجب تفعيلها للناشرين
مثال

JavaScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

JavaScript (الإصدار القديم)

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

TypeScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

googletag.config.PublisherProvidedSignalsConfig

عنصر إعدادات "الإشارات المقدَّمة من الناشر"
الخصائص
taxonomies
عنصر يحتوي على عمليات ربط الفهرسة
مثال

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '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 | 30-34'
      // '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 | 30-34'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});
انظر أيضًا

الخصائص

التصنيفات

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>
عنصر يحتوي على عمليات ربط الفهرسة

googletag.config.SlotSettingsConfig

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

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

جميع السمات المدرَجة أدناه هي أمثلة ولا تعكس الميزات الفعلية التي تستخدِم 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,
  });
الخصائص
adExpansion?
إعدادات للتحكّم في توسيع الإعلان
componentAuction?
صفيف من مزادات المكوّنات المطلوب تضمينها في مزاد إعلانات على الجهاز
interstitial?
الإعدادات التي تتحكّم في سلوك خانات الإعلانات البينية

الخصائص

Optional adExpansion

adExpansion?: null | AdExpansionConfig
إعدادات للتحكّم في توسيع الإعلان

Optional componentAuction

componentAuction?: null | ComponentAuctionConfig[]
صفيف من مزادات المكوّنات التي سيتم تضمينها في مزاد إعلانات على الجهاز

Optional الإعلانات البينية

interstitial?: null | InterstitialConfig
الإعدادات التي تتحكّم في سلوك خانات الإعلانات البينية

googletag.config.TaxonomyData

عنصر يحتوي على قيم تصنيف واحد
الخصائص
values
قائمة بقيم التصنيف

الخصائص

values

values: string[]
قائمة بقيم التصنيف

googletag.enums

هذه هي مساحة الاسم التي يستخدمها GPT لأنواع التعداد.
التعدادات
OutOfPageFormat
تنسيقات الإعلانات خارج الصفحة المتوافقة مع GPT
TrafficSource
مصادر الزيارات المتوافقة مع GPT

التعدادات

OutOfPageFormat

OutOfPageFormat
تنسيقات المحتوى خارج الصفحة المتوافقة مع GPT
انظر أيضًا
عناصر التعداد
BOTTOM_ANCHOR
تنسيق الإعلانات الثابتة التي تلتصق الشريحة فيها بأسفل إطار العرض
GAME_MANUAL_INTERSTITIAL
تنسيق الإعلان البيني لدليل اللعبة

ملاحظة: الإعلان البيني لدليل اللعبة هو تنسيق متاح لعدد محدود من المستخدمين.
INTERSTITIAL
تنسيق تصميم الإعلان البيني على الويب
LEFT_SIDE_RAIL
تنسيق السكة الجانبية اليسرى
REWARDED
شكل الإعلانات التي تضم مكافآت
RIGHT_SIDE_RAIL
تنسيق السكة الجانبية اليمنى
TOP_ANCHOR
تنسيق الربط الذي تلتصق فيه الشريحة بأعلى إطار العرض

TrafficSource

TrafficSource
مصادر الزيارات المتوافقة مع GPT
انظر أيضًا
عناصر التعداد
ORGANIC
إدخال عنوان URL مباشرةً أو البحث في الموقع الإلكتروني أو تنزيل التطبيق
PURCHASED
الزيارات التي تتم إعادة توجيهها من مواقع غير مملوكة (نشاط مكتسَب أو نشاط تم تحفيز المستخدِم لإجرائه بطريقة أخرى)

googletag.events

هذه هي مساحة الاسم التي يستخدمها نموذج GPT للأحداث. يمكن لرمزك البرمجي التفاعل مع هذه الأحداث باستخدام Service.addEventListener.
واجهات
Event
الواجهة الأساسية لجميع أحداث GPT
EventTypeMap
هذا نوع زائف يربط اسم حدث بنوع عنصر الحدث المقابل له في Service.addEventListener وService.removeEventListener.
GameManualInterstitialSlotClosedEvent
يتم تنشيط هذا الحدث عندما يغلق المستخدم خانة إعلان بيني يدوي في اللعبة.
GameManualInterstitialSlotReadyEvent
يتم تنشيط هذا الحدث عندما تكون خانة إعلان بيني يدوي في اللعبة جاهزة للعرض على المستخدم.
ImpressionViewableEvent
يتمّ تنشيط هذا الحدث عندما تصبح مرّة الظهور قابلة للعرض، وفقًا لمعايير العرض النشط.
RewardedSlotClosedEvent
يتمّ تشغيل هذا الحدث عندما يغلق المستخدِم خانة إعلان مقابل مكافأة.
RewardedSlotGrantedEvent
يتمّ تنشيط هذا الحدث عند منح مكافأة مقابل مشاهدة إعلان يضمّ مكافأة.
RewardedSlotReadyEvent
يتمّ إطلاق هذا الحدث عندما يكون إعلان مقابل مكافأة جاهزًا للعرض.
SlotOnloadEvent
يتمّ تشغيل هذا الحدث عندما يُطلق إطار iframe لتصميم الإعلان حدث التحميل.
SlotRenderEndedEvent
يتمّ تنشيط هذا الحدث عند إدخال رمز تصميم الإعلان في خانة.
SlotRequestedEvent
يتمّ تنشيط هذا الحدث عند طلب إعلان لموضع معيّن.
SlotResponseReceived
يتمّ تنشيط هذا الحدث عند تلقّي استجابة إعلان لمساحة معيّنة.
SlotVisibilityChangedEvent
يتمّ تنشيط هذا الحدث كلّما تغيّرت النسبة المئوية لمساحة خانة الإعلان على الشاشة.

googletag.events.Event

الواجهة الأساسية لجميع أحداث GPT ستتضمّن جميع أحداث GPT أدناه الحقول التالية.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
انظر أيضًا

الخصائص

serviceName

serviceName: string
اسم الخدمة التي تسبّبت في الحدث

slot

slot: Slot
خانة الإعلان التي أدّت إلى ظهور الحدث

googletag.events.EventTypeMap

هذا نوع زائف يربط اسم حدث بنوع عنصر الحدث المقابل له في Service.addEventListener وService.removeEventListener. ويتم توثيقها لأغراض مرجعية وسلامة النوع فقط.
الخصائص
gameManualInterstitialSlotClosed
gameManualInterstitialSlotReady
impressionViewable
اسم بديل لـ events.ImpressionViewableEvent.
rewardedSlotClosed
اسم بديل لـ events.RewardedSlotClosedEvent.
rewardedSlotGranted
اسم بديل لـ events.RewardedSlotGrantedEvent.
rewardedSlotReady
اسم بديل لـ events.RewardedSlotReadyEvent.
slotOnload
اسم بديل events.SlotOnloadEvent
slotRenderEnded
اسم بديل لـ events.SlotRenderEndedEvent.
slotRequested
اسم بديل لـ events.SlotRequestedEvent.
slotResponseReceived
اسم بديل لـ events.SlotResponseReceived.
slotVisibilityChanged
عنوان بديل لـ events.SlotVisibilityChangedEvent.

الخصائص

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent
عنوان بديل لـ events.GameManualInterstitialSlotClosedEvent.

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent
عنوان بديل لـ events.GameManualInterstitialSlotReadyEvent.

impressionViewable

impressionViewable: ImpressionViewableEvent
اسم بديل لـ events.ImpressionViewableEvent.

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent
اسم بديل لـ events.RewardedSlotClosedEvent.

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent
اسم بديل لـ events.RewardedSlotGrantedEvent.

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent
اسم بديل لـ events.RewardedSlotReadyEvent.

slotOnload

slotOnload: SlotOnloadEvent
اسم بديل events.SlotOnloadEvent

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent
اسم بديل لـ events.SlotRenderEndedEvent.

slotRequested

slotRequested: SlotRequestedEvent
اسم بديل لـ events.SlotRequestedEvent.

slotResponseReceived

slotResponseReceived: SlotResponseReceived
اسم بديل لـ events.SlotResponseReceived.

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent
الاسم المعرِّف لـ events.SlotVisibilityChangedEvent.

googletag.events.GameManualInterstitialSlotClosedEvent

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

ملاحظة: الإعلان البيني اليدوي في اللعبة هو تنسيق بإمكانية وصول محدودة.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

JavaScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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 interstitial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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 interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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

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

ملاحظة: الإعلان البيني اليدوي في اللعبة هو تنسيق بإمكانية وصول محدودة.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
الطُرق
makeGameManualInterstitialVisible
تعرِض هذه السمة الإعلان البيني اليدوي للمستخدم في اللعبة.
مثال

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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.
    }
  });
}
انظر أيضًا

الطُرق

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void
تعرِض هذه السمة الإعلان البيني اليدوي للمستخدم في اللعبة.

googletag.events.ImpressionViewableEvent

تتمديد Event
يتمّ تنشيط هذا الحدث عندما تصبح مرّة الظهور قابلة للعرض، وفقًا لمعايير العرض النشط.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

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

تتمديد Event
يتمّ تشغيل هذا الحدث عندما يغلق المستخدِم خانة إعلان مقابل مكافأة. ويمكن أن يتم تشغيله قبل منح المكافأة أو بعدها. لتحديد ما إذا تم منح مكافأة، استخدِم events.RewardedSlotGrantedEvent بدلاً من ذلك.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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 (الإصدار القديم)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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

تتمديد Event
يتمّ تنشيط هذا الحدث عند منح مكافأة مقابل مشاهدة إعلان يضمّ مكافأة. إذا تم إغلاق الإعلان قبل استيفاء معايير منح مكافأة، لن يتم تنشيط هذا الحدث.
الخصائص
payload
عنصر يحتوي على معلومات عن المكافأة التي تم منحها
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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 (الإصدار القديم)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.
    }
  });
}
انظر أيضًا

الخصائص

حمولة

payload: null | RewardedPayload
عنصر يحتوي على معلومات عن المكافأة التي تم منحها

googletag.events.RewardedSlotReadyEvent

تتمديد Event
يتمّ تشغيل هذا الحدث عندما يكون إعلان مقابل مكافأة جاهزًا للعرض. يتحمّل الناشر مسؤولية تقديم خيار للمستخدم لعرض الإعلان قبل عرضه.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
الطُرق
makeRewardedVisible
تعرِض هذه السمة الإعلان الذي يضم مكافأة.
مثال

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.
    }
  });
}
انظر أيضًا

الطُرق

makeRewardedVisible

makeRewardedVisible(): void
تعرِض هذه السمة الإعلان الذي يضم مكافأة. يجب عدم استدعاء هذه الطريقة إلا بعد موافقة المستخدِم على عرض الإعلان.

googletag.events.SlotOnloadEvent

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

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

تتمديد Event
يتمّ تنشيط هذا الحدث عند إدخال رمز تصميم الإعلان في خانة. سيحدث هذا الحدث قبل جلب موارد تصميم الإعلان، لذا قد لا يكون تصميم الإعلان مرئيًا بعد. إذا كنت بحاجة إلى معرفة وقت انتهاء تحميل جميع موارد المواد الإبداعية لأحد الشرائح، يمكنك استخدام events.SlotOnloadEvent بدلاً من ذلك.
الخصائص
advertiserId
المعرّف الإعلاني للإعلان المعروض.
campaignId
رقم تعريف الحملة للإعلان المعروض.
companyIds
أرقام تعريف الشركات التي تقدّم عروض أسعار على إعلان إعادة التعبئة المعروض.
creativeId
رقم تعريف تصميم إعلان الحجز المعروض.
creativeTemplateId
رقم تعريف نموذج تصميم الإعلان لإعلان الحجز المعروض.
isBackfill
ما إذا كان الإعلان هو إعلان ملء فراغات
isEmpty
ما إذا تمّ عرض إعلان للموضع
labelIds
تمّ إيقافه نهائيًا. 
lineItemId
معرّف عنصر الإعلان المحجوز الذي تم عرضه.
serviceName
اسم الخدمة التي تسبّبت في الحدث
size
تشير إلى حجم البكسل لتصميم الإعلان المعروض.
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
slotContentChanged
ما إذا كان قد تم تغيير محتوى المساحة الإعلانية بالإعلان المعروض
sourceAgnosticCreativeId
رقم تعريف تصميم الإعلان للحجز المعروض أو إعلان الملء اللاحق.
sourceAgnosticLineItemId
معرّف عنصر العرض للحجز المعروض أو إعلان إعادة التعبئة.
yieldGroupIds
أرقام تعريف مجموعات الشبكات الإعلانية المُدرّة للأرباح لإعلان الملء اللاحق المعروض
مثال

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("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("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("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.
  }
});
انظر أيضًا

الخصائص

advertiserId

advertiserId: null | number
المعرّف الإعلاني للإعلان المعروض. تكون القيمة null للمواضع الفارغة والإعلانات المعروضة في الخلفية وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

campaignId

campaignId: null | number
رقم تعريف الحملة للإعلان المعروض. تكون القيمة null للمواضع الفارغة والإعلانات المعروضة في الخلفية وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

companyIds

companyIds: null | number[]
أرقام تعريف الشركات التي تقدّم عروض أسعار على إعلان إعادة التعبئة المعروض. تكون القيمة null للمواضع الفارغة وإعلانات الحجز وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

creativeId

creativeId: null | number
رقم تعريف تصميم إعلان الحجز المعروض. تكون القيمة null للمواضع الفارغة والإعلانات المعروضة في الخلفية وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

creativeTemplateId

creativeTemplateId: null | number
رقم تعريف نموذج تصميم الإعلان لإعلان الحجز المعروض. تكون القيمة null للمنافذ الفارغة والإعلانات المعروضة في الخلفية وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

isBackfill

isBackfill: boolean
ما إذا كان الإعلان هو إعلان ملء فراغات تكون القيمة true إذا كان الإعلان من النوع "ملء الفراغ"، وfalse في غير ذلك.

isEmpty

isEmpty: boolean
ما إذا تمّ عرض إعلان للموضع تكون القيمة true إذا لم يتم عرض أي إعلان، وfalse في حال آخر.

labelIds

labelIds: null | number[]

lineItemId

lineItemId: null | number
معرّف عنصر الإعلان المحجوز الذي تم عرضه. تكون القيمة null للمواضع الفارغة والإعلانات المعروضة في الخلفية وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

size

size: null | string | number[]
تشير إلى حجم البكسل لتصميم الإعلان المعروض. مثال: [728, 90] تكون القيمة null لمواضع الإعلانات الفارغة.

slotContentChanged

slotContentChanged: boolean
ما إذا تم تغيير محتوى المساحة مع الإعلان المعروض تكون القيمة true إذا تم تغيير المحتوى، وfalse في حال عدم تغييره.

sourceAgnosticCreativeId

sourceAgnosticCreativeId: null | number
رقم تعريف تصميم الإعلان للحجز المعروض أو إعلان الملء اللاحق. تكون القيمة null إذا لم يكن الإعلان حجزًا أو عملية إضافة عناصر سابقة، أو إذا كانت خدمات أخرى غير PubAdsService هي التي تعرِض تصميم الإعلان.

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number
معرّف عنصر العرض للحجز المعروض أو إعلان إعادة التعبئة. تكون القيمة null إذا لم يكن الإعلان حجزًا أو عملية إضافة عناصر سابقة، أو إذا كانت خدمات أخرى غير PubAdsService هي التي تعرِض تصميم الإعلان.

yieldGroupIds

yieldGroupIds: null | number[]
أرقام تعريف مجموعات الشبكات الإعلانية المُدرّة للأرباح لإعلان الملء اللاحق المعروض تكون القيمة null للمواضع الفارغة وإعلانات الحجز وتصميمات الإعلانات التي تعرِضها خدمات غير PubAdsService.

googletag.events.SlotRequestedEvent

تتمديد Event
يتمّ تنشيط هذا الحدث عند طلب إعلان لموضع معيّن.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

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

تتمديد Event
يتمّ تنشيط هذا الحدث عند تلقّي استجابة إعلان لمساحة معيّنة.
الخصائص
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

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

تتمديد Event
يتمّ تنشيط هذا الحدث كلّما تغيّرت النسبة المئوية لمساحة خانة الإعلان على الشاشة. يتمّ الحدّ من معدّل تكرار الحدث ولن يتمّ تشغيله أكثر من مرّة كلّ 200 ملي ثانية.
الخصائص
inViewPercentage
النسبة المئوية لمساحة الإعلان المرئية.
serviceName
اسم الخدمة التي تسبّبت في الحدث
slot
خانة الإعلان التي أدّت إلى ظهور الحدث
مثال

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.
  }
});
انظر أيضًا

الخصائص

inViewPercentage

inViewPercentage: number
النسبة المئوية لمساحة الإعلان المرئية. القيمة هي رقم يتراوح بين 0 و100.

googletag.secureSignals

هذه هي مساحة الاسم التي يستخدمها GPT لإدارة الإشارات الآمنة.
واجهات
BidderSignalProvider
لعرض إشارة آمنة لمقدّم عروض أسعار معيّن.
PublisherSignalProvider
لعرض إشارة آمنة لناشر محدّد.
SecureSignalProvidersArray
واجهة لإدارة الإشارات الآمنة
الأسماء البديلة للبريد الإلكتروني
SecureSignalProvider
واجهة لعرض إشارة آمنة لمقدّم عروض أسعار أو مزوّد خدمة معيّن

الأسماء البديلة للبريد الإلكتروني

SecureSignalProvider

واجهة لعرض إشارة آمنة لمقدّم عروض أسعار أو مزوّد خدمة معيّن يجب تقديم أحد الخيارَين id أو networkCode، ولكن ليس كليهما.

googletag.secureSignals.BidderSignalProvider

لعرض إشارة آمنة لمقدّم عروض أسعار معيّن.

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

  1. دالة جامع تُرجع Promise تؤدي إلى إشارة آمنة
  2. id الذي يحدّد مقدّم عروض الأسعار المرتبط بالإشارة
لعرض إشارة آمنة لناشر، استخدِم secureSignals.PublisherSignalProvider بدلاً من ذلك.
الخصائص
collectorFunction
دالة تعرض Promise تؤدي إلى إشارة آمنة
id
معرّف فريد لآلة جمع البيانات المرتبطة بهذه الإشارة الآمنة، كما هو مسجّل في "مدير إعلانات Google"
مثال

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");
  },
});
انظر أيضًا

الخصائص

collectorFunction

collectorFunction: (() => Promise<string>)
دالة تعرض Promise يُحدَّد مصدره على أنّه إشارة آمنة

id

id: string
معرّف فريد لآلة جمع البيانات المرتبطة بهذه الإشارة الآمنة، كما هو مسجّل في "مدير إعلانات Google"

googletag.secureSignals.PublisherSignalProvider

لعرض إشارة آمنة لناشر معيّن.

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

  1. دالة جامع تُرجع Promise تؤدي إلى إشارة آمنة.
  2. networkCode الذي يحدّد الناشر المرتبط بالإشارة
لعرض إشارة آمنة لمقدّم عرض سعر، استخدِم secureSignals.BidderSignalProvider بدلاً من ذلك.
الخصائص
collectorFunction
دالة تعرض Promise يُحدَّد مصدره على أنّه إشارة آمنة
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");
  },
});
انظر أيضًا

الخصائص

collectorFunction

collectorFunction: (() => Promise<string>)
دالة تعرض Promise يُحدَّد مصدره على أنّه إشارة آمنة

networkCode

networkCode: string
رمز الشبكة (كما هو موضّح في مسار الوحدة الإعلانية) للناشر المرتبط بهذه الإشارة الآمنة.

googletag.secureSignals.SecureSignalProvidersArray

واجهة لإدارة الإشارات الآمنة
الطُرق
clearAllCache
يؤدي هذا الإجراء إلى محو جميع الإشارات لجميع أدوات جمع البيانات من ذاكرة التخزين المؤقت.
push
تُضيف هذه الوظيفة عنصرًا جديدًا من النوع secureSignals.SecureSignalProvider إلى صفيف مقدّمي الإشارات وتبدأ عملية إنشاء الإشارات.

الطُرق

clearAllCache

clearAllCache(): void
تُزيل هذه الطريقة جميع الإشارات لجميع المجمّعين من ذاكرة التخزين المؤقت.

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

الدفع

push(provider: SecureSignalProvider): void
تُضيف هذه الوظيفة عنصرًا جديدًا من النوع secureSignals.SecureSignalProvider إلى صفيف مقدّمي الإشارات وتبدأ عملية إنشاء الإشارات.
المعلمات
provider: SecureSignalProviderعنصر secureSignals.SecureSignalProvider الذي سيتمّ إضافته إلى الصفيف