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

Le nuove installazioni di app mobile sono in genere promosse dagli annunci per l'installazione di app. Per massimizzare il ROI della spesa pubblicitaria, è buona norma non mostrare un annuncio per l'installazione di un'app su 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 illustra in che modo Protected Audience su Android supporta il filtro degli annunci contestuali, in particolare degli annunci di installazione di app, nel rispetto 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 noto alla tecnologia pubblicitaria.

L'elenco delle app installate è visibile solo all'interno del flusso di selezione degli annunci e si basa sulla piattaforma di 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 di installazione di app:

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 dell'app registerForAdFiltering dalla propria app, o un SDK ad tech, con un elenco di eTLD+1 acquirenti di ad tech. In questo modo, gli acquirenti nell'elenco e solo loro possono filtrare gli annunci in base allo stato di installazione dell'app, direttamente o tramite l'SDK della loro tecnologia pubblicitaria. La registrazione offre allo sviluppatore dell'app il controllo completo sulla partecipazione o meno della sua app al filtro degli annunci di 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 l'esclusione in base allo stato di installazione di un'app. A questo scopo, è necessario includere il nome del pacchetto dell'app nei metadati dell'annuncio. La richiesta di filtraggio degli annunci per l'installazione dell'app fa parte dei dati degli annunci inseriti nella procedura di asta di Protected Audience. Questi dati sugli annunci vengono creati in modo diverso a seconda che si tratti di un annuncio di remarketing o di annunci contestuali.

  • Per il caso d'uso degli annunci contestuali, che è il caso d'uso principale per il filtro degli annunci di installazione di app, le informazioni sui filtri 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 si aspetta che le informazioni di filtro vengano restituite come parte della risposta contestuale, proprio come qualsiasi altro metadato specifico per l'annuncio.
  • Per il caso d'uso del remarketing, Protected Audience si aspetta che le informazioni per i filtri siano incluse nel segmento di pubblico personalizzato. Esistono due opportunità per realizzare questa inclusione: quando l'utente si iscrive al segmento di pubblico e quando vengono recuperati nuovi dati sul segmento di pubblico nell'ambito della procedura di aggiornamento del segmento di pubblico. La richiesta di filtrare gli annunci per l'installazione di app dovrebbe avere il seguente aspetto nell'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ò trasmettere al venditore più annunci con informazioni di filtro in modo da escludere gli annunci per le app installate. Il lato vendita è tenuto a trasmettere le informazioni di filtro nell'ambito della configurazione della funzione selectAds nel campo adData. Android si aspetta un formato del messaggio simile a quello riportato 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 esclude l'annuncio se l'app specificata nel messaggio corrisponde a quella nell'elenco di installazioni di app specifico per gli acquirenti di tecnologia pubblicitaria. Sono possibili due risultati:

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

Considerazioni relative agli 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 o è composta interamente solo da annunci contestuali.

  • Quando viene eseguita un'asta selectAd, l'acquirente ha la possibilità di passare 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 reporting per l'annuncio e il AdData contenente l'URL del contenuto dell'annuncio effettivo e una firma di verifica appartenente all'acquirente (per ulteriori dettagli, consulta la sezione Firma degli annunci contestuali. Tieni presente che il formato AdData viene utilizzato sia negli annunci contestuali che di remarketing.
  • All'inizio della procedura di asta, gli annunci di remarketing e contestuali vengono filtrati utilizzando l'insieme di nomi dei pacchetti specificati nell'elemento incluso in AdData.adFilters.appInstallFilters.packageNames. Successivamente, vengono stabiliti i valori di offerta per gli annunci di remarketing e viene assegnato un punteggio sia agli annunci di remarketing sia agli annunci contestuali 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 JS denominata reportWin() dall'URL del report incluso nei dati dell'annuncio contestuale. Questo è simile a come vengono generati i report per un annuncio di remarketing che vince l'asta.

    Funzione di generazione di report 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 degli annunci contestuale

  • Gli annunci contestuali che includono il filtro per le 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 di installazione di app pubblicitarie da applicare agli annunci. Questo viene fatto per impedire a un'ad tech dannosa di utilizzare l'identità di un'altra ad tech per trarre vantaggio dalla registrazione del filtro per le installazioni di app dell'altra ad tech.

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

  • Privacy Sandbox chiederà ai tecnici pubblicitari di confermare la disponibilità dell'endpoint fornito dalla tecnologia pubblicitaria durante la procedura di registrazione. Per maggiori dettagli sull'azione richiesta dalle tecnologie pubblicitarie attuali e appena registrate, consulta le istruzioni per la registrazione.

  • Prossimamente verrà pubblicata una Guida per gli sviluppatori con istruzioni più dettagliate per l'implementazione.