Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 25 lug 2023

FAQ di Audience Network

Visita il Centro assistenza di Audience Network per maggiori indicazioni e suggerimenti su come lavorare con Audience Network.

Implementazione

Prima di distribuire la tua app tramite lo store, è necessario controllare che l'integrazione funzioni in modo corretto. Consulta la nostra guida su come testare l'implementazione. Puoi anche seguire la nostra guida introduttiva se ti serve aiuto per l'integrazione. Dopo aver sottoposto la tua app all'analisi, potrai mostrare inserzioni reali in modo automatico.

A ogni richiesta, l'SDK fornirà a Facebook un identificatore del dispositivo (IDFA su iOS e ID pubblicitario su Android) per determinare quale inserzione mostrare all'utente. I dati relativi all'utente non saranno comunicati agli editori.

Su iOS, l'SDK Audience Network può essere integrato con le app per iOS 9 o versioni successive.

Su Android, la versione più recente dell'SDK Audience Network può essere integrata con le app per la versione 15 dell'API dell'SDK di Android e versioni successive.

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.

Sì, puoi implementare inserzioni da una classe che non sia di attività, purché faccia riferimento all'attività stessa. Quando creerai le istanze delle inserzioni, dovrai rendere l'attività un parametro.

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.

Significa che non siamo in grado di mostrare le inserzioni a una determinata persona. Il motivo potrebbe essere uno dei seguenti:

  • La persona che sta eseguendo il test non ha effettuato l'accesso all'app nativa di Facebook sul proprio dispositivo mobile.
  • Facebook ha ricevuto le informazioni tramite il contrassegno setAdvertiserTrackingEnabled di non pubblicare inserzioni personalizzate tramite Audience Network.
  • La persona non ha concesso l'autorizzazione a Facebook di utilizzare la propria attività, che altre app e siti web inviano a Facebook, per personalizzare le inserzioni pubblicate da Facebook per quella specifica persona.
  • Non è disponibile un inventario pubblicitario da mostrare a quella determinata persona.

Tieni presente che se riesci a visualizzare inserzioni reali durante il test condotto in base alla nostra guida ai test, l'implementazione funziona correttamente e le persone saranno in grado di visualizzare le inserzioni per le app una volta pubblicata.

  • Titolo: massimo 30 caratteri
  • Immagine di copertina: 1200 x 627 pixel
  • Icona: 128 pixel quadrati
  • Contesto social: 30 caratteri
  • Titolo del pulsante (invito all'azione): meno di 20 caratteri
  • Corpo del testo: 90 caratteri
  • Scala di valutazione: 5
  • Valutazione min/max: 1/5

Per caricare una nuova inserzione, crea un'altra istanza di 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.

Dopo l'integrazione dell'SDK nella tua app per iOS, dovrai sottoporla a un'analisi da parte di Apple. Come parte del processo di analisi, ti verrà chiesto se l'app usa un ID pubblicitario (IDFA) e dovrai selezionare "Yes" (Sì). Successivamente, ti verrà posta una domanda per capire come viene usato nella tua app e la domanda sarà simile a questa:

This app uses the Advertising Identifier to (select all that apply)? (L'app usa l'ID pubblicitario per (seleziona tutte le risposte appropriate)?)

  • Serve advertisements within the app (Mostrare le inserzioni all'interno dell'app)
  • Attribute this app installation to a previously served advertisement (Attribuire l'installazione dell'app a un'inserzione già mostrata)
  • Attribute an action taken within this app to a previously served advertisement (Attribuire un'azione compiuta nell'app a un'inserzione già mostrata)

Se usi il framework di Audience Network, devi selezionare la prima opzione. Se invece usi il nostro framework principale per monitorare l'attribuzione dell'installazione e gli eventi nell'app, seleziona la seconda e la terza opzione. Infine, se li usi entrambi, seleziona tutte e tre le opzioni.

Sì, l'SDK di Audience Network per Android usa l'ID pubblicitario e ne rispetta l'opzione che limita il monitoraggio, in conformità con i termini e le condizioni di Google Play. Pur non costituendo un requisito, consigliamo di configurare il tuo progetto con Google Play Services, in questo modo, le prestazioni tecniche su Audience Network risulteranno migliori.

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.

    • Token d'accesso dell'utente di sistema: utilizzato per effettuare richieste alle API di Facebook per conto di un'app.
    • ID del posizionamento: identificativo Audience Network univoco di un posizionamento pubblicitario specifico nella tua app.
    • ID app: l'ID del posizionamento è in parte composto dall'ID dell'app. Ad esempio, nell'ID del posizionamento 1234567898765432_9876543212345678, i numeri prima del trattino basso sono l'ID dell'app.
    • ID della proprietà: identificativo Audience Network univoco della tua app. Puoi utilizzare lo stesso ID proprietà su più piattaforme, ad esempio Android e iOS.

    Normative per gli editori

    Per garantire la migliore esperienza possibile agli utenti della tua app, segui le normative di Audience Network per l'integrazione delle inserzioni.

    Ci riserviamo il diritto di rifiutare, approvare o rimuovere gli editori per qualsiasi motivo, a nostra esclusiva discrezione, compresi gli editori che influenzano negativamente il nostro rapporto con gli utenti o che promuovono contenuti, servizi o attività che contrastano con la nostra posizione, i nostri interessi o la nostra filosofia pubblicitaria. Queste linee guida possono essere modificate in qualsiasi momento.

    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.

    Noi di Facebook siamo convinti che le inserzioni debbano contribuire a rendere ottimale l'esperienza utente e intendiamo raggiungere questo obiettivo su Facebook e su Audience Network.

    Le inserzioni che vengono pubblicate su Audience Network possono essere usate anche su Facebook, perciò sono soggette alle nostre severe normative pubblicitarie e sono sottoposte al nostro rigoroso, proattivo e reattivo processo di analisi. In altre parole, Facebook fornisce agli editori partner la stessa protezione applicata al nostro sito Web. Le nostre normative pubblicitarie, disponibili qui, assicurano che le inserzioni siano di alto livello, sicure per il brand e conformi alle leggi applicabili.

    Siamo consapevoli che in alcuni casi potresti desiderare che una particolare inserzione o un determinato tipo di inserzioni non venga mostrato nella tua app, indipendentemente dalle nostre normative. Come editore partner di Audience Network, potrai filtrare per inserzionisti o categorie di inserzionisti specifici (ad es. inserzioni politiche).

    Scopri come limitare gli inserzionisti che possono pubblicare inserzioni nella tua app o sul tuo sito.

    Prestazioni

    Le inserzioni saranno simili a quelle già esistenti in versione mobile su Facebook. Cliccando su un'inserzione, l'utente aprirà uno store da cui scaricare un'app, una pagina Web nel browser o avvierà un'app già esistente sul cellulare. Saranno usati banner, inserzioni interstitial e native a seconda dei posizionamenti presenti nell'app e conterranno gli stessi elementi presenti nelle classiche inserzioni di Facebook.

    Scopri di più sulle inserzioni che possono essere pubblicate su Audience Network e su cosa accade quando gli utenti vi interagiscono.

    Agli editori non verrà fornito un elenco degli inserzionisti, che non sarà presente nemmeno nei report. Le inserzioni mostrate nelle app degli editori sono sottoposte ad analisi da parte di Facebook e seguiranno le nostre linee guida sulle pubblicità.

    Non sono sempre gli stessi, le prestazioni possono variare a causa di fattori come pubblico, posizionamenti e campagne pubblicitarie dirette alla tua base di utenti.

    Il tasso di riempimento può variare nel tempo a causa della continua evoluzione della nostra rete. Il numero di inserzioni che è possibile visualizzare nella tua app può essere modificato e influenzato da diversi fattori, come le caratteristiche demografiche e geografiche della tua base di utenti, nonché le richieste degli inserzionisti.

    Se il tuo tasso di riempimento dovesse cambiare improvvisamente, controlla che:

    • L'implementazione sia stata eseguita correttamente.
    • Tutte le proprietà mobili (app e siti Web mobili) siano state aggiunte nella tab "App e siti Web" e che siano state approvate da Audience Network.
    • Non siano stati aggiunti ulteriori filtri.
    • L'SDK usato sia il più recente.
    • Le richieste non siano troppo frequenti (ad es. richieste multiple di un'inserzione per lo stesso ID posizionamento nell'arco di 15 secondi).

    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.

    Usa la tab "Filtri" nella sezione "Audience Network" per escludere le inserzioni delle app che non desideri siano mostrate nella tua app. Puoi anche escludere i domini Web, se vuoi evitare inserzioni da determinati siti Web.

    Inoltre, Audience Network rileva automaticamente l'app mobile che hai aggiunto alle Impostazioni app Facebook (developers.facebook.com/apps/[ID_DELLA_TUA_APP]>/settings/).

    Tieni presente che un approccio troppo restrittivo influisce sulla pubblicazione delle inserzioni e riduce il tasso di riempimento.

    Facebook intende offrire agli inserzionisti un valido ROI su Audience Network, per questo ci assicuriamo che i clic siano autentici e volontari. Non tolleriamo le frodi di clic da parte degli editori, che saranno estromessi immediatamente se dovessimo rilevare una frode. Monitoriamo attentamente i clic e le impression su Audience Network per individuare il modo in cui avvengono le frodi. Non addebiteremo alcun costo agli inserzionisti e gli editori non riceveranno pagamenti per i clic considerati non validi.

    Il tasso di riempimento viene calcolato sul totale delle inserzioni riempite rispetto al totale delle richieste considerate valide. Una richiesta non viene considerata valida nei seguenti casi:

    • Quando un'inserzione viene richiesta troppo frequentemente. Ad esempio, se si richiede un'inserzione per lo stesso ID posizionamento con intervalli inferiori a 15 secondi.
    • Quando l'IDFA (iOS) o l'ID pubblicitario (Android) non sono disponibili o non possono essere usati per mostrare un'inserzione.
    • Quando Facebook non è installato nell'app richiedente o l'utente non ha effettuato l'accesso di recente.

    Segnalazioni

    Affinché i membri del tuo team possano accedere ai report, aggiungili come amministratori o come utenti di Insights. Per aggiungere o modificare l'assegnazione di un ruolo, accedi alle impostazioni della tua app Facebook e alla sezione "Ruoli".

    I report sono disponibili nella sezione "Audience Network" delle impostazioni dell'app selezionando la tab Prestazioni. Essi contengono una panoramica delle prestazioni e i dettagli relativi a specifici intervalli di tempo. Inoltre, puoi analizzare le tue prestazioni per Paese o ID posizionamento.

    Per accedere ai dettagli e alla cronologia dei pagamenti, vai alla sezione "Audience Network" e seleziona la tab Pagamento.

    I tuoi report non conterranno informazioni specifiche sugli inserzionisti. Se desideri filtrare per uno specifico inserzionista o una specifica categoria di inserzionisti, accedi alla sezione "Audience Network" nelle impostazioni dell'app e seleziona la tab Filtri.

    Sì. Consulta questa guida per maggiori dettagli su come consultare i dati sulle prestazioni della tua app in modo programmatico.

    Ricezione dei pagamenti

    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.

    I pagamenti vengono effettuati quando i ricavi raggiungono la soglia minima di 100 $. Riceverai il saldo del mese precedente il giorno 21 di ogni mese successivo.

    Per prima cosa, controlla la tab Audience Network/Pagamento per confermare il completamento del flusso dei pagamenti.

    Se riscontri problemi relativi ai pagamenti, contattaci cliccando sul pulsante "Hai bisogno di assistenza?" all'interno della dashboard di Audience Network.

    Se desideri modificare le informazioni di pagamento, accedi alla sezione "Audience Network" delle impostazioni dell'app e seleziona la tab Pagamento.

    Crediamo che l'esperienza pubblicitaria mobile offerta da Audience Network aiuti gli editori a promuovere le loro app, ma attualmente non siamo in grado di stabilire una quota dei ricavi specifica. I report in tempo reale e i pagamenti previsti sono disponibili nella sezione "Audience Network" nella pagina delle impostazioni dell'app.

    Gestione delle app

    Per aggiungere un ruolo di amministratore o sviluppatore a un'app Facebook già esistente, accedi alla tab Ruoli della Dashboard gestione app e seleziona "Aggiungi amministratori" o "Aggiungi sviluppatori".

    In questa sezione

    Informazioni per app e servizi destinati ai bambini

    Spiega le tue responsabilità ai sensi dell'U.S. Children's Online Privacy Protection Act (COPPA).

    Conformità al California Consumer Privacy Act (CCPA)

    Descrive come limitare l'uso delle informazioni personali da parte della tua app o del tuo sito web in conformità al California Consumer Privacy Act (CCPA).