إعلانات مدمجة مع المحتوى

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

تتوفّر الإعلانات المدمجة لكلّ من "المشترين المعتمَدين" و "عروض الأسعار المفتوحة".

في ما يلي سير العمل للإعلانات المدمجة مع المحتوى:

1. يتم إرسال طلب إعلان مدمج مع المحتوى إلى Google. يحدّد الطلب نموذجًا واحدًا أو كلاً من نماذج الإعلانات المدمجة التالية، ويحدّد كلّ نموذج الحقول المدمجة المفضّلة.
2. تُرسِل Google إلى المشترين طلب عرض سعر في الوقت الفعلي يحتوي على قائمة بالحقول التي يتمّ طلبها.
3. يردّ المشترون المهتمون بالمنتجات مع إدخال الحقول المطلوبة.
4. تُجري Google مزادًا لاختيار عرض السعر الفائز وتُرسِل مواد عرض تصميم الإعلان التي قدّمها المشتري إلى الناشر.
5. يجمع الناشر مواد العرض في إعلان مضمّن مع المحتوى ويصمّمها ليلائم تصميم الموقع الإلكتروني.

تنسيقات الرسائل

تتيح Google استخدام مواصفات OpenRTB بتنسيقَي JSON وProtobuf.

بالنسبة إلى الإعلانات المدمجة مع المحتوى في OpenRTB Protobuf، تختلف الحقول التالية عن المواصفات:

JSON	نوع ملف JSON	Protobuf	نوع Protobuf
BidRequest.imp[].native.request	string	BidRequest.imp[].native.request_native	NativeRequest
BidResponse.seatbid[].bid[].adm	string	BidResponse.seatbid[].bid[].adm_native	NativeResponse

حقول OpenRTB Protobuf هي رسائل Protobuf بدلاً من سلاسل.

في حال استخدام عملية تنفيذ OpenRTB Protobuf، تتلقّى نقطة النهاية طلبات عروض أسعار تحتوي على BidRequest.imp.native.request_native بدلاً من BidRequest.imp.native.request. بالإضافة إلى ذلك، يجب أن تُعرِض نقطة النهاية ردود عروض أسعار تملأ BidResponse.seatbid.bid.adm_native بدلاً من BidResponse.seatbid.bid.adm، وإلا سيتمّ فلترتها من المزاد.

إذا كنت تستخدِم حزمة تطوير برامج (SDK) للمشتري لعرض الإعلانات المدمجة مع المحتوى، عليك تضمين صورة type في declared_ad عند إرسال تصميمات الإعلانات للمراجعة.

نماذج الإعلانات المدمجة مع المحتوى

توضّح نماذج الإعلانات المدمجة مع المحتوى مكونات الإعلان المدمج مع المحتوى، وتحدّد محتوى وبنية NativeRequest في OpenRTB أوNativeAdTemplate في بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google الذي سيتم إيقافه نهائيًا في طلب عروض الأسعار. تتيح Google نموذجَي الإعلانات المدمجة الأكثر شيوعًا للإعلانات المدمجة غير المضمّنة في الفيديو، والإعلانات المدمجة في الفيديو:

• نموذج إعلان تثبيت التطبيق: يمكنك الترويج لتطبيقك وزيادة عمليات تثبيته على الأجهزة الجوّالة.
• نموذج إعلان المحتوى: تركيبة أكثر عمومية من النصوص والصور للإعلانات على الويب أو للعلامات التجارية
• نموذج إعلان تثبيت التطبيق عبر الفيديو
• نموذج إعلان محتوى الفيديو

تتوفّر نماذج أخرى، وقد تتضمّن مجموعة مختلفة من المتطلبات المتعلقة بالحقول والسمات والمقاييس.

نموذج إعلان تثبيت التطبيق

الحقول المطلوبة والمُفضَّل ملؤها

تعرض الجداول التالية الحقول التي تحمل التصنيف مطلوبة أو مُقترَحة. ويتم تطبيق القواعد التالية:

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

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

الحقل	الوصف	هل هي مطلوبة أو يُنصح بها؟	هل يتم عرضها دائمًا؟	حجم الصورة المقترَح/الحد الأقصى لعدد الأحرف	مثال
العنوان	عنوان التطبيق	مطلوب	نعم	25 حرفًا	Flood-It!
صورة	لقطة شاشة من التطبيق أو صورة أخرى ذات صلة	مطلوب	لا	‫1,200 × 627 بكسل أو 600 × 600 بكسل حسب نسبة العرض إلى الارتفاع المطلوبة من قِبل الناشر	<لقطة شاشة من لعبة Flood-It!>
النص	النص الرئيسي للتطبيق	مطلوب	لا	90 حرفًا	لعبة بسيطة بشكل مخادع ومليئة بالتحديات المثيرة = لعبة مسببة للإدمان
رمز التطبيق	رمز التطبيق	مطلوب	لا	‫128 × 128 بكسل	<رمز تطبيق Flood-it!‎>
الحث على اتخاذ إجراء	الإجراء المفضّل للمستخدم	ننصح به	نعم	15 حرفًا	تثبيت
التقييم النجمي	عدد النجوم (من 0 إلى 5) الذي يمثّل تقييم التطبيق في متجر التطبيقات	ننصح به	لا	من 0 إلى 5	4.5
السعر	تكلفة التطبيق	ننصح به	لا	15 حرفًا	مجانًا

ملاحظات حول طول النص

إذا أرسل المشتري مادة عرض نصية (نص النص مثلاً) أطول من الحد الأقصى المقترَح لعدد الأحرف، قد تقتطع Google أو الناشر النص وتضع عليه علامة اقتباس. يُرجى العِلم أنّ حدود الاقتطاع تكون نصف الحجم في الصينية واليابانية والكورية. على سبيل المثال، يكون الحد الأقصى للعنوان هو 90 حرفًا في اللغة الإنجليزية و45 حرفًا في اللغة الصينية.

ملاحظات حول حجم الصورة

يُسمح للناشرين بما يلي:

• اقتصاص الصورة الرئيسية بشكل متماثل بنسبة تصل إلى% 20 في سمة واحدة (الارتفاع أو العرض)
• تغيير حجم الصورة بدون تغيير نسبة العرض إلى الارتفاع
• قد تتم فلترة الصور التي تكون نسب العرض إلى الارتفاع فيها مختلفة بشكل كبير عن تلك المُشار إليها من خلال الارتفاع والعرض.

نموذج الإعلانات التي تعرض محتوى

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

الحقل	الوصف	هل هي مطلوبة أو يُنصح بها؟	هل يتم عرضها دائمًا؟	حجم الصورة المقترَح/الحد الأقصى لعدد الأحرف *	مثال
العنوان	عنوان الإعلان	مطلوب	نعم	25 حرفًا	أدنى معدّلات الرهن العقاري
صورة	الصورة الأساسية للإعلان	مطلوب	لا	‫1,200 × 627 بكسل أو 600 × 600 بكسل حسب نسبة العرض إلى الارتفاع المطلوبة من قِبل الناشر	<الصورة الرئيسية للإعلان>
النص	محتوى الإعلان	مطلوب	لا	90 حرفًا	يمكنك الحصول على منزلك في بروكلين بتكلفة أقل وفي وقت أقرب مما تتوقّع.
Logo	شعار المعلِن أو صورة صغيرة أخرى ذات صلة	ننصح به	لا	‫128 × 128 بكسل	<NY Mortgage Inc.'s logo>
الحث على اتخاذ إجراء	الإجراء المفضّل للمستخدم	ننصح به	لا	15 حرفًا	طلب عرض سعر
المعلِن	نص يحدد المعلن أو العلامة التجارية	مطلوب	لا	25 حرفًا	NY Mortgage Inc.

نموذج إعلان فيديو لتثبيت تطبيق

الحقل	الوصف	هل هي مطلوبة أو يُنصح بها؟	هل يتم عرضها دائمًا؟	حجم الصورة المقترَح/الحد الأقصى لعدد الأحرف *	مثال
فيديو	استجابة نموذج عرض إعلانات الفيديو (VAST) التي تتضمّن كل مواد العرض اللازمة لتشغيل إعلان فيديو	مطلوب	لا	-	عنوان URL لملف XML الخاص بـ VAST يحتوي على Flood-It! إعلان فيديو
العنوان	عنوان التطبيق	مطلوب	نعم	25 حرفًا	Flood-It!
صورة	الصورة (الصورة المصغّرة) التي تظهر في المشغّل قبل النقر على إعلان الفيديو أو أثناء تحميله.	مطلوب	لا	يجب أن تتطابق مع نسبة العرض إلى الارتفاع للفيديو (على سبيل المثال: 1280x720 للفيديو 16:9، و4x3 للفيديو 640x480).	لقطة شاشة من لعبة Flood-It! أو من الفيديو
النص	النص الرئيسي للتطبيق	مطلوب	لا	90 حرفًا	لعبة بسيطة بشكل مخادع ومليئة بالتحديات المثيرة = لعبة مسببة للإدمان
رمز التطبيق	رمز التطبيق	مطلوب	لا	‫128 × 128 بكسل	رمز تطبيق Flood-it!‎
الحث على اتخاذ إجراء	الإجراء المفضّل للمستخدم	مطلوب	نعم	15 حرفًا	تثبيت
التقييم النجمي	عدد النجوم (من 0 إلى 5) التي تمثّل تقييم التطبيق في متجر التطبيقات	ننصح به	لا	من 0 إلى 5	4.5
السعر	تكلفة التطبيق	ننصح به	لا	15 حرفًا	مجانًا

القيود

• الفيديو: يجب أن يكون كل الفيديو في شكل عنوان URL لنموذج عرض إعلانات الفيديو (VAST) أو علامة VAST. لا يمكن تحديد ملف فيديو خام، مثل WebM أو MP4 أو غير ذلك.

• طول النص: إذا حدّد المشتري مادة عرض نصية مثل body في الردّ، قد تقتطعه Google أو الناشر وتضع علامة اقتباس عليه. يُرجى العِلم أنّ حدود الاقتطاع تقل إلى نصف القيمة المذكورة في الصينية واليابانية والكورية. على سبيل المثال، يكون الحد الأقصى للعنوان هو 90 حرفًا في اللغة الإنجليزية و45 حرفًا في اللغة الصينية.

• حجم الصورة: يُسمح للناشرين بما يلي:

  • اقتصاص الصورة الرئيسية بشكل متماثل بنسبة تصل إلى% 20 في سمة واحدة (الارتفاع أو العرض)
  • تغيير حجم الصورة بدون تغيير نسبة العرض إلى الارتفاع

مثال على إعلان لتثبيت التطبيق

نموذج إعلان محتوى فيديو

الحقل	الوصف	هل هي مطلوبة أو يُنصح بها؟	هل يتم عرضها دائمًا؟	حجم الصورة المقترَح/الحد الأقصى لعدد الأحرف *	مثال
فيديو	استجابة نموذج عرض إعلانات الفيديو (VAST) التي تتضمّن كل مواد العرض اللازمة لتشغيل إعلان فيديو	مطلوب	نعم	-	عنوان URL لملف XML الخاص بـ VAST يحتوي على Flood-It! إعلان فيديو
العنوان	عنوان الإعلان	مطلوب	نعم	25 حرفًا	أدنى معدّلات الرهن العقاري
صورة	الصورة (الصورة المصغّرة) التي تظهر في المشغّل قبل النقر على إعلان الفيديو أو أثناء تحميله.	مطلوب	لا	يجب أن تتطابق مع نسبة العرض إلى الارتفاع للفيديو (على سبيل المثال: 1280x720 للفيديو 16:9، و4x3 للفيديو 640x480).	لقطة شاشة من الفيديو
النص	محتوى الإعلان	مطلوب	لا	90 حرفًا	يمكنك الحصول على منزلك في بروكلين بتكلفة أقل وفي وقت أقرب مما تتوقّع.
Logo	شعار المعلِن أو صورة صغيرة أخرى ذات صلة	ننصح به	لا	‫128 × 128 بكسل	شعار NY Mortgage Inc.‎
الحث على اتخاذ إجراء	الإجراء المفضّل للمستخدم	مطلوب	لا	15 حرفًا	طلب عرض سعر
المعلِن	نص يحدد المعلن أو العلامة التجارية	مطلوب	لا	25 حرفًا	NY Mortgage Inc.

الحقول الوصفية

تتم مشاركة الحقول الوصفية التالية من قِبل جميع نماذج الإعلانات المتوافقة:

بروتوكول عرض الأسعار في الوقت الفعلي من Google	OpenRTB	الوصف
NativeAd.click_link_url	Link.url	عنوان URL الذي سيُطلِبه المتصفّح عندما ينقر المستخدِم على الإعلان. يمكن أن تكون الخطوة الأولى في سلسلة عمليات إعادة التوجيه التي تؤدي في النهاية إلى الصفحة المقصودة. بالنسبة إلى الإعلانات المدمجة، ننصحك باستخدام click_link_url كحقل لضبط الوجهة التي سينتقل إليها المستخدِم في نهاية المطاف. يجب استخدام هذا الحقل في حالة الصفحات المقصودة الديناميكية.
Ad.click_through_url	Bid.adomain	يجب ضبطه إذا كان مقدّم عروض الأسعار ينوي تقديم عروض أسعار. هذه هي مجموعة عناوين URL المقصودة للمقتطف، بما في ذلك عناوين URL التي سينتقل إليها المستخدِم في حال نقره على الإعلان المعروض، وأي عناوين URL تظهر في الإعلان المعروض. لا تُدرِج طلبات وسيطة إلى خادم الإعلانات لا علاقة لها بالصفحة المقصودة النهائية. سيتم تجاهل BidResponse الذي يعرض مقتطفًا أو إعلان فيديو ولكن لا يعرض click_through_url. لا تضبط هذا الحقل إلا إذا تم ضبط html_snippet أو video_url أو native_ad. تُستخدَم هذه البيانات كبيان لعنوان URL مقصود، على سبيل المثال لفلترة عناوين URL التي حظرها الناشرون أو لتصنيف الإعلانات بعد الفلترة. راجِع NativeAd.click_link_url عند استخدام الإعلانات المدمجة مع المحتوى. بالنسبة إلى الإعلانات غير المدمجة، لا يتم استخدامها لتتبُّع النقرات أو أي وظائف أخرى متعلقة بالإعلان، بل يتم استخدامها فقط كبيان لعنوان URL المقصود. بالنسبة إلى الإعلانات المدمجة، في حال عدم ضبط NativeAd.click_link_url، يتم استخدام القيمة الأولى لسمة click_through_url لتوجيه المستخدِم إلى الصفحة المقصودة. بالإضافة إلى ذلك، يتم استخدام جميع القيم كبيانات لعنوان URL المقصود (على غرار الحالة غير الأصلية).
NativeAd.click_tracking_urls	Link.clicktrackers	اختياريّ. عناوين URL إضافية تسمح للمعلِنين بتتبُّع نقرات المستخدِمين على الإعلان
Ad.ad_choices_destination_url	BidExt.ad_choices_destination_url	رابط يؤدي إلى صفحة الإعدادات المفضّلة للإعلانات أو صفحة إيقاف الإعلانات إذا كان متوفّرًا، تتم إضافة رمز AdChoices عادي إلى تصميم الإعلان المدمَج وربطه بعنوان URL هذا. يُتاح استخدام مع الإعلانات المدمجة، ولكنّه ليس جزءًا من الرسالة المدمجة في استجابة عروض الأسعار.
Ad.impression_tracking_url	NativeResponse.imptrackers	يجب تتبُّع مرّات الظهور للإعلانات المدمجة باستخدام impression_tracking_url في بروتوكول عرض الأسعار في الوقت الفعلي لبرنامج "الشراة المعتمَدون" أو تتبُّع مرّات الظهور للإعلانات المدمجة في OpenRTB.

الحقول المطلوبة والمُقترَحة في بروتوكول عرض الأسعار في الوقت الفعلي من Google

يحدّد الناشر قيمة required_fields وrecommended_fields. نوضّح كيفية ترجمة حقول الوحدات بتية هذه لتحديد ما إذا كان الحقل مطلوبًا أو مُقترَحًا.

يستخدم حقل الوحدات الثنائية كل وحدة من القيمة الثنائية لتخزين عبارة "صحيح" أو "خطأ"، ما يعادل إرسال العديد من الإشارات المنطقية مثل is_logo_required أو is_header_required، ولكن يتم تجميعها معًا.

ملاحظة: في OpenRTB، يحدِّد حقل BidRequest.imp.native.request_native.assets.required ما إذا كان حقل معيّن مطلوبًا أو مقترَحًا.

مثال

في هذا المثال، سنستخدم قيمة required_fields‏ 1085.

أولاً، ابحث عن القيمة الثنائية المكافئة: 10000111101

بعد الحصول على القيمة الثنائية، يمكنك التحقّق من الوحدات لتحديد ما إذا كان الحقل مطلوبًا (1) أو غير مطلوب (0).

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

الحقل	موضع القيمة الثنائية (من اليمين إلى اليسار)
HEADLINE	1
BODY	2
CALL_TO_ACTION	4
ADVERTISER	8
IMAGE	16
LOGO	32
APP_ICON	64
STAR_RATING	128
PRICE	256
STORE	512
VIDEO	1024

بالنظر إلى مثال القيمة الثنائية 10000111101، فإنّ وحدة البت الواحدة (الأكثر يمينًا) هي 1، ما يشير إلى قيمة مطلوبة. وفقًا للجدول، يتوافق الرمز HEADLINE مع القيمة 1.

القيمة المكونة من اثنين من البتات (القيمة الثانية من اليمين) هي 0، ما يعني أنّه غير مطلوب. يتوافق الرمز المكوّن من 2 بت مع BODY.

في ما يلي جميع الحقول المطلوبة التي تم تفسيرها في مثالنا:

القيمة	الوصف	مطلوب؟
1	VIDEO	نعم
0	STORE	لا
0	PRICE	لا
0	STAR_RATING	لا
0	APP_ICON	لا
1	LOGO	نعم
1	IMAGE	نعم
1	ADVERTISER	نعم
1	CALL_TO_ACTION	نعم
0	BODY	لا
1	HEADLINE	نعم

تمثيل نموذج الإعلان المدمج مع المحتوى في طلب عرض السعر

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

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

• الحقول المطلوبة أو المُقترَحة
• أبعاد الصور والشعارات ورموز التطبيقات
• مواصفات التنسيق الذي يتمّ به عرض الإعلان

ملاحظة: بالنسبة إلى الحقل style_layout_type، يشيرPIXEL إلى أنّ الوحدة الأصلية ذات حجم ثابت، في حين يشيرFLUID إلى أنّه يتم توسيعها لملء عرض العمود المحيط بها وتعديل الارتفاع للحفاظ على نسبة العرض إلى الارتفاع. عند تحديد FLUID ، قد يظهر الارتفاع والعرض على أنّهما 1×1.

أرقام تعريف مواد العرض في OpenRTB

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

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

عند تقديم عروض أسعار على المستودع الإعلاني المدمَج، على المشتري ملء الحقول المطلوبة التي تم تحديدها في طلب عرض السعر. في OpenRTB، يمكنك إجراء ذلك باستخدام BidResponse.seatbid.bid.adm_native عند استخدام Protobuf أو BidResponse.seatbid.bid.adm لتنسيق JSON. بالنسبة إلى بروتوكول Google المتوقّف نهائيًا، يتم إجراء ذلك باستخدام الحقل BidResponse.ad.native_ad.

أمثلة على طلبات عروض الأسعار

ملاحظة: لفهم ما هو مطلوب أو اختياري في الاستجابة، اطّلِع على نموذج الإعلان المدمج في طلب عرض السعر. بالنسبة إلى OpenRTB، يمكن العثور على هذا العنصر في BidRequest.imp.native. بالنسبة إلى بروتوكول Google المتوقّف نهائيًا، يمكن العثور عليه في BidRequest.adslot.native_ad_template.

طلبات عروض الأسعار غير المتعلقة بالفيديوهات

OpenRTB Protobufملف OpenRTB بتنسيق JSONGoogle

عرض المثال

طلب تسلسلي

id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

عرض المثال

{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}

عرض المثال

طلب تسلسلي

id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

طلبات عروض أسعار الفيديو

استكشاف

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

أمثلة على استجابات عروض الأسعار

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

OpenRTB Protobufملف OpenRTB بتنسيق JSONGoogle

عرض المثال

الاستجابة التسلسلية

id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"

عرض المثال

{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}

عرض المثال

الاستجابة التسلسلية

ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254 225"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

الردود على عروض أسعار الفيديو

استكشاف

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}