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

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

مثال

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

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

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

مثال

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (قديم)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

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

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

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

• تلقائيًا، باستخدام إشارة من منصّة إدارة الموافقة في الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB.
• يدويًا، من خلال ضبط قيمة هذا الحقل على 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,
});

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

انظر أيضًا

• عرض إعلان محدود

تُفعِّل عرض الإعلانات في وضع الإعلانات غير المخصّصة للمساعدة في تلبية متطلبات الامتثال التنظيمية للناشرين.

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

يشير إلى ما إذا كانت الطلبات تمثّل زيارات مدفوعة أو زيارات مجانية. تملأ هذه القيمة سمة مصدر الزيارات في تقارير "مدير إعلانات 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,
});

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

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

على وجه الخصوص، يؤدي محو مساحة عرض إلى إزالة الإعلان من مرّات الاطّلاع على الصفحة التي تدوم طويلاً في 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();

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

مثال

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.

انظر أيضًا

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

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

مثال

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.

انظر أيضًا

• استهداف القيمة الرئيسية

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

انظر أيضًا

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

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

انظر أيضًا

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

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

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

انظر أيضًا

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

تفعِّل طريقة "التحميل الكسول" في 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,
});

انظر أيضًا

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

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

انظر أيضًا

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

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

تعرِض هذه الدالة قيمة سمة 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

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

مثال

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

تعرِض هذه السمة مَعلمة استهداف مخصّصة محدّدة على مستوى الخدمة تمّ ضبطها.

مثال

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

تعرِض هذه السمة قائمة بجميع مفاتيح الاستهداف المخصّصة على مستوى الخدمة التي تمّ ضبطها.

مثال

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

تُرجع ما إذا تم إيقاف الطلبات الأولية للإعلانات بنجاح من خلال طلب سابق من PubAdsService.disableInitialLoad أم لا.

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

للحصول على السلوك الصحيح في جميع المتصفّحات، يجب أن يسبق استدعاء 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 });

انظر أيضًا

• التحكّم في تحميل الإعلانات وإعادة تحميلها
• إعادة تحميل الشرائح الإعلانية

تُستخدَم لضبط قيم لسمات 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

تُستخدَم لضبط استبعاد فئة إعلان على مستوى الصفحة لاسم التصنيف المحدّد.

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

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

تفعيل أو إيقاف وضع الإعلانات في الوسط أفقيًا يتم إيقاف ميزة التوسيط تلقائيًا. في ملف 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);

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

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

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

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

مثال

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

انظر أيضًا

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

لضبط قيمة المعرّف الذي يوفّره الناشر

مثال

JavaScript

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

JavaScript (قديم)

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

TypeScript

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

انظر أيضًا

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

تحدِّد هذه السياسة الإعدادات المفضَّلة على مستوى الصفحة لضبط 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

تُستخدَم لضبط مَعلمات استهداف مخصّصة لمفتاح معيّن تنطبق على جميع خانات الإعلانات في خدمة "إعلانات الناشر". سيؤدي استدعاء هذا المفتاح عدة مرات للمفتاح نفسه إلى استبدال القيم القديمة. يتمّ تحديد هذه المفاتيح في حسابك على "مدير إعلانات 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"]);

انظر أيضًا

• استهداف السمة-القيمة

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

انظر أيضًا

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

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

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

مثال

JavaScript

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

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

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

JavaScript (قديم)

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

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

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

TypeScript

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

انظر أيضًا

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

تسجِّل أداة مراقبة الأحداث التي تتيح لك إعداد وظيفة 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.
  }
});

انظر أيضًا

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

الحصول على قائمة الخانات المرتبطة بهذه الخدمة