Testare, implementare e scalare una soluzione basata su Topics

Questa pagina spiega come creare, testare e scalare un'implementazione per la produzione utilizzando l'API Topics.

Implementazione del backend degli argomenti

L'implementazione del backend dipende da come vuoi utilizzare gli argomenti calcolati nel browser. Consigliamo alle soluzioni di tecnologia pubblicitaria di utilizzare Topics come ulteriore indicatore di IBA.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Utilizzare Topics come indicatore aggiuntivo

I dati sugli argomenti possono essere presi in considerazione insieme ad altri indicatori, come URL, parole chiave o altri metadati, come indicatore aggiuntivo del tuo pubblico.

Come spiegato in Massimizzare la pertinenza degli annunci dopo i cookie di terze parti, esistono diversi approcci per sfruttare Topics per pubblicare annunci pertinenti. Alcuni di questi prevedono l'utilizzo degli argomenti per creare segmenti di pubblico, mentre altri approcci suggeriscono di utilizzare gli argomenti come uno dei tanti indicatori per addestrare modelli di machine learning che verranno utilizzati per dedurre ulteriori interessi del pubblico o persino per ottimizzare la logica di offerta.

Creazione e deployment

  1. Raccogli gli argomenti osservando gli utenti in produzione (tempo di implementazione stimato: circa una settimana):
    • Scopri le tue opzioni: come chiamare Topics con le intestazioni HTTP o con iframe e JavaScript.
    • Definisci il dominio dell'iframe che chiamerà l'API Topics.
    • Crea la tua soluzione utilizzando la demo dell'intestazione o la demo JavaScript come riferimento del codice.
    • Integrare Topics nel codice che gli editori incorporano nei loro siti (ad esempio, l'iframe dell'annuncio). Assicurati di chiamare gli argomenti dall'incorporamento.
    • Per iniziare a osservare gli argomenti degli utenti, incorpora l'ultima versione dello script nei tuoi siti web di produzione. Ti consigliamo di testare l'implementazione prima sui tuoi siti web con un numero ridotto di visite mensili. In questa fase, ti consigliamo di incorporare la nuova soluzione basata sugli argomenti in almeno cinque siti.
    • A questo punto, è previsto che l'API restituisca un array vuoto come risultato. Questo perché non sono ancora stati osservati argomenti per l'utente. Potrebbero essere necessarie fino a tre settimane prima di iniziare a ricevere gli argomenti degli utenti.
    • Esegui test funzionali e convalida. Puoi testare la soluzione manualmente o automaticamente. Ad esempio:
      • Apri il browser con i flag e imposta l'epoca su 15 secondi, in modo che il browser ricalcoli gli argomenti più rapidamente.
      • Visita i siti che incorporano il tuo script.
      • Controlla se gli argomenti vengono osservati dallo script su chrome://topics-internals/.
      • Scopri quali risultati puoi aspettarti.
  2. Utilizzare i dati di Topics insieme ad altri indicatori contestuali (come URL, metadati e così via) (tempo stimato: circa 3 giorni).
    • Dopo tre settimane in produzione, lo script dovrebbe aver osservato gli argomenti di alcuni utenti. A questo punto, dovresti essere in grado di utilizzare i dati di Topics come indicatore aggiuntivo.
    • Una volta che inizi a ricevere un elenco non vuoto di argomenti, puoi inviarlo al backend con altri indicatori contestuali.

Eseguire il deployment sui siti di destinazione

Dopo aver integrato una chiamata Topics nello script, assicurati che sia incorporata in alcuni siti di produzione per un primo test. Assicurati che l'implementazione funzioni come previsto:

  • Viene chiamata l'API Topics.
  • Gli argomenti possono essere osservati in questo ambiente controllato.
  • È possibile accedere agli argomenti (l'API restituisce gli argomenti osservati per l'utente).

Scegliere i siti target

Prima di implementare la soluzione sui siti dei publisher, ti consigliamo di testarla in un ambiente controllato, sui siti web di tua proprietà. Ti consigliamo di scegliere i siti web di destinazione nel seguente modo:

  • Il sito riceve un numero ridotto di visite mensili (meno di circa un milione di visite al mese): devi iniziare a implementare l'API su un piccolo pubblico.
  • Sei proprietario e controlli il sito: se necessario, puoi disattivare rapidamente l'implementazione senza approvazioni complesse.
  • Il sito non è fondamentale per l'attività: inizia con siti di destinazione a basso rischio.
  • Non più di cinque siti in totale: per il momento non avrai bisogno di molto traffico o visibilità.
  • I siti di destinazione rappresentano temi diversi: scegli siti web che rappresentano categorie diverse (ad esempio, uno sullo sport, un altro sulle notizie e un altro ancora su cibi e bevande). Puoi utilizzare lo strumento per gli argomenti interni di Chrome per convalidare i domini e il modo in cui vengono classificati dal classificatore di machine learning Topics.

Test funzionali e convalida

Quando chiami l'API Topics in questo ambiente limitato, puoi aspettarti i seguenti risultati:

  • Un array vuoto di argomenti [], se si tratta della prima chiamata di questo dispositivo, per questo sito e chiamante negli ultimi sette giorni.

  • Un elenco da zero a tre argomenti, che rappresentano gli interessi di questo utente. Dopo sette giorni di osservazione dovresti ricevere:

    • Un argomento selezionato tra i primi cinque per l'utente, calcolato in base ai nomi host delle pagine in cui l'autore della chiamata ha osservato gli argomenti durante la settimana.

  • La stessa risposta API di tutte le chiamate API Topics precedenti. Per lo stesso chiamante, utente e sito di primo livello, l'API restituirà gli stessi argomenti per l'intero periodo. In questo modo si evita di esporre troppi interessi dell'utente. Scopri maggiori dettagli su GitHub.

  • Un nuovo argomento che sostituisce uno dei tre precedenti se chiami l'API Topics dopo quattro settimane di osservazione.

  • Se non hai osservato argomenti per l'utente nelle tre settimane precedenti o in un periodo più lungo, l'API Topics restituirà di nuovo un array vuoto [].

Raccogli le metriche sul rendimento per valutare l'esperienza utente:

  • Il tempo di esecuzione delle chiamate JavaScript all'API Topics all'interno di un iframe multiorigine deve essere misurato per essere utilizzato in future analisi delle prestazioni.
  • Il tempo impiegato per creare un iframe e gli argomenti postMessage(), dopo aver ricevuto gli argomenti.

Per la risoluzione dei problemi, consulta la sezione Assistenza.

Scalabilità in produzione

A questo punto dovresti aver testato Topics in un ambiente controllato (su alcuni siti di tua proprietà). Se tutto funziona come previsto, è il momento di scalare questa implementazione. Esegui il deployment dello stesso codice in più siti web di destinazione. In questo modo, potrai osservare più utenti, raccogliere più dati sugli argomenti e approfondire la tua conoscenza dei segmenti di pubblico.

Ecco un riepilogo passo passo di come eseguire lo scale up alla produzione:

  1. Testa la tua soluzione basata sugli argomenti su un volume di traffico più elevato.
    • Aggiungi l'iframe ad altri siti di tua proprietà con un numero maggiore di visite e segui le istruzioni riportate di seguito per eseguire i test di carico.
  2. Esegui il deployment della soluzione sui siti dei publisher.
    • Una volta che la soluzione funziona correttamente nel tuo ambiente di test, collabora con i publisher per integrare l'iframe nei loro siti web. Ad esempio, potrebbe essere necessario aggiornare la libreria che include l'iframe.
  3. Elabora e utilizza i dati sugli argomenti (tempo stimato: circa quattro settimane).
    • Incorpora i dati di Topics come indicatore additivo insieme ad altri dati.
    • Trova partner di test delle offerte in tempo reale.
    • Esegui test di utilità con gli argomenti come indicatore additivo per gli altri dati.

Test di carico

Per assicurarti che il tuo sistema possa gestire il traffico, ti consigliamo di eseguire test di carico prima di implementare la soluzione basata sugli argomenti sui siti dei publisher.

  1. Esegui il deployment gradualmente su più siti di destinazione di tua proprietà, in particolare quelli con un volume di traffico maggiore.
  2. Esegui test di carico per i dati sugli argomenti, in base al traffico previsto.
    • Dovrai inviare le informazioni sull'argomento dall'iframe al tuo backend. In questo modo puoi elaborare ulteriormente i risultati dell'API Topics e utilizzarli come indicatore aggiuntivo per selezionare annunci più pertinenti per l'utente. Man mano che altri siti incorporano l'incorporamento, il numero di chiamate al backend aumenterà in modo significativo. Verifica che il backend possa gestire un grande volume di chiamate dall'iframe.
    • Configura la raccolta di metriche e log per l'analisi.
  3. Subito dopo aver implementato l'API Topics, controlla le metriche per rilevare eventuali problemi gravi per gli utenti finali. Controlla regolarmente le metriche.
  4. In caso di interruzione o comportamento imprevisto, esegui il rollback del deployment e analizza i log per comprendere e risolvere il problema.

Vedi anche

Consulta le nostre risorse per comprendere meglio l'API Topics sul web.