من الخادم إلى الخادم: استكشاف أخطاء دمج عروض الأسعار وإصلاحها

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

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

• تأكد من إكمال العروض التوضيحية لنظام Androidللإعلان الأصلي وإعلان البانر الأصلي والإعلان الخلالي وإعلان البانر وإعلان الفيديو بمكافأة.
• تأكد من إكمال العروض التوضيحية لنظام iOSللإعلان الأصلي وإعلان البانر الأصلي والإعلان الخلالي وإعلان البانر وإعلان الفيديو بمكافأة.
• تأكد من قراءة نظرة عامة على عروض أسعار تطبيق الهواتف المحمولة لـ Audience Network وأفضل ممارسات دمج عروض أسعار تطبيق الهواتف المحمولة.
• تأكد من إكمال دمج عروض الأسعار من خادم إلى خادم وإعداد خادم المزاد وإعداد عميل Android وإعداد عميل iOS.
• تأكد من إجراء اختبار دمج عروض أسعار التطبيق.

الأقسام

استخدام cURL لطلبات تصحيح أخطاء عروض الأسعار

رموز أخطاء HTTP والحلول في طلب عروض الأسعار

استكشاف أخطاء عدم وجود عروض أسعار وإصلاحها

استخدام cURL لطلبات تصحيح أخطاء عروض الأسعار

لطلب تصحيح أخطاء عروض الأسعار، استخدم أمر cURL، والذي يسمح لك بإرسال طلب عروض الأسعار واستلام استجابة عروض الأسعار في الوحدة الطرفية.

الخطوة الأولى. حمولة بيانات JSON للإعلان الخلالي في طلب عرض الأسعار

• استبدال YOUR_PLACEMENT_ID بمعرف الاستبدال
• استبدال YOUR_BUSINESS_ID بمعرف النشاط التجاري
• استبدال YOUR_DEVICE_ID بمعرف الجهاز
• استبدال YOUR_BIDDER_TOKENبرمز مقدم عرض الأسعار الذي تم إنشاؤه من مجموعة Audience Network SDK
• استبدل YOUR_PLATFORM_ID بمعرف منصة شريك الخدمة الوسيطة (معرف تطبيق فيسبوك).
• في حالة الرغبة في إجراء الاختبار بتنسيق إعلاني مختلف، يُرجى الرجوع إلى التنسيقات الإعلانية المدعومة.
• حفظ حمولة بيانات JSON أدناه كـ bid_request.json

{
"id": "vwxfKskkMobzQQ1e7M70",
"imp": [
{
"id": "FB Ad Impression",
"tagid": "YOUR_PLACEMENT_ID",
"instl": 1,
"banner": {
"h": 0,
"w": 0,
"linearity": 0
}
}
],
"app": {
"publisher": {
"id": "YOUR_BUSINESS_ID"
}
},
"device": {
"ua": "Dalvik\/2.1.0 (Linux; U; Android 8.1.0; Android SDK built for x86 Build\/OSM1.180201.000)",
"ifa": "YOUR_DEVICE_ID",
"dnt": 0,
"ip": "125.123.255.123"
},
"user": {
"buyeruid": "YOUR_BIDDER_TOKEN"
},
"regs": {
"coppa": 0
},
"at": 1,
"tmax": 500,
"test": 1,
"ext": {
"platformid": "YOUR_PLATFORM_ID"
}
}

الخطوة الثانية. إرسال طلب عرض الأسعار من خلال أمر cURL

• فتح Terminal
• الانتقال إلى الدليل الذي تم فيه حفظ bid_request.json بواسطة cd ~/{FILE_PATH}

curl -X POST -H "Content-Type: application/json" -d @bid_request.json https://an.facebook.com/placementbid.ortb

الخطوة الثالثة. التحقق من استجابة عرض الأسعار في حال كان طلب عرض الأسعار صالحًا

{
"id": "Auction ID",
"seatbid": [
{
"bid": [
{
"id": "Bid Response ID",
"impid": "FB Ad Impression",
"price": 99.99,
"adm": "{\"type\":\"ID\",\"bid_id\":\"BID ID\",\"placement_id\":\"Placement ID\",\"resolved_placement_id\":\"Resolved Placement ID\",\"sdk_version\":\"SDK Version\",\"device_id\":\"Device ID\",\"template\":102,\"payload\":null}",
"nurl": "https://www.facebook.com/audiencenetwork/nurl/?partner=partner_id&app=app_id&placement=placement_id&auction=auction_id&impression=impression_id&request=request_id&bid=bid_id&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}",
"lurl": "https://www.facebook.com/audiencenetwork/nurl/?partner=partner_id&app=app_id&placement=placement_id&auction=auction_id&impression=impression_id&request=request_id&bid=bid_id&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"
}
]
}
],
"bidid": "Bid ID",
"cur": "USD"
}

الخطوة الرابعة. اطلع على x-fb-an-errors في عناوين استجابة HTTP عندما لا تستلم استجابة أعلى من عرض الأسعار.

أرسل أمر cURL لعرض عناوين استجابة HTTP.

url -X POST -H "Content-Type: application/json" -v @bid_request.json https://an.facebook.com/placementbid.ortb

...
> Content-Type: application/json
>
* Connection state changed (MAX_CONCURRENT_STREAMS updated)!
< HTTP/2 400
< x-fb-an-request-id: fb_an_request_id
...
< x-fb-an-errors: Value cannot be null: value given: null
...

يُرجى الرجوع إلى وصف خطأ HTTP والحلول في طلب عرض الأسعار لإصلاح طلب عرض الأسعار.

وصف خطأ HTTP والحلول في طلب عرض الأسعار

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

استجابة 400: أخطاء المعلمة غير الصالحة

استجابة 400: الأخطاء غير المصرح بها

استجابة 204: رسالة الخطأ فارغة

استكشاف أخطاء عدم وجود عرض أسعار وإصلاحها

• تأكد من الحصول على عنوان HTTP x-fb-an-errors وتسجيله للمساعدة في فهم سبب الخطأ.
• تأكد من تثبيت تطبيق فيسبوك على الجهاز الذي يتم تشغيل التطبيق عليه وتسجيل الدخول إلى فيسبوك باستخدام حساب المستخدم الفعلي. تُعد حسابات مستخدمي فيسبوك الزائفة أو الاختبارية انتهاكًا لسياسة فيسبوك وسيتم تعطيلها.
• تأكد من الحصول على رمز عرض الأسعار من مجموعة Audience Network SDK عن طريق استدعاء com.facebook.ads.BidderTokenProvider.getBidderToken() في Android و[FBAdSettings bidderToken] في iOS وإرسال السلسلة التي تم إرجاعها إلى الحقل buyeruid لطلب عرض الأسعار.
• تأكد من إرسال معرف الجهاز الصحيح إلى الحقل ifa في طلب عرض الأسعار (Android -- AdvertisingIdClient.getAdvertisingIdInfo(context).getId()، iOS -- [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]).
• تأكد من عدم تمكين do-not-track(dnt) في الجهاز، ثم أدخل dnt: 0 do-not-track في طلب عروض الأسعار.