‏‎Bidding with In-House Mediation‎‏

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

الخدمة الوسيطة الداخلية ليست متوفرة للعامة

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

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

يتوفر لدى Audience Network من فيسبوك مُقدم عروض أسعار ORTB (عروض الأسعار الفورية المفتوحة) يدعم عمليات دمج العملاء وعمليات دمج الخادم إلى الخادم المباشرة. يشرح هذا الدليل كيفية دمج عروض الأسعار من خادم المزاد.

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

المتطلبات الأساسية

قبل البدء، تفضل بقراءة نظرة عامة على عروض أسعار Audience Network وأفضل ممارسات دمج عروض الأسعار.

Android

iOS

الإعداد

الخطوات التالية مطلوبة لإعداد عروض الأسعار الداخلية من خادم إلى خادم:

تسجيل النشاط التجاري

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

  • انتقل إلى وثائق Audience Network من فيسبوك وانقر على زر البدء الآن لإنشاء معرف نشاط تجاري جديد أو استخدام معرف النشاط التجاري الموجود.
  • يمكنك إنشاء الخصائص ضمن معرف النشاط التجاري ذاته ولكن سيتعين تسجيلها؛ راجع مدير الأرباح لمزيد من التفاصيل.
  • أخطرنا بمعرف النشاط التجاري (وهو معرف الناشر الخاص بك).
  • يمكنك إدارة وصول المستخدم إلى النشاط التجاري/التطبيق.

إنشاء تطبيق أمان فيسبوك

يتعين على جميع الناشرين الداخليين من جانب الخادم إنشاء تطبيق أمان فيسبوك في https://developers.facebook.com. بمجرد إنشاء التطبيق، ستحتاج إلى الحصول على معرف التطبيق والمفتاح السري للتطبيق لتطبيق الأمان. سيتم استخدام المفتاح السري للتطبيق في كل طلب لإنشاء رمز المصادقة للتحقق من صحة منشئ الطلب.

احرص على استخدام التجزئة الصحيحة (محددة أدناه) وإذا بدأت التجزئة بـ 0، فلن يتم فقدانها.

لإنشاء تطبيق أمان وربطه بالنشاط التجاري:

  1. قم بتسجيل الدخول إلى https://developers.facebook.com.
  2. في قائمة تطبيقاتي، انقر على إنشاء تطبيق.
  3. حدّد أعمال. ثم انقر على التالي.
  4. قم بإدخال اسم للتطبيق يبدأ بالبادئة "AN_SECURITY_APP" ثم انقر على إنشاء معرف تطبيق.
  5. في القائمة اليمنى، حدّد الإعدادات ← الإعدادات الأساسية.
  6. في حقل المفتاح السري للتطبيق، انقر على عرض. اكتب معرف التطبيق والمفتاح السري للتطبيق.
  7. انتقل إلى https://business.facebook.com وحدّد النشاط التجاري.
  8. في القائمة اليمنى، انقر على إعدادات مدير الأعمال.
  9. في القائمة اليمنى لصفحة إعدادات مدير الأعمال، حدّد الحسابات ← التطبيقات.
  10. في لوحة التطبيقات، انقر على إضافة ← إضافة إلى تطبيق.
  11. أدخل معرف تطبيق الأمان ثم انقر على إضافة تطبيق. من المفترض أن يظهر AN_SECURITY_APP الآن ضمن النشاط التجاري.

يتم إنشاء authentication_id الخاص بالطلب باستخدام الخوارزمية HMAC-SHA256. تستخدم هذه الخوارزمية الإدخالات التالية:

  • معرف الطلب كرسالة
  • المفتاح السري للتطبيق كمفتاح
      authentication_id = HMAC_SHA256(request_id, app_secret)

بعد ذلك تتم إضافة المعرف الذي تم إنشاؤه إلى ملحق طلب عرض أسعار OpenRTB ذي المستوى الأعلى في الحقل authentication_id. على سبيل المثال، إذا كان معرف الطلب "9r90wurjqw" وكان المفتاح السري للتطبيق "12345asdfg" فسيبدو authentication_id الذي تم إنشاؤه كما يلي:

      authentication_id = HMAC_SHA256(9r90wurjqw, 12345asdfg) = 39bbe40bc68899a9356085ca8c81

سيتم تضمين هذا الرمز في كل طلب بالإضافة إلى معرف تطبيق الأمان.

      {
      "id": "9r90wurjqw",
      ...
      "ext": {
      "authentication_id": "39bbe40bc68899a9356085ca8c81d3021cfa124f2a2b3c68c88f95fb4cde40a4",
      "security_app_id": "AN_SECURITY_APP_MY_SECURITY_APP_ID" 
      ...
      }
      }

إرسال رمز الهوية إلى مُقدم عروض الأسعار

يتوقع مُقدم عروض الأسعار العثور على رمز الهوية في الحقل user.buyeruid لطلب ORTB. يتم إنشاء هذا الرمز المميز بطرق مختلفة لمنصات مختلفة.

Android

في السلسلة الخلفية، قم باستدعاء com.facebook.ads.BidderTokenProvider.getBidderToken() من مجموعة Android Audience Network SDK. يجب طلب الرمز لكل طلب عرض أسعار. أرسل أيضًا IDFA في الحقل device.ifa إلى AdvertisingIdClient.getAdvertisingIdInfo(context).getId().

iOS

قم باستدعاء [FBAdSettings bidderToken] من مجموعة iOS Audience Network SDK. يجب طلب الرمز لكل طلب عرض أسعار. أرسل أيضًا IDFA في الحقل device.ifa مع [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString].

الخطوات التالية