Introduction
Les détaillants disposant de salles blanches ou de segments d'audience autogérés peuvent synchroniser les données clients et segments pour fournir des audiences personnalisées aux principaux annonceurs et audiences générales. Cette intégration implique l'utilisation de votre CDP pour fournir des informations sur les clients/segments à Epsilon. Soit par API, soit par fichier.
Exigences d'intégration
- L'intégration standard sur site doit inclure l'ID client sur tous les points de contact pertinents (lorsque disponible).
- Flux d’identification des clients, par API ou par flux de fichiers.
- Segmenter le flux par API ou par fichier.
Fonctionnement
Le CDP ou la plateforme d'audience fournit des données sur les clients et les segments à Epsilon en utilisant une importation de fichiers ou l'API. Les ID des clients inclus dans les demandes d'annonces sont associés à des segments d'audience et à des campagnes connexes. Cela permet un ciblage précis basé sur des définitions d'audience personnalisées ou générales.
Exemples d'intégration
Exemple de demande d'annonce : demande d'annonce contenant l’ID client :
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
Votre demande d’annonce doit contenir
customerId, que vous effectuiez l'intégration via un fichier ou une API.
Intégration avec synchronisation de fichiers (recommandé)
Lors de la synchronisation des clients et des segments par fichier, nous avons besoin de deux fichiers :
- Fichier de segment
- Fichier de client
Fichier de segment
Un fichier de segment est utilisé pour fournir un ID de segment affiché dans l'interface utilisateur, ainsi qu'un nom et une description. Il peut également être utilisé pour spécifier les team_ids spécifiques pouvant visualiser un segment, ce qui vous permet de créer des segments pour des annonceurs spécifiques.
| segment_id | Nom | Description | team_ids |
|---|---|---|---|
| segment général 1 | Acheteurs aux dépenses élevées | Acheteurs dont les achats hebdomadaires moyens se situent dans les 15 % supérieurs. | |
| general-segment-2 | Acheteurs soucieux du prix | Acheteurs ayant un pourcentage plus élevé de produits axés sur la valeur dans leur panier. | |
| segment général-3 | Clients réguliers | Acheteurs qui achètent chaque semaine en moyenne. | |
| segment personnalisé 1 | Personnalisé : Récence d'achat élevée BrandCo | Clients ayant acheté BrandCo au cours des 30 derniers jours. | ["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Consultez le guide de référence des segments ici.
Fichier de client
Votre fichier de client est utilisé pour créer un client unique et le relier à des segments. Vous devez simplement fournir customer_id et segment_ids
| customer_id | Segments |
|---|---|
| cust_12345 | ["general-segment-3", "general-segment-4"] |
| cust_67890 | ["general-segment-3"] |
Consultez le guide de référence des clients ici.
Intégration de synchronisation via l'API
Lors de la synchronisation des clients et des segments par API, trois opérations doivent être effectuées.
- Créer des segments
- Facultatif : accès au segment du gestionnaire
- Créer des clients
- Gérer les liens entre les segments et les clients
Création de segments via API
La première chose à faire est de créer vos segments pour y rattacher les clients.
Vous devez fournir un ID de segment qui s'affiche dans l'interface utilisateur, un nom, une description, ainsi que votre équipe de détaillants.
Important : l'API des segments utilise l'autorisation Bearer utilisée par l'API Partner. Vous devrez générer un jeton Bearer et l'utiliser. En savoir plus : Requêtes d’authentification.
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"segment":{
"segmentId": "general-segment-4",
"sourceId": "DEFAULT_SOURCE_ID",
"name": "Value Shoppers",
"description": "Shoppers that have a higher basket % of value driven products.",
"retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
}
}
Consultez la référence pour le point de terminaison Créer un segment ici.
Facultatif : gérer l'accès aux segments
Vous pouvez utiliser la fonction de gestion des accès pour autoriser certains annonceurs à consulter le segment, ce qui vous permet de personnaliser les segments pour des annonceurs spécifiques.
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
Consultez la référence pour le point de terminaison Gérer l'accès à un segment spécifique ici.
Création de clients via une API
L'API clients utilise l'authentification de base fournie par l'API Intégration.
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customers": [
{
"id": "cust_12345"
},
{
"id": "cust_67890"
}
}
]
}
Une fois cette étape terminée, vous devez également créer des segments auxquels les clients seront rattachés. Vous pouvez créer jusqu'à 100 clients par demande.
Consultez les spécifications de l'API pour créer ou mettre à jour un client ici.
Lier les clients aux segments via une API
Après avoir créé les segments, utilisez l’API /customers/manage-segments pour relier les clients aux segments
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "cust_12345",
"teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
"segments": {
"segmentIds":[
"general-segment-4","general-segment-3"
]
}
}
L'ID d'équipe dans cette requête est votre ID d'équipe de détaillant.
Consultez les spécifications de l'API pour gérer les segments et les clients ici.