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

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

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

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

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

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

ننصح باستخدام تطبيق OpenRTB من Google. بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google نهائيًا. مزيد من المعلومات

تنفيذ Google OpenRTB

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

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

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

الرد بعرض سعر

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

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

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

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

تتبُّع مرّات الظهور لتقليل التناقضات

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

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

تهدف هذه الميزة إلى ضمان أن يكون عدد مرات الظهور يتم إصدار فاتورة يتماشى مع عدد مرات الظهور التي يدفعها المستخدم شبكة Google الإعلانية الفيديو 360 (مساحة العرض والفيديو 360).

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

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

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

الإعلان عن السمة الثالث_party_buyer_token في الردود على عروض الأسعار

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

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

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

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

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

يتعذّر على Google تطبيق حل للتناقض في حال حدوث عملية تبادل مع Google تصميم إعلان HTML في علامة (script أو iframe أو غيرها Google) التي تؤدي لاحقًا إلى تحميل رمز 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 لـ VAST:

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

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

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

في هذا المثال، تستخدم Google (مساحة العرض والفيديو 360) معرّف الموارد المنتظم (URI) لـ VAST للمواد الإبداعية من استجابة عرض السعر حرفيًا، حيث يضيف تبادل حدث 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 -->

العروض

يمكن لخدمات Exchange المشاركة في "عرض الأسعار المفتوح" استخدام الصفقات المفضَّلة (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 مطابقة الجداول، يمكن للمشاركين في "عرض الأسعار المفتوح" استخدام أيٍّ من الخيارات التالية الأنسب لهم يحتاج إلى:

• مطابقة ملفات تعريف الارتباط: مطابقة المشتري أو التبادل يمكنك الاطّلاع على المزيد من المعلومات.
• مطابقة Pixel: المطابقة التي بدأتها Google يمكنك الاطّلاع على المزيد من المعلومات.
• Cookie Match Assist: المطابقة التي بدأت من Exchange مع مقدمي عروض الأسعار يمكنك الاطّلاع على المزيد من المعلومات.

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

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

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

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

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

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

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

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

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

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

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

مراجع إضافية

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

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

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