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

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

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

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

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

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

تتيح Google استخدام مواصفات OpenRTB بكل من JSON وProtobuf

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

مواصفات JSON (PROTOCOL_OPENRTB_2_4)	نوع JSON	تنفيذ OpenRTB (PROTOCOL_OPENRTB_PROTOBUF_2_4)	نوع OpenRTB
BidRequest.imp[].native.request	string	BidRequest.imp[].native.request_native	NativeRequest
BidResponse.seatbid[].bid[].adm	string	BidResponse.seatbid[].bid[].adm_native	NativeResponse

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

إذا كنت تستخدم تنفيذ OpenRTB Protobuf، فلن تتلقى BidRequest.imp[].native.request، ويجب الرد باستخدام BidResponse.seatbid[].bid[].adm_native الاستجابات لعروض الأسعار مع تمت تصفية BidResponse.seatbid[].bid[].adm. أرقام تعريف مواد العرض غير مطلوبة في OpenRTB الاستجابات لعروض أسعار Protobuf.

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

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

تتيح Google نموذجَي الإعلانات المدمجة مع المحتوى الأكثر شيوعًا لغير الفيديوهات إعلانات الفيديو المدمجة مع المحتوى:

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

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

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

الحقول المطلوبة والحقول التي يُنصح بها

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

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

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

الحقل	الوصف	هل هي سمة مطلوبة أم مقترَحة؟	هل يتم عرضها دائمًا؟	حجم الصورة المقترَح/الحد الأقصى لعدد الأحرف	مثال
العنوان	عنوان التطبيق	مطلوب	نعم	25 حرفًا	Flood-It!
صورة	لقطة شاشة من التطبيق أو صورة أخرى ذات صلة	مطلوب	لا	1,200 بكسل × 627 بكسل أو 600 بكسل × 600 بكسل حسب نسبة العرض إلى الارتفاع المطلوبة من قِبل الناشر	<لقطة شاشة من لعبة Flood-It!>
النص الأساسي	النص الأساسي للتطبيق	مطلوب	لا	90 حرفًا	ألعاب بسيطة ومخيفة مليئة بالتحديات الممتعة.
رمز التطبيق	رمز التطبيق	مطلوب	لا	128 × 128 بكسل	<الفيضانات! رمز التطبيق>
الحث على اتخاذ إجراء	إجراء المستخدم المفضّل	الخيار الذي ننصح به	نعم	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.>
الحث على اتخاذ إجراء	الإجراء المفضّل لدى المستخدم	الخيار الذي ننصح به	لا	15 حرفًا	طلب عرض سعر
المعلِن	نص يحدد المعلن أو العلامة التجارية	مطلوب	لا	25 حرفًا	NY Mortgage Inc.

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

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

القيود

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

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

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

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

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

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

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

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

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

مفوَّض المورد الاحتياطي للبروتوكول في الوقت الفعلي للمشترين	مفوَّض مكافئ 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	رابط إلى تفضيلات الإعلانات أو صفحة إلغاء الاشتراك. إذا كان هناك معيار، تتم إضافة رمز "خيارات الإعلان" إلى تصميم الإعلان المدمج مع المحتوى ويتم ربطه بعنوان URL هذا. هذا النمط متاح للإعلانات المدمجة مع المحتوى، ولكنه ليس جزءًا من الرسالة المدمجة مع المحتوى في استجابة عرض السعر.
Ad.impression_tracking_url	NativeResponse.imptrackers	ينبغي تتبع مرات الظهور المدمجة مع المحتوى باستخدام impression_tracking_url في عروض الأسعار في الوقت الفعلي "الشراة المعتمَدون" Proto أو Native imptrackers في OpenRTB.

الحقول المطلوبة والحقول التي يُنصح بها

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

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

مثال

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

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

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

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

الحقل	موضع القيمة الثنائية (من اليمين إلى اليسار)
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.

تشير القيمة 2 بت (القيمة الثانية من اليمين) إلى 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	نعم

رسالة NativeAdTemplate

عند تلقي طلب عرض أسعار يحتوي على مستودع إعلانات مدمجة، سيتضمن BidRequest.adSlot[].native_ad_template. توفِّر الرسالة NativeAdTemplate مواصفات لما يلي:

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

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

message BidRequest {
  //...
  message AdSlot {
    //...

    message NativeAdTemplate {
      // Defines the bits used in required_fields and recommended_fields.
      // There is one bit for each of the fields in BidResponse.Ad.NativeAd
      enum Fields {
        NO_FIELDS = 0x0;
        HEADLINE = 0x1;
        BODY = 0x2;
        CALL_TO_ACTION = 0x4;
        ADVERTISER = 0x8;
        IMAGE = 0x10;
        LOGO = 0x20;
        APP_ICON = 0x40;
        STAR_RATING = 0x80;
        PRICE = 0x100;
        DEPRECATED_STORE = 0x200;
        VIDEO = 0x400;
      }

      // Bitfield describing which fields are required by the publisher. Bid
      // responses with no value for these fields will be rejected. Click
      // and view tracking urls are always implicitly required.
      optional int64 required_fields = 1;

      // Bitfield describing which fields are recommended by the publisher.
      // All recommended field are supported, but not all recommended fields
      // are required.
      optional int64 recommended_fields = 2;

      // max_safe_length indicates the maximum number of Unicode characters that
      // are guaranteed to be shown without truncation. Longer strings may be
      // truncated and ellipsized by Ad Exchange or the publisher during
      // rendering.
      optional int32 headline_max_safe_length = 3;
      optional int32 body_max_safe_length = 4;
      optional int32 call_to_action_max_safe_length = 5;
      optional int32 advertiser_max_safe_length = 6;
      optional int32 price_max_safe_length = 15;

      // The width and height from which to calculate the required aspect ratio.
      // You can provide a larger image in the response. Images that have aspect
      // ratios substantially different than those implied by the height and
      // width may be filtered.
      optional int32 image_width = 7;
      optional int32 image_height = 8;
      optional int32 logo_width = 9;
      optional int32 logo_height = 10;
      optional int32 app_icon_width = 11;
      optional int32 app_icon_height = 12;

      // Globally distinct id for the specific style, HTML, and CSS with which
      // the native ad is rendered.
      optional int32 style_id = 16;

      // Type of style layout for each native ad template.
      enum LayoutType {
        PIXEL = 0;
        FLUID = 1;
      }
      optional LayoutType style_layout_type = 17 [default = PIXEL];

      // If the style_layout_type is Pixel, width and height of the
      // entire native ad after rendering. If the style_layout_type is
      // Fluid, the style_height and style_width may optionally
      // not be populated.
      optional int32 style_height = 18;
      optional int32 style_width = 19;
    }
    repeated NativeAdTemplate native_ad_template = 51;
  }

    // NativePlacementType describes placement of native ad slot with respect to
    // surrounding context.
    enum NativePlacementType {
      PLACEMENT_UNKNOWN = 0;
      // In the feed of content - for example as an item inside the organic
      // feed/grid/listing/carousel.
      PLACEMENT_IN_FEED = 1;
      // In the atomic unit of the content - for example, in the article page or single
      // image page.
      PLACEMENT_ATOMIC_UNIT = 2;
      // Outside the core content - for example in the ads section on the right
      // rail, as a banner-style placement near the content, etc.
      PLACEMENT_OUTSIDE = 3;
      // Recommendation widget, most commonly presented below the article
      // content.
      PLACEMENT_RECOMMENDATION = 4;
    }

    optional NativePlacementType native_placement_type = 45;

  // ...
}

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

عند تقديم عرض أسعار لمستودع من الإعلانات المدمجة مع المحتوى، يجب على المشتري تعبئة BidResponse.ad[].native_ad مع الحقول المطلوبة الموضَّحة في السمة BidRequest.adSlot[].native_ad_template المقابلة

ملاحظة: بعض الحقول الإضافية المتوفّرة في BidResponse.Ad هي أدناه أيضًا لأنها ملائمة للإعلانات المدمجة مع المحتوى.

message BidResponse {
  //...
  message Ad {
    //...

    message NativeAd {
      // A short title for the ad.
      optional string headline = 1;

      // A long description of the ad.
      optional string body = 2;

      // A label for the button that the user is supposed to click.
      optional string call_to_action = 3;

      // The name of the advertiser or sponsor, to be displayed in the ad
      // creative.
      optional string advertiser = 4;

      // Next tag to use: 4
      message Image {
        optional string url = 1;

        // Image width and height are specified in pixels. You may provide a
        // larger image than was requested, so long as the aspect ratio is
        // preserved.
        optional int32 width = 2;
        optional int32 height = 3;
      }

      // A large image.
      optional Image image = 5;

      // A smaller image, for the advertiser's logo.
      optional Image logo = 6;

      // The app icon, for app download ads.
      optional Image app_icon = 7;

      // The video file. Only set this field if the video field is requested.
      oneof video {
        // The URL to fetch a video ad. The URL should return an XML response
        // that conforms to VAST standards.
        string video_url = 13;

        // The VAST document to be returned.
        string video_vast_xml = 16;
      }

      // The app rating in the app store. Must be in the range [0-5].
      optional double star_rating = 8;

      // The URL that the browser/SDK will load when the user clicks the ad.
      // This can be the landing page directly, or the first step of a redirect
      // chain that eventually leads to it. For backward compatibility, if this
      // is not set, the first Ad.click_through_url is used.
      optional string click_link_url = 14;

      // The URL to use for click tracking. The SDK pings click tracking url on
      // a background thread. When resolving the url, HTTP 30x redirects are
      // followed. The SDK ignores the contents of the response; this URL
      // has no effect on the landing page for the user.
      // This field is planned to be deprecated and we are moving to the
      // repeated click_tracking_urls field.
      optional string click_tracking_url = 11;

      // The URLs to use for click tracking. This will be used throughout the
      // serving stack and will incorporate any URL in click_tracking_urls.
      repeated string click_tracking_urls = 15;

      // The price of the promoted app including the currency info.
      optional string price = 10;

    };
    optional NativeAd native_ad = 18;

    // The set of destination URLs for the snippet. This includes the URLs that
    // the user will go to if they click on the displayed ad, and any URLs that
    // are visible in the rendered ad. Do not include intermediate calls to the
    // adserver that are unrelated to the final landing page. A BidResponse that
    // returns a snippet or video ad but declares no click_through_url will be
    // discarded. Only set this field if html_snippet or video_url or native_ad
    // are set. This data is used as a destination URL declaration, for example
    // for post-filtering of publisher-blocked URLs or ad categorization.
    //
    // For non-native ads, it is not used for click tracking or any
    // other ad functionality; it is only used as a destination URL
    // declaration.
    //
    // For native ads, if NativeAd.click_link_url is not set, the first
    // value of click_through_url is used to direct the user to the landing
    // page. In addition, all values are used as destination
    // URL declarations (similar to the non-native case).
    repeated string click_through_url = 4;

    //...

    // The URLs to call when the impression is rendered. The SDK pings
    // impression urls on a background thread and ignores the contents
    // of the response.
    repeated string impression_tracking_url = 19;

    // Link to ad preferences page. This is only supported for native ads.
    // If present, a standard AdChoices icon is added to the native ad creative and
    // linked to this URL.
    optional string ad_choices_destination_url = 21;
    // ...
  }
}

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

ملاحظة: لفهم ما هو المطلوب أو الاختياري الذي يظهر في الرد، يُرجى الرجوع إلى إلى BidRequest.adslot.native_ad_template في طلب Google الوارد أدناه. بالنسبة إلى OpenRTB JSON، يمكن العثور على المتطلبات في الحقل request من BidRequest.imp.native بالنسبة إلى بروتوكول OpenRTB Protobuf، ارجع إلى حقل request_native في BidRequest.imp.native.

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

Google

عرض المثال

id: "\020?|;\324c\013\010b\323\321A\277]\017\3643\232.<\230?b"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0"
url: "https://www.google.com"
detected_language: "pl"
adslot {
  id: 1
  excluded_attribute: 95
  excluded_attribute: 16
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  excluded_sensitive_category: 4
  excluded_sensitive_category: 23
  matching_ad_data {
    billing_id: 63548360940
    billing_id: 73058881203
    minimum_cpm_micros: 210000
  }
  matching_ad_data {
    billing_id: 47396933418
    billing_id: 29288464031
    minimum_cpm_micros: 1000000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 13680
  ad_block_key: 7661032520
  publisher_settings_list_id: 3957665107521501273
  publisher_settings_list_id: 2660288298851198176
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 49
  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: PDj94L0qm9"
    source: "OMITTED"
  }
  consented_providers_settings {
    consented_providers: 1186
    consented_providers: 1301
    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: 800
    image_height: 800
    style_id: 536714
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_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
postal_code: "10011"
geo_criteria_id: 20858
encrypted_hyperlocal_set: "!\363\260\353\204l\255n\216\215\201G\261e/\t\305\350=\220\034\220\\J\310\305\247\266\247\027\347\212_\211\363\332\370baL\226\312\375\007}\017\0140\000\262\363\373Y\243\223d\022d=\342\257\340b]\367\356\304\357 \302\204\rC\000|\245\312\235\321\323\265\357K`\307vL\354\220V\346"
publisher_type: PUBLISHER_OWNED_AND_OPERATED
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  os_version {
  }
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "PL"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z31Byn-43v7X648f48t464c0VJ47168b3x66Lz451VGsHXp58L9O1o135IzD1F09ZZGb"
auction_type: FIRST_PRICE
geo {
  lat: 50.72
  lon: 21.32
  country: "POL"
  region: "PL-SK"
  zip: "27-570"
  utcoffset: 120
  accuracy: 4730
}
user_agent_data {
  platform {
    brand: "Windows NT"
    version: "10"
    version: "0"
  }
  mobile: false
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "Gecko"
    version: "20100101"
  }
  source: USER_AGENT_STRING
}
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"

OpenRTB JSON

عرض المثال

{
  "id": "05nylT967i314zc0550QIR",
  "imp": [
    {
      "id": "1",
      "tagid": "9635174525",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"ext\":{\"style_id\":221281,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}",
        "ver": "1.2"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "viewability",
          "value": 0.02,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 7,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          97677444075
        ],
        "publisher_settings_list_id": [
          2939393531484090288,
          7076809137765332725
        ],
        "allowed_vendor_type": [
          42,
          144
        ],
        "ampad": 3,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32,
          33
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "livestream": 0,
      "language": "ja"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-21",
      "city": "Ogaki",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 1485
    },
    "ipv6": "2402:6b00:f311::",
    "make": "Sharp",
    "model": "shg05",
    "os": "android",
    "osv": "13",
    "devicetype": 4,
    "lmt": 0,
    "w": 320,
    "h": 721,
    "pxratio": 3.375,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "124",
            "0"
          ]
        },
        {
          "brand": "Google Chrome",
          "version": [
            "124",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "13",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SHG05",
      "source": 2
    }
  },
  "user": {
    "id": "RMnq2980sl68Ha7b7TUd4clG7ab",
    "buyeruid": "nc79n59R0Ubi1zrgc9X923Oe72M34CfD",
    "customdata": "I2P0IGi7dhNG943Ecm6436198j178K6v4nP3s99456bUbc27"
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB9",
    "IAB26"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp2.com",
          "sid": "pub-1111111111111112",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          },
          {
            "asi": "testssp2.com",
            "sid": "pub-1111111111111112",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-ze18lg-8rEH89k518130b8zL5N4Lm590d756ONF330Yg8zoqpisuOv2m5YH2o4712Z0A",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 0
    }
  }
}

بروتوكول OpenRTB Protobuf

عرض المثال

id: "4vO3ESnZs7gsbNlU3LHL56"
imp {
  id: "1"
  tagid: "4199517334"
  bidfloor: 1.88
  bidfloorcur: "USD"
  pmp {
    deals {
      id: "21043453"
      bidfloor: 1.88
      bidfloorcur: "USD"
      [com.google.doubleclick.deal] {
        deal_type: AUCTION_PACKAGE
      }
    }
  }
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_2
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 90
        }
      }
      assets {
        id: 2
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 3
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      [com.google.doubleclick.native_ext] {
        style_id: 775009
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0011545843444764614
    vendor: "EXCHANGE"
  }
  metric {
    type: "session_depth"
    value: 1.0
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 85753840376
    publisher_settings_list_id: 5097279519468003913
    publisher_settings_list_id: 4840342404554094271
    allowed_vendor_type: 3
    allowed_vendor_type: 42
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    allowed_restricted_category: 33
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.0"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "KY"
    metro: "659"
    city: "Russellville"
    zip: "42276"
    type: IP
    utcoffset: -300
    accuracy: 2548
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9014733
    }
  }
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "124"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "124"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "10"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "83b9429Xl4Xh2aj6j098Ep3qM0K"
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB23-1"
bcat: "IAB23-10"
regs {
  gpp: "OMITTED"
}
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-z2S2lv-WNT3r7KS3S939181y04U9RrC4mv4669j3v5FJ3F823683vd9W3j4q7T3hZr1P"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

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

عرض التفاصيل

{
  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
}

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

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

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

Google

عرض المثال

ad {
  adslot {
    id: 1
    max_cpm_micros: 14161
    billing_id: 63548360940
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_374241"
  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: "213,99 z\305\202"
    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"
}
processing_time_ms: 21

OpenRTB JSON

عرض المثال

{
  "id": "Z8TDDaW77DBY91rct559D3",
  "seatbid": [
    {
      "bid": [
        {
          "id": "20g178F1nO1U81rq3l6",
          "impid": "1",
          "price": 0.12127,
          "adid": "test_creative_id_879318",
          "adm": "{\"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Galactic Luxury Cruises\"}}, {\"id\": 3, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 1200, \"h\": 628}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adomain": [
            "google.com"
          ],
          "cid": "97677444075",
          "crid": "test_creative_id_879318",
          "ext": {
            "app_promotion_type": "INSTALLS",
            "ad_choices_destination_url": "https://test.com/preferences"
          }
        }
      ],
      "seat": "9714:3611:768318"
    }
  ],
  "bidid": "V2drbz93-w5w09453-0766-pLu36cYs0I91"
}

بروتوكول OpenRTB Protobuf

عرض المثال

id: "Z1ooz319AuluM78c9gs382"
seatbid {
  bid {
    id: "27Zv77s98G1G6j81vg2"
    impid: "1"
    price: 1.9337624810013911
    adid: "test_creative_id_425686"
    adomain: "google.com"
    cid: "85753840376"
    crid: "test_creative_id_425686"
    dealid: "21043453"
    cat: "IAB7-5"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Book today"
        }
      }
      assets {
        id: 3
        data {
          value: "Galactic Luxury Cruises"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
  }
  seat: "1287:1720:806996"
}
cur: "USD"

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

عرض التفاصيل

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/"
    }
  }
}