這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:2022年5月5日

Audience Network 常見問題

瀏覽 Audience Network 幫助中心以進一步了解關於使用 Audience Network 的更多指南與指示。

執行

將應用程式發行至商店前,測試整合是否正確運作是非常重要的。請詳閱我們的指南,以瞭解測試安裝是否成功。如果您需要整合作業的協助,也可以參閱我們的新手指南。一旦您的應用程式通過審查後,您就可以自動刊登實際的廣告了。

對於每個廣告要求,SDK 都會將裝置識別碼(在 iOS 上為 IDFA,在 Android 上為廣告編號)傳遞給 Facebook,我們才可決定適合的刊登廣告。絕不會發生任何用戶相關資訊連同廣告一起傳回發佈商的情況。

在 iOS 上,您可以將 Audience Network SDK 與為 iOS 9 及更新版本而設的應用程式整合。

在 Android 上,您可以將最新版本的 Audience Network SDK 與為 Android SDK API 第 15 版和以上版本而設的應用程式整合。

Yes, the Audience Network delivers ads for publishers using Unity within their iOS and Android app. The Unity SDK supports all of the format supported by the iOS and Android SDKs.

是。您可從非 Activity 類別建置廣告,只要該類別參照保留的 Activity 即可。建立廣告執行個體時,您必須將此 Activity 傳遞為參數。

Most mediation services have an option to integrate with 3rd party networks using adapters. The following describes the steps needed to setup such integrations:

  1. Add our SDK to your app
  2. Create a Placement ID on the Facebook app settings page. If you use a banner, make sure to select "None" as the refresh interval. The mediation layer will control the automatic refresh.
  3. Add or code the adapter according to your mediation service instructions. These can be either pre-built adapters (see below for Mopub, Admob and DFP) or a custom adapter that you will need to develop.
  4. Configure the adapter name and placement ID in your mediation server UI and allocate impressions to it

See tips for how to get more fill and revenue when using mediation.

這代表我們無法向此用戶刊登廣告。出現這種情況的原因有很多,包括:

  • 測試的用戶未在流動裝置上登入原生 Facebook 應用程式
  • 您已透過 setAdvertiserTrackingEnabled 標示通知 Facebook 不要經 Audience Network 刊登個人化廣告。
  • 此用戶未允許 Facebook 使用其活動(即其他應用程式和網站傳送給 Facebook 的活動)來刊登個人化的 Facebook 廣告。
  • 我們沒有可向此用戶展示的廣告庫存

請注意,若您根據我們的測試指南操作,在測試時能夠看到真實的廣告,即表示您的實作工作正確,待廣告發佈後用戶便可在您的應用程式中看到廣告。

  • 標題: 最多 30 個字元
  • 封面圖像: 1200x627 像素
  • 圖示: 128 平方像素
  • 社交元素: 30 個字元
  • 按鈕標題(呼籲字句):少於 20 個字元
  • 正文: 90 個字元
  • 評分等級: 5
  • 最低/最高評分: 1/5

如需載入新廣告,請建立新的 NativeAd 執行個體。

Yes, ads can be cached and re-used for up to 60 minutes. If you plan to use the ad after this time period, make a call to load a new ad. After this time passes, if the person has not clicked the ad, you must request a new ad.

在將我們的 SDK 整合至您的 iOS 應用程式後,您需要將您的應用程式提交給 Apple 進行審查。審查過程中,Apple 將詢問您的應用程式是否使用廣告識別碼 (IDFA)。請選擇「是」。然後,系統會詢問您的應用程式如何運用廣告識別碼。問題形式為:

此應用程式使用廣告識別碼的目的為(選擇所有適用選項)?

  • 在應用程式內刊登廣告
  • 將應用程式安裝歸因於之前刊登的廣告
  • 將應用程式中的某一操作歸因於之前刊登的廣告

如果您將使用 Audience Network 框架,您必須選擇第一個選項。如果您正在使用我們的核心框架來追蹤安裝歸因條件和應用程式事件,請選擇第二個和第三個選項。如果您同時使用這兩種框架,請選擇全部三個選項。

是。Android 專用 Audience Network SDK 會依據 Google Play 的條款及細則來使用廣告編號,並支援限制追蹤選項。雖不強制,但建議您在專案中設定 Google Play 服務。以此方式設定應用程式會在使用 Audience Network 時獲得更佳的技術效能。

1, What is the purpose of this guide?


This guide is intended to help mobile app developers and ad operation personals to validate ad request/response to and from Audience Network in cases such as:

  • Hassles for adding debugging code and investigating mobile device log
  • No clues for missing ad requests or impressions from dashboard
  • Audience Network ad requests are communicated between Audience Network SDK and Audience Network ad server through HTTPS. Testing and confirming ad requests and responses from the HTTPS network activity is the primary and direct step among many other steps.


    2, How to setup Charles Proxy?


    One of the tools to log the ad requests and responses information from the HTTPS is Charles, a web debugging proxy application https://www.charlesproxy.com.

    Charles is an HTTP proxy / HTTP monitor / Reverse Proxy that enables a developer to view all of the HTTP and SSL / HTTPS traffic between their machine and the internet. This includes requests, responses and the HTTP headers (which contain the cookies and caching information).

    It is found that Charles SSL Proxying is very useful and required for viewing all HTTPS ad requests traffic between iOS and Android app and FAN server.

    The SSL Proxying (https://www.charlesproxy.com/documentation/proxying/ssl-proxying/) shows how to setup Charles for iOS and Android device, and host machine running Windows and Mac OS.

    Once SSL Proxying is setup and tested properly, make sure Charles is able to proxy SSL requests and see request/response content.


    3, How to look up ad requests?


    3.1 Setup SSL Proxy for Audience Network

    Update Charles Proxy / SSL Proxying setting by adding Host: “graph.facebook.com” and Port: “8888”, Host: “graph.facebook.com” and Port: “443”.

    3.2 Read SSL Proxy request / response content for Audience Network

    Go to your mobile app and make ad requests, you should see ad request going to FAN server: https://graph.facebook.com/network_ads_common/ and ad response in JSON text form within HTTPS response contents.

    3.3 Confirming ad request sent to and received from Audience Network

    Ad request can be verified if the ad is filled successfully or returned with no fill based on the “code” in the JSON form. “Code” is “0” indicates the request is returned or filled with an ad, “code” is “1001” means no ad is available for the request and app can make another request after passing the specific time limit.

    Below is an example of successful ad response:

    { "type": "ads", "code": 0, "placements": [{ "definition": { "placement_id": "148789268824369_851969285173027", "type": "rewarded_video", "refresh": "0", "refresh_threshold": "-1", "min_viewability_percentage": "1", "viewability_check_ticker": "0", "viewability_check_interval": "100", "viewability_check_initial_delay": "0", "video_time_polling_interval": "200", "cacheable": true, "client_max_retry_count": "1", "invalidation_duration_in_seconds": "3600", "request_timeout": "30000" }, … }

    3.4 Unable to observe an SSL Proxy request for Audience Network

    If no entry point is observed from Charles Proxy for Audience Network end-point (https://graph.facebook.com/network_ads_common/), it should suggest that the primary reason is the mobile app did not make any ad requests to Audience Network server. For this case, re-examining the app integration and app logic is required for mobile developer or ad operation personal.

    4, What is the next step?

    This guide should help you through testing, troubleshooting ad request/response issues with Audience Network.

    If you have further questions on how to use this guide or unanswered questions on ad request/response, please contact our publisher support portal at https://www.facebook.com/business/publishersupport.

    • System User Access Token:Used to make requests to Facebook APIs on behalf of an app.
    • Placement ID:Unique Audience Network identifier of a specific ad placement in your app.
    • 應用程式編號:The Placement ID is partly made up of the App ID.For example, in the Placement ID 1234567898765432_9876543212345678, the numbers before the underscore are the App ID.
    • Property ID:Unique Audience Network identifier of your app.You can use the same property ID on multiple platforms, for example Android and iOS.

    發佈商政策

    為確保您的應用程式用戶都能得到最佳體驗,建議整合廣告時請遵守我們的 Audience Network 政策

    我們保留因任何理由而拒絕、允許或移除任何發佈商的權利,且判斷依據皆得以由我方自行斟酌;其中包含對我們和用戶之間關係造成負面影響的發佈商,或是任何廣告宣傳的內容、服務或活動違反我們競爭力、利益或廣告理念之情形,均在酌情之列。此等原則可能隨時變更。

    In order to ensure that our publishers are offering a high quality advertising experience, we require that all apps serving Facebook ads are in compliance with our Audience Network policies.

    All apps in our network will be reviewed by automated systems as well as manually checked for quality and compliance. We will have on-going quality review to ensure continued adherence to our policies and Audience Network design guidelines.

    在 Facebook,我們相信廣告應對整體用戶體驗有所貢獻,且與之一致。 我們致力在 Facebook 和 Audience Network 上達成這個目標。

    在 Audience Network 上刊登的每一則廣告也都具備可在 Facebook 上刊登的資格。 這表示這些廣告必須遵守 Facebook 嚴格的廣告政策,並且通過我們嚴密的主動和被動審查程序。 換句話說,Facebook 是以保護本身網站的方式,保護發佈商合作夥伴。您可在此處 查看我們的廣告政策。這些政策的目的在於確保廣告不但優質、符合品牌形象,而且遵守所有適用的法律。

    我們瞭解,無論廣告是否符合我們的政策,有些時候您會希望應用程式不要刊登某特定廣告或某特定類型的廣告。 身為 Audience Network 的發佈商合作夥伴,您能夠根據需要篩選掉特定廣告客戶或特定類別的廣告客戶(如政治性廣告)。

    瞭解如何限制哪些廣告客戶在您的應用程式或網站上刊登廣告

    成效

    這些廣告看起來極為類似現有的 Facebook 流動廣告。點擊廣告會將用戶帶至應用程式商店來下載應用程式、在瀏覽器中開啟網頁,或在手機上啟動現有的應用程式。廣告包括橫額、插頁和原生廣告,以配搭應用程式中的廣告版位。這些廣告會包含和標準 Facebook 廣告相同的元素。

    深入瞭解什麼類型的廣告會在 Audience Network 上刊登,以及人們與廣告互動之後會發生什麼事。

    發佈商在任何時候皆不會收到廣告客戶清單,發佈商報告也不例外。在發佈商應用程式中刊登的廣告會經過 Facebook 的審查,且須遵守 Facebook 的廣告刊登原則

    這視乎情況而定。成效會因廣告受眾、廣告版位及符合您用戶群的廣告宣傳活動等因素而有所變化。

    因為 Audience Network 持續不斷地進展,所以達標率 (Fill Rate) 會隨著時間變化。例如用戶群的人口統計資料、用戶群的地理位置和廣告客戶需求等許多因素都可能改變與影響可在應用程式中刊登的廣告數量。

    如發現達標率 (Fill Rate) 突然發生變化,請檢查下列事項:

    • 建置是否正確
    • 是否已在「應用程式與網站」標籤中加入所有的流動資源(流動應用程式與網站),且這些資源是否已通過 Audience Network 的審查。
    • 是否新增其他篩選條件
    • 是否使用最新版的 SDK
    • 是否提交要求太過頻繁(例如:在 15 秒時間間隔內,多次針對同一版位編號要求廣告)

    Ad refresh is not supported by Facebook Audience Network. In addition, disableAutoRefresh is deprecated from FBAdView (iOS) and AdView (Android) in the 4.99 release and above.

    使用「Audience Network」區塊中的「篩選」標籤即可排除應用程式,以避免這些應用程式的廣告顯示在您的應用程式中。如果您想防止特定網站的廣告出現,您也可以排除網站的網域。

    除了上述處理方式外,Audience Network 還會自動偵測您新增到 Facebook 應用程式設定 (developers.facebook.com/apps/[YOUR_APP_ID]>/settings/) 中的流動應用程式。

    請注意,太過嚴格的設定可能會影響廣告刊登效果並降低達標率。

    Facebook 會確保點擊的真實性和意圖,致力於為「Audience Network」的廣告客戶提供高價值的投資報酬率。我們對於從事點擊詐欺行為的發佈商決不寬容,一旦發現詐欺,會立即禁止該發佈商。我們會仔細監察 Audience Network 上的所有點擊和刊登的瀏覽次數,以偵測是否有點擊詐欺的模式。對於判定無效的點擊,我們不會向廣告客戶收費,也不會付款給發佈商。

    達標率 (Fill Rate) 的計算方式是以供應廣告總數除以合格要求總數。要求不予計算的情況如下:

    • 要求廣告的次數太過頻繁。例如:在不到 15 秒時間間隔內,以相同版位編號要求廣告
    • 未提供 IDFA (iOS) 或廣告編號 (Android),或無法用於刊登廣告
    • 發出要求的應用程式上未安裝 Facebook,或用戶最近並未登入

    報告

    新增團隊成員 作為管理員或分析報告用戶,即可授與對報告的存取權。若要新增或變更角色指派,請前往 Facebook 應用程式設定,然後選擇「角色」區段。

    若要尋找報告,請前往「應用程式設定」中的「Audience Network」區段,然後選擇「成效」標籤。報告會顯示成效概觀,也會顯示特定時間範圍內的成效詳細資料。您可按國家和版位編號進一步分析成效。

    如需付款記錄和支付明細,請前往「Audience Network」區段,然後選擇「支付」標籤。

    我們不會在您的報告中披露特定廣告客戶資訊。如需篩選特定廣告客戶或特定類別的廣告客戶,請前往「應用程式設定」中的「Audience Network」區段,然後選擇「篩選條件」標籤。

    可以。如需有關如何以程式設計的方式讀取應用程式成效資料的詳細資訊,請參閱這份指南

    收取付款

    You can set up payments by completing the publisher payout forms. The forms are located under the payout tab in the "Audience Network" section in your app settings page. We require your bank name, SSN/TIN and tax information in order to process your payouts.

    Note: You need to set up your payout information for ad delivery to start.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you are having problems completing the forms.

    For more information see Add Payout Information.

    You will receive payment on approximately the 21st of each month for the previous month's balance. Read our Audience Network Terms for more information.

    Contact us by clicking on "Need Help?" button within Audience Network Dashboard if you do not receive a payment or if you have questions about the payout process.

    當您的收益至少累積達到 $100 美元時,我們才會付款。您會在每月的 21 號收到上月餘額的付款。

    首先請檢查 Audience Network/支付標籤,確保您已完成支付流程。

    如果您有任何付款相關的問題,點擊 Audience Network 管理中心內的「需要協助?」按鈕即可與我們聯絡。

    如需變更任何的付款資料,請前往「應用程式設定」中的「Audience Network」區段,然後選擇「支付」標籤。

    我們深信「Audience Network」提供的流動廣告體驗,更容易使發佈商和開發人員將應用程式變成獲利來源,但我們目前無法承諾明確的營收分享。在應用程式設定頁面上的「Audience Network」區段中,我們會提供即時報告和預期支付款項。

    管理應用程式

    若要將某人加入為現有 Facebook 應用程式的管理員或開發人員角色,請瀏覽至「應用程式管理中心」的「角色」標籤,然後選擇「新增管理員」或「新增開發人員」。

    本部分內容

    以兒童為受眾的應用程式和服務的相關資訊

    講解美國《美國兒童網絡私隱保護法》(COPPA) 規定您需承擔的責任。

    《加州消費者私隱保護法》(CCPA) 合規性

    說明如何限制您應用程式或網站使用個人資訊的方式,以遵守《加州消費者私隱保護法》(CCPA)。