內部中介服務尚未對公眾開放
Audience Network 的內部出價功能目前為不公開測試版,尚未對公眾開放。如有任何變更,我們將會公佈進一步消息。
您可以考慮改為透過與我們合作的其中一個中介服務平台使用 Audience Network 出價功能。
完成伺服器至伺服出價整合後,您應在實體裝置上以正式版廣告完成測試應用程式出價整合。若您遇到一些 http 錯誤或「無出價」問題,此部分將幫助您解決實施方面的疑難。
您可以使用 cURL 指令來為出價要求除錯;此指令讓您能夠在自己的終端機傳送出價要求並接收出價回應。
YOUR_PLACEMENT_ID
換成您的版位編號。YOUR_BUSINESS_ID
換成您的企業編號。YOUR_DEVICE_ID
換成您的裝置編號。YOUR_BIDDER_TOKEN
換成 Audience Network SDK 所產生的出價者憑證。YOUR_PLATFORM_ID
換成中介服務合作夥伴平台編號,即 Facebook 應用程式編號。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" } }
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 指令。
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 錯誤說明和解決方案,以修復您的出價要求。
測試出價的執行情況時,您或會在傳送出價要求時收到多種可能錯誤代碼的其中一種。以下說明這些錯誤代碼和解決方案。
錯誤訊息 | 說明 | 解決方法 |
---|---|---|
user.buyeruid 中的出價者憑證無效 |
| 如何產生有效的出價者憑證:
|
ipaddress 必須為有效的 IP 位址 | 在出價要求裝載的 | 正確範例:
錯誤範例:(切勿輸入不完整的 IP)
|
需要有效的 placementid | 在 | 請從企業管理平台找出您的版位編號。選擇「管理資產」並在 Android 或 iOS 平台的廣告空間下找出版位編號。 |
應用程式要求中未設定發佈商編號。 | 要求中未設定 | 請從企業管理平台設定找出您的發佈商編號。在左側選單中選擇「應用程式」並找出您的應用程式編號,以此作為您的發佈商編號 |
所有 placementid 必須屬於相同的 appid | 如此訊息所示,出價要求中的所有 Audience Network 版位編號應屬於相同的應用程式編號。 | 請在企業管理平台中檢查出價要求中的所有版位編號是否屬於相同的應用程式編號。選擇「管理資產」並在 Android 或 iOS 平台的廣告空間下找出版位編號。 |
值未包含必填且不可留空的 shape 欄位 | 您的出價要求欠缺必填值。 | 必填值:
|
必須提供 adformat,adformat 和 placementid 的數量必須相同 | 請提供非空白且有效的 adformat。 | 支援的廣告格式:
如欲了解更多詳細資訊,請參閱支援的廣告格式。 |
橫幅廣告、原生廣告和影片廣告的物件互斥,但其中一個為必要項目 | 上述廣告格式有不同的物件: | 請參閱上文支援的廣告格式解決方案。 |
錯誤訊息 | 說明 | 解決方法 |
---|---|---|
無應用程式與網域和企業編號相符 | 若您在 | 如果您一直遇到此錯誤,請在 |
應用程式未獲授權使用應用程式出價功能 |
| 請聯絡我們,以申請將您的應用程式加入許可名單,或等待應用程式獲批。 |
平台未獲授權使用應用程式出價功能 |
| 解決方案:
請聯絡我們,以申請將您的應用程式加入許可名單,或等待應用程式獲批。 |
意外錯誤 | 原因:
| 解決方案:
|
錯誤訊息 | 說明 | 解決方法 |
---|---|---|
出價回應 | 原因:
| 解決方案:
若持續收到 |
x-fb-an-errors
HTTP 標題,以幫助您了解錯誤原因。com.facebook.ads.BidderTokenProvider.getBidderToken()
和在 iOS 上呼叫 [FBAdSettings bidderToken]
,以從 Audience Network SDK 獲得出價者憑證,並將傳回的字串傳送到出價要求的 buyeruid
欄位。ifa
欄位傳送正確的裝置編號(Android:AdvertisingIdClient.getAdvertisingIdInfo(context).getId()
;iOS:[[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]
)。dnt: 0
(不追蹤)。