For the complete documentation index, see llms.txt. This page is also available as Markdown.

Spotify Conversions API

Spotify est un fournisseur de services de streaming musical. En utilisant cette destination, vous pouvez exploiter Spotify Conversions API comme outil d’attribution tagless qui vous permet de transmettre des événements de conversion en ligne et hors ligne à Spotify. Conversions API 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.

Principales fonctionnalités

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

  • Structure des événements: notre Référence des événements le modèle couvre Événements Spotify, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

  • Mappages préconfigurés: la correspondance des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie la saisie de l'utilisateur.

  • Hachage automatique: les informations sont automatiquement hachées conformément aux spécifications du partenaire.

  • Smart Mapping: la correspondance des données peut être ajustée à l'aide des champs définis dans votre datalayer.

  • Correspondance 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

Paramètres
Description

Jeton d'accès

Obligatoire Votre jeton d’accès. Générez votre jeton dans Spotify Ads Manager, en allant dans Événements → Connecter la source de données → Conversions API → Générer le jeton .

ID de connexion

Obligatoire L’identifiant de connexion est une clé unique attribuée à votre organisation qui vous permet d’accéder à CAPI lorsqu’il est associé au jeton d’accès. Obtenez votre identifiant dans Spotify Ads Manager, en allant dans Événements → Connecter la source de données → Conversions API . Lorsque vous soumettez le formulaire, l’interface Spotify affichera le nouvel identifiant de connexion créé (un UUID).

Mappage des événements

Modifiez le mappage standard entre les événements Spotify et les vôtres. Valeurs acceptées pour Nom de l’événement Spotify : VIEW, PRODUCT, CHECK_OUT, ADD_TO_CART, PURCHASE, LEAD, SIGN_UP, CUSTOM_EVENT_1, CUSTOM_EVENT_2, CUSTOM_EVENT_3, CUSTOM_EVENT_4 et CUSTOM_EVENT_5.

Référence rapide

Événements Commanders Act
Événements Spotify

add_to_cart

ADD_TO_CART

begin_checkout

CHECK_OUT

generate_lead

LEAD

page_view

VIEW

purchase

PURCHASE

sign_up

SIGN_UP

view_item

Détails

[Any Event]

[Tout événement pris en charge] [1]

1. Voir Mappage des événements dans Configuration pour plus de détails sur les événements pris en charge par Spotify.

Correspondances des champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping fonctionnalité.

Champs Smart Mapping
Propriétés par défaut de Commanders Act
Propriétés Spotify

-

ID de connexion

capi_connection_id [*][1]

-

Mappage des événements

event_name

event_name [*][2][3]

ID de l'événement

context.event_id

event_id [*][2][4]

Horodatage de l'événement

context.event_timestamp

event_time [*][2][5]

URL de la page

context.page.url

event_source_url [2]

IP de l'appareil

context.device.ip

ip_address [6]

Identifiant mobile de l'appareil

context.device.advertising_id

device_id [6]

E-mail de l'utilisateur

user.email

hashed_emails.0 [6]

Téléphone de l’utilisateur

user.phone

hashed_phone_number [6]

Devise

currency

currency [7]

Valeur

value

montant [7]

Catégorie de contenu

partners.spotify.content_category

content_category [7]

Nom du contenu

partners.spotify.content_name

content_name [7]

Source de l’action

type

action_source [2][8]

Ciblage Opt-out

partners.spotify.optout_targeting

opt_out_targeting [2][9]

* Propriété obligatoire. 1. Voir ID de connexion dans Configuration. Défini dans conversion_events . 2. Défini dans conversion_events.evennts.X . 3. Voir Référence rapide pour le mappage standard, et Mappage des événements dans Configuration pour modifier le mappage ou en ajouter de nouveaux. 4. Par défaut : context.event_id . 5. Par défaut : horodatage de l’événement. 6. Défini dans conversion_events.events.X.user_data . 7. Défini dans conversion_events.events.X.event_details . 8. Par défaut : • défini sur WEB si type est online • défini sur APP si type est app ou mobile_app • défini sur OFFLINE si type est offline • défini sur WEB si rien de ce qui précède ne s’applique. 9. Valeurs acceptées : true ou false (boolean)

Mis à jour

Ce contenu vous a-t-il été utile ?