> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/spotify-conversions-api.md).

# Spotify Conversions API

[Spotify](https://open.spotify.com/) est un fournisseur de service de streaming musical. Cette destination vous permet d’exploiter [Spotify Conversions API](https://adshelp.spotify.com/s/article/Spotify-Conversions-API-US?language=en_US) comme outil d’attribution sans tag, qui vous permet de transmettre à Spotify des événements de conversion en ligne et hors ligne. La Conversions API est conçue pour fournir une attribution complète et de grande fidélité afin de vous aider à comprendre les performances de vos campagnes sur Spotify.

## Fonctionnalités clés

La destination Spotify Conversions API offre les fonctionnalités clés suivantes :

* **Structure des événements** : notre [référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) couvre le modèle des [événements Spotify](https://developer.spotify.com/documentation/ads-api/guides#capi-setup-guide), ce qui signifie que vos données sont correctement associées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Mappage des événements** : modifiez le mappage standard entre les événements Spotify et les vôtres.
* **Prise en charge du mode batch** : envoyez plusieurs événements dans une seule requête.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Access Token</code></td><td><em><strong><code>Required</code></strong></em><br>Votre jeton d’accès. Générez votre jeton dans <a href="https://adsmanager.spotify.com">Spotify Ads Manager</a>, en accédant à <code>Events</code> → <code>Connect Data Source</code> → <code>Conversions API</code> → <code>Generate Token</code> .</td></tr><tr><td><code>Connection Id</code></td><td><em><strong><code>Required</code></strong></em><br>L’identifiant de connexion est une clé unique attribuée à votre organisation qui vous permet d’accéder à la CAPI lorsqu’il est utilisé avec le jeton d’accès. Récupérez votre identifiant dans <a href="https://adsmanager.spotify.com">Spotify Ads Manager</a>, en accédant à <code>Events</code> → <code>Connect Data Source</code> → <code>Conversions API</code> . Après l’envoi du formulaire, l’interface Spotify affichera l’identifiant de connexion qui vient d’être créé (un UUID).</td></tr><tr><td><code>Event Mapping</code></td><td>Modifiez le mappage standard entre les événements Spotify et les vôtres. Valeurs acceptées pour <code>Spotify event name</code> : <code>VIEW</code>, <code>PRODUCT</code>, <code>CHECK_OUT</code>, <code>ADD_TO_CART</code>, <code>PURCHASE</code>, <code>LEAD</code>, <code>SIGN_UP</code>, <code>CUSTOM_EVENT_1</code>, <code>CUSTOM_EVENT_2</code>, <code>CUSTOM_EVENT_3</code>, <code>CUSTOM_EVENT_4</code> et <code>CUSTOM_EVENT_5</code>.</td></tr></tbody></table>

## Référence rapide

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Événements Commanders Act</th><th>Événements Spotify</th></tr></thead><tbody><tr><td><code>add_to_cart</code></td><td><code>ADD_TO_CART</code></td></tr><tr><td><code>begin_checkout</code></td><td><code>CHECK_OUT</code></td></tr><tr><td><code>generate_lead</code></td><td><code>LEAD</code></td></tr><tr><td><code>page_view</code></td><td><code>VIEW</code></td></tr><tr><td><code>purchase</code></td><td><code>PURCHASE</code></td></tr><tr><td><code>sign_up</code></td><td><code>SIGN_UP</code></td></tr><tr><td><code>view_item</code></td><td><code>Détails</code></td></tr><tr><td><code>[Any Event]</code></td><td><code>[Tout événement pris en charge]</code> <strong>[1]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour en savoir plus sur les événements Spotify pris en charge.
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) .
{% endhint %}

{% hint style="warning" %}
Au moins l’un des champs « Smart Mapping » suivants est requis :\
• <mark style="color:bleu;">`Device IP`</mark>\
• <mark style="color:bleu;">`Device Mobile Identifier`</mark>\
• <mark style="color:bleu;">`User Email`</mark>\
• <mark style="color:bleu;">`User Phone`</mark>
{% endhint %}

<table data-header-hidden="false" data-header-sticky data-search="true"><thead><tr><th>Champs Smart Mapping</th><th>Propriétés par défaut de Commanders Act</th><th>Propriétés Spotify</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>Connection Id</code></td><td><code>capi_connection_id</code> <strong>[*][1]</strong></td></tr><tr><td><code>-</code></td><td><p><code>Event Mapping</code></p><p><code>event_name</code></p></td><td><code>event_name</code> <strong>[*][2][3]</strong></td></tr><tr><td><code>Event Id</code></td><td><code>context.event_id</code></td><td><code>event_id</code> <strong>[*][2][4]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>event_time</code> <strong>[*][2][5]</strong></td></tr><tr><td><code>Page URL</code></td><td><code>context.page.url</code></td><td><code>event_source_url</code> <strong>[2]</strong></td></tr><tr><td><code>Device IP</code></td><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[6]</strong></td></tr><tr><td><code>Identifiant mobile de l’appareil</code></td><td><code>context.device.advertising_id</code></td><td><code>device_id</code> <strong>[6]</strong></td></tr><tr><td><code>E-mail de l’utilisateur</code></td><td><code>user.email</code></td><td><code>hashed_emails.0</code> <strong>[6]</strong></td></tr><tr><td><code>Téléphone de l’utilisateur</code></td><td><code>user.phone</code></td><td><code>hashed_phone_number</code> <strong>[6]</strong></td></tr><tr><td><code>Ccurrency</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[7]</strong></td></tr><tr><td><code>Valeur</code></td><td><code>value</code></td><td><code>amount</code> <strong>[7]</strong></td></tr><tr><td><code>Catégorie de contenu</code></td><td><code>partners.spotify.content_category</code></td><td><code>content_category</code> <strong>[7]</strong></td></tr><tr><td><code>Nom du contenu</code></td><td><code>partners.spotify.content_name</code></td><td><code>content_name</code> <strong>[7]</strong></td></tr><tr><td><code>Source de l’action</code></td><td><code>type</code></td><td><code>action_source</code> <strong>[2][8]</strong></td></tr><tr><td><code>Opt-out Targeting</code></td><td><code>partners.spotify.optout_targeting</code></td><td><code>opt_out_targeting</code> <strong>[2][9]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Voir <mark style="color:bleu;">`Connection Id`</mark> dans [Configuration](#configuration). Définir dans <mark style="color:bleu;">`conversion_events`</mark> .\
**2.** Définir dans <mark style="color:bleu;">`conversion_events.evennts.X`</mark> .\
**3.** Voir [Référence rapide](#quick-reference) pour le mappage standard, et <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour modifier le mapping ou en ajouter de nouveaux.\
**4.** Par défaut : <mark style="color:bleu;">`context.event_id`</mark> .\
**5.** Par défaut : horodatage de l’événement.\
**6.** Définir dans <mark style="color:bleu;">`conversion_events.events.X.user_data`</mark> .\
**7.** Définir dans <mark style="color:bleu;">`conversion_events.events.X.event_details`</mark> .\
**8.** Par défaut :\
• défini sur <mark style="color:bleu;">`WEB`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`online`</mark>\
• défini sur <mark style="color:bleu;">`APP`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`app`</mark> ou <mark style="color:bleu;">`mobile_app`</mark>\
• défini sur <mark style="color:bleu;">`OFFLINE`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`offline`</mark>\
• défini sur <mark style="color:bleu;">`WEB`</mark> si aucune des conditions ci-dessus ne s’applique.\
**9.** Valeurs acceptées : <mark style="color:bleu;">`true`</mark> ou <mark style="color:bleu;">`false`</mark> (booléen)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/spotify-conversions-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
