Giữa các máy chủ: Khắc phục sự cố cho tiện ích tích hợp đặt giá thầu

Khi hoàn tất quy trình tích hợp giải pháp đặt giá thầu giữa các máy chủ, bạn nên hoàn tất quy trình thử nghiệm tiện ích tích hợp đặt giá thầu trong ứng dụng trên các thiết bị thực với quảng cáo chính thức. Trong trường hợp gặp phải một số lỗi http hoặc "không có giá thầu", phiên thử nghiệm này sẽ giúp bạn khắc phục sự cố trong quá trình triển khai.

Điều kiện tiên quyết

• Đảm bảo bạn đã đọc hết hướng dẫn dành cho Android về Quảng cáo tự nhiên, Quảng cáo biểu ngữ tự nhiên, Quảng cáo chèn giữa, Quảng cáo biểu ngữ, Quảng cáo video kèm phần thưởng.
• Đảm bảo bạn đã đọc hết hướng dẫn dành cho iOS về Quảng cáo tự nhiên, Quảng cáo biểu ngữ tự nhiên, Quảng cáo chèn giữa, Quảng cáo biểu ngữ, Quảng cáo video kèm phần thưởng.
• Đảm bảo bạn đã đọc Tổng quan về giải pháp đặt giá thầu trong ứng dụng di động của Audience Network và Cách tốt nhất để để tích hợp giải pháp đặt giá thầu trong ứng dụng di động.
• Đảm bảo bạn đã hoàn tất quy trình Tích hợp giải pháp đặt giá thầu giữa các máy chủ, Thiết lập máy chủ đấu giá, Thiết lập máy khách Android, Thiết lập máy khách iOS.
• Đảm bảo bạn đã hướng dẫn cách Thử nghiệm tiện ích tích hợp đặt giá thầu trong ứng dụng.

Phần

Sử dụng cURL để gỡ lỗi yêu cầu giá thầu

Mã lỗi và giải pháp khắc phục lỗi HTTP trong yêu cầu giá thầu

Khắc phục sự cố Không có giá thầu

Sử dụng cURL để gỡ lỗi yêu cầu giá thầu

Để gỡ lỗi yêu cầu giá thầu, bạn có thể sử dụng lệnh cURL. Lệnh này cho phép bạn gửi yêu cầu giá thầu và nhận phản hồi giá thầu trong thiết bị đầu cuối của mình.

Bước 1. Phần tải dữ liệu JSON dành cho Quảng cáo chèn giữa trong yêu cầu giá thầu

• Thay thế YOUR_PLACEMENT_ID bằng ID vị trí quảng cáo của bạn
• Thay thế YOUR_BUSINESS_ID bằng ID doanh nghiệp của bạn
• Thay thế YOUR_DEVICE_ID bằng ID thiết bị của bạn
• Thay thế YOUR_BIDDER_TOKEN bằng Mã nhà thầu do Audience Network SDK tạo ra
• Thay thế YOUR_PLATFORM_ID bằng ID nền tảng của đối tác trung gian (ID ứng dụng Facebook).
• Trong trường hợp bạn muốn thử nghiệm bằng định dạng quảng cáo khác, vui lòng tham khảo phần Định dạng quảng cáo được hỗ trợ.
• Lưu phần tải dữ liệu JSON dưới đây ở dạng 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"
}
}

Bước 2. Gửi yêu cầu giá thầu bằng lệnh cURL

• Mở Terminal của bạn
• Chuyển đến thư mục lưu bid_request.json của bạn qua cd ~/{FILE_PATH}

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

Bước 3. Xem phản hồi giá thầu trong trường hợp yêu cầu giá thầu hợp lệ

{
"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"
}

Bước 4. Xem x-fb-an-errors trong tiêu đề phản hồi HTTP nếu bạn không nhận được phản hồi giá thầu ở trên.

Lệnh cURL để hiển thị tiêu đề phản hồi 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
...

Vui lòng tham khảo phần Mô tả và giải pháp khắc phục lỗi HTTP trong yêu cầu giá thầu để sửa lỗi cho yêu cầu giá thầu của bạn.

Mã lỗi và giải pháp khắc phục lỗi HTTP trong yêu cầu giá thầu

Khi thử nghiệm quá trình triển khai giải pháp đặt giá thầu, bạn có thể gặp một trong các mã lỗi tiềm ẩn khi gửi yêu cầu giá thầu. Bảng dưới đây mô tả các mã lỗi này và giải pháp khắc phục.

Phản hồi 400: Lỗi thông số không hợp lệ

Phản hồi 400: Lỗi trái phép

Phản hồi 204: Thông báo lỗi trống

Khắc phục sự cố không có giá thầu

• Hãy nhớ chụp và ghi lại tiêu đề HTTP x-fb-an-errors để giúp bạn hiểu nguyên nhân gây ra lỗi.
• Đảm bảo đã cài đặt ứng dụng Facebook trên thiết bị mà ứng dụng của bạn đang chạy và bạn đã đăng nhập vào Facebook bằng tài khoản người dùng thực của mình. Việc sử dụng tài khoản người dùng Facebook giả mạo hoặc thử nghiệm là vi phạm chính sách của Facebook. Các tài khoản này sẽ bị vô hiệu hóa.
• Đảm bảo bạn nhận được mã nhà thầu từ Audience Network SDK bằng cách gọi com.facebook.ads.BidderTokenProvider.getBidderToken() trên Android và [FBAdSettings bidderToken] trên iOS, rồi gửi chuỗi được trả về vào trường buyeruid của yêu cầu giá thầu.
• Đảm bảo bạn gửi đúng id thiết bị trong trường ifa của yêu cầu giá thầu (Android - AdvertisingIdClient.getAdvertisingIdInfo(context).getId(), iOS - [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]).
• Đảm bảo bạn không bật tính năng do-not-track(dnt) trên thiết bị, sau đó chuyển dnt: 0 (do-not-track) vào yêu cầu giá thầu.