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

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

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

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

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

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

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

تنفيذ OpenRTB من Google

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

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

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

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

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

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

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

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

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

ننصحك بشدّة باستخدام الحقل الاختياري BidResponse.seatbid.bid.ext.impression_tracking_url لاسترداد البيانات على مستوى مرّات الظهور بشأن الحالات التي تسجّل فيها Google أحداثًا قابلة للفوترة سيتم تحصيل رسوم منك مقابلها.

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

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

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

نقل google_query_id في طلبات عروض الأسعار

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

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

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

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

لضمان تطبيق عملية حلّ التفاوت على عروض الأسعار من مصادر طلب Google، يجب أن ينشر تبادل ترميز مواد عرض Google بدون أي أغلفة (علامات النصوص البرمجية أو إطارات iframe أو أغلفة VAST). نتيجةً لحلّ التناقض، قد تبطل Google صحة مرّات الظهور هذه في "المزايدة المفتوحة" ولا تصدر فواتير لها لأنّ منصات طلب 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 في استجابات VAST XML:

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

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

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

في هذا المثال، يتم تمرير معرّف 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 -->

العروض

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

الحقل	الوصف
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;

في ما يلي نموذج لردّ على عرض أسعار في "العروض المباشرة" و"الاتفاقيات الآلية".

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 من "تقرير الأداء"
• تحديد المشاكل وحلّها في الإصدار التجريبي 1 من RTB API‏ 2

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

مراجع إضافية

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

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

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