تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بعد أن يعالج تطبيقك طلب عروض الأسعار من Google، يجب أن ينشئ
ويرسل ردًا. يوضّح هذا الدليل كيفية ترميز تطبيقك لإنشاء
الردّ.
إنشاء رسالة BidResponse بتنسيق Protobuf
تُرسِل "الشراة المعتمَدون" BidRequest كنص الرسالة في
POST HTTP. إذا تم ضبط نقطة نهاية عروض الأسعار لاستخدام تنسيق
Protobuf، يجب أن يرسل تطبيقك ردًا مع ضبط عنوان
Content-Type على application/octet-stream
ونص الرسالة المكوّن من تنسيق تسلسلي لبروتوكول برمجة التطبيقات. ملف تخزين
البروتوكول هو رسالة BidResponse كما هو محدّد في
openrtb.proto. يجب أن يعرض تطبيقك BidResponse قابلاً للتحليل كردّ على كل BidRequest. إنّ حالات المهلة
والردود التي لا يمكن تحليلها تُعدّ أخطاء، وتعمل Google على الحدّ من
عروض الأسعار التي تسجّل معدّلات أخطاء عالية.
إذا كنت لا تريد تقديم عروض أسعار لمشاهدة إعلان، يجب عرض استجابة HTTP
204 فارغة. يمكنك الحصول على openrtb.proto من صفحة
البيانات المرجعية.
الرقم التعريفي لتصميم الإعلان
يحدِّد BidResponse تصميم إعلان من خلال الحقل
BidResponse.seatbid.bid.crid (الحدّ الأقصى 64 بايت). حتى مواد العرض المشابهة، يجب أن تحتوي على قيم فريدة لهذا الحقل إذا كانت تختلف في أي خصائص ملحوظة، بما في ذلك على سبيل المثال لا الحصر: الحجم وعنوان URL المُعلَن عنه وسمات مواد العرض وأنواع المورّدين. بعبارة أخرى، يجب منح معرّفات مواد إبداعية مختلفة لأي إعلانَين:
تبدو مختلفة أو تتصرف بشكل مختلف
عرض الصور بتنسيقات مختلفة
يتم عرضها بوسائل مختلفة (على سبيل المثال، يتألف أحد الإعلانات من صورة،
بينما الآخر عبارة عن فيديو).
أثناء تصميم طلبك، عليك اختيار طريقة منهجية ل
إنشاء معرّفات منطقية لأنواع تصميمات الإعلانات التي تخطّط
لإرسالها.
سمات الإعلان
تنصح Google بتعريف سمات المواد الإبداعية لوصف
سمات إعلانك واستهدافه باستخدام إما تركيبة من
BidResponse.seatbid.bid.apis و
BidResponse.seatbid.bid.attr أو إضافة
BidResponse.seatbid.bid.ext.attribute. توضّح الخطوات التالية كيفية تحديد السمات:
VPAID
اضبط BidResponse.seatbid.bid.apis على VPAID_1
أو VPAID_2. بالنسبة إلى تنسيق JSON، يمكن ضبط هذا الخيار على
1 أو 2 على التوالي.
MRAID
اضبط BidResponse.seatbid.bid.apis على
MRAID_1 أو 3 لتنسيق JSON.
SIZELESS
اضبط BidResponse.seatbid.bid.attr على
RESPONSIVE أو 18 لتنسيق JSON.
PLAYABLE
ويُشار إلى ذلك من خلال ضبط BidResponse.seatbid.bid.attr
على USER_INTERACTIVE أو 13 لتنسيق JSON.
اطّلِع على
مرجع تصميمات الإعلانات
للاطّلاع على شرح حول كيفية الحصول على ملاحظات بشأن السمات التي تم رصدها في
تصاميم إعلاناتك.
حقول "عرض الأسعار المفتوح"
إنّ ردود عروض الأسعار التي يرسلها مقدّمو عروض الأسعار في الشبكة الإعلانية وشبكة التبادل الذين يشاركون في "عرض الأسعار المفتوح" مشابهة لتلك التي يرسلها "الشراة المعتمَدون" الذين يشاركون في "عرض أسعار الوقت الفعلي" العادي. يمكن لعملاء عروض الأسعار المفتوحة تحديد عدد صغير من
الحقول الإضافية، وقد يكون لبعض الحقول الحالية استخدامات بديلة. وتشمل هذه التحسينات
ما يلي:
OpenRTB
الشراة المعتمَدون
التفاصيل
BidResponse.imp[].pmp.deals[].id
BidResponse.ad[].adslot[].exchange_deal_id
معرّف الصفقة من مساحة اسم التبادل المرتبط بهذه المحاولة
الإجرائية ويكون مُدرَجًا في التقارير المرسَلة إلى الناشرين.
الرمز المميّز المستخدَم لتحديد معلومات المشتري النهائي التابع لجهة خارجية إذا كان
التبادل بصفته مقدّم عروض أسعار مفتوحة هو وسيط. يتم الحصول على هذه المعلومات من العميل
التابع للجهة الخارجية ويجب نقلها إلى Google بدون تغيير في ردّ
عروض الأسعار.
اقتراحات
فعِّل اتصالات HTTPS المستمرة (المعروفة أيضًا باسم "الاستدامة" أو
"إعادة استخدام الاتصال") على خوادمك. اضبط مهلة الانتظار على 10 ثوانٍ على الأقل، ويمكنك ضبط قيم أعلى في العديد من الحالات. تتحقّق Google
من ذلك أثناء اختبارات وقت الاستجابة الأولية لتطبيقك، لأنّه
يُرسِل "المشترون المعتمَدون" الطلبات بمعدّل مرتفع ويجب تجنُّب
الوقت الإضافي الذي يستغرقه إنشاء اتصال TCP منفصل لكل
طلب.
أدرِج عنوان URL الاختياري لتتبُّع مرّات الظهور من أجل تتبُّع مرّات الظهور بدلاً من تتبُّع وقت فوز مقدّم عروض الأسعار. ونظرًا للانخفاض
في عدد مرات الفوز وعدد عمليات العرض، يؤدي ذلك إلى إحصاءات تتبُّع
أكثر دقة.
يجب أن يكون رمز مقدّم عروض الأسعار خاليًا من الاعتماد على الحقول المتوقّفة نهائيًا،
لأنّ ذلك قد يؤدي إلى تعذّر عرض أسعارك بسبب حدوث أخطاء.
أدرِج BidResponse.seatbid.bid.w و
BidResponse.seatbid.bid.h في BidResponse. يجب أن يتضمّن
BidResponse لطلب يتضمّن أحجام إعلانات متعددة
هذه الحقول وإلا سيتم إسقاطه من المزاد.
يجب ألا يزيد حجم الردّ عن 8 كيلوبايت. قد تؤدي الاستجابات الكبيرة جدًا إلى زيادة
وقت استجابة الشبكة وتسبب في انتهاء المهلة.
ملاحظة مهمة: يتم عرض رسائل Protobuf المعروضة في المثالين أدناه كنص يمكن لشخص عادي قراءته. ومع ذلك، هذه ليست الطريقة التي يتم بها
إرسال الرسائل عبر الشبكة. عند استخدام تنسيق Google أو OpenRTB Protobuf
، لن يتم قبول سوى رسائل BidResponse المتسلسلة.
يمكنك إنشاء رسالة BidResponse وتسلسلها باستخدام رمز C++ التالي:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
تحديد تصميم الإعلان
يحدِّد ردّ عرض السعر تصميم الإعلان الذي سيتم عرضه إذا فاز عرض سعرك. يجب أن يتضمّن عرض السعر
أحد أشكال الإعلانات المتوافقة (AMP أو فيديو أو إعلان مدمج). في هذا
المثال، نحدّد تصميم الإعلان باستخدام الحقل html_snippet.
بدلاً من ذلك، يمكنك تحديد تصميم إعلانك باستخدام واحد من
الحقول التالية، استنادًا إلى شكل الإعلان:
إعلان معروض باستخدام حزمة SDK
BidResponse.seatbid.bid.ext.sdk_rendered_ad
صفحات AMP
BidResponse.seatbid.bid.amp_ad_url
الفيديو
BidResponse.seatbid.bid.adm
الإعلانات المدمَجة مع المحتوى
BidResponse.seatbid.bid.adm_native
حدِّد إعلانًا مستضافًا على خوادمك باستخدام مقتطف HTML في
حقل BidResponse.seatbid.bid.adm. يتم تضمين المقتطف في ملف iFrame مُدرَج في صفحة الويب، ما يؤدي إلى استرداد الإعلان و
عرضه عند تحميل الصفحة. يجب إنشاء مقتطف HTML لكي يتم عرض الإعلان (البانر أو الإعلان البيني) بشكل صحيح داخل إطار iFrame وبحجم مناسب لموضع الإعلان الذي تقدّم عروض أسعار له.
بالإضافة إلى ذلك، يجب أن يتطابق حجم الإعلان الذي تمّ الإعلان عنه في ردّ عرض السعر مع أحد مجموعات الحجم بالضبط في طلب عرض السعر في الحالات التالية:
الإعلان هو بانر عادي (وليس فيديو أو إعلان مضمّن مع المحتوى أو إعلان بيني).
أعلن مقدّم عروض الأسعار عن الحجم في استجابة عرض السعر. يجب تحديد المقاس
في حال توفّر أكثر من مقاس واحد في الطلب.
يتمّ استثناء الإعلانات البينية. بالنسبة إلى الإعلانات البينية، يجب ألا يقلّ عرضها عن% 50 من عرض الشاشة، ويجب ألا يقلّ ارتفاعها عن% 40 من ارتفاع الشاشة.
يمكنك تحديد تصميم مكوّن إعلان مقتطف HTML باستخدام أيّ رمز HTML صالح يتم
عرضه بشكل صحيح، ولكن عليك مراعاة القيود المفروضة على تحديد الحقل
crid في القسم
إنشاء رسالة BidResponse.
ومن بين استخدامات ذلك وضع معلومات إضافية في وسيطات عناوين URL التي يتم جلبها من خوادمك كجزء من عرض الإعلان. يتيح لك ذلك تمرير
بيانات عشوائية عن مرّة الظهور إلى خوادمك.
وحدات الماكرو هي نص منسَّق مضمّن في بعض حقول استجابة عروض الأسعار التي تحتوي على
عناوين URL يتم استبدالها بقيمة ذات صلة في وقت عرض الإعلان. على سبيل المثال،
إذا كان عرض السعر الفائز يتضمّن وحدة الماكرو AUCTION_PRICE في مقتطف HTML
الإعلاني المضمّن في عرض السعر، سيتم استبدال وحدة الماكرو بقيمة
يمكنك فك تشفيرها لتحديد المبلغ الذي دفعته مقابل مرّة الظهور في
المزاد.
يمكنك تضمين وحدات الماكرو في الحقول التالية:
BidResponse.seatbid.bid.adm
تتوفّر وحدات الماكرو لتنسيقات مقتطفات HTML والإعلانات المدمجة وعنوان URL للفيديو وتنسيق XML لإعلانات VAST
للفيديوهات.
استخدِم هذا العنصر بدلاً من BidResponse.seatbid.bid.burl إذا كنت تحتاج إلى
أكثر من عنوان URL واحد للفوترة.
على سبيل المثال، يمكنك تضمين وحدة ماكرو كجزء من مقتطف HTML من خلال
تضمين ${MACRO} ضمن عنوان URL المستخدَم لجلب تصميم الإعلان،
حيث يكون MACRO أحد وحدات الماكرو المتوافقة الموضّحة في
مواصفات OpenRTB.
وحدات ماكرو عروض الأسعار في الوقت الفعلي من Google
تتيح Google استخدام وحدات ماكرو إضافية إلى جانب تلك الوحدات الواردة في مواصفات OpenRTB. ويتم تنسيق هذه الوحدات بشكل مختلف، وستظهر على النحو التالي:
%%MACRO%% في حال تضمينها في عنوان URL. يوضّح الجدول التالي
وحدات الماكرو هذه:
Macro
الوصف
ADVERTISING_IDENTIFIER
السماح للمشترين بتلقّي معرّف المعلِنين (IDFA) في نظام التشغيل iOS أو المعرّف الإعلاني في Android عند
عرض الإعلانات
اطّلِع على فك تشفير معرّفات المعلِنين
للاطّلاع على التفاصيل.
CACHEBUSTER
تمثيل سلسلة لعدد صحيح عشوائي غير موقَّع من أربعة بايت
CLICK_URL_UNESC
عنوان URL غير المشفَّر للنقرة على الإعلان. في المقتطف، يجب أن يتبع رمز برمجي واسِع النطاق
لعنوان URL الخاص بالنقرة على الجهة الخارجية مباشرةً رمز برمجي
الماكرو.
على سبيل المثال، إذا كان عنوان URL للنقرة التابع لجهة خارجية هو
http://my.adserver.com/some/path/handleclick?click=clk،
يمكن استخدام الرمز التالي مع الإصدار المُشفَّر بترميز واحد
لعنوان URL للنقرة التابع لجهة خارجية بعد استدعاء الماكرو:
سيسجِّل عنوان URL النقرة أولاً مع Google، ثم سيعيد توجيهك
إلى عنوان URL الخاص بالنقرة التابع للجهة الخارجية.
CLICK_URL_ESC
عنوان URL للنقرة على الإعلان الذي تمّ ترميزه استخدِم هذا الإجراء بدلاً من
CLICK_URL_UNESC إذا كنت بحاجة إلى تمرير القيمة أولاً من خلال
خادم آخر سيعرض بعد ذلك إعادة توجيه.
على سبيل المثال، يمكن استخدام الرمز البرمجي التالي في مقتطف HTML:
سيؤدي ذلك إلى تسجيل النقرة باستخدام my.adserver.com التي
ستكون مسؤولة بعد ذلك عن إعادة التوجيه إلى عنوان URL الذي تم تمريره في المَعلمة
google_click_url. يفترض ذلك أنّه يتم إزالة ترميز المَعلمة
google_click_url باستخدام الإجراء
my.adserver.com.
يمكنك إلحاق عنوان URL مشفَّر مزدوجًا بعد
%%CLICK_URL_ESC%%. بعد إزالة ترميز المحتوى من خلال
my.adserver.com، يبقى إصدار واحد غير مشفَّر من
عنوان URL مُلحَقًا بالعنصر google_click_url. عند جلب
google_click_url، ستتم إزالة ترميزه مرة أخرى
ثم إعادة التوجيه.
CLICK_URL_ESC_ESC
عنوان URL الذي تم تشفيره مرتين للإعلان. استخدِم هذا الإجراء بدلاً من
CLICK_URL_UNESC إذا كنت بحاجة إلى تمرير القيمة أولاً
عبر خادم آخر سيعرض بعد ذلك إعادة توجيه.
على سبيل المثال، يمكن استخدام الرمز البرمجي التالي في مقتطف HTML:
يتمّ توسيعه إلى http: إذا كان طلب عروض الأسعار لا يتطلّب طبقة المقابس الآمنة (SSL) أو إلى
https: إذا كان طلب عروض الأسعار يتطلّب طبقة المقابس الآمنة (SSL).
SITE
النطاق الذي تم ترميزه لعنوان URL للمحتوى أو المعرّف المجهول للمستودع المجهول
SITE_URL
تمّ الإيقاف. تم استبداله بالرمز الموسّع SITE الذي يوفّر وظيفة مماثلة.
TZ_OFFSET
معادلة المنطقة الزمنية
VERIFICATION
القيم المختلفة للإنتاج ووقت فحص تصميم الإعلان
في مسار التحقّق التنسيق هو:
%%?VERIFICATION:true-val:false-val%% حيث يمكن استخدام أي قيم
باستثناء الوحدات النمطية لكل من true-val و
false-val، بما في ذلك السلاسل الفارغة. بالنسبة إلى عروض الأسعار المفتوحة، ننصحك
بأن تستخدم البورصات هذه الماكرو. وبعد إجراء ذلك، لن تحتاج منصات العميل
إلى إجراء تغييرات.
على سبيل المثال، إذا كان تصميم الإعلان يتضمّن
%%?VERIFICATION:-1:5000%%، سيكون 5000 هو بديل النص
عند عرض الإعلان و-1 في
مسار التحقّق. يهدف ذلك إلى المساعدة في التفريق بين هذين
مجموعتَي الإشعارات.
WINNING_PRICE
تكلفة مرّة الظهور المشفّرة (أي تكلفة تثبيت التطبيق بدلاً من التكلفة لكلّ ألف ظهور) في
الميكرو من عملة الحساب على سبيل المثال، التكلفة الفائزة لكل ألف ظهور التي تبلغ 5 دولار أمريكي
تتوافق مع 5,000,000 تكلفة لكل ألف ظهور في الميكرو، أو 5,000 تكلفة لكل تثبيت في الميكرو. ستكون القيمة المرمّزة
لرمز WINNING_PRICE في هذه الحالة 5,000.
يتم تحديد السعر الفائز بوحدة التكلفة لكل تثبيت.
لتحليل هذه الوحدات النمطية، عليك تنفيذ تطبيق
لفك تشفير تأكيدات الأسعار. يُرجى الرجوع إلى صفحة
فك تشفير تأكيدات الأسعار
للحصول على مزيد من المعلومات.
WINNING_PRICE_ESC
WINNING_PRICE التي تم ترميزها لتكون صالحة لعنوان URL
تشترط Google استخدام إحدى الوحدات النمطية CLICK_URL_UNESC أو
CLICK_URL_ESC في تصميم الإعلان المعروض
الذي تقدّمه الجهة الخارجية. تستخدِم Google وحدات الماكرو CLICK_URL لتتبُّع النقرات.
يستخدم ترميز عنوان URL في وحدات الماكرو المخطط التالي:
يتم استبدال حرف المسافة بعلامة الجمع (+).
تظل الأحرف الأبجدية الرقمية (0-9 وa-z وA-Z) والأحرف من المجموعة !(*،-./:_~ بدون تغيير.
يتم استبدال جميع الأحرف الأخرى بـ %XX، حيث يكون XX هو الرقم السداسي
الذي يمثّل الحرف.
القيود المفروضة على الناشرين والمتطلبات التي يجب استيفاؤها
يتضمّن طلب عرض السعر معلومات عن أنواع القيود وال requirements التي يفرضها الناشرون على تصميمات الإعلانات في المزاد.
BidRequest.bcat
يمكنك مقارنة الفئات المحظورة المحدّدة في هذا الحقل بتلك التي
تم رصدها لتصاميم الإعلانات التي تم إرسالها باستخدام حقل
detectedCategories في واجهة برمجة التطبيقات Real-time Bidding API.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
في العادة، سيتم ضبط هذا الخيار دائمًا على true لأنّه
تشترط Google توفّر طبقة المقابس الآمنة (SSL) لجميع تصميمات الإعلانات.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
لا تقدِّم أبدًا عروض أسعار باستخدام إعلان يتضمّن ميزة محظورة. بالنسبة إلى الميزات المسموح بها،
مثل نوع المورّد، لا تعرض إعلانًا إلا إذا كان نوع المورّد مُدرَجًا في قائمة
allowed_vendor_type ضمن BidRequest. يجب عدم تضمين سوى التنسيقات
الإعلانية المحدّدة في طلب عرض السعر من خلال ملء حقول مثل
BidRequest.imp.banner في عرض السعر. اطّلِع على مزيد من التفاصيل في ملف تعريف
هذه الحقول في تعريف BidRequest لملف تخزين بروتوكول BidRequest.
إذا تم عرض إعلان في BidResponse، عليك
ضبط حقلَي BidResponse.seatbid.bid.attr و
BidResponse.seatbid.bid.cat وأحد الحقلين
BidResponse.seatbid.bid.adomain أو
BidResponse.seatbid.bid.adm_native.link.url بدقة في
BidResponse. إذا كان الإعلان يتضمّن قيمًا متعددة سارية لهؤلاء
الحقول، يجب تضمين كل قيمة. اطّلِع على التعليقات لهذه الحقول في
تعريف ملف تخزين بروتوكول BidResponse للحصول على مزيد من التفاصيل.
ويتم تجاهل الردود التي لم يتم ضبط هذه الحقول فيها.
القياس المفتوح
تتيح لك ميزة "القياس المفتوح" تحديد مورّدين خارجيين يوفّرون خدمات مستقلة
لقياس الأداء والتحقّق من المعلنين للإعلانات التي يتم عرضها في
بيئات التطبيقات المتوافقة مع الأجهزة الجوّالة.
تشمل أشكال الإعلانات المتاحة إعلانات الفيديو وإعلانات البانر والإعلانات البينية. لمزيد من
المعلومات عن كيفية استخدام "القياس المفتوح" في ردّ عرض سعر يحتوي على
هذه التنسيقات، يُرجى الرجوع إلى مقالة مجموعة تطوير البرامج (SDK) لبرنامج "القياس المفتوح" في
مركز المساعدة.
أمثلة على الاستجابات لعروض الأسعار
تعرض الأقسام التالية نماذج من ردود عروض الأسعار لأنواع الإعلانات المختلفة.
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
ملف JSON في OpenRTB
عرض المثال
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
ad{adslot{id:1max_cpm_micros:158000billing_id:41106584355deal_id:1}click_through_url:"google.com"attribute:70buyer_creative_id:"test_creative_id_251451"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:1200height:222}app_icon{url:"https://native.test.com/icon?id=123456"width:512height:512}star_rating:4.300000190734863click_link_url:"https://www.google.com"}impression_tracking_url:"https://test.com/imp?id=123456"impression_tracking_url:"https://test.com/imp?id=123456"event_notification_token:"token"skadn{version:"4.0"network:"l6x39K4z"itunesitem:"731305960"sourceapp:"627009739"fidelities{fidelity_type:STOREKIT_RENDERED_ADSnonce:"9216faff-74a9-4b35-badc-66878c35f67c"timestamp:1728975919221signature:"b0USXkmg02Q3v6p301kYOHG36CCOWWdEo52RHRttB9t8PTNi79qL17E4D6h7UeUSuq479oTK13G2Ev34MJlU86C5vY1SMVw2"}fidelities{fidelity_type:VIEW_THROUGH_ADSnonce:"9216faff-74a9-4b35-badc-66878c35f67c"timestamp:1728975919221signature:"4Cf4NH6239z9f3wa8j6420Z7H0UISYxyxN5720444dkq6457I5FY0Jg8bk1xge2P8YgiDp74l2738136v2g1A8D50331IRm0"}source_identifier:1}click_tracking_urls:"https://google.com/rtb/click?imp_id=55d2112c-4947-4da5-bc37-b79ebf4577dd"advertised_app_id:"APP_ID_OMITTED"app_promotion_type:INSTALLS}processing_time_ms:63
تاريخ التعديل الأخير: 2025-02-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-02-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Bid responses must be serialized `BidResponse` protocol buffers with the `Content-Type` header set to `application/octet-stream` for Protobuf, and a parsable `BidResponse` is required for each `BidRequest`, while an empty HTTP 204 response signals no bid."],["Each creative needs a unique `crid` (creative ID) limited to 64 bytes, and this ID must be unique across creatives if there are differences in size, declared URL, attributes, vendor types, appearance, behavior, or rendering method."],["Ad characteristics should be declared using `BidResponse.seatbid.bid.apis`, `BidResponse.seatbid.bid.attr`, or `BidResponse.seatbid.bid.ext.attribute`, with specific values indicating VPAID, MRAID, SIZELESS, or PLAYABLE attributes, respectively, and additional attributes from `buyer-declarable-creative-attributes.txt`."],["Responses should remain under 8KB, utilize persistent HTTPS connections with at least a 10-second timeout, and employ `BidResponse.seatbid.bid.burl` or `BidResponse.seatbid.bid.ext.impression_tracking_url` for tracking impressions."],["The `BidResponse` must accurately set creative attributes (`BidResponse.seatbid.bid.attr`), categories (`BidResponse.seatbid.bid.cat`), and advertiser domain (`BidResponse.seatbid.bid.adomain`) or native ad link (`BidResponse.seatbid.bid.adm_native.link.url`), as responses lacking these are discarded."]]],["Applications must respond to each `BidRequest` with a parsable `BidResponse`, using Protobuf or an HTTP 204 for no bids. Creatives are identified by a unique `crid`. Ad attributes, such as VPAID and MRAID, are declared in specific fields. Utilize impression tracking URLs and avoid deprecated fields. Open Bidding bid responses are similar to Authorized Buyers. Ad sizes in the response must match the request. Macros are used in URLs. Publisher requirements are specified in the `BidRequest`. The response must accurately reflect these requirements and provide the accurate ad attributes and links.\n"]]