ضبط عملية دمج لعرض الأسعار المفتوح

تتيح عروض الأسعار المفتوحة لتبادلات البيانات والمشترين الآخرين الاستفادة من بنية عروض الأسعار في الوقت الفعلي من Google لتقديم عروض أسعار على مستودع "مدير إعلانات Google" وAdMob.

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

حصر عملية الدمج بمجموعة محدّدة من الناشرين

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

البروتوكولات والترميزات المتوافقة

يمكنك استخدام OpenRTB بتنسيقَي JSON أو Protobuf. مزيد من المعلومات

تنفيذ Google OpenRTB

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

معالجة طلبات عروض الأسعار الواردة

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

الردّ بعرض سعر

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

ملاحظة: يجب أن تتلقّى طلبات عروض الأسعار المُرسَلة إلى المشاركين في "عرض الأسعار المفتوح" ردًا في غضون 300 إلى 1000 ملي ثانية، استنادًا إلى تنسيق المستودع الإعلاني. لتحديد المتطلّب المحدّد ل طلب معيّن، ضَع علامة في الحقل BidRequest.tmax.

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

• الإعلانات البينية
• إعلانات الفيديو
• إعلانات الفيديو في OpenRTB
• الإعلانات المدمجة مع المحتوى
• إعلانات الفيديو المدمجة مع المحتوى
• إعلانات حزمة تطوير البرامج (SDK) الخاصة بالمشترين

تتبُّع مرّات الظهور للحدّ من الاختلافات

ننصحك بشدة باستخدام الحقل الاختياري BidResponse.seatbid.bid.ext.impression_tracking_url ل retrieving data at the impression level on when Google records billable events for which you will be charged.

معالجة التفاوت في عدد مرات الظهور من Google (إصدار تجريبي)

تهدف هذه الميزة إلى التأكّد من أنّ عدد مرّات الظهور التي يتم تحصيل رسوم مبادلتها يتطابق مع عدد مرّات الظهور التي تدفع ثمنها "مساحة العرض والفيديو 360".

من خلال تحديد مرّات الظهور في "مساحة العرض والفيديو 360" التي تم عرضها من خلال عروض أسعار المفتوحة، يمكن لخدمة Google بعد ذلك تعديل الرسائل غير المرغوب فيها والأحداث التي يمكن إصدار فواتير بها لضمان عدم تحصيل رسوم منك مقابل مرّات الظهور التي لا تتلقّى مقابلها مبالغ مالية.

نشر مَعلمة google_query_id في طلبات عروض الأسعار

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

نشر رمز مشترٍ تابع لجهة خارجية في الردود على عروض الأسعار

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

تمرير ترميز تصميم الإعلان من Google كما هو في ردود عروض الأسعار

لضمان تطبيق حلّ التناقضات على عروض الأسعار الواردة من طلب Google، يجب إجراء عملية تبادل لنشر ترميز تصميم الإعلان من Google بدون أيّ أغلفة (علامات النصوص البرمجية أو إطارات iframe أو أغلفة VAST). بسبب حلّ التناقضات، قد تلغي Google مرّات الظهور في عروض Bid Open التي لم يتم احتسابها من خلال منصّات طلب Google، ولن تُحصّل رسومًا مقابلها. ستراجع Google بشكل دوري ترميز المواد الإبداعية للتأكّد من أنّ عروض الأسعار التي تتضمّن third_party_buyer_token تم إرسالها بالنيابة عن طلب Google، وليس أي مشتري آخر.

تصميمات إعلانات HTML5

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

لا يمكن لشركة Google تطبيق حلّ التناقضات إذا كان أحد أنظمة التبادل يلضم تصميم الإعلان المكوّن من HTML من Google في علامة (script أو iframe أو تقنيات أخرى) تحمّل لاحقًا رمز HTML من Google أو تعرِضه.

استيفاء المتطلبات الفنية

في هذا المثال، يتمّ نقل رمز HTML لتصميم الإعلان من استجابة عروض الأسعار بشكل حرفي في Google ("مساحة العرض والفيديو 360")، مع إضافة رمز HTML خاص بالتبادل في بداية الرمز وآخره.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

لا يستوفي المتطلبات الفنية

في هذا المثال، تم تشويش رمز HTML الذي تعرضه Google في تصميم الإعلان في استجابة عرض السعر التي تقدّمها منصة تبادل الإعلانات، ولا يظهر حرفيًا في استجابة عرض السعر. قد يتم عرض رمز HTML المقدَّم من Google بواسطة ملف مغلف مقدَّم من تبادل الإعلانات في المتصفّح.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

تصميمات إعلانات الفيديو بتنسيق VAST

للتأهّل لحلّ التناقضات، يجب أن يستخدم التبادل أحد النهجَين التاليَين لتعبئة VASTTagURI في ملفَي XML الخاصَين بـ "نموذج عرض إعلانات الفيديو":

1. يمكن أن تحافظ عملية التبادل على قيمة عنصر VASTTagURI كأحد أجزاء مستند VAST XML الذي تعرضه Google في الحقل BidResponse.seatbid.bid.adm كما هو، مع توسيعات الوحدات النمطية الخاصة بعملية التبادل التي تنطبق عادةً.
2. يمكن لخدمة DV360 ملء الحقل BidResponse.seatbid.bid.adm.nurl بعنوان URL لمستند VAST في ردود عروض الأسعار على تبادل. يمكن للتبادل بعد ذلك تمرير هذه القيمة باستخدام العلامة VASTTagURI، مع توسيع الوحدات المبرمَجة الخاصة بالتبادل بشكلٍ طبيعي حسب الحاجة.

يمكن لنظام تبادل الإعلانات تحديد أجهزة تتبُّع إضافية لأحداث VAST والأخطاء ضمن مستند VAST XML إذا لزم الأمر.

استيفاء المتطلبات الفنية

في هذا المثال، يتمّ نقل معرّف URI لتنسيق VAST للتصميم من استجابة عروض الأسعار بشكل حرفي في Google (مساحة العرض والفيديو 360)، مع إضافة تبادل لأحداث VAST ومقتبِسي أخطاء محدّدين.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

لا يستوفي المتطلبات الفنية

في هذا المثال، رمز VAST أو معرّف الموارد المنتظم (URI) الذي تعرضه Google لا يظهر حرفيًا في ردّ عروض الأسعار، وبدلاً من ذلك، يتم استخدام غلاف VAST خاص بالتبادل. يمكن تحميل رمز VAST المقدَّم من Google باستخدام حزمة VAST التي يوفّرها نظام الصرف (على النحو المحدّد في VASTAdTagURI العنصر، https://video.exchange.example.com/creative?…) عند تحميل حزمة تطوير البرامج (SDK) لإعلان.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

العروض

يمكن للبورصات المشاركة في ميزة "عرض الأسعار المفتوح" استخدام الصفقات المفضّلة (PD) والمزادات الخاصة (PA) مع ميزة "عرض الأسعار المفتوح". يجب تحديد رقم تعريف الصفقة ونوعها على النحو التالي:

الحقل	الوصف
BidResponse.seatbid.bid.dealid	معرّف الصفقة من مساحة اسم تبادل الإعلانات المرتبط بعرض السعر والمبلّغ عنه للناشرين. هذا نص UTF8 عشوائي ويجب ألا يزيد عن 64 بايت.
BidResponse.seatbid.bid.ext.exchange_deal_type	فهرس يحدّد نوع الصفقة ويتم إبلاغ الناشرين بذلك، ويؤثّر ذلك في كيفية التعامل مع الصفقة في المزاد. القيم المحتمَلة هي: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

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

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

مطابقة ملفات تعريف الارتباط

لملء جداول المطابقة المستضافة على Google، يمكن لمشاركي "عروض الأسعار المفتوحة" استخدام أيّ من الخيارات التالية التي تناسب احتياجاتهم على أفضل نحو:

• مطابقة ملفات تعريف الارتباط: مطابقة تبدأ من المشتري أو من عملية التبادل مزيد من المعلومات
• مطابقة البكسل: عملية مطابقة تبدأها Google مزيد من المعلومات
• مساعدة مطابقة ملفات تعريف الارتباط: مطابقة تبدأ من جهة التبادل مع مقدّمي عروض الأسعار مزيد من المعلومات

ملاحظة: لا يمكن للمشاركين في ميزة "عروض الأسعار المفتوحة" إنشاء قوائم مستخدمين أو تعبئتها أو استهدافها في الوقت الحالي.

إدارة وقت الاستجابة

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

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

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

وحدات ماكرو النقرات

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

واجهات برمجة التطبيقات

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

• الإصدار 1.4 من تقرير الأداء
• تحديد المشاكل وحلّها في عروض الأسعار في الوقت الفعلي (RTB) في الإصدار 2.0 من الإصدار التجريبي

يمكنك التواصل مع المدير الفني لحسابك لضبط إعدادات حسابك للوصول إلى واجهات برمجة التطبيقات هذه، واسترداد رقم تعريف الحساب المطلوب لإجراء طلبات برمجة التطبيقات. للحصول على دعم فني لاستخدام واجهات برمجة التطبيقات هذه، يمكنك التواصل مع عنوان البريد الإلكتروني البديل للدعم: [e-mail].

مراجع إضافية

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

عيّنات من طلبات عروض الأسعار واستجاباتها

يمكن العثور على نماذج طلبات عروض الأسعار والردود لجميع البروتوكولات المتوافقة في دليلَي الطلب والرد.