Spotify Conversions API

Cette destination est actuellement en revue finale et sera bientôt disponible.

Spotify est un fournisseur de service de streaming musical. En utilisant cette destination, vous pouvez exploiter Spotify Conversions API comme outil d'attribution sans tag qui vous permet d'envoyer des événements de conversion online et offline à 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 offre les fonctionnalités clés suivantes :

• Structure des événements : notre référence des événements couvre les événements Spotify, 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 s'effectue automatiquement, ce qui simplifie la saisie des utilisateurs.

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

• Mappage intelligent: le mappage des données peut être ré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

Paramètres	Description
Jeton d'accès	Requis 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	Requis 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 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
[Tout événement]	[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.

Mappages des champs

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

Au moins un des champs « Smart Mapping » suivants est requis : • IP de l'appareil • Identifiant mobile de l'appareil • E-mail de l'utilisateur • Téléphone de l'utilisateur

Champs Smart Mapping	Propriétés par défaut 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	amount [7]
Catégorie de contenu	partners.spotify.content_name	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éfinissez dans conversion_events . 2. Définissez 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éfinissez dans conversion_events.events.X.user_data . 7. Définissez 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 aucune des options ci-dessus ne s'applique. 9. Valeurs acceptées : true ou false (booléen)