مرجع علامة "ناشر 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 Publisher Tag لواجهة برمجة التطبيقات

مساحات الاسم
config	واجهة الإعداد الرئيسية لإعدادات مستوى الصفحة
enums	هذه هي مساحة الاسم التي تستخدمها GPT لأنواع التعداد.
events	هذه هي مساحة الاسم التي تستخدمها GPT للأحداث.
secureSignals	هذه هي مساحة الاسم التي تستخدمها GPT لإدارة الإشارات الآمنة.

واجهات
CommandArray	يقبل مصفوفة الأوامر تسلسلاً من الدوال ويستدعيها بالترتيب.
CompanionAdsService	خدمة "الإعلانات المصاحبة"
PrivacySettingsConfig	عنصر الإعدادات الخاصّة بالخصوصية
PubAdsService	خدمة "إعلانات الناشرين"
ResponseInformation	عنصر يمثّل استجابة إعلان واحدة.
RewardedPayload	عنصر يمثّل المكافأة المرتبطة بالإعلان مقابل مكافأة
Service	فئة الخدمة الأساسية التي تحتوي على طرق شائعة لجميع الخدمات
SizeMappingBuilder	أداة إنشاء لعناصر مواصفات ربط الحجم.
Slot	الخانة الإعلانية هي عنصر يمثّل خانة إعلانية واحدة على الصفحة.

الأسماء المستعارة للأنواع
GeneralSize	إعداد حجم صالح لموضع إعلان، ويمكن أن يكون حجمًا واحدًا أو أحجامًا متعددة.
MultiSize	قائمة بأحجام صالحة فردية
NamedSize	أحجام مُسمّاة يمكن أن يحتوي عليها موضع الإعلان.
SingleSize	حجم واحد صالح لخانة إعلانية
SingleSizeArray	مصفوفة من رقمَين يمثّلان [العرض، الارتفاع].
SizeMapping	عملية ربط بين حجم إطار العرض وأحجام الإعلانات
SizeMappingArray	قائمة بعمليات ربط الأحجام

المتغيّرات
apiReady	علامة تشير إلى أنّه تم تحميل واجهة برمجة تطبيقات "ناشر Google" وأصبحت جاهزة للاستخدام.
cmd	مرجع لقائمة انتظار الأوامر العامة للتنفيذ غير المتزامن للمكالمات ذات الصلة بعلامة "ناشر Google"
pubadsReady	علامة تشير إلى أنّ PubAdsService مفعَّلة ومحمَّلة وتعمل بشكل كامل.
secureSignalProviders	مرجع إلى مصفوفة مقدّمي الإشارات الآمنة.

الدوال
companionAds	تعرض هذه الطريقة مرجعًا إلى CompanionAdsService.
defineOutOfPageSlot	تنشئ هذه الدالة خانة إعلانية خارج الصفحة باستخدام مسار الوحدة الإعلانية المحدّد.
defineSlot	تنشئ هذه الدالة خانة إعلانية باستخدام مسار وحجم وحدة إعلانية محدّدين، وتربطها برقم تعريف عنصر div في الصفحة سيحتوي على الإعلان.
destroySlots	تؤدي هذه الطريقة إلى إتلاف المواضع الإعلانية المحدّدة، وإزالة جميع العناصر والمراجع ذات الصلة بهذه المواضع من GPT.
disablePublisherConsole	يؤدي ذلك إلى إيقاف "وحدة تحكّم ناشري Google".
display	توجّه خدمات الفتحة لعرض الفتحة.
enableServices	تفعيل جميع خدمات GPT التي تم تحديدها لمساحات عرض الإعلانات على الصفحة
getConfig	تعرض هذه السمة خيارات الضبط العامة للصفحة التي تم ضبطها باستخدام setConfig.
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"]

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

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

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

حجم واحد صالح لخانة إعلانية

---

SingleSizeArray

SingleSizeArray: [number, number]

مصفوفة من رقمَين يمثّلان [العرض، الارتفاع].

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

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

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

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

المتغيّرات

---

Const apiReady

apiReady: boolean | undefined

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

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

---

Const cmd

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

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

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

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

المرتجعات
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 التي تم تحديدها لمساحات عرض الإعلانات على الصفحة

---

getConfig

getConfig(keys: string | string[]): Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">

تعرض هذه الدالة خيارات الإعداد العامة للصفحة التي تم ضبطها باستخدام setConfig.

لا تتوافق هذه الطريقة مع جميع خصائص setConfig(). السمات المتوافقة هي:

• adsenseAttributes
• disableInitialLoad
• targeting

مثال

JavaScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

JavaScript (قديمة)

// Get the value of the `targeting` setting.
var targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
var config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

TypeScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

المعلمات
keys: string | string[]	مفاتيح خيارات الإعداد المطلوب الحصول عليها.

المرتجعات
Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">	خيارات الإعداد للفتحة.

---

getVersion

getVersion(): string

تعرض هذه السمة الإصدار الحالي من GPT.

انظر أيضًا

• سجلّ إصدارات GPT

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

---

openConsole

openConsole(div?: string): void

يفتح هذا الخيار "وحدة تحكّم الناشرين من Google".

مثال

JavaScript

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

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

JavaScript (قديمة)

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

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

TypeScript

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

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

انظر أيضًا

• وحدة تحكّم الناشرين من Google

المعلمات
Optional div: string	رقم تعريف div الخاص بالخانة الإعلانية هذه القيمة اختيارية. عند توفّرها، ستحاول "وحدة تحكّم الناشر" الفتح مع عرض تفاصيل موضع الإعلان المحدّد.

---

pubads

pubads(): PubAdsService

تعرض هذه الطريقة مرجعًا إلى PubAdsService.

المرتجعات
PubAdsService	خدمة "إعلانات الناشرين"

---

setAdIframeTitle

setAdIframeTitle(title: string): void

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

مثال

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (قديمة)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

المعلمات
title: string	العنوان الجديد لجميع إطارات iframe الخاصة بحاويات الإعلانات

---

setConfig

setConfig(config: PageSettingsConfig): void

تضبط هذه السمة خيارات الإعداد العامة للصفحة.

المعلمات
config: PageSettingsConfig

---

sizeMapping

sizeMapping(): SizeMappingBuilder

تُنشئ هذه الطريقة SizeMappingBuilder جديدًا.

انظر أيضًا

• أحجام الإعلانات: الإعلانات المتجاوبة

المرتجعات
SizeMappingBuilder	أداة إنشاء جديدة

---

googletag.CommandArray

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

الطُرق
push	تنفِّذ هذه الدالة تسلسل الدوال المحدّدة في الوسيطات بالترتيب.

الطُرق

---

push

push(...f: ((this: typeof globalThis) => void)[]): number

تنفِّذ هذه الدالة تسلسل الدوال المحدّدة في الوسيطات بالترتيب.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

المعلمات
Rest ...f: ((this: typeof globalThis) => void)[]	دالة JavaScript سيتم تنفيذها سيكون الربط في وقت التشغيل دائمًا globalThis. ننصحك بتمرير دالة سهمية للاحتفاظ بقيمة this لسياق المعجم المحيط.

المرتجعات
number	عدد الأوامر التي تمت معالجتها حتى الآن وهذا متوافق مع القيمة المعروضة للدالة Array.push (الطول الحالي للمصفوفة).

---

googletag.CompanionAdsService

تمديد Service

خدمة "الإعلانات المصاحبة" تستخدم إعلانات الفيديو هذه الخدمة لعرض الإعلانات المصاحبة.

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

انظر أيضًا

• الإعلانات المصاحبة للفيديو والصوت

الطُرق

---

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void

تضبط هذه السمة ما إذا كان سيتم تلقائيًا إعادة ملء مواضع الإعلانات المصاحبة التي لم يتم ملؤها.

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

مثال

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (قديمة)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

المعلمات
value: boolean	true لملء الخانات غير المملوءة تلقائيًا، false لتركها بدون تغيير

---

googletag.PrivacySettingsConfig

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

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

انظر أيضًا

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

الخصائص

---

Optional childDirectedTreatment

childDirectedTreatment?: 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?: boolean

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

---

googletag.PubAdsService

تمديد Service

خدمة "إعلانات الناشرين" تُستخدَم هذه الخدمة لجلب الإعلانات وعرضها من حسابك على "مدير إعلانات Google".

الطُرق
addEventListener	تسجّل هذه السمة أداة معالجة حدث تتيح لك إعداد دالة JavaScript واستدعاءها عند وقوع حدث معيّن من GPT على الصفحة. مكتسب من Service.addEventListener
clear	تزيل هذه الطريقة الإعلانات من المواضع المحدّدة وتستبدلها بمحتوى فارغ.
clearCategoryExclusions	يمحو جميع تصنيفات استبعاد فئات الإعلانات على مستوى الصفحة.
clearTargeting	محو مَعلمات الاستهداف المخصّص لمفتاح معيّن أو لجميع المفاتيح
collapseEmptyDivs	يتيح تصغير عناصر div الخاصة بالخانة الإعلانية كي لا تشغل أي مساحة على الصفحة عندما لا يتوفّر محتوى إعلاني لعرضه.
disableInitialLoad	يوقف طلبات الإعلانات عند تحميل الصفحة، ولكن يسمح بطلب الإعلانات باستخدام استدعاء PubAdsService.refresh.
display	تنشئ هذه الدالة خانة إعلانية وتعرضها باستخدام مسار الوحدة الإعلانية والحجم المحدّدَين.
enableLazyLoad	تفعيل التحميل الكسول في GPT على النحو المحدّد في كائن الإعدادات
enableSingleRequest	تفعيل وضع الطلب الفردي لجلب إعلانات متعددة في الوقت نفسه
enableVideoAds	تشير هذه السمة إلى "علامة ناشر Google" بأنّ إعلانات الفيديو ستظهر على الصفحة.
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

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

انظر أيضًا

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

المعلمات
Optional collapseBeforeAdFetch: boolean	تحديد ما إذا كان سيتم تصغير الخانات حتى قبل استرداد الإعلانات هذه المَعلمة اختيارية، وفي حال عدم توفيرها، سيتم استخدام false كقيمة تلقائية.

المرتجعات
boolean	تعرِض هذه السمة القيمة true إذا تم تفعيل وضع تصغير div، والقيمة false إذا تعذّر تفعيل وضع التصغير لأنّه تم استدعاء الطريقة بعد تفعيل الخدمة.

---

disableInitialLoad

disableInitialLoad(): void

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

انظر أيضًا

• التحكّم في تحميل الإعلانات وإعادة تحميلها
• التحكّم في تجميع طلبات الإعلانات المتزامنة

---

عرض

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

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

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

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

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

---

enableLazyLoad

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

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

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

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

المعلمات

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

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

---

enableSingleRequest

enableSingleRequest(): boolean

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

انظر أيضًا

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

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

---

enableVideoAds

enableVideoAds(): void

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

---

get

get(key: string): 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	اسم السمة المطلوب البحث عنها.

المرتجعات
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?: 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: Slot[]	الفتحات التي سيتم إعادة تحميلها المصفوفة اختيارية، وسيتم إعادة تحميل جميع الخانات إذا لم يتم تحديدها.
Optional options: {   changeCorrelator: boolean; }	خيارات الإعداد المرتبطة بطلب إعادة التحميل هذا تحدّد السمة changeCorrelator ما إذا كان سيتم إنشاء معرّف ارتباط جديد لجلب الإعلانات أم لا. تحتفظ خوادم الإعلانات بقيمة معرّف الربط هذا لفترة وجيزة (30 ثانية حاليًا، ولكنّها قابلة للتغيير)، بحيث يتم اعتبار الطلبات التي تتضمّن معرّف الربط نفسه والتي يتم تلقّيها في وقت قريب مشاهدة واحدة للصفحة. يتم تلقائيًا إنشاء معرّف ربط جديد في كل مرة يتم فيها إعادة التحميل. ملاحظة: ليس لهذا الخيار أي تأثير في عرض الصفحة لفترة طويلة في GPT، والذي يعرض تلقائيًا الإعلانات الحالية على الصفحة وليس له وقت انتهاء صلاحية.

---

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 لفرض عرض جميع الإعلانات على الصفحة في إطارات SafeFrame وfalse لتغيير الإعداد السابق إلى "خطأ". لن يؤدي ضبط هذا الخيار على false عندما لا يتم تحديده مسبقًا إلى تغيير أي شيء.

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الدالة عليه.

---

setLocation

setLocation(address: string): PubAdsService

تنقل معلومات الموقع الجغرافي من المواقع الإلكترونية حتى تتمكّن من استهداف عناصر الحملات حسب الموقع الجغرافي في مواقع جغرافية معيّنة.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

المعلمات
address: string	عنوان بتنسيق حر

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الطريقة عليه

---

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

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

مثال

JavaScript

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

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

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

JavaScript (قديمة)

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

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

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

TypeScript

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

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

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

انظر أيضًا

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

المعلمات
privacySettings: PrivacySettingsConfig	عنصر يحتوي على إعدادات الخصوصية.

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الدالة عليه.

---

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService

تضبط هذه السمة قيمة المعرّف المقدَّم من الناشر.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

• لمحة عن المعرّفات المقدَّمة من الناشر

المعلمات
ppid: string	معرّف أبجدي رقمي يقدّمه الناشر. يجب أن يتراوح عدد الأحرف بين 32 و150 حرفًا.

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الطريقة عليه

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService

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

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

مثال

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

JavaScript (قديمة)

googletag.pubads().setForceSafeFrame(true);

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

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

انظر أيضًا

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

المعلمات
config: SafeFrameConfig	كائن الإعدادات

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الطريقة عليه

---

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService

تضبط هذه الطريقة مَعلمات استهداف مخصّصة لمفتاح معيّن تنطبق على جميع خانات الإعلانات في خدمة "إعلانات الناشرين". سيؤدي طلب هذا الإجراء عدة مرات للمفتاح نفسه إلى استبدال القيم القديمة. يتم تحديد هذه المفاتيح في حسابك على "مدير إعلانات Google".

مثال

JavaScript

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

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

JavaScript (قديمة)

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

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

TypeScript

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

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

انظر أيضًا

• الاستهداف حسب المفتاح والقيمة

المعلمات
key: string	مفتاح مَعلمة الاستهداف.
value: string | string[]	قيمة مَعلمة الاستهداف أو مصفوفة القيم

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الطريقة عليه

---

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void

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

انظر أيضًا

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

المعلمات
videoContentId: string	رقم تعريف محتوى الفيديو
videoCmsId: string	معرّف نظام إدارة المحتوى للفيديو

---

updateCorrelator

updateCorrelator(): PubAdsService

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

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

مثال

JavaScript

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

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

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

JavaScript (قديمة)

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

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

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

TypeScript

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

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

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

المرتجعات
PubAdsService	كائن الخدمة الذي تم استدعاء الدالة عليه.

---

googletag.ResponseInformation

عنصر يمثّل استجابة إعلان واحدة.

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

انظر أيضًا

• Slot.getResponseInformation

الخصائص

---

advertiserId

advertiserId: number

رقم تعريف المعلِن.

---

campaignId

campaignId: number

رقم تعريف الحملة.

---

creativeId

creativeId: number

معرّف تصميم الإعلان.

---

creativeTemplateId

creativeTemplateId: number

رقم تعريف نموذج الإعلان.

---

lineItemId

lineItemId: number

معرّف السلعة.

---

googletag.RewardedPayload

عنصر يمثّل المكافأة المرتبطة بإعلان مقابل مكافأة

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

انظر أيضًا

• عرض إعلان مقابل مكافأة

الخصائص

---

amount

amount: number

عدد السلع المضمّنة في المكافأة.

---

type

type: string

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

---

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(): SizeMappingArray

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

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

ملاحظة: لا يمكن تحديد سلوك أداة الإنشاء بعد استدعاء هذه الطريقة.

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

---

googletag.Slot

الخانة الإعلانية هي عنصر يمثّل خانة إعلانية واحدة على الصفحة.

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

الطُرق

---

addService

addService(service: Service): Slot

تضيف هذه السمة خدمة إلى هذا الموضع.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

المعلمات
service: Service	الخدمة التي ستتم إضافتها

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

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

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

مثال

JavaScript

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

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

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

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

JavaScript (قديمة)

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

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

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

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

TypeScript

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

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

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

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

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

---

clearTargeting

clearTargeting(key?: string): Slot

يمحو هذا الإجراء مَعلمات الاستهداف المخصّصة المحدّدة أو جميعها على مستوى موضع الإعلان.

مثال

JavaScript

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

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

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

JavaScript (قديمة)

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

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

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

TypeScript

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

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

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

انظر أيضًا

• الاستهداف حسب المفتاح والقيمة

المعلمات
Optional key: string	مفتاح مَعلمة الاستهداف. المفتاح اختياري، وسيتم محو جميع مَعلمات الاستهداف إذا لم يتم تحديده.

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

---

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

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

مثال

JavaScript

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

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

slot.defineSizeMapping(mapping);

JavaScript (قديمة)

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

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

slot.defineSizeMapping(mapping);

TypeScript

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

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

slot.defineSizeMapping(mapping!);

انظر أيضًا

• أحجام الإعلانات: الإعلانات المتجاوبة

المعلمات
sizeMapping: SizeMappingArray	مجموعة من عمليات ربط الأحجام. يمكنك استخدام SizeMappingBuilder لإنشائه. كل عملية ربط بالحجم هي عبارة عن مصفوفة من عنصرَين: SingleSizeArray وGeneralSize.

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

---

get

get(key: string): 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	اسم السمة المطلوب البحث عنها.

المرتجعات
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[]	تصنيفات استبعاد فئات الإعلانات لهذه الخانة، أو مصفوفة فارغة إذا لم يتم ضبط أي تصنيفات

---

getConfig

getConfig(keys: string | string[]): Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">

تعرض هذه الدالة خيارات الإعداد العامة للصفحة التي تم ضبطها باستخدام setConfig.

لا تتوافق هذه الطريقة مع جميع خصائص setConfig(). السمات المتوافقة هي:

• adsenseAttributes
• categoryExclusion
• targeting

مثال

JavaScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

JavaScript (قديمة)

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

// Get the value of the `targeting` setting.
var targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
var config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

TypeScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

المعلمات
keys: string | string[]	مفاتيح خيارات الإعداد المطلوب الحصول عليها.

المرتجعات
Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">	خيارات الإعداد للفتحة.

---

getResponseInformation

getResponseInformation(): ResponseInformation

تعرِض هذه السمة معلومات استجابة الإعلان. ويستند ذلك إلى آخر ردّ تلقّته الخانة الإعلانية. إذا تم استدعاء هذه الطريقة عندما لا تحتوي الخانة على إعلان، سيتم عرض 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());

انظر أيضًا

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

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

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

---

setSafeFrameConfig

setSafeFrameConfig(config: 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: 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	إعدادات للتحكّم في توسيع الإعلانات
AdSenseAttributesConfig	إعدادات للتحكّم في سلوك إعلانات AdSense
ComponentAuctionConfig	كائن يمثّل مزادًا واحدًا للمكوّنات في مزاد إعلانات على الجهاز
InterstitialConfig	عنصر يحدّد سلوك خانة إعلانية بينية واحدة.
LazyLoadConfig	إعدادات للتحكّم في استخدام التحميل البطيء في علامات "ناشر Google"
PageSettingsConfig	واجهة الإعداد الرئيسية لإعدادات مستوى الصفحة
PrivacyTreatmentsConfig	إعدادات للتحكّم في طريقة تعامل الناشرين مع الخصوصية
PublisherProvidedSignalsConfig	كائن إعدادات "الإشارات المقدَّمة من الناشر" (PPS)
SafeFrameConfig	إعدادات التحكّم في SafeFrame في GPT
SlotSettingsConfig	واجهة الضبط الرئيسية لإعدادات مستوى الفتحة
TaxonomyData	عنصر يحتوي على قيم التصنيف الفردي.
VideoAdsConfig	إعدادات لضبط الإعدادات ذات الصلة بإعلانات الفيديو

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

الأسماء المستعارة للأنواع

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

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

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

طرق التعامل مع الخصوصية المتاحة للناشرين

---

التصنيف

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

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

انظر أيضًا

• تصنيف IAB للجمهور 1.1
• الإصدار 2.2 من تصنيف IAB للمحتوى

---

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

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

يمكن استخدام هذه السمات لتجاوز الإعدادات من جهة الخادم على أساس كل طلب على حدة.

الخصائص
adsense_ad_format?	شكل إعلان AdSense
adsense_channel_ids?	معرّفات قنوات AdSense
adsense_test_mode?	تحديد ما إذا كان "وضع الاختبار" مفعَّلاً أم لا
document_language?	لغة الصفحة التي يتم عرض الإعلانات عليها
page_url?	عنوان URL للصفحة التي يتم عرض الإعلانات عليها

انظر أيضًا

• PageSettingsConfig.adsenseAttributes
• SlotSettingsConfig.adsenseAttributes

الخصائص

---

Optional adsense_ad_format

adsense_ad_format?: "120x240_as" | "120x600_as" | "125x125_as" | "160x600_as" | "180x150_as" | "200x200_as" | "234x60_as" | "250x250_as" | "300x250_as" | "336x280_as" | "468x60_as" | "728x90_as"

شكل إعلان AdSense

---

Optional adsense_channel_ids

adsense_channel_ids?: string

معرّفات قنوات AdSense

القيم المسموح بها هي معرّفات القنوات مفصولة بعلامة "+".

مثال: 271828183+314159265

انظر أيضًا

• تتبُّع أداء الوحدة الإعلانية باستخدام القنوات المخصّصة

---

Optional adsense_test_mode

adsense_test_mode?: "on"

تُستخدَم لتحديد ما إذا كان وضع الاختبار مفعّلاً أم لا.

عند ضبطها على on، يتم وضع علامة "اختبار فقط" على الإعلانات، ولن يتم تضمينها في عملية الاحتساب أو الفوترة. يجب إلغاء ضبط هذا الإعداد في مرحلة الإنتاج، أي بالنسبة إلى الزيارات غير الاختبارية.

---

Optional document_language

document_language?: string

لغة الصفحة التي يتم عرض الإعلانات عليها.

القيم المسموح بها هي رموز لغة صالحة وفقًا لمعيار ISO 639-1.

مثال: en

انظر أيضًا

• قائمة رموز اللغات وفق معيار ISO 639

---

Optional page_url

page_url?: string

عنوان URL للصفحة التي يتم عرض الإعلانات عليها.

القيم المسموح بها هي عناوين URL صالحة.

مثال: http://www.example.com

---

googletag.config.ComponentAuctionConfig

كائن يمثّل مزادًا واحدًا للمكوّنات في مزاد إعلانات على الجهاز

الخصائص
auctionConfig	عنصر إعدادات المزاد لهذا المزاد الخاص بالمكوّن
configKey	مفتاح الإعداد المرتبط بمزاد المكوّن هذا.

انظر أيضًا

• دليل البائعين في Protected Audience API: إجراء مزادات الإعلانات

الخصائص

---

auctionConfig

auctionConfig: {
  auctionSignals?: unknown;
  decisionLogicURL: string;
  interestGroupBuyers?: string[];
  perBuyerExperimentGroupIds?: {
    [buyer: string]: number;
  };
  perBuyerGroupLimits?: {
    [buyer: string]: number;
  };
  perBuyerSignals?: {
    [buyer: string]: unknown;
  };
  perBuyerTimeouts?: {
    [buyer: string]: number;
  };
  seller: string;
  sellerExperimentGroupId?: number;
  sellerSignals?: unknown;
  sellerTimeout?: number;
  trustedScoringSignalsURL?: string;
}

كائن إعدادات المزاد لهذا المكوّن

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

مثال

JavaScript

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

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

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

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

JavaScript (قديمة)

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

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

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

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

TypeScript

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

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

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

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

انظر أيضًا

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

---

configKey

configKey: string

مفتاح الإعداد المرتبط بمزاد هذا المكوّن

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

---

googletag.config.InterstitialConfig

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

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

الخصائص

---

Optional requireStorageAccess

requireStorageAccess?: boolean

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

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

مثال

JavaScript

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

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

JavaScript (قديمة)

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

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

TypeScript

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

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

انظر أيضًا

• الإعلانات البينية على المواقع الإلكترونية التي تجذب الزيارات

---

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

triggers?: 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.LazyLoadConfig

إعدادات للتحكّم في استخدام التحميل البطيء في علامات "ناشر Google"

الخصائص
fetchMarginPercent?	الحدّ الأدنى للمسافة التي يجب أن تبعدها الخانة عن إطار العرض الحالي قبل أن نطلب إعلانًا، ويتم التعبير عنها كنسبة مئوية من حجم إطار العرض
mobileScaling?	مضاعِف يتم تطبيقه على الهوامش على الأجهزة الجوّالة
renderMarginPercent?	الحدّ الأدنى للمسافة التي يجب أن تبعدها الخانة عن إطار العرض الحالي قبل عرض الإعلان، ويتم التعبير عنها كنسبة مئوية من حجم إطار العرض

انظر أيضًا

• PageSettingsConfig.lazyLoad

الخصائص

---

Optional fetchMarginPercent

fetchMarginPercent?: number

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

يسمح هذا الإعداد بجلب الإعلان مسبقًا عند استخدامه مع renderMarginPercent، ولكن مع الانتظار إلى حين عرض الموارد الفرعية الأخرى وتنزيلها. وبالتالي، يجب أن تكون هذه القيمة دائمًا أكبر من أو تساوي renderMarginPercent.

تعني القيمة 0 "عندما تدخل المساحة إطار العرض"، وتعني القيمة 100 "عندما يكون الإعلان على بُعد إطار عرض واحد"، وهكذا.

---

Optional mobileScaling

mobileScaling?: number

مضاعِف يتم تطبيقه على الهوامش على الأجهزة الجوّالة يتم تطبيق هذا المضاعف على كلّ من fetchMarginPercent وrenderMarginPercent.

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

---

Optional renderMarginPercent

renderMarginPercent?: number

الحدّ الأدنى للمسافة التي يجب أن تفصل بين موضع الإعلان وعرض الصفحة الحالي قبل عرض الإعلان، ويتم التعبير عنها كنسبة مئوية من حجم عرض الصفحة.

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

تعني القيمة 0 "عندما تدخل الفتحة إلى مساحة العرض"، وتعني 100 "عندما يكون الإعلان على بُعد مساحة عرض واحدة"، وهكذا.

---

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?	إعدادات للتحكّم في توسيع الإعلانات
adsenseAttributes?	إعداد لضبط سمات AdSense
adYield?	تمّ إيقافها نهائيًا.
categoryExclusion?	إعداد لضبط استثناءات فئات الإعلانات
centering?	إعداد للتحكّم في توسيط الإعلانات أفقيًا
collapseDiv?	إعداد للتحكّم في سلوك تصغير الخانات الإعلانية
disableInitialLoad?	إعداد للتحكّم في وقت طلب الإعلانات
lazyLoad?	إعدادات للتحكّم في استخدام التحميل البطيء في علامات "ناشر Google"
location?	إعداد لاستهداف المواقع الجغرافية بعناصر الحملات
pps?	إعدادات للتحكّم في الإشارات المقدَّمة من الناشر (PPS)
privacyTreatments?	إعدادات للتحكّم في طريقة تعامل الناشرين مع الخصوصية
safeFrame?	إعدادات للتحكّم في استخدام SafeFrame في GPT
singleRequest?	إعداد لتفعيل أو إيقاف بنية الإعلان الأحادي الطلب (SRA)
targeting?	إعداد للتحكّم في استهداف مفتاح القيمة
threadYield?	إعداد للتحكّم في ما إذا كان على GPT إيقاف مؤقت لمسار JS عند طلب تصميمات الإعلانات وعرضها.
videoAds?	إعدادات للتحكّم في إعلانات الفيديو

الخصائص

---

Optional adExpansion

adExpansion?: AdExpansionConfig

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

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

إعداد لضبط سمات AdSense

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

لا تنطبق تغييرات سمات AdSense إلا على الإعلانات التي يتم طلبها بعد استدعاء هذه الطريقة. لهذا السبب، يُنصح باستدعاء هذه الطريقة قبل أي استدعاءات إلى googletag.display أو PubAdsService.refresh.

مثال

JavaScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

JavaScript (قديمة)

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

TypeScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

---

Optional adYield

adYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

تم إيقافها نهائيًا: استخدِم threadYield بدلاً منها. ستتم إزالة هذه الميزة في المستقبل القريب.

---

Optional categoryExclusion

categoryExclusion?: string[]

إعداد لضبط استثناءات فئات الإعلانات

مثال

JavaScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

JavaScript (قديمة)

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

TypeScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

انظر أيضًا

• لمحة عن التصنيفات المخصَّصة لحظر الإعلانات

---

Optional centering

centering?: boolean

إعداد للتحكّم في توسيط الإعلانات أفقيًا يتم إيقاف التوسيط تلقائيًا.

لا تنطبق تغييرات التوسيط الأفقي إلا على الإعلانات التي يتم طلبها بعد استدعاء هذه الطريقة. لهذا السبب، يُنصح باستدعاء هذه الطريقة قبل أي استدعاءات إلى googletag.display أو PubAdsService.refresh.

مثال

JavaScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

JavaScript (قديمة)

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

TypeScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

---

Optional collapseDiv

collapseDiv?: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"

إعداد للتحكّم في سلوك تصغير الخانات الإعلانية.

لا تشغل الخانة الإعلانية المصغّرة أي مساحة على الصفحة.

القيم المتاحة:

• null (القيمة التلقائية): لن يتم تصغير مساحة العرض.
• DISABLED: لن يتم تصغير الخانة، سواء تم عرض إعلان أم لا.
• BEFORE_FETCH: ستبدأ الخانة الإعلانية مصغّرة، وسيتم توسيعها عند عرض إعلان.
• ON_NO_FILL: ستبدأ الخانة الإعلانية موسّعة، وسيتم تصغيرها في حال عدم عرض أي إعلان.

مثال

JavaScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

JavaScript (قديمة)

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

TypeScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

انظر أيضًا

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

---

Optional disableInitialLoad

disableInitialLoad?: boolean

إعداد للتحكّم في وقت طلب الإعلانات

تلقائيًا، تسجّل الطريقة googletag.display أماكن عرض الإعلانات وتطلب الإعلانات لها. ومع ذلك، قد يكون من الأفضل في بعض الأحيان فصل هذه الإجراءات للتحكّم بشكلٍ أكثر دقة في وقت تحميل محتوى الإعلان.

من خلال تفعيل هذا الإعداد، لن يتم طلب الإعلانات للمساحات الإعلانية المسجّلة عند استدعاء الطريقة display(). بدلاً من ذلك، يجب إجراء طلب منفصل إلى PubAdsService.refresh لبدء طلب إعلان.

يجب استخدام هذه الطريقة قبل استخدام googletag.enableServices.

مثال

JavaScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

JavaScript (قديمة)

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

TypeScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

انظر أيضًا

• التحكّم في تحميل الإعلانات وإعادة تحميلها
• التحكّم في تجميع طلبات الإعلانات المتزامنة

---

Optional lazyLoad

lazyLoad?: LazyLoadConfig

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

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

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

أي إعدادات تحميل كسول لم يتم تحديدها عند طلب setConfig() ستستخدِم قيمة تلقائية تحدّدها Google. قد يتم تعديل هذه الإعدادات التلقائية بمرور الوقت. لإيقاف إعداد معيّن، اضبط القيمة على null.

مثال

JavaScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

JavaScript (قديمة)

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

TypeScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

انظر أيضًا

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

---

Optional الموقع الجغرافي

location?: string

إعداد لاستهداف المواقع الجغرافية بعناصر الحملات.

مثال

JavaScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

JavaScript (قديمة)

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

TypeScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

انظر أيضًا

• استهداف المواقع الجغرافية للعرض

---

Optional نقطة في البوصة

pps?: PublisherProvidedSignalsConfig

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

---

Optional privacyTreatments

privacyTreatments?: PrivacyTreatmentsConfig

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

---

Optional safeFrame

safeFrame?: SafeFrameConfig

إعدادات للتحكّم في استخدام SafeFrame في GPT

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

مثال

JavaScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

JavaScript (قديمة)

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

TypeScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

---

Optional singleRequest

singleRequest?: boolean

إعداد لتفعيل أو إيقاف بنية الطلب الفردي (SRA).

عند تفعيل بنية الطلب الفردي، سيتم تجميع جميع خانات الإعلانات المحدّدة قبل طلب googletag.display أو PubAdsService.refresh في طلب إعلان واحد. يوفّر ذلك مزايا متعلّقة بالأداء، ولكنّه ضروري أيضًا لضمان الالتزام بـ "الإعلانات المتتالية" و"الاستبعادات التنافسية".

عند إيقاف ميزة "طلبات الإعلانات المتزامنة"، يتم طلب كلّ موضع إعلان على حدة. هذا هو السلوك التلقائي لـ GPT.

يجب استدعاء هذه الطريقة قبل استدعاء googletag.enableServices.

مثال

JavaScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

JavaScript (قديمة)

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

TypeScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

انظر أيضًا

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

---

Optional الاستهداف

targeting?: Record<string, string | string[]>

إعداد للتحكّم في الاستهداف حسب المفتاح والقيمة.

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

مثال

JavaScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

JavaScript (قديمة)

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

TypeScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

انظر أيضًا

• الاستهداف حسب المفتاح والقيمة

---

Optional threadYield

threadYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

إعداد للتحكّم في ما إذا كان يجب أن توقف علامة GPT مؤقتًا سلسلة JS عند طلب تصميمات الإعلانات وعرضها.

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

القيم المتاحة:

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

مثال

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

انظر أيضًا

• المجدوِل

---

Optional videoAds

videoAds?: VideoAdsConfig

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

مثال

JavaScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

JavaScript (قديمة)

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

TypeScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

انظر أيضًا

• استيعاب محتوى الفيديو

---

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

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

الخصائص
taxonomies	عنصر يحتوي على عمليات ربط التصنيف أو قيمة فارغة لمحو الإعدادات.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

الخصائص

---

التصنيفات

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

عنصر يحتوي على عمليات ربط التصنيف أو قيمة فارغة لمحو الإعدادات.

---

googletag.config.SafeFrameConfig

إعدادات التحكّم في SafeFrame في GPT

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

انظر أيضًا

• PageSettingsConfig.safeFrame
• SlotSettingsConfig.safeFrame

الخصائص

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

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

---

Optional allowPushExpansion

allowPushExpansion?: boolean

تحديد ما إذا كان يجب أن تسمح SafeFrame بتوسيع محتوى الإعلان من خلال دفع محتوى الصفحة

---

Optional forceSafeFrame

forceSafeFrame?: boolean

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

---

Optional وضع الحماية

sandbox?: boolean

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

---

Optional useUniqueDomain

useUniqueDomain?: boolean

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

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

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

انظر أيضًا

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

---

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?	إعدادات لضبط توسيع الإعلان
adsenseAttributes?	إعداد لضبط سمات AdSense
categoryExclusion?	إعداد لضبط استثناءات فئات الإعلانات
clickUrl?	إعداد لضبط عنوان URL الذي ستتم إعادة توجيه المستخدمين إليه بعد النقر على الإعلان.
collapseDiv?	إعداد لضبط سلوك تصغير مساحة عرض الإعلان
componentAuction?	مجموعة من مزادات المكوّنات التي سيتم تضمينها في مزاد الإعلانات على الجهاز.
interstitial?	إعدادات تضبط سلوك موضع الإعلان البيني.
safeFrame?	إعدادات لضبط استخدام SafeFrame في GPT
targeting?	إعداد لضبط استهداف المفتاح والقيمة

الخصائص

---

Optional adExpansion

adExpansion?: AdExpansionConfig

إعدادات ضبط توسيع الإعلانات

انظر أيضًا

• توسيع نطاق الإعلان

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

إعداد لضبط سمات AdSense

لن يتم تطبيق سمات AdSense التي تم ضبطها من خلال هذا الإعداد إلا على موضع الإعلان. يمكن استدعاء هذا الإعداد عدة مرات لتحديد قيم سمات متعددة أو للكتابة فوق القيم الحالية.

لا تنطبق تغييرات سمات AdSense إلا على الإعلانات التي يتم طلبها بعد استدعاء هذه الطريقة. لهذا السبب، يُنصح باستدعاء هذه الطريقة قبل أي استدعاءات إلى googletag.display أو PubAdsService.refresh.

مثال

JavaScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

JavaScript (قديمة)

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

TypeScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

إعداد لضبط استثناءات فئات الإعلانات

مثال

JavaScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

JavaScript (قديمة)

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

TypeScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

انظر أيضًا

• لمحة عن التصنيفات المخصَّصة لحظر الإعلانات

---

Optional clickUrl

clickUrl?: string

إعداد لتحديد عنوان URL الذي ستتم إعادة توجيه المستخدمين إليه بعد النقر على الإعلان.

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

ملاحظة: لا ينطبق هذا الإعداد إلا على الطلبات غير المرتبطة ببنية طلب الإعلان.

مثال

JavaScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

JavaScript (قديمة)

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

TypeScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

---

Optional collapseDiv

collapseDiv?: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"

إعداد لتحديد سلوك تصغير مساحة عرض الإعلان.

لا تشغل مساحة عرض الإعلان المصغَّرة أي مساحة على الصفحة.

القيم المتاحة:

• null (القيمة التلقائية): لن يتم تصغير مساحة العرض.
• DISABLED: لن يتم تصغير الخانة، سواء تم عرض إعلان أم لا.
• BEFORE_FETCH: ستبدأ الخانة الإعلانية مصغّرة، وسيتم توسيعها عند عرض إعلان.
• ON_NO_FILL: ستبدأ الخانة الإعلانية موسّعة، وسيتم تصغيرها في حال عدم عرض أي إعلان.

مثال

JavaScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

JavaScript (قديمة)

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

TypeScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

انظر أيضًا

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

---

Optional componentAuction

componentAuction?: ComponentAuctionConfig[]

مجموعة من مزادات المكوّنات التي سيتم تضمينها في مزاد الإعلانات على الجهاز.

---

Optional إعلان بيني

interstitial?: InterstitialConfig

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

انظر أيضًا

• الإعلانات البينية على المواقع الإلكترونية التي تجذب الزيارات

---

Optional safeFrame

safeFrame?: SafeFrameConfig

إعدادات لضبط استخدام SafeFrame في GPT

لن تنطبق القيم التي تم ضبطها من خلال هذا الإعداد إلا على موضع الإعلان، وسيتم إلغاء القيم التي تم ضبطها من خلال PageSettingsConfig.safeFrame.

مثال

JavaScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

JavaScript (قديمة)

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

TypeScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

---

Optional الاستهداف

targeting?: Record<string, string | string[]>

إعداد لضبط الاستهداف حسب المفتاح والقيمة

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

مثال

JavaScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

JavaScript (قديمة)

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

TypeScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

انظر أيضًا

• الاستهداف حسب المفتاح والقيمة

---

googletag.config.TaxonomyData

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

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

الخصائص

---

القيم

values: readonly string[]

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

---

googletag.config.VideoAdsConfig

إعدادات لضبط الإعدادات ذات الصلة بإعلانات الفيديو

الخصائص
enableVideoAds	تحدّد هذه السمة ما إذا كانت إعلانات الفيديو ستظهر على الصفحة.
videoCmsId?	رقم تعريف مصدر محتوى الفيديو
videoContentId?	رقم تعريف محتوى الفيديو

انظر أيضًا

• PageSettingsConfig.videoAds

الخصائص

---

enableVideoAds

enableVideoAds: boolean

تحدّد هذه السمة ما إذا كانت إعلانات الفيديو ستظهر على الصفحة.

عند ضبط القيمة على true، يتم تفعيل قيود استبعاد المحتوى على الإعلانات الصورية وإعلانات الفيديو.

إذا كان محتوى الفيديو معروفًا، اضبط videoContentId وvideoCmsId على القيم المقدَّمة إلى خدمة استيعاب المحتوى في "مدير إعلانات Google" للاستفادة من استبعاد المحتوى للإعلانات الصورية.

---

Optional videoCmsId

videoCmsId?: string

معرّف مصدر محتوى الفيديو.

هذه قيمة فريدة يحدّدها نظام استيعاب المحتوى في "مدير إعلانات Google" للتعرّف على مصدر محتوى الفيديو المحدّد بواسطة videoContentId.

انظر أيضًا

• cmsid (معرّف مصدر المحتوى)

---

Optional videoContentId

videoContentId?: string

تمثّل هذه السمة معرّف محتوى الفيديو.

وهي قيمة فريدة تحدّد فيديو معيّنًا من مصدر المحتوى المحدّد بواسطة videoCmsId. يتم تعيين هذه القيمة من خلال نظام إدارة المحتوى الذي يستضيف محتوى الفيديو.

انظر أيضًا

• vid (رقم تعريف الفيديو)

---

googletag.enums

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

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

التعدادات

---

OutOfPageFormat

OutOfPageFormat

تنسيقات الإعلانات خارج الصفحة المتوافقة مع GPT

انظر أيضًا

• defineOutOfPageSlot

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

---

TrafficSource

TrafficSource

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

انظر أيضًا

• PrivacySettingsConfig.trafficSource

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

---

googletag.events

هذه هي مساحة الاسم التي تستخدمها GPT للأحداث. يمكن أن يتفاعل الرمز مع هذه الأحداث باستخدام Service.addEventListener.

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

---

googletag.events.Event

الواجهة الأساسية لجميع أحداث GPT ستتضمّن جميع أحداث GPT أدناه الحقول التالية.

الخصائص
serviceName	اسم الخدمة التي بدأت تشغيل الحدث.
slot	الفتحة التي أدّت إلى ظهور الحدث

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

الخصائص

---

serviceName

serviceName: string

اسم الخدمة التي بدأت تشغيل الحدث.

---

slot

slot: Slot

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

---

googletag.events.EventTypeMap

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

الخصائص
gameManualInterstitialSlotClosed	اسم مستعار لـ events.GameManualInterstitialSlotClosedEvent.
gameManualInterstitialSlotReady	اسم مستعار لـ events.GameManualInterstitialSlotReadyEvent.
impressionViewable	اسم مستعار لـ events.ImpressionViewableEvent.
rewardedSlotClosed	اسم مستعار لـ events.RewardedSlotClosedEvent.
rewardedSlotGranted	اسم مستعار لـ events.RewardedSlotGrantedEvent.
rewardedSlotReady	اسم مستعار لـ events.RewardedSlotReadyEvent.
slotOnload	اسم مستعار لـ events.SlotOnloadEvent.
slotRenderEnded	اسم مستعار لـ events.SlotRenderEndedEvent.
slotRequested	اسم مستعار لـ events.SlotRequestedEvent.
slotResponseReceived	اسم مستعار لـ events.SlotResponseReceived.
slotVisibilityChanged	اسم مستعار لـ events.SlotVisibilityChangedEvent.

الخصائص

---

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent

اسم مستعار لـ events.GameManualInterstitialSlotClosedEvent.

---

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent

اسم مستعار لـ events.GameManualInterstitialSlotReadyEvent.

---

impressionViewable

impressionViewable: ImpressionViewableEvent

اسم مستعار لـ events.ImpressionViewableEvent.

---

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent

اسم مستعار لـ events.RewardedSlotClosedEvent.

---

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent

اسم مستعار لـ events.RewardedSlotGrantedEvent.

---

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent

اسم مستعار لـ events.RewardedSlotReadyEvent.

---

slotOnload

slotOnload: SlotOnloadEvent

اسم مستعار لـ events.SlotOnloadEvent.

---

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent

اسم مستعار لـ events.SlotRenderEndedEvent.

---

slotRequested

slotRequested: SlotRequestedEvent

اسم مستعار لـ events.SlotRequestedEvent.

---

slotResponseReceived

slotResponseReceived: SlotResponseReceived

اسم مستعار لـ events.SlotResponseReceived.

---

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent

اسم مستعار لـ events.SlotVisibilityChangedEvent.

---

googletag.events.GameManualInterstitialSlotClosedEvent

تمديد Event

يتم تنشيط هذا الحدث عندما يغلق المستخدم موضعًا إعلانيًا بينيًا خاصًا بدليل الألعاب.

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

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

مثال

JavaScript

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

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

JavaScript (قديمة)

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

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
    var slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

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

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

انظر أيضًا

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

---

googletag.events.GameManualInterstitialSlotReadyEvent

تمديد Event

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

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

الخصائص
serviceName	اسم الخدمة التي بدأت تشغيل الحدث. مكتسب من 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,
);

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
    const slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

JavaScript (قديمة)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
    var slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

TypeScript

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

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

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
    const slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

انظر أيضًا

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

الطُرق

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void

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

---

googletag.events.ImpressionViewableEvent

تمديد Event

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

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

مثال

JavaScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

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

JavaScript (قديمة)

// This listener is called when an impression becomes viewable.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", function (event) {
  var slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

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

TypeScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

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

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.RewardedSlotClosedEvent

تمديد Event

يتمّ إطلاق هذا الحدث عندما يغلق المستخدم موضع "الإعلان مقابل مكافأة". ويمكن أن يتم تشغيلها قبل منح مكافأة أو بعده. لتحديد ما إذا تم منح مكافأة، استخدِم events.RewardedSlotGrantedEvent بدلاً من ذلك.

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

مثال

JavaScript

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

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

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

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

JavaScript (قديمة)

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

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

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

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

TypeScript

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

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

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

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

انظر أيضًا

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

---

googletag.events.RewardedSlotGrantedEvent

تمديد Event

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

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

مثال

JavaScript

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

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

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

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

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

JavaScript (قديمة)

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

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

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

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

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

TypeScript

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

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

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

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

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

انظر أيضًا

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

الخصائص

---

الحمولة

payload: RewardedPayload

عنصر يحتوي على معلومات عن المكافأة التي تم منحها.

---

googletag.events.RewardedSlotReadyEvent

تمديد Event

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

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

الطُرق
makeRewardedVisible	تعرِض هذه السمة الإعلان مقابل مكافأة.

مثال

JavaScript

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (قديمة)

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
    var slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

انظر أيضًا

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

الطُرق

---

makeRewardedVisible

makeRewardedVisible(): void

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

---

googletag.events.SlotOnloadEvent

تمديد Event

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

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

مثال

JavaScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

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

JavaScript (قديمة)

// This listener is called when a creative iframe load event fires.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  var slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

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

TypeScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

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

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotRenderEndedEvent

تمديد Event

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

الخصائص
advertiserId	المعرّف الإعلاني للإعلان المعروض
campaignId	رقم تعريف الحملة التي يعرضها الإعلان.
companyIds	معرّفات الشركات التي قدّمت عروض أسعار للإعلان البديل المعروض
creativeId	رقم تعريف تصميم الإعلان المحجوز الذي تم عرضه
creativeTemplateId	رقم تعريف نموذج تصميم الإعلان المحجوز المعروض.
isBackfill	ما إذا كان الإعلان إعلانًا لملء الفراغات
isEmpty	تُستخدَم لتحديد ما إذا تم عرض إعلان في موضع الإعلان.
labelIds	تمّ إيقافها نهائيًا.
lineItemId	معرّف عنصر الإعلان المحجوز المعروض
responseIdentifier	معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان.
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: number

المعرّف الإعلاني للإعلان المعروض القيمة هي null للخانات الفارغة والإعلانات الاحتياطية وتصاميم الإعلانات التي تعرضها خدمات أخرى غير PubAdsService.

---

campaignId

campaignId: number

رقم تعريف الحملة التي يعرضها الإعلان. القيمة هي null للخانات الفارغة والإعلانات الاحتياطية وتصاميم الإعلانات التي تعرضها خدمات أخرى غير PubAdsService.

---

companyIds

companyIds: number[]

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

---

creativeId

creativeId: number

رقم تعريف تصميم الإعلان المحجوز الذي تم عرضه القيمة هي null للخانات الفارغة والإعلانات الاحتياطية وتصاميم الإعلانات التي تعرضها خدمات أخرى غير PubAdsService.

---

creativeTemplateId

creativeTemplateId: number

رقم تعريف نموذج تصميم الإعلان المحجوز المعروض. القيمة هي null للخانات الفارغة والإعلانات الاحتياطية وتصاميم الإعلانات التي تعرضها خدمات أخرى غير PubAdsService.

---

isBackfill

isBackfill: boolean

ما إذا كان الإعلان إعلانًا لملء الفراغات تكون القيمة true إذا كان الإعلان إعلانًا احتياطيًا، أو false في الحالات الأخرى.

---

isEmpty

isEmpty: boolean

تُستخدَم لتحديد ما إذا تم عرض إعلان في موضع الإعلان. تكون القيمة true إذا لم يتم عرض أي إعلان، أو false في الحالات الأخرى.

---

labelIds

labelIds: number[]

تم إيقافه نهائيًا: لم يعُد يتم ملء هذا الحقل.

---

lineItemId

lineItemId: number

معرّف عنصر الإعلان المحجوز المعروض القيمة هي null للخانات الفارغة والإعلانات الاحتياطية وتصاميم الإعلانات التي تعرضها خدمات أخرى غير PubAdsService.

---

responseIdentifier

responseIdentifier: string

معرّف الاستجابة هو معرّف فريد لاستجابة الإعلان. يمكن استخدام هذه القيمة لتحديد الإعلان وحظره في مركز مراجعة الإعلانات.

---

size

size: string | number[]

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

---

slotContentChanged

slotContentChanged: boolean

تُستخدَم لتحديد ما إذا تم تغيير محتوى موضع الإعلان باستخدام الإعلان المعروض. تكون القيمة true إذا تم تغيير المحتوى، وfalse في ما عدا ذلك.

---

sourceAgnosticCreativeId

sourceAgnosticCreativeId: number

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

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: number

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

---

yieldGroupIds

yieldGroupIds: number[]

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

---

googletag.events.SlotRequestedEvent

تمديد Event

يتم إطلاق هذا الحدث عندما يتم طلب إعلان لفتحة إعلانية معيّنة.

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

مثال

JavaScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

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

JavaScript (قديمة)

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", function (event) {
  var slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

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

TypeScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

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

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotResponseReceived

تمديد Event

يتم إطلاق هذا الحدث عند تلقّي استجابة إعلان لخانة إعلانية معيّنة.

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

مثال

JavaScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

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

JavaScript (قديمة)

// This listener is called when an ad response has been received
// for a slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", function (event) {
  var slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

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

TypeScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

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

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

---

googletag.events.SlotVisibilityChangedEvent

تمديد Event

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

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

مثال

JavaScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

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

JavaScript (قديمة)

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", function (event) {
  var slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", "".concat(event.inViewPercentage, "%"));
  console.groupEnd();

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

TypeScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

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

انظر أيضًا

• أدوات معالجة أحداث الإعلانات

الخصائص

---

inViewPercentage

inViewPercentage: number

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

---

googletag.secureSignals

هذه هي مساحة الاسم التي تستخدمها GPT لإدارة الإشارات الآمنة.

واجهات
BidderSignalProvider	تعرض هذه السمة إشارة آمنة لعارض مزايدة معيّن.
PublisherSignalProvider	تعرض هذه السمة إشارة آمنة لناشر معيّن.
SecureSignalProvidersArray	واجهة لإدارة الإشارات الآمنة

الأسماء المستعارة للأنواع
SecureSignalProvider	واجهة لعرض إشارة آمنة لعارض أسعار أو مقدّم خدمة معيّن

الأسماء المستعارة للأنواع

---

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

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

---

googletag.secureSignals.BidderSignalProvider

تعرض هذه الدالة إشارة آمنة لمقدّم عرض سعر معيّن.

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

1. دالة تجميع تعرض Promise يتم حلّه إلى إشارة آمنة.
2. id يحدّد مقدّم العرض المرتبط بالإشارة.

لعرض إشارة آمنة للناشر، استخدِم secureSignals.PublisherSignalProvider بدلاً من ذلك.

الخصائص
collectorFunction	دالة تعرض Promise يتم تحويلها إلى إشارة آمنة.
id	معرّف فريد لجامع البيانات المرتبط بهذه الإشارة الآمنة، كما هو مسجّل في "مدير إعلانات Google".

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

الخصائص

---

collectorFunction

collectorFunction: (() => Promise<string>)

دالة تعرض Promise يتم تحويلها إلى إشارة آمنة.

---

id

id: string

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

---

googletag.secureSignals.PublisherSignalProvider

تعرض هذه السمة إشارة آمنة لناشر معيّن.

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

1. دالة تجميع تعرض Promise يتم حلّه إلى إشارة آمنة.
2. تمثّل networkCode الناشر المرتبط بالإشارة.

لعرض إشارة آمنة لمقدّم عرض سعر، استخدِم secureSignals.BidderSignalProvider بدلاً من ذلك.

الخصائص
collectorFunction	دالة تعرض Promise يتم تحويلها إلى إشارة آمنة.
networkCode	رمز الشبكة (كما يظهر في مسار الوحدة الإعلانية) للناشر المرتبط بهذه الإشارة الآمنة.

مثال

JavaScript

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

JavaScript (قديمة)

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

TypeScript

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

انظر أيضًا

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

الخصائص

---

collectorFunction

collectorFunction: (() => Promise<string>)

دالة تعرض Promise يتم تحويلها إلى إشارة آمنة.

---

networkCode

networkCode: string

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

---

googletag.secureSignals.SecureSignalProvidersArray

واجهة لإدارة الإشارات الآمنة

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

الطُرق

---

clearAllCache

clearAllCache(): void

يمحو هذا الإجراء جميع الإشارات لجميع أدوات الجمع من ذاكرة التخزين المؤقت.

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

---

push

push(provider: SecureSignalProvider): void

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

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