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 di Topics

L'implementazione del backend dipende da come vuoi utilizzare gli argomenti calcolati nel browser. Consigliamo alle soluzioni di ad tech 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 Argomenti come indicatore aggiuntivo

I dati sugli argomenti possono essere considerati insieme ad altri indicatori, come URL, parole chiave o altri metadati, come un ulteriore indicatore 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 di Topics per creare segmenti di pubblico, mentre altri approcci suggeriscono di utilizzare Topics come un indicatore, tra gli altri, per addestrare modelli di machine learning che verranno utilizzati per dedurre ulteriori interessi del pubblico o anche 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 opzioni a tua disposizione: 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 l'intestazione demo o la demo JavaScript come riferimento al codice.
    • Integra Topics nel codice che i publisher 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 siti web di produzione. 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, si prevede che l'API restituisca un array vuoto. Questo perché nessun argomento è stato ancora osservato per l'utente. Potrebbero essere necessarie fino a tre settimane per iniziare a visualizzare gli argomenti utente.
    • Esegui test e convalida funzionali. Puoi testare la soluzione manualmente o automaticamente. Ad esempio:
      • Apri il browser con i flag e imposta l'epoch su 15 secondi, in modo che il browser ricalcoli Topics prima.
      • Visita i siti che incorporano il tuo script.
      • Controlla se gli argomenti vengono osservati dallo script il giorno chrome://topics-internals/.
      • Scopri i risultati che puoi aspettarti.
  2. Utilizzare i dati di Topics insieme ad altri indicatori contestuali (ad esempio URL, metadati e così via) (tempo stimato: circa 3 giorni).
    • Dopo tre settimane di utilizzo 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.
    • Quando inizi a ricevere un elenco di argomenti non vuoto, puoi inviarlo al tuo backend con altri indicatori di contesto.

Esegui il deployment nei siti di destinazione

Dopo aver integrato una chiamata di Topics nello script, per un primo test assicurati che sia incorporata in alcuni siti di produzione. 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).

Scegli 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 come segue:

  • Il sito riceve un numero ridotto di visite mensili (meno di un milione di visite al mese): dovresti iniziare eseguendo il deployment dell'API per un pubblico ristretto.
  • Sei tu il proprietario e il controllo del sito: se necessario, puoi disattivare rapidamente l'implementazione senza approvazioni complesse.
  • Il sito non è fondamentale per l'attività: inizia con siti target a basso rischio.
  • In totale, non più di cinque siti: per il momento non avrai bisogno di molto traffico o esposizione.
  • I siti target rappresentano temi diversi: scegli siti web che rappresentano categorie diverse (ad esempio, uno dedicato allo sport, un altro alle notizie e un altro ancora relativi a cibi e bevande). Puoi utilizzare lo strumento interno per gli argomenti in Chrome per convalidare i domini e come sono classificati dal classificatore di machine learning Topics.

Test e convalida funzionali

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

  • Un array vuoto di argomenti [], se questa è la prima chiamata con il dispositivo, per questo sito e il 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 cinque principali per l'utente, calcolato dai nomi host delle pagine in cui gli argomenti sono stati osservati dal chiamante durante la settimana.

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

  • Un nuovo argomento che sostituisce uno dei tre vecchi argomenti se chiami Topics dopo quattro settimane di osservazione.

  • Se non hai osservato argomenti per l'utente nelle tre settimane precedenti o per un periodo di tempo 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 in modo da essere utilizzato nelle analisi del rendimento future.
  • Il tempo necessario per creare un iframe e gli argomenti postMessage() dopo la ricezione degli argomenti.

Per la risoluzione dei problemi, consulta la sezione di assistenza.

Scala 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 applicare la scalabilità dell'implementazione. Esegui il deployment dello stesso codice su più siti web target. In questo modo, potrai osservare un maggior numero di utenti, raccogliere più dati sugli argomenti e approfondire la conoscenza dei tuoi segmenti di pubblico.

Ecco un riepilogo dettagliato della procedura per eseguire il ridimensionamento alla produzione:

  1. Testa la tua soluzione basata sugli argomenti con 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 test di carico.
  2. Esegui il deployment della soluzione sui siti dei publisher.
    • Quando la soluzione funziona correttamente nel tuo ambiente di test, collabora con i publisher per integrare l'iframe nei loro siti web. Ad esempio, potrebbe dover aggiornare la libreria che include il tuo iframe.
  3. Elabora e utilizza i dati degli argomenti (tempo stimato: circa quattro settimane).
    • Incorpora i dati sugli argomenti come indicatore aggiuntivo insieme ad altri dati.
    • Individuare i partner per i test delle offerte in tempo reale.
    • Esegui test di utilità con gli argomenti come indicatore aggiuntivo 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. Distribuisci gradualmente su più siti target di tua proprietà, in particolare quelli che hanno un volume di traffico maggiore.
  2. Esegui test di carico per i dati degli argomenti in base al traffico previsto.
    • Dovrai inviare le informazioni sugli argomenti dall'iframe al tuo backend. In questo modo puoi elaborare ulteriormente i risultati dell'API Topics e utilizzarli come indicatore aggiuntivo per selezionare gli annunci più pertinenti per l'utente. Man mano che un numero maggiore di siti incorpora il tuo embed, il numero di chiamate al tuo backend aumenterà notevolmente. Verifica che il tuo backend sia in grado di gestire un grande volume di chiamate dall'iframe.
    • Configura la raccolta delle metriche e i log per l'analisi.
  3. Immediatamente dopo aver implementato l'API Topics, controlla le metriche per rilevare eventuali problemi gravi per gli utenti finali. Continua a controllare regolarmente le metriche.
  4. In caso di interruzione o comportamenti imprevisti, 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.