Metrics
Métriques Spotify Ads via l'API
Votre client connecte son compte Spotify Ads et votre produit interroge 50 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:clicks",
"component": "number_v1",
"metrics": [
"clicks"
],
"dimensions": [
"AD_ACCOUNT"
]
}
]
}Plus d'exemples d'appels Spotify Ads
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Portée et Impressions au fil du temps
Le nombre d'utilisateurs uniques qui ont reçu votre annonce et le nombre de fois que votre annonce a été diffusée au fil du temps.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:reach_impressions_by_day",
"component": "chart_v1",
"metrics": [
"reach",
"impressions"
],
"dimensions": [
"DAY"
]
}
]
}Tableau
Publicités à la une
Vos publicités sur la période spécifiée.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:ads",
"component": "datatable_v1",
"metrics": [
"reach",
"impressions",
"clicks",
"completes",
"completion_rate",
"ctr",
"e_cpm",
"e_cpcl",
"frequency",
"spend"
],
"dimensions": [
"AD"
]
}
]
}Chiffre
Annonce Lue Jusqu'à 100%
Le nombre d'annonces diffusées qui ont été lues jusqu'à la fin
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:completes",
"component": "number_v1",
"metrics": [
"completes"
],
"dimensions": [
"AD_ACCOUNT"
]
}
]
}Chiffres
37 métriques
Clics
Le nombre d'impressions sur lesquelles votre annonce a été cliquée
spotify_ads:clicksAnnonce Lue Jusqu'à 100%
Le nombre d'annonces diffusées qui ont été lues jusqu'à la fin
spotify_ads:completesTaux d'achèvement
Le pourcentage d'annonces lues jusqu'à la fin
spotify_ads:completion_rateTaux de Clics
Le pourcentage d'annonces qui ont été cliquées
spotify_ads:ctrCPM
Le Coût Moyen Par Mille Impressions (CPM) est le montant moyen payé par l'annonceur pour chaque 1 000 impressions de l'annonce, qu'elles soient ou non entendues.
spotify_ads:e_cpmCPCL
Le Coût Moyen Par Mille Écoutes Complètes (ACPL) est le montant moyen payé pour chaque 1 000 écoutes complètes de votre annonce. Cette métrique s'applique exclusivement aux campagnes audio actives configurées avec le modèle ACPL.
spotify_ads:e_cpclAnnonce Lue Jusqu'à 25%
Le nombre d'utilisateurs qui ont écouté ou vu 25 % de la durée totale de l'annonce
spotify_ads:first_quartilesFréquence des Annonces Diffusées
Le nombre moyen de fois qu'une personne a écouté ou vu votre annonce
spotify_ads:frequencyImpressions
Le nombre de fois qu'une annonce a été diffusée
spotify_ads:impressionsAnnonce Lue Jusqu'à 50%
Le nombre d'utilisateurs pour lesquels l'annonce a été lue jusqu'à la moitié de sa durée totale
spotify_ads:midpointsImpressions Hors Spotify
Le nombre d'annonces diffusées en dehors de Spotify
spotify_ads:off_spotify_impressionsÉcoutes Payantes
Le nombre d'écoutes pour une campagne CPCL où un utilisateur N'a PAS sauté l'annonce
spotify_ads:paid_listensFréquence des Écoutes Payantes
La fréquence moyenne des écoutes sur une campagne CPCL
spotify_ads:paid_listens_frequencyPortée des Écoutes Payantes
Nombre total d'utilisateurs uniques ayant écouté une annonce payante dans son intégralité dans une campagne CPCL.
spotify_ads:paid_listens_reachPortée des Annonces Diffusées
Le nombre d'utilisateurs uniques ayant reçu votre annonce
spotify_ads:reachValeur investie
Le montant total dépensé dans cette campagne
spotify_ads:spendDémarrages
Le nombre de fois qu'un utilisateur commence à écouter/voir votre annonce
spotify_ads:startsSauts
Le nombre de fois qu'un utilisateur saute une annonce
spotify_ads:skipsAnnonce Lue Jusqu'à 75%
Le nombre d'utilisateurs ayant écouté ou vu 75 % de la durée totale de l'annonce
spotify_ads:third_quartilesDémutations
Le nombre de fois qu'un utilisateur active le son d'une annonce
spotify_ads:unmutesExpansions Vidéo
Le nombre de fois qu'une personne a tapé sur votre annonce pour l'agrandir
spotify_ads:video_expandsTaux d'Expansion Vidéo
Le nombre d'extensions de vidéo divisé par le nombre d'impressions
spotify_ads:video_expand_rateVues Vidéo
Le nombre de fois où votre vidéo a été lue pendant au moins 3 secondes
spotify_ads:video_viewsStreams Moyens par Auditeur
Le nombre moyen de fois que chaque auditeur a diffusé votre contenu après avoir vu ou entendu votre annonce.
spotify_ads:streams_per_userStreams Moyens par Nouvel Auditeur
Le nombre moyen de fois que chaque nouvel auditeur a diffusé votre contenu après avoir vu ou entendu votre annonce.
spotify_ads:streams_per_new_listenerTaux d'Intention
Le pourcentage d'auditeurs qui ont pris des mesures montrant l'intention de diffuser à nouveau votre contenu à l'avenir. Les actions incluent la sauvegarde de votre contenu (en appuyant sur l'icône + ou "sauvegarder") ou en l'ajoutant à une playlist.
spotify_ads:intent_rateTaux de Conversion des Auditeurs
Le pourcentage d'auditeurs qui ont diffusé votre contenu après avoir vu ou entendu votre annonce.
spotify_ads:conversion_rateAuditeurs
Le nombre d'utilisateurs uniques de Spotify qui ont diffusé au moins 30 secondes du contenu promu dans les 14 jours suivant la visualisation ou l'écoute de votre annonce.
spotify_ads:listenersStreams de Nouveaux Auditeurs
Le nombre de streams de nouveaux auditeurs qui ont entendu ou vu votre annonce.
spotify_ads:new_listener_streamsNouveaux Auditeurs
Le nombre d'auditeurs qui n'avaient pas diffusé votre contenu dans les 28 jours avant de voir ou entendre votre annonce.
spotify_ads:new_listenersTaux de Conversion des Nouveaux Auditeurs
Le pourcentage de nouveaux auditeurs qui ont diffusé votre contenu après avoir vu ou entendu votre annonce.
spotify_ads:new_listener_conversion_rateStreams
Le nombre de fois où les auditeurs ont diffusé votre contenu pendant au moins 30 secondes dans les 14 jours suivant la visualisation ou l'écoute de vos annonces.
spotify_ads:streamsImpressions Diffusées en Streaming
Le nombre de fois qu'une annonce a été diffusée en streaming
spotify_ads:streamed_impressionsLeads
Le nombre d'événements de lead attribués à vos annonces sur une fenêtre de 30 jours
spotify_ads:leadsAchats
Le nombre d'événements d'achat attribués à vos annonces sur une fenêtre de 30 jours
spotify_ads:purchasesRevenu Attribué
Le montant total des revenus attribués aux événements d'achat ou de lead, selon les informations reçues des sources de données connectées à Spotify
spotify_ads:revenueROAS
Le retour total sur les dépenses publicitaires issu des achats attribués, selon la valeur des événements d'achat ou de lead reçus des sources de données connectées à Spotify
spotify_ads:return_on_ad_spend
Graphiques
7 métriques
Portée et Impressions au fil du temps
Le nombre d'utilisateurs uniques qui ont reçu votre annonce et le nombre de fois que votre annonce a été diffusée au fil du temps.
spotify_ads:reach_impressions_by_dayClics et CTR au fil du temps
Le nombre de fois qu'une annonce a été cliquée et le pourcentage d'annonces cliquées au fil du temps.
spotify_ads:clicks_ctr_by_dayDépenses au fil du temps
Le montant total dépensé dans cette campagne au fil du temps.
spotify_ads:spend_by_dayAuditeurs et Nouveaux Auditeurs
Le nombre d'utilisateurs uniques de Spotify qui ont diffusé au moins 30 secondes du contenu promu dans les 14 jours suivant la visualisation ou l'écoute de votre annonce et le nombre d'auditeurs qui n'avaient pas diffusé votre contenu dans les 28 jours avant de voir ou entendre votre annonce pendant la période spécifiée.
spotify_ads:listeners_by_dayClics par Âge
Le nombre de fois qu'une annonce a été cliquée par groupe d'âge
spotify_ads:clicks_by_ageClics par Genre
Le nombre de fois qu'une annonce a été cliquée par genre
spotify_ads:clicks_by_genderPortée par Plateforme
Le nombre d'utilisateurs uniques ayant reçu votre annonce par plateforme
spotify_ads:reach_by_platform
Tableaux
6 métriques
Publicités à la une
Vos publicités sur la période spécifiée.
spotify_ads:adsCampagnes à la une
Campagnes qui ont eu le plus grand impact sur votre public, sur la période analysée.
spotify_ads:featured_campaignsEnsemble d'annonces en vedette
Synthèse des données clés des ensembles de publicités pour la période analysée.
spotify_ads:ad_setsGenre en Vedette
Résumé des données clés pour les genres
spotify_ads:insights_by_genrePays en Vedette
Résumé des données clés pour les pays
spotify_ads:insights_by_countryPlacement en Vedette
Résumé des données clés pour les placements
spotify_ads:insights_by_placement
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
