Al momento questa funzionalità è in versione beta.

 

Questo articolo spiega come connettersi all'API Conversioni di Spotify

 

Indice

Informazioni sull'API Conversioni di Spotify

Riepilogo dell'onboarding

Metodi di integrazione

       Integrazione con Google Tag Manager

       Integrazione diretta

Connettiti all'API Conversioni in Ads Manager

Creazione di un'integrazione con Google Tag Manager

Creazione di un'integrazione diretta da server a server

Utilizzo dell'API

Risoluzione dei problemi dell'API Conversioni

 

 

Informazioni sull'API Conversioni di Spotify

Cos'è l'API Conversioni di Spotify?

L'API Conversioni di Spotify è uno strumento di attribuzione senza tag che ti consente di trasferire direttamente eventi di conversione online e offline a Spotify. L'API Conversioni è progettata per fornire un'attribuzione completa e attendibile per aiutarti a comprendere le prestazioni delle tue campagne su Spotify. 

 

Una volta creata, la connessione API Conversioni deve essere selezionata come origine dati per la misurazione delle conversioni durante il processo di prenotazione della campagna Ads Manager.

 

Utilizzando l'API Conversioni di Spotify con Ads Manager, puoi:

  • Installare l'API Conversioni, una sola volta, per misurare tutte le tue campagne su Spotify. 

  • Visualizzare le principali azioni cross-device che gli ascoltatori svolgono sul tuo sito web, app o offline

  • Comprendere meglio il ROI del tuo investimento in Ads Manager.

 

Cosa puoi misurare con l'API Conversioni?

L'API Conversioni supporta i seguenti eventi dal tuo sito web, app o offline:

  • Aggiunta al carrello

  • Alias

  • Lead

  • Visita alla pagina

  • Acquisto

  • Iscrizione

  • Inizio checkout

  • Visualizzazione del prodotto

  • Evento personalizzato (fino a 5)

 

Riepilogo dell'onboarding

L'API Conversioni di Spotify (CAPI) consente agli inserzionisti di inviare eventi web, app e offline tramite un'integrazione server-to-server. Come Spotify Pixel, questa integrazione ti consente di monitorare e misurare l'attribuzione delle tue campagne Spotify trasferendo questi eventi a Spotify.

 

 

Metodi di integrazione

Integrazione con Google Tag Manager

Gli inserzionisti che utilizzano Google Tag Manager (GTM) possono utilizzare il nostro modello GTM per un'opzione di integrazione più rapida e leggera che non richiede lavoro di sviluppo. 

Prima di impostare un'integrazione GTM, assicurati di avere l'accesso all'account di fatturazione e le autorizzazioni per la creazione di progetti all'interno della tua organizzazione GCP per eseguire il provisioning automatico. Se prevedi di eseguire il provisioning manuale anziché automatico, avrai bisogno dell'aiuto di un utente con le autorizzazioni GCP appropriate per configurare l'infrastruttura Cloud Run seguendo la documentazione di Google.

Integrazione diretta

Per massimizzare il controllo sul processo di integrazione, ti consigliamo di creare un'integrazione diretta con l'API Conversioni. Per farlo sarà necessario il coinvolgimento di uno sviluppatore.

 

Connettiti all'API Conversioni in Ads Manager

  1. Accedi a Ads Manager e vai a Eventi dall'icona di navigazione globale nell'angolo in alto a sinistra

  2. Una volta in questa pagina, vai su Connetti fonte di dati e seleziona API Conversioni
     

  3. Quindi, assegna un nome alla tua API Conversioni

  4. Se prevedi di utilizzare anche Spotify Pixel, ti consigliamo di creare un set di dati per consentire la misurazione delle conversioni deduplicate utilizzando sia i dati di Spotify Pixel che quelli dell'API Conversioni.

  5. Utilizzando la barra di ricerca, scegli gli account pubblicitari da connettere alla tua API Conversioni. Gli account pubblicitari desiderati devono essere associati al tuo account aziendale.
     

  6. In "Visualizza istruzioni API Conversioni", leggi la sezione "Accedi all'API Conversioni", quindi vai alla sezione "Token"

  7. Clicca su "Genera token"

  8. Genera il tuo token di autenticazione (puoi generare fino a 3 token)
     

  9. Copia il token e l'ID di connessione

    1. Puoi inviare eventi solo per l'ID di connessione che appartiene all'organizzazione che ha generato il token. 

 

Creazione di un'integrazione con Google Tag Manager

Per creare un'integrazione con Google Tag Manager, avrai bisogno di un token di autenticazione e di un ID di connessione generati dalla pagina Eventi in Spotify Ads Manager. Per accedere al pannello di controllo e seguire i passaggi riportati sotto, devi essere un amministratore aziendale in Ads Manager.

Prima di impostare un'integrazione GTM, assicurati di avere l'accesso all'account di fatturazione e le autorizzazioni per la creazione di progetti all'interno della tua organizzazione GCP per eseguire il provisioning automatico. Se prevedi di eseguire il provisioning manuale anziché automatico, avrai bisogno dell'aiuto di un utente con le autorizzazioni GCP appropriate per configurare l'infrastruttura Cloud Run seguendo la documentazione di Google.

  1. Segui le istruzioni nella sezione precedente per connetterti all'API Conversioni in Ads Manager

  2. Vai su Google Tag Manager e crea un nuovo contenitore del server

  3. Clicca su "Tag" dalla barra laterale sinistra e seleziona Nuovo

  4. Clicca su Configurazione tag e seleziona "Scopri altri tipi di tag nella Galleria dei modelli della community" dalla finestra Scegli tipo di tag

  5. Cerca "Spotify" e seleziona "Spotify CAPI 3P Integration Tag" > Aggiungi all'area di lavoro

  6. Incolla il token di autenticazione e l'ID di connessione da Gestore degli eventi

  7. Configura gli eventi, l'origine dell'azione e seleziona i trigger

  8. Clicca su Salva per implementare il tag

 

Puoi anche accedere al modello di tag di Google Tag Manager per l'API Conversioni direttamente qui: https://tagmanager.google.com/gallery/#/owners/spotify/templates/conversion-api-tag-template

 

Il repository pubblico per il modello di tag GTM è disponibile anche qui: https://github.com/spotify/conversion-api-tag-template 

 

Creazione di un'integrazione diretta da server a server

Per creare un'integrazione diretta da server a server e accedere all'API delle conversioni, avrai bisogno di un token di autenticazione e di un ID di connessione generati dalla pagina Eventi in Spotify Ads Manager. Per accedere al pannello di controllo e seguire i passaggi riportati sotto, devi essere un amministratore aziendale in Ads Manager.

 

Autenticazione

Spotify supporta un token di lunga durata. Potrai generare fino a 3 token alla volta. Dopo aver creato il terzo token, dovrai eliminarne uno precedente per generarne uno nuovo. Il tuo token non scadrà e potrà essere utilizzato a tempo indeterminato. 

 

ID di connessione

Per accedere all'API, dovrai disporre del tuo ID di connessione. L'ID di connessione è una chiave univoca assegnata alla tua organizzazione che ti consente di accedere all'API quando viene utilizzata con il token. L'ID di connessione si trova in Ads Manager alla voce "Visualizza istruzioni API Conversioni".

 

Dati utente

L'API Conversioni attualmente accetta quattro (4) tipi di identificatori: indirizzo IP, ID dispositivo, indirizzo e-mail con hash e numero di telefono con hash. È necessario trasmettere almeno un tipo di identificatore. Il nostro consiglio è di includere sia l'IP che l'ID del dispositivo, se possibile.

 

Utilizzo dell'API

Endpoint

URL risorsa: https://capi.spotify.com/capi-direct/events/

ConversionService
URL risorsa: https://capi.spotify.com/capi-direct/events/


Metodo di richiesta: POST
Descrizione: questo metodo invia eventi di conversione, consentendo il monitoraggio delle interazioni dell'utente come acquisti, pagamenti e altri tipi di engagement tramite l'endpoint API diretto specificato.

Visita Spotify per sviluppatori per maggiori informazioni sull'invio delle richieste all'API.

 

Definizioni dell'evento

Nome del tipo di evento 

Descrizione 

Visita alla pagina 

facoltativo

L'atto di arrivare su (o visualizzare) una pagina specifica su un sito web. Ad esempio, arrivare sulla home page del sito web o navigare in una pagina di prodotto specifica. Tieni presente che l'evento di visita alla pagina è obbligatorio per tutti gli inserzionisti per monitorare se scelgono di utilizzare Spotify Pixel. 

Lead 

facoltativo

L'invio di informazioni su una persona o un'azienda che ha espresso una qualche forma di interesse per un prodotto o servizio. Ad esempio, l'invio di un indirizzo e-mail per iscriversi a una newsletter. Tieni presente che il termine lead può avere significati diversi a seconda dell'inserzionista e del settore.

Aggiunta al carrello

facoltativo

L'azione di aggiunta a un cestino o a un carrello virtuale. Ad esempio, facendo clic su un pulsante Aggiungi al carrello su un sito web, ma non completando effettivamente la transazione di acquisto.

Acquisto

facoltativo

Il completamento di una transazione di acquisto online, di solito indicato dalla ricezione dell'ordine o della conferma di acquisto, o da una ricevuta della transazione. Ad esempio, arrivando su una pagina di ringraziamento o di conferma dell'ordine.

Visualizzazione del prodotto 

facoltativo

Misura l'azione di qualcuno che visualizza una pagina web dedicata a un prodotto specifico. 


Best practice: 

  • Il codice dell'evento di Visualizzazione del prodotto deve essere installato su ogni pagina di prodotto che l'inserzionista desidera misurare.

  • Per ottenere ulteriori informazioni su nomi di prodotti specifici, si consiglia di utilizzare il parametro product_name per passare il nome della pagina o del prodotto associato all'evento di visualizzazione del prodotto. 

Iscrizione

facoltativo

Misura l'azione di iscriversi o registrarsi a un evento, prodotto, servizio, ecc. 

Inizio checkout 

facoltativo

Indica quando un utente ha avviato la procedura di pagamento online.

Alias

facoltativo

Invia i dati del cliente dell'inserzionista a Spotify (e-mail, numero di telefono).

Evento personalizzato

facoltativo

Misura azioni di eventi su misura o personalizzate su un sito web che non rientrano tra quelle disponibili come tipi di eventi standard di Spotify. Sono eventi che puoi definire per conto tuo.


In versione beta, gli eventi personalizzati non possono essere rinominati. Appariranno nei report come Evento personalizzato 1, Evento personalizzato 2, ecc., quindi è importante documentare quali eventi personalizzati riportano ad azioni specifiche avvenute sul tuo sito web durante la configurazione iniziale. 


Nota: al momento Ads Manager supporta fino a 5 eventi personalizzati. 



Risoluzione dei problemi dell'API Conversioni

Hai implementato l'API Conversioni sul tuo sito web e anche se sono passati almeno 20 minuti continui a non vedere nessuna attività nel grafico delle attività dell'evento in Ads Manager. Cosa fare?

 

Suggerimenti per la risoluzione dei problemi

  • Assicurati di aver inserito correttamente il token e l'ID di connessione.

  • Conferma che l'API Conversioni sia stata selezionata come origine dati per la misurazione delle conversioni per la tua campagna.

  • Se utilizzi Google Tag Manager, assicurati di aver impostato un contenitore server, non un contenitore web.

  • Se utilizzi l'integrazione diretta da server a server, assicurati che la chiamata API sia formattata correttamente.

 

Se non vedi ancora alcuna attività dell'evento, verifica con i tuoi tecnici informatici com'è stata configurata l'API Conversioni e quali eventi vengono condivisi.