Quota limite del segmento di pubblico protetto

La quota limite è una pratica pubblicitaria che limita il numero di annunci di una determinata categoria mostrati a un utente in un determinato periodo di tempo. La quota limite migliora l'esperienza dell'utente finale mantenendo le impressioni degli annunci aggiornate e interessanti e aiuta gli inserzionisti a gestire la spesa pubblicitaria.

Questa proposta introduce come Protected Audience su Android può essere utilizzato per implementare la funzionalità di quota limite in modo accurato e rispettoso della privacy.

Protected Audience implementa il limite di frequenza combinando due funzionalità: l'archiviazione on-device dei contatori per gli eventi specifici degli annunci e la possibilità di filtrare gli annunci in base a un insieme predefinito di strategie di filtro. Il limite di frequenza consente agli inserzionisti di indicare una soglia del contatore su una somma di valori dell'istogramma per un determinato periodo di tempo.

I contatori sono univoci per ogni combinazione di profilo del dispositivo, tecnologia pubblicitaria e chiave del contatore. Ogni annuncio deve contenere un insieme di chiavi di conteggio da utilizzare nel caso in cui venga registrata una visualizzazione o un'impressione per l'annuncio. Per ogni chiave, Protected Audience memorizza un insieme di contatori e ogni contatore conteggia tutti gli eventi specifici degli annunci che si verificano in un intervallo di tempo specifico. I contatori sul dispositivo vengono incrementati quando si verifica un'impressione o una visualizzazione e i dati dei contatori vengono conservati sul dispositivo. Il tempo di persistenza esatto verrà definito in un secondo momento.

La logica di filtraggio degli annunci nel flusso di lavoro di selezione degli annunci di Protected Audience ha accesso a contatori, annunci di remarketing e annunci contestuali, consentendo alla quota limite di Protected Audience di funzionare con tutti questi tipi di richieste di annunci.

Nota: il filtro degli annunci è disponibile solo in Privacy Sandbox su Android. L'implementazione di Protected Audience di Chrome non implementa un meccanismo per filtrare gli annunci non Protected Audience con targeting contestuale. Questa proposta copre solo l'assistenza per gli acquirenti. Se c'è richiesta, aggiungeremo il supporto per la parte vendite in un secondo momento.

La quota limite di Protected Audience supporta un'ampia gamma di requisiti, tra cui:

  • Filtro in tempo reale, con un ritardo lato server minimo quando vengono aggiornati i contatori sul dispositivo.
  • Gerarchia flessibile di chiavi, inclusi singoli annunci, campagne o qualsiasi altro raggruppamento.
  • Coerenza con altri metodi di quota limite, senza dipendenza da AdID.
  • Funziona in tutte le app di un determinato profilo utente del dispositivo.
  • Contatori accurati e completi.
  • Supporto per le definizioni personalizzate degli eventi pubblicitari, ad esempio visualizzazioni o impressioni.
  • Una funzione per gli annunci di remarketing e contestuali.

Per configurare la quota limite:

Passaggio 1: aggiungi le informazioni sul limite di frequenza agli annunci

Gli annunci contestuali e di remarketing indicano i contatori dell'istogramma pertinenti da aggiornare in caso di visualizzazione o impressione utilizzando il campo ad_counter_keys che contiene un elenco di numeri interi arbitrari. Il campo non è incluso nel campo metadata che non viene analizzato da Protected Audience.

L'esempio seguente mostra il formato dei dati per il campo adsData in AdSelectionConfig. Per il remarketing, il formato dell'elenco degli annunci per un determinato segmento di pubblico personalizzato è coerente con il contenuto del campo ads mostrato nell'esempio seguente:

'adsData': [
  {
    "buyer": "ads.example.com",
    "ads": [
      {
        'render_url': 'exampleUrl',
        'metadata': {...},   /* metadata are opaque to Protected Audience are
                                required to be in valid JSON format */
        'ad_counter_keys': [1234, 5678]
      }]
  }]
}

Passaggio 2: registra una visualizzazione o un'impressione

Le tecnologie pubblicitarie possono richiamare il metodo updateAdCounterHistogram per registrare le occorrenze di eventi utilizzati per la quota limite. Un metodo può essere richiamato ripetutamente sullo stesso evento per le chiavi specificate nel eventType dell'annuncio vincente.

void updateAdCounterHistogram(@EventType eventType, long adSelectionId)

Input:

  • eventType: indica se un evento viene conteggiato come visualizzazione, impressione, clic o vittoria del processo di selezione degli annunci.
  • adSelectionId: valori ID nell'oggetto AdSelectionOutcome restituiti dalle chiamate selectAds.

La chiamata updateAdCounterHistogram aggiorna l'istogramma per l'insieme di chiavi definito come parte degli annunci di remarketing recuperati da un CustomAudience o degli annunci contestuali inclusi nel parametro AdSelectionConfig per selectAds.

Se supponi che l'annuncio nel passaggio 1 sia il vincitore di un AdSelection con un valore id di 9999, una chiamata a updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW, adSelectionId: 999) incrementa i contatori per le seguenti tre chiavi primarie:

  • {'ads.example.com', 1234, VIEW}
  • {'ads.example.com', 5678, VIEW}

Il nome della tecnologia pubblicitaria viene tratto dal campo dell'acquirente, dagli annunci contestuali o dai segmenti di pubblico personalizzati, a seconda della provenienza degli annunci vincenti.

Protected Audience per Android incrementa automaticamente tutti i contatori menzionati in precedenza per il tipo di evento FrequencyCapFilters.AD_EVENT_TYPE_WIN per gli annunci restituiti da una chiamata API selectAds. Questa operazione è funzionalmente equivalente all'aggiunta dell'argomento prev_wins a browser_signals in generateBid nell'implementazione di Protected Audience di Chrome.

Passaggio 3: implementa il filtro dei limiti di frequenza con i filtri

Per un rendimento ottimale, la funzione di filtro della quota limite viene eseguita entro AdServices. Protected Audience determina se un messaggio deve essere filtrato leggendo il campo dei filtri nell'oggetto AdsData. In frequency_cap è specificato un elenco di filtri. I valori per key, event_type e interval_in_seconds vengono utilizzati per recuperare un istogramma degli eventi utilizzati per il filtraggio e Protected Audience.

Le informazioni di filtraggio possono essere specificate per gli annunci di remarketing forniti da un pubblico personalizzato e per gli annunci contestuali nell'ambito dell'oggetto AdSelectionConfig.

Per gli annunci contestuali con filtri per la quota limite, gli annunci vengono trasmessi utilizzando il campo ads nell'oggetto AdSelectionConfig. Gli annunci vengono filtrati e l'annuncio con l'offerta più alta viene restituito come risultato della chiamata selectAds.

Per gli annunci di remarketing con filtri di quota limite, gli annunci vengono filtrati prima che venga richiamata la funzione JavaScript generateBid() fornita dall'acquirente.

L'esempio seguente mostra un messaggio con il filtro della quota limite:

{
  'render_url': 'url',
  'metadata': {...},   /* metadata are opaque to Protected Audience and assumed
                        to be in valid JSON format */

  'ad_counter_keys': [1234, 5678],

  "filters": {
    "frequency_cap": {
      "view": [
        {
          "ad_counter_key": 1234
          "max_count": 10,
          "interval_in_seconds": 86400
        },
        {
          "ad_counter_key": 5678
          "max_count": 10,
          "interval_in_seconds": 86400
        },
      ],
      "win": [
        {
          "ad_counter_key": 1234
          "max_count": 5,
          "interval_in_seconds": 604800
        },
        {
          "ad_counter_key": 5678
          "max_count": 5,
          "interval_in_seconds": 345600
        },
      ]
    },

  // This field is only required in contextual ads and is used in
  // reportImpression calls to fetch the reportWin function.
  'reportingJS': "https://ads.example.com?reportWin.js"
}

Passaggio 4: genera report sugli annunci vincenti

Al termine della procedura di selezione dell'annuncio, viene restituito un oggetto AdSelectionOutcome contenente renderUri e adSelectionId, un identificatore numerico per la chiamata selectAds. Questo ID può essere utilizzato per richiamare l'API reportImpression che supporta i report a livello di evento. Nella beta 1, questo metodo supporta i report per gli annunci di remarketing e verrà esteso per supportare i report per gli annunci contestuali in una release successiva. Per gli annunci contestuali, l'acquirente è tenuto a indicare dove è possibile recuperare la funzione reportWin durante una chiamata reportImpression utilizzando un campo aggiuntivo denominato reportingJS nella struttura dell'annuncio, come mostrato nell'esempio precedente.

Best practice per la selezione dei candidati per gli annunci

Protected Audience sposta l'applicazione della quota limite dal server al dispositivo. Sebbene le offerte vincenti vengano segnalate con Privacy Sandbox, gli sviluppatori non sapranno perché un annuncio non viene mostrato. Gli annunci potrebbero non essere visualizzati a causa di un'offerta persa o di una quota limite. Senza una visibilità completa dei motivi per cui determinati annunci non vengono pubblicati, i sistemi di offerta richiedono un lavoro aggiuntivo per verificare che vengano pubblicati gli annunci ottimali. Queste best practice ti aiuteranno a verificare la pubblicazione ottimale degli annunci con Protected Audience.

Inviare un numero sufficiente di annunci di remarketing

Gli annunci di remarketing non possono essere ottimizzati per utente. Se un utente vede un numero significativo di annunci di un segmento di pubblico personalizzato e i limiti degli annunci sono bassi, tutti gli annunci potrebbero essere filtrati. Gli annunci di remarketing vengono aggiornati periodicamente, pertanto è necessario che una quantità sufficiente di inventario pubblicitario superi la quota limite per verificare che gli annunci di remarketing continuino a essere pubblicati. Questo deve essere bilanciato con le limitazioni alle dimensioni degli annunci che possono essere specificate durante la chiamata joinCustomAudience e durante l'aggiornamento giornaliero del pubblico personalizzato. Gli acquirenti devono tenere presente che potrebbe verificarsi un aumento della latenza durante la fase di offerta. Per ridurre al minimo l'impatto di questi problemi, il filtro della quota limite di frequenza viene eseguito prima della chiamata a generateBid.

Mantenere i contatori contestuali sul server

Con la stima lato server, uno sviluppatore può avere stime approssimative di quando la quota limite potrebbe essere attiva. Queste stime possono indicare che un annuncio ha probabilmente raggiunto la soglia della quota limite e pertanto deve essere inviato con più candidati annuncio o eliminato completamente.

Inviare più candidati per gli annunci nella risposta contestuale

Devi inviare più candidati annuncio con una risposta contestuale prima di un'asta Protected Audience. In questo modo, se vengono filtrati diversi annunci, gli altri vengono comunque mostrati. I candidati annuncio possono essere classificati in ordine di priorità in modo che alcuni annunci vengano forniti come backup.

Poiché l'esecuzione è vincolata al tempo, i candidati annuncio devono essere scelti in base alla loro probabilità di vincere un'asta e di non essere filtrati.

Limitazioni

Di seguito sono riportate le limitazioni note della quota limite di Protected Audience:

  1. La quota limite di Protected Audience opera a livello di profilo utente del dispositivo, senza contatori condivisi su altri dispositivi e altri profili. Eventuali incrementi degli annunci mostrati da altri dispositivi devono essere incorporati manualmente, se necessario.
  2. I contatori dei dispositivi vengono memorizzati e accessibili sul dispositivo. I contatori lato server devono essere gestiti separatamente.
  3. Poiché la quota limite e il filtro degli annunci correlati vengono elaborati su un dispositivo, le piattaforme di tecnologia pubblicitaria non hanno il controllo diretto su queste operazioni. Per ignorare la soglia del limite di frequenza del dispositivo, le piattaforme di tecnologia pubblicitaria possono inviare più annunci candidati con filtri diversi.
  4. Gli aggiustamenti delle offerte in base alla frequenza registrata non sono supportati. Le funzioni generateBid non possono visualizzare i contatori di frequenza.