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"
      ]
    }
  ]
}
Exemple : « Clics » en octobre, comparé à septembre.

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:clicks
  • Annonce Lue Jusqu'à 100%

    Le nombre d'annonces diffusées qui ont été lues jusqu'à la fin

    spotify_ads:completes
  • Taux d'achèvement

    Le pourcentage d'annonces lues jusqu'à la fin

    spotify_ads:completion_rate
  • Taux de Clics

    Le pourcentage d'annonces qui ont été cliquées

    spotify_ads:ctr
  • CPM

    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_cpm
  • CPCL

    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_cpcl
  • Annonce Lue Jusqu'à 25%

    Le nombre d'utilisateurs qui ont écouté ou vu 25 % de la durée totale de l'annonce

    spotify_ads:first_quartiles
  • Fréquence des Annonces Diffusées

    Le nombre moyen de fois qu'une personne a écouté ou vu votre annonce

    spotify_ads:frequency
  • Impressions

    Le nombre de fois qu'une annonce a été diffusée

    spotify_ads:impressions
  • Annonce Lue Jusqu'à 50%

    Le nombre d'utilisateurs pour lesquels l'annonce a été lue jusqu'à la moitié de sa durée totale

    spotify_ads:midpoints
  • Impressions 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_listens
  • Fréquence des Écoutes Payantes

    La fréquence moyenne des écoutes sur une campagne CPCL

    spotify_ads:paid_listens_frequency
  • Porté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_reach
  • Portée des Annonces Diffusées

    Le nombre d'utilisateurs uniques ayant reçu votre annonce

    spotify_ads:reach
  • Valeur investie

    Le montant total dépensé dans cette campagne

    spotify_ads:spend
  • Démarrages

    Le nombre de fois qu'un utilisateur commence à écouter/voir votre annonce

    spotify_ads:starts
  • Sauts

    Le nombre de fois qu'un utilisateur saute une annonce

    spotify_ads:skips
  • Annonce Lue Jusqu'à 75%

    Le nombre d'utilisateurs ayant écouté ou vu 75 % de la durée totale de l'annonce

    spotify_ads:third_quartiles
  • Démutations

    Le nombre de fois qu'un utilisateur active le son d'une annonce

    spotify_ads:unmutes
  • Expansions Vidéo

    Le nombre de fois qu'une personne a tapé sur votre annonce pour l'agrandir

    spotify_ads:video_expands
  • Taux d'Expansion Vidéo

    Le nombre d'extensions de vidéo divisé par le nombre d'impressions

    spotify_ads:video_expand_rate
  • Vues Vidéo

    Le nombre de fois où votre vidéo a été lue pendant au moins 3 secondes

    spotify_ads:video_views
  • Streams 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_user
  • Streams 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_listener
  • Taux 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_rate
  • Taux de Conversion des Auditeurs

    Le pourcentage d'auditeurs qui ont diffusé votre contenu après avoir vu ou entendu votre annonce.

    spotify_ads:conversion_rate
  • 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.

    spotify_ads:listeners
  • Streams de Nouveaux Auditeurs

    Le nombre de streams de nouveaux auditeurs qui ont entendu ou vu votre annonce.

    spotify_ads:new_listener_streams
  • Nouveaux 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_listeners
  • Taux 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_rate
  • Streams

    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:streams
  • Impressions Diffusées en Streaming

    Le nombre de fois qu'une annonce a été diffusée en streaming

    spotify_ads:streamed_impressions
  • Leads

    Le nombre d'événements de lead attribués à vos annonces sur une fenêtre de 30 jours

    spotify_ads:leads
  • Achats

    Le nombre d'événements d'achat attribués à vos annonces sur une fenêtre de 30 jours

    spotify_ads:purchases
  • Revenu 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:revenue
  • ROAS

    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_day
  • Clics 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_day
  • Dépenses au fil du temps

    Le montant total dépensé dans cette campagne au fil du temps.

    spotify_ads:spend_by_day
  • Auditeurs 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_day
  • Clics par Âge

    Le nombre de fois qu'une annonce a été cliquée par groupe d'âge

    spotify_ads:clicks_by_age
  • Clics par Genre

    Le nombre de fois qu'une annonce a été cliquée par genre

    spotify_ads:clicks_by_gender
  • Porté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:ads
  • Campagnes à la une

    Campagnes qui ont eu le plus grand impact sur votre public, sur la période analysée.

    spotify_ads:featured_campaigns
  • Ensemble 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_sets
  • Genre en Vedette

    Résumé des données clés pour les genres

    spotify_ads:insights_by_genre
  • Pays en Vedette

    Résumé des données clés pour les pays

    spotify_ads:insights_by_country
  • Placement 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.