مرجع علامة "ناشر 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 تقبل الدوالّ. تقبل معلَمات الاستراحة عددًا غير محدود من القيم من النوع المحدّد.

---

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.api ready، لأنّ تنفيذها مضمون بمجرد إعداد واجهة برمجة التطبيقات.

---

Const cmd

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

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

يتمّ إعداد المتغيّر googletag.cmd على أنّه صفيف JavaScript فارغ من خلال بنية علامة "ناشر Google" على الصفحة، وcmd.push هي طريقة Array.push العادية التي تضيف عنصرًا إلى نهاية الصفيف. عند تحميل JavaScript لـ GPT، تبحث في الصفيف وتنفّذ جميع الدوال بالترتيب. يستبدل النص البرمجي بعد ذلك cmd بكائن CommandArray الذي تم تحديد طريقة الإرسال له لتنفيذ وسيطة الدالة التي تم تمريرها إليها. تسمح هذه الآلية لنموذج 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

---

الشبكة الإعلانية

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	رقم تعريف قسم الشريحة الإعلانية هذه القيمة اختيارية. عند توفير "وحدة تحكم الناشر"، ستحاول فتح "وحدة تحكُّم الناشر" بتفاصيل عن الشريحة الإعلانية المحدّدة في العرض.

---

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(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 نفسه
Optional clickUrl: string	عنوان URL الذي يتم النقر عليه لاستخدامه في هذه الفتحة

---

enableLazyLoad

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

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

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

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

المعلمات

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

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

---

enableSingleRequest

enableSingleRequest(): boolean

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

انظر أيضًا

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

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

---

enableVideoAds

enableVideoAds(): void

إشارات إلى علامة 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	معرّف Content ID للفيديو
videoCmsId: string	رقم تعريف نظام إدارة المحتوى للفيديو

---

updateCorrelator

updateCorrelator(): PubAdsService

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

ملاحظة: لا يؤثر هذا الإجراء في مشاهدة الصفحة الطويلة الأجل في علامة "علامة ناشر Google" (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 للصفحة المقصودة مرتبط بتصميم الإعلان المعروض إلى القيمة المقدَّمة. وتحل المكالمات اللاحقة محل القيمة. ولا تعمل هذه الطريقة إلا مع الطلبات غير التابعة لـ SRA.

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

المعلمات
value: string	عنوان URL للنقر المطلوب ضبطه.

المرتجعات
Slot	عنصر الفتحة الذي تمّ استدعاء الطريقة عليه

---

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot

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

مثال

JavaScript

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

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

JavaScript (قديم)

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

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

TypeScript

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

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

انظر أيضًا

• تصغير خانات الإعلانات الفارغة
• الحدّ من تغيُّر التنسيق

المعلمات
collapse: boolean	ما إذا كان سيتم تصغير المربّع في حال عدم عرض أي إعلان.
Optional collapseBeforeAdFetch: boolean	ما إذا كان سيتم تصغير المساحة حتى قبل جلب إعلان يتم تجاهله إذا لم يكن العنصر المُدمَج هو true.

المرتجعات
Slot	عنصر الفتحة الذي تمّ استدعاء الطريقة عليه

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): void

لضبط خيارات الضبط العامة لهذه الخانة.

المعلمات
slotConfig: SlotSettingsConfig	عنصر الضبط

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

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

يُرجى مراعاة النقاط التالية أثناء استخدام واجهة برمجة التطبيقات هذه:

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

• عرض تصاميم إعلانات باستخدام "الإطار الآمن"

المعلمات
forceSafeFrame: boolean	‫true لإجبار جميع الإعلانات في هذا الموضع على عرضها في إطارات آمنة و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)

انظر أيضًا

• الإصدار 1.1 من تصنيف الجمهور الصادر عن مكتب IAB
• تصنيف 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?: 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

عنصر يحدّد سلوك خانة إعلان بيني واحد

أماكن إقامة
triggers?	إعداد مشغّل الإعلان البيني لهذا الإعلان البيني.

أماكن إقامة

---

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

triggers?: Partial<Record<InterstitialTrigger, boolean>>

إعداد مشغّل الإعلان البيني لهذا الإعلان البيني.

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

مثال

JavaScript

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

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

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

JavaScript (قديم)

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

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

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

TypeScript

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

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

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

انظر أيضًا

• عرض إعلان بيني على الويب

---

googletag.config.PageSettingsConfig

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

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

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

أمثلة:

• لا يتم تعديل سوى الميزات المحدّدة في طلب googletag.setConfig.

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

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

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

• يمكن محو جميع إعدادات إحدى الميزات من خلال إرسال القيمة null.

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

أماكن إقامة
adExpansion?	إعدادات للتحكّم في توسيع الإعلان
adYield?	تمّ إيقافه نهائيًا.
pps?	إعدادات للتحكُّم في "الإشارات المقدَّمة من الناشر" (PPS).
privacyTreatments?	إعدادات للتحكّم في إجراءات حماية خصوصية الناشر
threadYield?	إعداد للتحكّم في ما إذا كان يجب أن يعرض GPT سلسلة مهام JavaScript عند عرض المواد الإبداعية.

أماكن إقامة

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

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

---

Optional adYield

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

---

Optional pps

pps?: null | PublisherProvidedSignalsConfig

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

---

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig

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

---

Optional threadYield

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

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

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

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

• null (تلقائي): تعرض GPT سلسلة محادثات JS للخانات خارج إطار العرض.
• 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: "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'
    },
  },
});

انظر أيضًا

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

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

---

Optional componentAuction

componentAuction?: ComponentAuctionConfig[]

صفيف من مزادات المكوّنات المطلوب تضمينها في مزاد إعلانات على الجهاز

---

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

interstitial?: InterstitialConfig

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

---

googletag.config.TaxonomyData

عنصر يحتوي على قيم تصنيف واحد

أماكن إقامة
values	قائمة بقيم التصنيف

أماكن إقامة

---

القيم

values: string[]

قائمة بقيم التصنيف

---

googletag.enums

هذه هي مساحة الاسم التي تستخدمها GPT لأنواع التعداد.

التعدادات
OutOfPageFormat	تنسيقات الإعلانات خارج الصفحة المتوافقة مع جدول تقسيم المعرّف الفريد العمومي.
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 الذي سيتمّ إضافته إلى الصفيف