Filtro degli annunci per l'installazione di app per Protected Audience

Le nuove installazioni di app mobile sono in genere guidate dagli annunci per l'installazione di app. Per massimizzare il ROI della tua spesa pubblicitaria, ti consigliamo di non mostrare un annuncio per installare un'app sui dispositivi su cui è già installata la stessa app. In questa proposta, facciamo riferimento a questa pratica come "filtro degli annunci per l'installazione di app".

Questa proposta introduce in che modo Protected Audience su Android supporta il filtro degli annunci contestuali, in particolare il filtro degli annunci per l'installazione di app, in un modo incentrato sulla tutela della privacy. Per partecipare, l'app sul dispositivo deve attivare esplicitamente il filtro degli annunci per l'installazione di app. Durante la selezione degli annunci, gli annunci candidati vengono filtrati in base all'elenco di app installate sul dispositivo.

L'elenco delle app installate è visibile soltanto all'interno del flusso di selezione degli annunci e si basa sulla piattaforma lato acquisti per segnalare che un determinato annuncio deve essere filtrato in base all'esistenza di un'app sul dispositivo.

Per impostare il filtro degli annunci per l'installazione di app, procedi nel seguente modo:

Passaggio 1: registra l'app per il filtro degli annunci per l'installazione di app

Per attivare il filtro degli annunci per l'installazione di app, lo sviluppatore di app richiama l'API di registrazione app registerForAdFiltering dalla propria app, o un SDK di tecnologia pubblicitaria, con un elenco di acquirenti eTLD+1 di acquirenti di ad tech. Ciò consente agli acquirenti nell'elenco, e solo a loro, di filtrare gli annunci in base allo stato di installazione dell'app, direttamente o tramite l'SDK di tecnologia pubblicitaria. La registrazione offre allo sviluppatore di app il controllo completo per capire se la sua app deve partecipare o meno al filtro degli annunci per l'installazione di app. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

Passaggio 2: richiedi di filtrare gli annunci per l'installazione di app

Quando un annuncio viene preso in considerazione per le offerte, gli acquirenti possono scegliere di segnalarlo per filtrarlo in base allo stato di installazione di un'app. includendo il nome del pacchetto dell'app nei metadati dell'annuncio. La richiesta di filtro degli annunci per l'installazione di app fa parte dei dati degli annunci inseriti nella procedura di asta di Protected Audience. Questi dati pubblicitari vengono creati in modo diverso a seconda che si tratti di un annuncio contestuale o di remarketing.

  • Per il caso d'uso degli annunci contestuali, che è il caso d'uso principale per il filtro degli annunci per l'installazione di app, le informazioni sul filtro sono incluse nei dati pubblicitari che gli acquirenti possono fornire ai venditori quando rispondono a un'offerta contestuale al di fuori di Protected Audience. Protected Audience prevede che le informazioni del filtro vengano restituite nell'ambito della risposta contestuale, proprio come qualsiasi altro metadati specifici per gli annunci.
  • Per il caso d'uso del remarketing, Protected Audience prevede che le informazioni dei filtri siano incluse nel segmento di pubblico personalizzato. Questa inclusione ha due opportunità: durante la partecipazione al segmento di pubblico e durante il recupero di nuovi dati sul pubblico nell'ambito del processo di aggiornamento del pubblico. La richiesta di escludere gli annunci per l'installazione di app dovrebbe avere il seguente aspetto all'interno dell'oggetto JSON AdData: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Passaggio 3: filtra gli annunci per l'installazione di app durante la selezione degli annunci

Durante una richiesta di annuncio, l'acquirente può ritrasmettere più annunci al venditore con informazioni di filtro in modo da poter escludere gli annunci relativi alle app installate. Il lato vendita è obbligatorio per passare le informazioni di filtro come parte della configurazione della funzione selectAds nel campo adData. Android si aspetta un formato di messaggio simile a quello mostrato di seguito.

AdData myAdData = new AdData.Builder()
        .setRenderUri(Uri.parse("https://.."))
        .setMetadata("{...}")
        .setFilters(new AdFilters.Builder()
                .setAppInstalledFilter(new AppInstalledFilter.Builder()
                    .setPackageNames(ImmutableList.of("app1.package", "app2.package"))
                    .build())
                .build())
        .build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
    .setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
    .setDecisionLogicUri(Uri.parse("https://..."))
    ...
    .setContextualAds(ImmutableList.of(new ContextualAd.Builder()
                      .setBuyer(AdTechIdentifier.fromString("example.com"))
                      .setReportingUri("https://example.com/reporting")
                      .setBid(20)
                      // myAdData could be taken from the JSON above
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Il filtro viene elaborato all'interno dell'API selectAds. Protected Audience filtra l'annuncio se l'app specificata nel messaggio corrisponde a quella nell'elenco di installazioni di app specifico degli acquirenti di ad tech. Si possono ottenere due risultati:

  • L'app non è presente in questo elenco, ovvero non è installata e aperta.
  • L'app si trova in questo elenco, il che significa che è installata e aperta. Se Protected Audience rileva già un'app, l'annuncio viene escluso dall'elenco di annunci su cui l'asta pubblica scoreAds.

Considerazioni sull'uso di annunci contestuali

Con il filtro degli annunci per l'installazione di app, le API Protected Audience iniziano a supportare i filtri degli annunci contestuali. È importante specificare alcuni aspetti nelle situazioni in cui l'asta è un mix di annunci contestuali e di remarketing oppure composta interamente solo da annunci contestuali.

  • Quando viene eseguita un'asta selectAd, l'acquirente ha la possibilità di trasmettere un elenco di oggetti ContextualAd. Questi oggetti contengono l'eTLD+1 dell'acquirente dell'annuncio, l'offerta per l'annuncio, un URL che rimanda alla logica dei report dell'annuncio e l'AdData contenente l'URL effettivo del contenuto dell'annuncio e una firma di verifica appartenente all'acquirente (per ulteriori informazioni, consulta la sezione Firma degli annunci contestuali. Tieni presente che il formato AdData viene utilizzato sia negli annunci contestuali che in quelli di remarketing.
  • All'inizio della procedura di asta, gli annunci contestuali e di remarketing vengono filtrati utilizzando l'insieme di nomi dei pacchetti specificati nell'AdData.adFilters.appInstallFilters.packageNames. A questo punto, vengono scelti i valori delle offerte per tutti gli annunci di remarketing e per gli annunci di remarketing e contestuali viene assegnato un punteggio utilizzando la funzione scoreAds fornita. Vince l'annuncio con il punteggio più alto. Tieni presente che questa procedura funziona anche se non sono presenti annunci di remarketing.

  • Se un annuncio contestuale vince l'asta e i report sulle impressioni vengono attivati dall'app, Protected Audience scarica ed esegue una funzione JavaScript denominata reportWin() dall'URL del report incluso nei dati dell'annuncio contestuale. La procedura è simile a quella dei report per un annuncio di remarketing che vince l'asta.

    Esempio di funzione di reporting JavaScript:

    function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer,
contextual_signals) {
let reporting_address = 'https://reporting.example.com';
return {'status': 0, 'results': {'reporting_uri':
     reporting_address + '?some_signal=' + per_buyer_signals.some_signal} };
}

Firma contestuale degli annunci

  • Gli annunci contestuali che includono il filtro delle installazioni di app devono essere firmati dall'acquirente. La piattaforma utilizza questa firma per verificare la tecnologia pubblicitaria che ha fornito gli annunci e i filtri per l'installazione di app di tecnologia pubblicitaria da applicare agli annunci. Ciò viene fatto per evitare che una tecnologia pubblicitaria dannosa utilizzi l'identità di un'altra ad tech per trarre vantaggio dalla registrazione del filtro delle installazioni di app dell'altra tecnologia pubblicitaria.

  • Privacy Sandbox recupererà queste chiavi dall'endpoint ad tech fornito durante la registrazione. Come best practice, consigliamo di aggiornare le chiavi spesso, ma non oltre ogni 6 mesi.

  • Privacy Sandbox chiederà agli ad tech di confermare la disponibilità dell'endpoint fornito da ad tech durante il processo di registrazione. Per ulteriori dettagli sull'azione richiesta dagli ad tech attuali e appena registrati, consulta le istruzioni per la registrazione.

  • A breve verrà pubblicata una guida per gli sviluppatori con istruzioni più dettagliate per l'implementazione.