مرجع علامة "ناشر 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 Publisher Console.
pubads	تعرِض هذه السمة مرجعًا إلى PubAdsService.
setAdIframeTitle	تُستخدَم لضبط عنوان جميع إطارات iframe لحاويات الإعلانات التي أنشأها PubAdsService، من هذه النقطة فصاعدًا.
setConfig	لضبط خيارات الإعداد العامة للصفحة.
sizeMapping	لإنشاء SizeMappingBuilder جديد.

الأسماء البديلة

---

GeneralSize

GeneralSize: SingleSize | MultiSize

إعداد حجم صالح لأحد الفتحات، والذي يمكن أن يكون حجمًا واحدًا أو أحجامًا متعددة.

---

MultiSize

MultiSize: SingleSize[]

قائمة بالأحجام الصالحة الفردية

---

NamedSize

NamedSize: "fluid" | ["fluid"]

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

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

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

حجم واحد صالح للفتحة

---

SingleSizeArray

SingleSizeArray: [number, number]

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

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

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

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

قائمة بعمليات ربط الأحجام

المتغيّرات

---

Const apiReady

apiReady: boolean | undefined

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

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

---

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray

إشارة إلى قائمة الطلبات الشاملة لتنفيذ طلبات علامة GPT غير المتزامنة.

يتمّ إعداد المتغيّر googletag.cmd على أنّه صفيف JavaScript فارغ من خلال بنية علامة GPT على الصفحة، و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");

انظر أيضًا

• بدء استخدام علامات "ناشر Google"

المعلمات
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[]	صفيف الفتحات المطلوب إزالتها الصفيف اختياري، وسيتم إتلاف جميع الفتحات في حال عدم تحديده.

المرتجعات
boolean	true إذا تم إتلاف الفتحات، false بخلاف ذلك.

---

disablePublisherConsole

disablePublisherConsole(): void

إيقاف "وحدة تحكّم الناشر في Google"

انظر أيضًا

• Google Publisher Console

---

العرض

display(divOrSlot: string | Element | Slot): void

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

في حال استخدام بنية الطلب الفردي (SRA)، سيتم جلب جميع المساحات الإعلانية التي لم يتم جلبها في وقت استدعاء هذه الطريقة مرة واحدة. لمنع عرض مساحة إعلانية، يجب إزالة div بالكامل.

انظر أيضًا

• بدء استخدام علامات "ناشر Google"
• عرض إعلان اختباري
• التحكّم في تحميل الإعلانات وإعادة تحميلها

المعلمات
divOrSlot: string | Element | Slot	إما معرّف عنصر div الذي يحتوي على خانة الإعلان أو عنصر div أو عنصر خانة الإعلان. في حال تقديم عنصر div، يجب أن يحتوي على سمة id تتطابق مع رقم التعريف الذي تم تمريره إلى defineSlot.

---

enableServices

enableServices(): void

تفعِّل هذه القيمة جميع خدمات GPT التي تم تحديدها للشرائح الإعلانية على الصفحة.

---

getVersion

getVersion(): string

عرض الإصدار الحالي من GPT

انظر أيضًا

• سجلّ إصدارات علامة "ناشر Google"

المرتجعات
string	سلسلة إصدار GPT التي يتم تنفيذها حاليًا

---

openConsole

openConsole(div?: string): void

يؤدي هذا الإجراء إلى فتح Google Publisher Console.

مثال

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

انظر أيضًا

• Google Publisher Console

المعلمات
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

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 محدّد على الصفحة. مكتسَب من Service.addEventListener
getSlots	الحصول على قائمة الفتحات المرتبطة بهذه الخدمة مكتسَب من Service.getSlots
removeEventListener	تزيل مستمعًا مسجَّلاً في السابق. مكتسَب من Service.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: boolean	true لإعادة ملء الفتحات غير المملوءة تلقائيًا، false لتركها بدون تغيير

---

googletag.PrivacySettingsConfig

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

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

انظر أيضًا

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

الخصائص

---

Optional childDirectedTreatment

childDirectedTreatment?: null | boolean

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

---

Optional limitedAds

limitedAds?: boolean

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

يمكنك توجيه GPT لطلب الإعلانات المحدودة بطريقتَين:

• تلقائيًا، باستخدام إشارة من منصّة إدارة الموافقة الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB
• يدويًا، من خلال ضبط قيمة هذا الحقل على true
لا يمكن ضبط الإعلانات المحدودة يدويًا إلا عند تحميل 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 محدّد على الصفحة. مكتسَب من Service.addEventListener
clear	تزيل هذه الطريقة الإعلانات من الفتحات المحدّدة وتستبدلها بمحتوى فارغ.
clearCategoryExclusions	تمحو جميع تصنيفات استبعاد فئات الإعلانات على مستوى الصفحة.
clearTargeting	تمحو هذه القيمة مَعلمات الاستهداف المخصّصة لمفتاح معيّن أو لجميع المفاتيح.
collapseEmptyDivs	يتيح هذا الخيار تصغير divs للّقطات كي لا تشغل أي مساحة على الصفحة عندما لا يكون هناك محتوى إعلاني لعرضه.
disableInitialLoad	يؤدي هذا الخيار إلى إيقاف طلبات الإعلانات عند تحميل الصفحة، ولكنه يسمح بطلب الإعلانات من خلال طلب PubAdsService.refresh.
display	تُنشئ هذه الدالة خانة إعلانية وتعرضها باستخدام مسار الوحدة الإعلانية وحجمها المحدّدَين.
enableLazyLoad	تفعِّل ميزة "التحميل البطيء" في GPT كما هو محدّد في كائن الإعداد.
enableSingleRequest	تفعيل وضع الطلب الفردي لجلب إعلانات متعددة في الوقت نفسه
enableVideoAds	إشارات إلى GPT بأنّ إعلانات الفيديو ستظهر على الصفحة
get	تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد.
getAttributeKeys	تعرِض مفاتيح السمات التي تم ضبطها على هذه الخدمة.
getSlots	الحصول على قائمة الفتحات المرتبطة بهذه الخدمة مكتسَب من Service.getSlots
getTargeting	تعرِض هذه الدالة مَعلمة استهداف مخصّصة محدّدة على مستوى الخدمة تمّ ضبطها.
getTargetingKeys	تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة على مستوى الخدمة التي تمّ ضبطها.
isInitialLoadDisabled	تعرِض هذه السمة ما إذا تم إيقاف الطلبات الأولية للإعلانات بنجاح من خلال طلب سابق من PubAdsService.disableInitialLoad أم لا.
refresh	تُستخدَم هذه الوظيفة لجلب إعلانات جديدة وعرضها في خانات معيّنة أو جميع الخانات على الصفحة.
removeEventListener	تزيل مستمعًا مسجَّلاً في السابق. مكتسَب من Service.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(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 كما هو محدّد في كائن الإعداد. للحصول على أمثلة أكثر تفصيلاً، اطّلِع على نموذج التحميل البطيء.

ملاحظة: لا تعمل ميزة "التحميل البطيء" في 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

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

---

get

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'.

انظر أيضًا

• سمات AdSense

المعلمات
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(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");

انظر أيضًا

• سمات AdSense

المعلمات
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: boolean	true لمحاذاة الإعلانات في الوسط، 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");

انظر أيضًا

• عرض المواد الإبداعية باستخدام SafeFrame

المعلمات
forceSafeFrame: boolean	true لفرض عرض جميع الإعلانات على الصفحة في إطارات 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");

انظر أيضًا

• عرض المواد الإبداعية باستخدام SafeFrame

المعلمات
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".

انظر أيضًا

• مَعلمات عناوين URL لعلامات إعلانات نموذج عرض إعلانات الفيديو (VAST)

المعلمات
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	رقم تعريف العنصر.

انظر أيضًا

• Slot.getResponseInformation

الخصائص

---

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 نطاقات فرعية عشوائية للمواد الإبداعية للحجز

انظر أيضًا

• PubAdsService.setSafeFrameConfig

الخصائص

---

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 لمحو القيمة المخزّنة.

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

ميزة متوقّفة نهائيًا: لم يعُد بإمكانك إيقاف هذه الميزة. ليس للإعداد useUniqueDomain أي تأثير.

انظر أيضًا

• عرض المواد الإبداعية باستخدام SafeFrame

---

googletag.Service

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

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

الطُرق

---

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service

يُسجِّل أداة مراقبة أحداث تتيح لك إعداد دالة JavaScript واستدعاؤها عند حدوث حدث معيّن من GPT على الصفحة. الأحداث التالية متاحة:

• events.GameManualInterstitialSlotClosedEvent
• events.GameManualInterstitialSlotReadyEvent
• events.ImpressionViewableEvent
• events.RewardedSlotClosedEvent
• events.RewardedSlotGrantedEvent
• events.RewardedSlotReadyEvent
• events.SlotOnloadEvent
• events.SlotRenderEndedEvent
• events.SlotRequestedEvent
• events.SlotResponseReceived
• events.SlotVisibilityChangedEvent
يتم تمرير عنصر من نوع الحدث المناسب إلى أداة المعالجة عند استدعائها.

مثال

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

انظر أيضًا

• بدء استخدام علامات "ناشر Google"
• عرض إعلان اختباري

المعلمات
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

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'.

انظر أيضًا

• سمات AdSense

المعلمات
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(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());

انظر أيضًا

• سمات AdSense

المعلمات
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());

انظر أيضًا

• عرض المواد الإبداعية باستخدام SafeFrame

المعلمات
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");

انظر أيضًا

• عرض المواد الإبداعية باستخدام SafeFrame

المعلمات
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	كائن إعدادات "الإشارات المقدَّمة من الناشر" (PPS)
SlotSettingsConfig	واجهة الضبط الرئيسية للإعدادات على مستوى الفتحة
TaxonomyData	عنصر يحتوي على قيم تصنيف واحد

الأسماء البديلة
InterstitialTrigger	عوامل تشغيل الإعلانات البينية المتوافقة
PrivacyTreatment	إجراءات حماية خصوصية الناشرين المتوافقة
Taxonomy	التصنيفات المتوافقة مع الإشارات المقدَّمة من الناشر (PPS)

الأسماء البديلة

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

عوامل تشغيل الإعلانات البينية المتوافقة

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

إجراءات حماية خصوصية الناشرين المتوافقة

---

التصنيف

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

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

انظر أيضًا

• IAB Audience Taxonomy 1.1
• IAB Content Taxonomy 2.2

---

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	مفتاح الضبط المرتبط بمزاد المكوّن هذا.

انظر أيضًا

• دليل البائعين لاستخدام Protected Audience API: تنفيذ مزادات الإعلانات

الخصائص

---

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

انظر أيضًا

• Protected Audience API: بدء مزاد على الجهاز

---

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"
متوقف نهائيًا: استخدِم threadYield بدلاً من ذلك. ستتم إزالة هذه الميزة في المستقبل القريب.

---

Optional pps

pps?: null | PublisherProvidedSignalsConfig

إعدادات للتحكّم في الإشارات المقدَّمة من الناشر (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 سلسلة مهام JavaScript لجميع الفتحات بغض النظر عمّا إذا كانت الفتحة ضمن إطار العرض.
• DISABLED: لن تُظهر علامة "ناشر Google" سلسلة محادثات 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

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

الخصائص
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'
    },
  },
});

انظر أيضًا

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

الخصائص

---

التصنيفات

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

انظر أيضًا

• defineOutOfPageSlot

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

---

TrafficSource

TrafficSource

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

انظر أيضًا

• PrivacySettingsConfig.trafficSource

عناصر التعداد
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

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

---

googletag.events.EventTypeMap

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

الخصائص
gameManualInterstitialSlotClosed	عنوان بديل لـ events.GameManualInterstitialSlotClosedEvent.
gameManualInterstitialSlotReady	عنوان بديل لـ events.GameManualInterstitialSlotReadyEvent.
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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.slot

مثال

JavaScript

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

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

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

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

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

TypeScript

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

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

انظر أيضًا

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

---

googletag.events.GameManualInterstitialSlotReadyEvent

تمديد Event

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

ملاحظة: الإعلان البيني اليدوي في اللعبة هو تنسيق بإمكانية وصول محدودة.

الخصائص
serviceName	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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,
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

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

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

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

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

TypeScript

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

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

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

انظر أيضًا

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

الطُرق

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void

تعرِض هذه السمة الإعلان البيني لدليل اللعبة للمستخدم.

---

googletag.events.ImpressionViewableEvent

تمديد Event

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

الخصائص
serviceName	اسم الخدمة التي أدّت إلى حدوث الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي أدّت إلى حدوث الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
size	تشير إلى حجم البكسل لتصميم الإعلان المعروض.
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي تسبّبت في الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي أدّت إلى حدوث الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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	اسم الخدمة التي أدّت إلى حدوث الحدث. مكتسَب من Event.serviceName
slot	خانة الإعلان التي أدّت إلى ظهور الحدث مكتسَب من Event.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

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

واجهة لعرض إشارة آمنة لمقدّم عروض أسعار أو مزوّد خدمة معيّن يجب تقديم أحد الخيارَين 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

push(provider: SecureSignalProvider): void

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

المعلمات
provider: SecureSignalProvider	عنصر secureSignals.SecureSignalProvider الذي سيتمّ إضافته إلى الصفيف