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

Le nuove installazioni di app mobili sono generalmente generate da annunci per l'installazione di app. Per massimizzare il ROI della spesa pubblicitaria, è consigliabile non mostrare un annuncio per installare un'app su dispositivi su cui è già installata la stessa app. In questa proposta, ci riferiamo a questa pratica come "filtraggio degli annunci per l'installazione di app".

Questa proposta introduce il modo in cui Protected Audience su Android supporta il filtro degli annunci contestuali, in particolare il filtro degli annunci per l'installazione di app, in modo da preservare la privacy. Per partecipare, l'app sul dispositivo deve attivare esplicitamente il filtro degli annunci per l'installazione di app. Durante la selezione degli annunci, i candidati vengono filtrati in base all'elenco delle app installate sul dispositivo note alla tecnologia pubblicitaria.

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

Per configurare il filtro degli annunci per l'installazione di app:

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

Per attivare il filtro degli annunci di installazione di app, lo sviluppatore di app richiama l'API di registrazione delle app registerForAdFiltering dalla propria app o da un SDK di tecnologia pubblicitaria con un elenco di eTLD+1 degli acquirenti di tecnologia pubblicitaria. In questo modo, gli acquirenti nell'elenco e solo questi acquirenti possono filtrare gli annunci in base allo stato di installazione dell'app, direttamente o utilizzando l'SDK della loro tecnologia pubblicitaria. La registrazione offre il controllo completo allo sviluppatore dell'app in merito alla partecipazione o meno della sua app al filtro degli annunci di installazione di app. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

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

Quando un annuncio viene preso in considerazione per le offerte, gli acquirenti possono scegliere di contrassegnarlo in modo che venga filtrato in base allo stato di installazione di un'app. A questo scopo, viene incluso 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 nel processo di asta Protected Audience. Questi dati sugli annunci 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 principale caso d'uso per il filtro degli annunci per l'installazione di app, le informazioni di filtraggio sono incluse nei dati degli annunci 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 di filtraggio vengano restituite come parte della risposta contestuale, proprio come qualsiasi altro metadato specifico dell'annuncio.
Per il caso d'uso del remarketing, Protected Audience prevede che le informazioni sul filtro siano incluse nel segmento di pubblico personalizzato. Esistono due opportunità per questa inclusione: quando si entra a far parte del segmento di pubblico e quando si recuperano nuovi dati del segmento di pubblico nell'ambito del processo di aggiornamento del segmento di pubblico. La richiesta di filtrare gli annunci per l'installazione di app dovrebbe essere simile alla seguente all'interno dell'oggetto JSON AdData: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
Nota:puoi filtrare gli annunci per l'installazione di app per più app contemporaneamente. Per farlo, elenca tutti i nomi dei pacchetti delle app da valutare. Se uno dei pacchetti viene trovato nell'elenco di installazione delle app, l'annuncio viene filtrato. Stiamo esaminando dei metodi per attivare la crittografia e/o la firma delle informazioni sugli annunci contestuali.

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

Durante una richiesta di annuncio, l'acquirente può restituire più annunci al venditore con informazioni di filtraggio in modo che gli annunci per le app installate possano essere filtrati. Il lato vendite è tenuto a trasmettere le informazioni di filtraggio nell'ambito della configurazione della funzione selectAds nel campo adData. Android prevede un formato del messaggio simile a questo.

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 defined earlier
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Il filtraggio viene elaborato all'interno dell'API selectAds. Protected Audience filtra l'annuncio se l'app specificata nel messaggio corrisponde all'app nell'elenco specifico di installazioni di app degli acquirenti di tecnologia pubblicitaria. Sono possibili due risultati:

L'app non è presente in questo elenco, il che significa che non è installata e aperta.
L'app è presente in questo elenco, il che significa che è installata e aperta. Se Protected Audience rileva che un'app esiste già, l'annuncio viene escluso dall'elenco degli annunci che l'asta utilizza per l'esecuzione di scoreAds.

Considerazioni quando sono coinvolti annunci contestuali

Con il filtro degli annunci per l'installazione di app, le API Protected Audience iniziano a supportare il filtro 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 inserire 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 di generazione dei report per l'annuncio e AdData contenente l'URL dei contenuti dell'annuncio effettivo e una firma di verifica appartenente all'acquirente (per maggiori dettagli, 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 in AdData.adFilters.appInstallFilters.packageNames. Successivamente, i valori delle offerte vengono decisi per gli annunci di remarketing e sia gli annunci di remarketing che quelli contestuali vengono valutati 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 la generazione di report sulle impressioni viene attivata dall'app, Protected Audience scarica ed esegue una funzione JS denominata reportWin() dall'URL di reporting incluso nei dati dell'annuncio contestuale. Questo è simile al modo in cui vengono generati i report per un annuncio di remarketing che vince l'asta.

Funzione di reporting JavaScript di esempio:
```
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 dell'annuncio contestuale

Gli annunci contestuali che includono il filtro per l'installazione di app devono essere firmati dall'acquirente. La piattaforma utilizza questa firma per verificare la tecnologia pubblicitaria che ha fornito gli annunci e quali filtri per l'installazione di app di tecnologia pubblicitaria applicare agli annunci. Questa operazione viene eseguita per impedire a una tecnologia pubblicitaria dannosa di utilizzare l'identità di un'altra tecnologia pubblicitaria per trarre vantaggio dalla registrazione del filtro per l'installazione di app dell'altra tecnologia pubblicitaria.
Privacy Sandbox recupererà queste chiavi dall'endpoint di tecnologia pubblicitaria fornito durante la registrazione. Come best practice, consigliamo di aggiornare spesso le chiavi, ma non oltre ogni 6 mesi.
Durante la procedura di registrazione, Privacy Sandbox chiederà alle tecnologie pubblicitarie di confermare la disponibilità dell'endpoint fornito. Per maggiori dettagli sull'azione richiesta dalle tecnologie pubblicitarie attuali e da quelle appena registrate, consulta le istruzioni per la registrazione.
A breve verrà pubblicata una Guida per gli sviluppatori con istruzioni più dettagliate per l'implementazione.

Consigliati per te

Nota: il testo del link viene visualizzato quando JavaScript è disattivato
Guida per gli sviluppatori sull'API Protected Audience su Android
Note di rilascio
Supportare il targeting per pubblico personalizzato con l'API Protected Audience