عروض الأسعار من خادم إلى خادم

في قسم الخادم إلى خادم:

• الدمج
• إعداد خادم المزاد
• إعداد عميل Android
• إعداد عميل iOS
• الاختبار
• استكشاف الأخطاء وإصلاحها

في هذه الصفحة:

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

• المقدمة
• هياكل الدمج
• طلب/استجابة ORTB وتنسيقات الإعلانات المدعومة
• إشعارات تتعلق بالفوز/الخسارة/الفوترة/انتهاء المهلة
• العوائد والمزادات وإمكانية العرض وزمن الاستجابة

مقدمة

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

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

أسباب استخدام عروض أسعار التطبيقات

• يمثل المزاد الفوري فرصة لتحسين كل طلبات عرض الإعلانات.
• توفر إمكانية العرض للقيمة الحقيقية للمخزون الإعلاني لديك.
• سهلة الصيانة وتتطلب موارد عمليات إعلانية أقل.

هياكل الدمج

تتوفر عروض أسعار التطبيقات من خلال نقطة النهاية التي تنفذ بروتوكول عروض الأسعار المفتوحة والفورية (ORTB) لتوفير عروض الأسعار وفقًا لفرص الظهور الفردية. ويلزم توفير مجموعة SDK لـ Audience Network في عروض أسعار التطبيقات لتنفيذ الإجراءات التالية:

• احصل على buyeruid (يُسمى bidderToken في مجموعة Audience Network SDK). يُعد هذا الرمز المميز حقلاً مطلوبًا في طلب عرض الأسعار، ويكون فريدًا لكل من المستخدم والتطبيق؛ حيث لا يصلح الرمز المميز لمستخدم أو تطبيق آخر.
• تحميل استجابة عرض الأسعار وعرض الإعلان في حالة فوز مقدم عرض الأسعار بالمزاد.
• تسجيل عدد مرات الظهور والنقرات.

الخطوات الرئيسية في دفق عروض الأسعار

1. الحصول على الرمز المميز لمقدم عرض الأسعار. تحتاج Audience Network إلى توفر سلسلة غير واضحة ليستجيب إلى طلب عرض الأسعار.
2. إرسال طلب عرض الأسعار والحصول على استجابة عرض الأسعار. هذا هو التفاعل الأساسي مع نقطة نهاية عروض الأسعار. في هذه الخطوة، يمكنك إرسال طلب لعرض أسعار ORTB ثم ستتلقى إما استجابة عرض أسعار صالحة أو خطأ.
3. تشغيل المزاد. قم بتشغيل المزاد وتحديد فائز من بين استجابات عرض الأسعار. تقارن معظم المزادات عروض الأسعار في الوقت الفعلي مع التكاليف لكل ألف ظهور من مصادر الطلب الأخرى (مثل المتوسط التاريخي للتكاليف لكل ألف ظهور)؛ ويتم ذلك لأن بعض مصادر الطلب لا تدعم عروض الأسعار في الوقت الفعلي. ويمكن تشغيل المزادات وفقًا لأحد الخيارات التالية:
   • خادم داخلي يعمل على تشغيل منطق المزاد المخصص الخاص
   • خادم مزاد تابع لجهة خارجية
   • العميل الموجود على جهاز المستخدم
4. استرد الإعلان من خلال استجابة عرض الأسعار. إذا فاز Audience Network بالمزاد، فقم بتحميل الإعلان من خلال إرسال الحقل adm الوارد من استجابة عرض الأسعار إلى مجموعة Audience Network SDK في جهاز المستخدم. لاحظ أن الحقل adm لا يحتوي على الإعلان الفعلي؛ حيث يحتوي على معلومات تسمح لمجموعة SDK باسترداد الإعلان من خادم Audience Network.

أنواع الدمج

عند تشغيل المزاد (الخطوة الثالثة في دفق عروض الأسعار أعلاه)، يمكن استضافته من جانب العميل أو من جانب الخادم. توجد 3 أنواع مختلفة من الدمج أدناه:

هيكل دمج خادم إلى خادم

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

دمج خادم الإعلان الخارجي

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

طلب/استجابة ORTB وتنسيقات الإعلانات المدعومة

طلب ORTB

تدعم نقطة نهاية عروض الأسعار التي نوفرها مجموعة فرعية من بروتوكول OpenRTB بالإصدار 2.5.

ملاحظة: يرجى الاطّلاع على عينة كاملة من الطلب في دليل إعداد خادم المزاد

'id' => string, // platform's auction identifier,
'imp' => vec< // slots to bid on
shape(
'id' => string, // platform's identifier for this slot auction
// only for banner impression opportunities
'banner' => shape(
'w' => int, // width
'h' => int, // height
),
// only for native impression opportunities
'native' => shape(
'w' => int, // width 
'h' => int, // height 
),
// only for video impression opportunities
'video' => shape(
'w' => int, // width
'h' => int, // height
'linearity' => int, // 1 = instream, optional
'ext' => shape(
'videotype' => string, // 'rewarded' for Rewarded Video impression opportunities, optional
),
),
'tagid' => string, // Placement ID
'instl' => int, // interstitial flag, 1 = On, 0 = Off, optional
)
>,
// app details (in-app bidding only)
'app' => shape( 
'publisher' => shape(
'id' => string, // publisher app ID
),
),
'device' => shape(
'ua' => string, // device user-agent
'ifa' => string, // ID sanctioned for advertiser use
// Do not send ip or ipv6 if you are requesting bids from the client device.
// For server-side bid requests set ip or ipv6.
'ip' => string, // device IPv4
'ipv6' => string, // device IPv6
'dnt' => int, // "do not track", 1 = On, 0 = Off, optional
'lmt' => int, // "limit ad tracking", 1 = On, 0 = Off
),
'regs' => shape( // regulations object
'coppa' => int, // US FTC regulations for Children's Online Privacy Protection Act, 1 = On, 0 = Off, optional
),
'user' => shape(
'buyeruid' => string, // Audience Network Identity Token, mandatory
),
'ext' => shape(
'platformid' => string, // Mediation partner Platform ID or publisher FB app ID, mandatory
'authentication_id' => string // Authentication token to validate the originator of the request                     
),
'at' => int, // auction type: 1 = First Price, 2 = Second Price
'tmax' => int, // auction timeout in milliseconds
'test' => int, // 0 = normal, 1 = test-mode (we bid $99.99, but don't pay out), optional

استجابة ORTB

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

ملاحظة: بمجرد طلب إعلان من خلال استجابة عرض الأسعار، يمكن تخزين الإعلان مؤقتًا لدى العميل ولكن يجب عرضه خلال 60 دقيقة من بداية وقت تحميله. ولن يتم الدفع مقابل أي مرات ظهور تستند إلى إعلان تم تخزينه مؤقتًا لمدة تتجاوز 60 دقيقة.

1  
'id' => string // platform's request identifier
'seatbid' => vec<
    shape(
        'bid' => vec<
            shape(
                'id' => string, // Our identifier for this bid
                'impid' => string, // platform's identifier for this slot auction
                'price' => float, // Our bid price on CPM basis, in USD
                'adm' => string, // Our creative - see Rendering The Ad
                'nurl' => string, // URL to get if we win the impression
                'lurl' => string, // URL to get if we lose the impression
            )
        >,
    ),
>,
'bidid' => string, // Our identifier for this response
'cur' => string, // bid currency: USD

إشعارات تتعلق بالفوز/الخسارة/الفوترة/انتهاء المهلة

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/burl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&auction=${AUCTION_ID}&ortb_loss_code=2"

العوائد والمزادات وإمكانية العرض وزمن الاستجابة

الأسعار والعوائد

يتم تحديد الأسعار بالدولار الأمريكي على أساس التكلفة لكل ألف ظهور (على سبيل المثال، 4.25 تعني أننا سندفع 4.25 دولارات أمريكية لكل 1000 ظهور في حالة الفوز). ويجب استخدام الوحدة ذاتها لسعر التسوية في nurl وlurl. ويتم إرسال العوائد مباشرة إلى الناشر.

آليات المزاد

نقدم دومًا عرض أسعار بناءً على سعر افتتاح عرض الأسعار، مما يعني أننا ندفع المبلغ الذي نقدم به عرض الأسعار، ونقدم عرض الأسعار على افتراض أننا سندفع المبلغ بالكامل. ويعني هذا أننا نكون في وضع غير مناسب عند عرض السعر الثاني في المزاد، حيث يمكن لمقدمي عروض الأسعار الآخرين تقديم عروضهم بافتراض أنهم سيدفعون أقل من المبلغ المعروض.

إمكانية العرض

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

زمن الاستجابة

• لتقليل زمن الاستجابة قدر الإمكان، اطلب عرض أسعار واحد لكل استدعاء لواجهة API (على سبيل المثال، إذا كنت تزايد للحصول على خمس مساحات إعلانية، فيجب استدعاء واجهة API خمس مرات، بحيث تستدعي في كل مرة عرض أسعار واحد).
• لا نوفر نقاط النهاية حسب المنطقة. وستوجه بنية Facebook الأساسية طلب عرض الأسعار إلى أقرب مركز بيانات.
• استخدم الاتصالات الثابتة HTTP/2.
• قم بملء الحقل ORTB tmax في طلب عرض الأسعار بموعد انتهاء مهلة المزاد، وسنختار إستراتيجية عرض الأسعار للموازنة بين زمن الاستجابة والأداء. (يُرجى مراجعة مثال على طلب عرض الأسعار أعلاه لمزيد من المعلومات حول tmax)
• لتحقيق أهداف زمن الاستجابة، قد نؤجل بعض العمليات لعرض الوقت (على سبيل المثال، قد يعني عرض الأسعار الأسرع أن يتم عرض الإعلان بصور أبطأ، وينتج عن عرض الأسعار الأبطأ إعلان يتم عرضه بصورة أسرع).
• نعمل باجتهاد على تحسين زمن الاستجابة. ونوصي حاليًا بتعيين المهلة على 800 ميللي ثانية في عروض أسعار خادم إلى خادم.

راجع أيضًا

• الدمج
• إعداد خادم المزاد
• إعداد عميل Android
• إعداد عميل iOS
• الاختبار
• استكشاف الأخطاء وإصلاحها