將應用程式發行至商店前,測試整合是否正確運作是非常重要的。請詳閱這份「指南」(/docs/audience-network/testing),瞭解測試實作的方式。如需整合上的相關協助,另可遵循「新手指南」(/docs/audience-network/getting-started)。我們完成對應用程式的審查後,您就能夠自動投遞實際廣告。
對於每個廣告要求,SDK 都會將裝置識別碼(在 iOS 上為 IDFA,在 Android 上為廣告編號)傳遞給 Facebook,我們才可決定適合投遞的廣告。絕不會發生任何用戶相關資訊連同廣告一起傳回發佈商的情況。
在 iOS 上,您可將 Audience Network SDK 整合到針對 iOS 9 和以上版本的應用程式中。
在 Android 上,最新的 Audience Network SDK 可與針對 Android SDK 的 API 第 15 版和以上版本的應用程式整合。
是。您可從非 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:
See tips for how to get more fill and revenue when using mediation.
這表示我們無法對此用戶供應廣告。發生此情況可能有多種原因,包括:
setAdvertiserTrackingEnabled
標示通知 Facebook 未經由 Audience Network 投遞個人化廣告。請注意,如果您在根據我們的測試指南進行測試時可以看到真實的廣告,表示您的實作可以正常運作,用戶可以在應用程式上線後立即在應用程式中看到廣告。
如需載入新廣告,請建立新的 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 審查。在此審查過程中,系統將詢問您的應用程式是否使用廣告識別碼(IDFA)。請勾選「是」。接著系統將詢問您的應用程式會如何使用該資料。問題的形式如下:
此應用程式如何使用廣告識別碼(選擇所有適用的答案)?
若您要使用 Audience Network 架構,必須選擇第一個選項。若您要使用我們的核心架構來追蹤安裝歸因和應用程式事件,請選擇第二個和第三個選項。若您同時使用這兩個架構,請選擇全部三個選項。
是。Android 專用 Audience Network SDK 會依據 Google Play 的條款與條件來使用廣告編號,並遵守限制追蹤選項。雖不強制,但建議您「將專案設定為使用 Google Play 服務」(https://developer.android.com/google/play-services/setup.html)。若以此方式設定應用程式,使用 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:
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?
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 NetworkGo 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 NetworkAd 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"
},
…
}
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.
我們希望確保應用程式用戶都能得到最佳體驗,所以整合廣告時請遵守「Audience Network 政策」(https://developers.facebook.com/docs/audience-network/policy)。
我們保留因任何理由而拒絕、允許或移除任何發佈商的權利,且判斷依據皆得由我方自行斟酌;其中包含對我們和用戶之間關係造成負面影響的發佈商,或是任何廣告宣傳的內容、服務或活動違反我們競爭力、利益或廣告理念之情形,均在酌情之列。此等原則可能隨時變更。
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 是以保護本身網站的方式,保護發佈商合作夥伴。您可在「此處」(https://www.facebook.com/ad_guidelines.php)參閱我們的廣告刊登政策。這些政策的目的在於確保廣告不但優質、符合品牌形象,而且遵守所有適用的法律。
我們瞭解,無論廣告是否符合我們的政策,有些時候您會希望應用程式不要刊登特定廣告或特定類型的廣告。 身為 Audience Network 的發佈商合作夥伴,您能夠根據需要篩選掉特定廣告主或特定類別的廣告主(如政治性廣告)。
瞭解如何「限制特定廣告主刊登廣告」(https://www.facebook.com/help/audiencenetwork/602115929943054)在您的應用程式或網站上。
這些廣告看起來極為類似現有的 Facebook 行動廣告。點擊廣告會將用戶帶至應用程式商店來下載應用程式、在瀏覽器中開啟網頁,或在手機上啟動現有的應用程式。廣告包括橫幅、插頁和原生廣告,以搭配應用程式中的廣告版位。這些廣告會包含和標準 Facebook 廣告相同的元素。
深入瞭解「Audience Network 會刊登的廣告內容」(https://www.facebook.com/help/audiencenetwork/909759812477057),以及用戶與這些廣告互動時會發生的情況。
發佈商在任何時候皆不會收到廣告主清單,發佈商分析報告也不例外。在發佈商應用程式中刊登的廣告會經過 Facebook 審查,且須遵守「Facebook 的廣告刊登政策」(https://www.facebook.com/policies/ads)。
這視情況而定。成效會因廣告受眾、廣告版位及符合您用戶群的廣告行銷活動等因素而有所變化。
因為 Audience Network 持續不斷地進展,所以達標率(Fill Rate)會隨著時間變化。像是用戶群的人口統計資料、用戶群的地理位置和廣告主需求等許多因素都可能改變與影響可在應用程式中刊登的廣告數。
如發現達標率(Fill Rate)突然發生變化,請檢查下列事項:
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/[您的應用程式編號]>/settings/)的行動應用程式。
請注意,太多限制會影響廣告投遞效果並降低達標率。
Facebook 會確保點擊的真實性和意圖,致力於為「Audience Network」的廣告主提供高價值的投資報酬率。我們對於從事點擊詐欺行為的發佈商決不寬容,一旦發現詐欺,會立即禁止該發佈商。我們會仔細監控 Audience Network 上的所有點擊和投遞的曝光次數,以偵測是否有點擊詐欺的模式。對於判定無效的點擊,我們不會向廣告主收費,也不會付款給發佈商。
達標率(Fill Rate)的計算方式是以供應廣告總數除以合格要求總數。要求不予計算的情況如下:
只要「將團隊成員加入」(https://developers.facebook.com/docs/apps/security#app_roles)為管理員或洞察報告使用者,對方即可看到分析報告。若要指派新角色或變更原本角色,請前往 Facebook 應用程式設定,然後選擇「角色」區塊。
若要尋找分析報告,請前往「應用程式設定」中的「Audience Network」區塊,然後選擇「成效」頁籤。分析報告會顯示成效概觀,也會顯示特定時間範圍內的成效詳細資料。您可按國家和版位編號進一步分析成效。
如需付款紀錄和支付明細,請前往「Audience Network」區塊,然後選擇「支付」頁籤。
我們不會在您的分析報告中披露特定廣告主資訊。如需篩選特定廣告主或特定類別的廣告主,請前往「應用程式設定」中的「Audience Network」區塊,然後選擇「篩選條件」頁籤。
可以。如需有關如何以程式設計的方式讀取應用程式成效資料的詳細資訊,請參閱「這份指南」(/docs/audience-network/reporting-api)。
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」區塊中,我們會提供即時分析報告和預期支付款項。
兒童導向應用程式與服務的相關資訊說明您在美國兒童線上隱私保護法(COPPA)下的責任。 | 遵守加州消費者隱私法(CCPA)說明如何限制應用程式或網站使用個人資訊,以遵守《加州消費者隱私法》(CCPA)。 |