> 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 services de streaming musical. En utilisant cette destination, vous pouvez exploiter [Spotify Conversions API](https://adshelp.spotify.com/s/article/Spotify-Conversions-API-US?language=en_US) en tant qu'outil d'attribution tagless qui vous permet d'envoyer des événements de conversion en ligne et hors ligne à Spotify. La Conversions API est conçue pour fournir une attribution complète et de haute fidélité afin de vous aider à comprendre les performances de vos campagnes sur Spotify.

## Fonctionnalités clés

La destination Spotify Conversions API fournit 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) modèle couvre [les événements Spotify](https://developer.spotify.com/documentation/ads-api/guides#capi-setup-guide), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.**Mappage intelligent
* **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>Jeton d'accès</code></td><td><em><strong><code>Requis</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 allant dans <code>Événements</code> → <code>Connecter la source de données</code> → <code>Conversions API</code> → <code>Générer le jeton</code> .</td></tr><tr><td><code>ID de connexion</code></td><td><em><strong><code>Requis</code></strong></em><br>L'identifiant de connexion est une clé unique attribuée à votre organisation qui vous permet d'accéder à CAPI lorsqu'il est utilisé avec le jeton d'accès. Obtenez votre identifiant dans <a href="https://adsmanager.spotify.com">Spotify Ads Manager</a>, en allant dans <code>Événements</code> → <code>Connecter la source de données</code> → <code>Conversions API</code> . Lorsque vous soumettez le formulaire, l'interface utilisateur Spotify affichera le nouvel identifiant de connexion créé (un UUID).</td></tr><tr><td><code>Mappage des événements</code></td><td>Modifiez le mappage standard entre les événements Spotify et les vôtres. Valeurs acceptées pour <code>nom de l'événement Spotify</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>[Tout événement]</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 plus de détails sur les événements pris en charge par Spotify.
{% endhint %}

## Mappages des champs

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

{% hint style="warning" %}
Au moins l'un des champs « Smart Mapping » suivants est requis :\
• <mark style="color:bleu;">`IP de l'appareil`</mark>\
• <mark style="color:bleu;">`Identifiant mobile de l'appareil`</mark>\
• <mark style="color:bleu;">`E-mail de l'utilisateur`</mark>\
• <mark style="color:bleu;">`Téléphone de l'utilisateur`</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>ID de connexion</code></td><td><code>capi_connection_id</code> <strong>[*][1]</strong></td></tr><tr><td><code>-</code></td><td><p><code>Mappage des événements</code></p><p><code>event_name</code></p></td><td><code>event_name</code> <strong>[*][2][3]</strong></td></tr><tr><td><code>ID de l'événement</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>URL de la page</code></td><td><code>context.page.url</code></td><td><code>event_source_url</code> <strong>[2]</strong></td></tr><tr><td><code>IP de l'appareil</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>Devise</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>Ciblage Opt-out</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;">`ID de connexion`</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 mappage 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éfinir sur <mark style="color:bleu;">`WEB`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`en ligne`</mark>\
• définir sur <mark style="color:bleu;">`APP`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`application`</mark> ou <mark style="color:bleu;">`mobile_app`</mark>\
• définir sur <mark style="color:bleu;">`OFFLINE`</mark> si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`hors ligne`</mark>\
• définir sur <mark style="color:bleu;">`WEB`</mark> si aucun des cas 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.