مرجع علامة "ناشر 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

إشارة إلى قائمة الانتظار الشاملة للأوامر لتنفيذ طلبات ذات صلة بعلامة "ناشر Google" بشكل غير متزامن.

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

---

Const pubadsReady

pubadsReady: boolean | undefined

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

---

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

إشارة إلى صفيف مقدّمي الإشارات الآمنة.

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

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

الدوال

---

companionAds

companionAds(): CompanionAdsService

لعرض مرجع إلى CompanionAdsService.

المرتجعات
CompanionAdsService	خدمة الإعلانات المصاحبة

---

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null

تُنشئ هذه الدالة خانة إعلان خارج الصفحة باستخدام مسار الوحدة الإعلانية المحدّد.

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

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

مثال

JavaScript

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

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

JavaScript (قديم)

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

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

TypeScript

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

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

انظر أيضًا

• عرض إعلان يضم مكافأة
• عرض إعلان بيني على الويب
• عرض إعلان ثابت
• عرض إعلان خارج الصفحة

المعلمات
adUnitPath: string	مسار الوحدة الإعلانية الكامل مع رمز الشبكة ورمز الوحدة الإعلانية
Optional div: string | OutOfPageFormat	رقم تعريف div الذي سيحتوي على هذه الوحدة الإعلانية أو OutOfPageFormat

المرتجعات
Slot | null	خانة المواعيد التي تم إنشاؤها حديثًا، أو null إذا تعذّر إنشاء خانة مواعيد

---

defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null

تُنشئ هذه الوظيفة خانة إعلان باستخدام مسار وحدة إعلانية وحجم معيّنَين وتربطها برقم تعريف عنصر div على الصفحة التي ستحتوي على الإعلان.

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

• بدء استخدام علامات "ناشر 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

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(...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 كما هو محدّد في كائن config.
enableSingleRequest	تفعيل وضع الطلب الفردي لجلب إعلانات متعددة في الوقت نفسه
enableVideoAds	إشارات إلى علامة Google Publisher Tag (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

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void

تُنشئ هذه الدالة خانة إعلانية وتعرضها باستخدام مسار الوحدة الإعلانية وحجمها المحدّدَين. لا تعمل هذه الطريقة مع وضع الطلب الواحد.

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

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

المعلمات
adUnitPath: string	مسار الوحدة الإعلانية للمساحة التي سيتم عرضها.
size: GeneralSize	عرض الفتحة وارتفاعها
Optional div: string | Element	إما رقم تعريف div الذي يحتوي على الفتحة أو عنصر div نفسه.
Optional clickUrl: string	عنوان URL الذي يتم النقر عليه لاستخدامه في هذه الفتحة

---

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void

تفعِّل ميزة "التحميل البطيء" في GPT كما هو محدّد في كائن config. للحصول على أمثلة أكثر تفصيلاً، اطّلِع على نموذج التحميل الكسول.

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

• أفضل الممارسات المتعلّقة بالإعلانات: إعطاء الأولوية لمواضع الإعلانات "المهمة"
• التحميل الكسول

المعلمات

Optional config: {   fetchMarginPercent?: number;   mobileScaling?: number;   renderMarginPercent?: number; }

يتيح عنصر الإعدادات تخصيص السلوك المُهمل. وستستخدم أيّ إعدادات تمّ حذفها إعدادات تلقائية تحدّدها Google وسيتم ضبطها بمرور الوقت. لإيقاف إعداد معيّن، مثل هامش الجلب، اضبط القيمة على -1. fetchMarginPercent الحدّ الأدنى للمسافة التي يجب أن تكون بين الشريحة الإعلانية وإطار العرض الحالي قبل جلب الإعلان كنسبة مئوية من حجم إطار العرض تعني القيمة 0 "عندما تدخل الشريحة إطار العرض"، وتعني القيمة 100 "عندما يكون الإعلان على بُعد إطار عرض واحد"، وهكذا. renderMarginPercent الحد الأدنى للمسافة التي يجب أن تكون بين الشريحة الإعلانية وإطار العرض الحالي قبل عرض إعلان. يتيح ذلك بدء تحميل الإعلان مسبقًا، ولكن مع الانتظار لعرض الموارد الفرعية الأخرى وتنزيلها. تعمل القيمة تمامًا مثل fetchMarginPercent كنسبة مئوية من مساحة العرض. mobileScaling مُضاعِف يُطبَّق على الهوامش على الأجهزة الجوّالة. ويتيح ذلك اختلاف الهوامش على الأجهزة الجوّالة مقارنةً بأجهزة الكمبيوتر المكتبي. على سبيل المثال، ستؤدي القيمة 2.0 إلى ضرب جميع الهوامش في 2 على الأجهزة الجوّالة، ما يزيد الحد الأدنى للمسافة التي يمكن أن تكون فيها خانة قبل جلبها وعرضها.

---

enableSingleRequest

enableSingleRequest(): boolean

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

انظر أيضًا

• أفضل الممارسات المتعلّقة بالإعلانات: استخدام بنية الطلب الواحد بشكل صحيح
• التحكّم في تجميع طلبات البحث في شبكة الإعلانات المتجاوبة

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

---

enableVideoAds

enableVideoAds(): void

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

---

الحصول

get(key: string): null | string

تعرِض هذه الدالة قيمة سمة AdSense المرتبطة بالمفتاح المحدّد.

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

• سمات 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

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

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

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

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

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

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

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

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

---

التصنيف

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

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

انظر أيضًا

• تصنيف IAB للجمهور 1.1
• تصنيف IAB للمحتوى 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?	إعدادات للتحكّم في الإشارات المقدَّمة من الناشر
privacyTreatments?	إعدادات للتحكّم في إجراءات حماية خصوصية الناشر
threadYield?	إعداد للتحكّم في ما إذا كان يجب أن يعرض GPT سلسلة مهام JavaScript عند عرض المواد الإبداعية.

أماكن إقامة

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

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

---

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
تم إيقافها نهائيًا: استخدِم threadYield بدلاً منها. ستتم إزالة هذا الخيار في المستقبل القريب.

---

Optional pps

pps?: null | PublisherProvidedSignalsConfig

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

---

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig

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

---

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

إعداد للتحكّم في ما إذا كان يجب أن تُخرج علامة GPT سلسلة مهام JavaScript عند عرض المواد الإبداعية.

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

القيم المسموح بها:

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

مثال

JavaScript

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

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

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

JavaScript (قديم)

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

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

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

TypeScript

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

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

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

انظر أيضًا

• جدولة

---

googletag.config.PrivacyTreatmentsConfig

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

أماكن إقامة
treatments	مجموعة من إجراءات الخصوصية التي يجب تفعيلها للناشر

أماكن إقامة

---

المعالجات

treatments: null | "disablePersonalization"[]

مجموعة من إجراءات الخصوصية التي يجب تفعيلها للناشر

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

---

googletag.config.PublisherProvidedSignalsConfig

عنصر إعدادات "الإشارات المقدَّمة من الناشر"

أماكن إقامة
taxonomies	عنصر يحتوي على عمليات ربط الفهرسة

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

• لمحة عن الإشارات المقدَّمة من الناشر (إصدار تجريبي)
• تصنيف IAB للجمهور 1.1
• تصنيف IAB للمحتوى 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: 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

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

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

JavaScript (قديم)

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

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

TypeScript

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

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

انظر أيضًا

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

---

googletag.events.RewardedSlotGrantedEvent

تتمديد Event

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

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

مثال

JavaScript

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

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

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

JavaScript (قديم)

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

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

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

TypeScript

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

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

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

انظر أيضًا

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

أماكن إقامة

---

حمولة

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.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (قديم)

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

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

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

TypeScript

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

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

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

انظر أيضًا

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

الطُرق

---

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(provider: SecureSignalProvider): void

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

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