Cette fonctionnalité est actuellement en version bêta.

 

Cet article explique comment se connecter à l'API Conversions de Spotify

 

Sommaire

À propos de l'API Conversions de Spotify

Résumé de l'intégration

Méthodes d'intégration

       Intégration de Google Tag Manager

       Intégration directe

Connectez-vous à l'API Conversions dans Ads Manager

Créer une intégration Google Tag Manager

Créer une intégration directe de serveur à serveur

Utilisation de l'API

Résolution des problèmes pour l'API Conversions

 

À propos de l'API Conversions de Spotify

Qu'est-ce que l'API Conversions de Spotify ?

L'API Conversions de Spotify est un outil d'attribution sans balise qui vous permet de transmettre directement à Spotify les événements de conversion en ligne et hors ligne. L'API Conversions est conçue pour fournir une attribution complète et haute fidélité afin de vous aider à comprendre les performances de vos campagnes sur Spotify. 

 

Une fois créée, la connexion de l'API Conversions doit être sélectionnée comme source de données de mesure de conversion pendant le processus de réservation de campagne d'Ads Manager.

 

En utilisant l'API Conversions de Spotify avec Ads Manager, vous pouvez :

  • Installer l'API Conversions, une seule fois, pour mesurer toutes vos campagnes sur Spotify. 

  • Voir les actions clés que les auditeurs effectuent sur votre site Web, votre application ou hors ligne, quel que soit l'appareil utilisé.

  • Obtenir une meilleure compréhension du ROI de votre investissement dans Ads Manager.

 

Que peut mesurer l'API Conversions ?

L'API Conversions prend en charge les événements suivants à partir de votre site Web, de votre application ou hors ligne :

  • Ajouts au panier

  • Alias

  • Prospects

  • Vue de pages

  • Achats

  • Inscriptions

  • Démarrage du paiement 

  • Vue du produit

  • Événement personnalisé (jusqu'à 5)

 

Résumé de l'intégration

L'API Conversions (CAPI, de l'anglais Conversion API) de Spotify permet aux annonceurs d'envoyer des événements sur le Web, dans l'application et hors ligne via une intégration de serveur à serveur. Comme le Spotify Pixel, cette intégration vous permet de suivre et de mesurer l'attribution de vos campagnes Spotify en transmettant ces événements à Spotify.

 

 

Méthodes d'intégration

Intégration de Google Tag Manager

Les annonceurs travaillant avec Google Tag Manager (GTM) peuvent utiliser notre modèle GTM pour disposer d'une option d'intégration plus rapide et plus légère, qui ne nécessite pas d'effort de développement. 

Avant de configurer une intégration GTM, veuillez vous assurer que vous disposez d'un accès au compte de facturation et des autorisations de créateur de projet au sein de votre organisation GCP afin d'effectuer le provisionnement automatique. Si vous prévoyez d'effectuer un provisionnement manuel plutôt qu'automatique, vous aurez besoin de l'aide d'un utilisateur disposant des autorisations GCP appropriées pour configurer l'infrastructure Cloud Run en suivant la documentation de Google.

Intégration directe

Pour maximiser le contrôle de votre processus d'intégration, nous vous recommandons de créer une intégration directe avec l'API Conversions. Cela nécessitera la participation d'un développeur.

 

Connectez-vous à l'API Conversions dans Ads Manager

  1. Connectez-vous à Ads Manager et accédez à Événements à partir de l'icône de navigation globale en haut à gauche.

  2. Une fois sur cette page, accédez à Connecter la source de données et sélectionner API Conversions
     

  3. Ensuite, nommez votre API Conversions.

  4. Si vous prévoyez également d'utiliser Spotify Pixel, il est recommandé de créer un ensemble de données afin de permettre une mesure de conversion dédupliquée, en utilisant à la fois les données du Spotify Pixel et les données de l'API Conversions.

  5. À l'aide de la barre de recherche, choisissez le(s) compte(s) publicitaire(s) à connecter à votre API Conversions. Le ou les comptes publicitaires souhaités doivent être associés à votre compte professionnel.
     

  6. Dans « Afficher les instructions de l'API Conversions », lisez la section « Accéder à l'API Conversions », puis accédez à la section Jeton.

  7. Cliquez sur « Générer un jeton ».

  8. Générez votre jeton d'authentification (vous pouvez générer jusqu'à 3 jetons)
     

  9. Copiez votre jeton et votre identifiant de connexion

    1. Vous pouvez uniquement envoyer des événements pour l'identifiant de connexion appartenant à l'organisation qui a généré le jeton. 

 

Créer une intégration Google Tag Manager

Pour créer une intégration Google Tag Manager, vous aurez besoin d'un jeton d'authentification et d'un identifiant de connexion générés à partir de la page Événements dans Spotify Ads Manager. Vous devez être administrateur professionnel dans Ads Manager pour accéder au tableau de bord et suivre les étapes ci-dessous.

Avant de configurer une intégration GTM, veuillez vous assurer que vous disposez d'un accès au compte de facturation et des autorisations de créateur de projet au sein de votre organisation GCP afin d'effectuer le provisionnement automatique. Si vous prévoyez d'effectuer un provisionnement manuel plutôt qu'automatique, vous aurez besoin de l'aide d'un utilisateur disposant des autorisations GCP appropriées pour configurer l'infrastructure Cloud Run en suivant la documentation de Google.

  1. Suivez les instructions de la section ci-dessus pour vous connecter à l'API Conversions dans Ads Manager

  2. Accédez à Google Tag Manager et créez un nouveau conteneur de serveur.

  3. Cliquez sur « Balises » dans la barre latérale gauche et sélectionnez Nouveau.

  4. Cliquez sur « Configuration des balises » et sélectionnez « Découvrir plus de types de balises dans la galerie de modèles de la communauté » dans la fenêtre Choisir le type de balise.

  5. Recherchez « Spotify » et sélectionnez « Spotify CAPI 3P Integration Tag » > Ajouter à l'espace de travail

  6. Collez votre jeton d'authentification et votre identifiant de connexion à partir du gestionnaire d'événements

  7. Configurez les événements, la source d'action et sélectionnez les déclencheurs

  8. Cliquez sur « Enregistrer » pour déployer la balise

 

Vous pouvez également accéder au modèle de balise Google Tag Manager de l'API Conversions directement ici : https://tagmanager.google.com/gallery/#/owners/spotify/templates/conversion-api-tag-template

 

Le référentiel public du modèle de balise GTM est également disponible ici : https://github.com/spotify/conversion-api-tag-template 

 

Créer une intégration directe de serveur à serveur

Pour créer une intégration directe de serveur à serveur et accéder à l'API Conversions, vous aurez besoin d'un jeton d'authentification et d'un identifiant de connexion générés à partir de la page Événements dans Spotify Ads Manager. Vous devez être administrateur professionnel dans Ads Manager pour accéder au tableau de bord et suivre les étapes ci-dessous.

 

Authentification

Spotify prend en charge un jeton de longue durée. Vous pourrez générer jusqu'à 3 jetons à la fois. Une fois votre troisième jeton créé, vous devrez supprimer un jeton précédent pour en générer un nouveau. Votre jeton n'expirera pas et pourra être utilisé indéfiniment. 

 

Identifiant de connexion

Pour accéder à l'API, vous devez disposer de votre identifiant de connexion. L'identifiant de connexion est une clé unique attribuée à votre organisation qui vous permet d'accéder à l'API lorsqu'elle est utilisée avec le jeton. L'identifiant de connexion se trouve dans Ads Manager sous « Afficher les instructions de l'API Conversions ».

 

Données d'utilisateur

L'API Conversions accepte actuellement quatre (4) types d'identifiants : l'adresse IP, l'identifiant de l'appareil, l'adresse e-mail hachée et le numéro de téléphone haché. Au moins un type d'identifiant doit être transmis. Comme meilleure pratique, incluez à la fois l'IP et l'identifiant de l'appareil lorsque cela est possible.

 

Utilisation de l'API

 

Point de terminaison

URL de la ressource : https://capi.spotify.com/capi-direct/events/

ConversionService
URL de la ressource : https://capi.spotify.com/capi-direct/events/


Méthode de requête : POST
Description : cette méthode soumet des événements de conversion, permettant ainsi le suivi des interactions des utilisateurs telles que les achats, les paiements et d'autres types d'engagement via le point de terminaison d'API direct spécifié.

Accédez à Spotify for Developers pour en savoir plus sur l'envoi de requêtes à l'API.

 

Définitions des événements

Nom du type d'événement 

Description 

Vue de la page 

facultatif

Le fait d'atterrir sur une page spécifique sur un site Web ou de la consulter. Par exemple, atterrir sur la page d'accueil du site Web ou parcourir une page de produit spécifique. Notez que l'événement Vue de pages est requis pour que tous les annonceurs puissent suivre s'ils choisissent d'utiliser le Spotify Pixel. 

Prospects 

facultatif

La transmission d'informations sur une personne ou une entreprise ayant exprimé un intérêt pour un produit ou un service. Par exemple, soumettre une adresse e-mail pour s'inscrire à une newsletter. Notez que Prospects peut signifier différentes choses selon l'annonceur et le secteur.

Ajouts au panier

facultatif

L'action d'ajouter un article à un panier virtuel. Par exemple, cliquer sur un bouton Ajouter au panier sur un site Web, mais ne pas terminer la transaction d’achat.

Achats

facultatif

La réalisation d'une transaction d'achat en ligne, généralement signifiée par la réception d'une confirmation de commande ou d'achat, ou d'un reçu de transaction. Par exemple, atterrir sur une page de remerciement ou de confirmation de commande.

Vue du produit 

facultatif

Mesure l'action d'une personne qui consulte une page Web dédiée à un produit spécifique. 


Bonnes pratiques : 

  • Le code d'événement Vue du produit doit être installé sur chaque page de produit que l'annonceur cherche à mesurer.

  • Pour obtenir des informations plus granulaires sur des noms de produits spécifiques, il est recommandé d'utiliser le paramètre product_name pour transmettre le nom de la page ou du produit associé à l'événement de vue du produit. 

Inscriptions

facultatif

Mesure l'action qui consiste à s'inscrire ou s'enregistrer à un événement, un produit, un service, etc. 

Démarrage du paiement 

facultatif

Mesures lorsqu'un utilisateur a lancé le processus de paiement en ligne.

Alias

facultatif

Envoie les coordonnées du client de l'annonceur à Spotify (e-mail, numéro de téléphone).

Événement personnalisé

facultatif

Mesure les actions d'événements sur mesure ou personnalisés sur un site Web qui ne sont pas disponibles comme l'un des types d'événements standard de Spotify. Ce sont des événements que vous définissez vous-même.


En version bêta, les événements personnalisés ne peuvent pas être renommés. Ils apparaîtront dans le rapport comme Événement personnalisé 1, Événement personnalisé 2, etc. Il est donc important de documenter quels événements personnalisés correspondent à des actions spécifiques sur votre site Web lors de la configuration initiale. 


Remarque : Ads Manager autorise actuellement jusqu'à 5 événements personnalisés. 



Résolution des problèmes pour l'API Conversions

Vous avez installé l'API de conversion depuis au moins 20 minutes et vous ne voyez toujours pas d'activité dans le graphique d'activité des événements dans Ads Manager. Que faire ? 

 

Conseils de résolution de problèmes

  • Assurez-vous d'avoir correctement saisi votre jeton et votre identifiant de connexion.

  • Confirmez que l'API Conversions a été sélectionnée comme source de données de mesure de conversion pour votre campagne.

  • Si vous utilisez Google Tag Manager, assurez-vous d'avoir configuré un conteneur de serveur et non un conteneur Web.

  • Si vous utilisez l'intégration directe serveur à serveur, assurez-vous que votre appel d'API est correctement formaté.

 

Si vous ne voyez toujours aucune activité d'événement, vérifiez auprès de votre équipe d'ingénierie comment l'API de conversion a été configurée et quels événements sont partagés.