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

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

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

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

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

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

تستخدم ميزة "عرض الأسعار المفتوح" بروتوكولَي "الشراة المعتمَدون" المملوكة وبروتوكولات عرض الأسعار في الوقت الفعلي (RTB) لعروض الأسعار في الوقت الفعلي. مزيد من المعلومات

تنفيذ Google OpenRTB

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

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

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

الرد باستخدام عرض سعر

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

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

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

• الإعلانات البينية
• إعلانات الفيديو
• إعلانات فيديو OpenRTB
• الإعلانات المدمجة مع المحتوى
• إعلانات الفيديو المدمجة مع المحتوى
• إعلانات SDK للمشتري

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

ننصحك بشدة باستخدام الحقل impression_tracking_url الاختياري لاسترداد البيانات على مستوى مرات الظهور التي تشير إلى توقيت تسجيل Google للأحداث القابلة للفوترة التي سيتم تحصيل رسوم منك مقابلها. بالنسبة إلى OpenRTB، يتم عرض ذلك كـ BidResponse.seatbid[].bid[].ext.impression_tracking_url، وبصفته BidResponse.ad[].impression_tracking_url في بروتوكول Google.

حلّ الاختلاف في الطلب من Google (إصدار تجريبي)

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

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

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

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

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

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

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

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

<!-- 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 الخاصة بنموذج عرض إعلانات فيديو (VAST):

1. يمكن أن يحافظ التبادل على قيمة العنصر VASTTagURI كجزء من مستند XML الخاص بنموذج عرض إعلانات الفيديو (VAST) الذي تعرضه Google في الحقل adm كما هو، مع توسيعات ماكرو خاصة بالتبادل والتي تنطبق عادةً.
2. يمكن لـ "مساحة العرض والفيديو 360" تعبئة الحقل nurl بعنوان URL لمستند نموذج عرض إعلانات الفيديو (VAST) في الردود على عروض الأسعار لعملية التبادل. ويمكن لعملية التبادل بعد ذلك تمرير قيمة nurl التي يستجيب بها محرّك بحث Google (مساحة العرض والفيديو 360) في العلامة 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 -->

العروض

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

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

في ما يلي نموذج لاستجابة عرض سعر OpenRTB من أجل PD/PA.

يستخدم النموذج أدناه حقلَي OpenRTB لـ PD/PA (dealid، exchange_deal_type)، وفي حال استخدام بروتوكول "الشراة المعتمَدون"، ستكون حقول الاستجابة لعروض الأسعار في PD/PA هي exchange_deal_id وexchange_deal_type.

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، يمكن للمشاركين في "عرض الأسعار المفتوح" استخدام أي من الخيارات أدناه التي تناسب احتياجاتهم على أفضل وجه:

• مطابقة ملفات تعريف الارتباط: مطابقة المشترين أو المطابقة التي تبدأ من خلال Exchange مزيد من المعلومات.
• مطابقة البكسل: المطابقة التي تبدأ من Google مزيد من المعلومات.
• المساعدة في مطابقة ملفات تعريف الارتباط: مطابقة تبدأ في Exchange مع أنظمة عروض الأسعار مزيد من المعلومات.

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

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

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

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

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

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

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

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

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

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

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

مراجع إضافية

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

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

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