Option 2 : synchronisation des clients et des audiences

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
}

📘

Your ad request must contain customerId, regardless of if you are integrating via file or 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.

View the Segment Reference Guide here.

Fichier de client

Votre fichier de client est utilisée pour créer un client unique et le relier à des segments. Vous devez simplement fournir customer_id et segment_ids

View the Customer Reference Guide here.

📘

Maximum de 100 segments par client.

Si vous synchronisez plus de 100 segments pour un client, veuillez contacter Epsilon. Si vous dépassez 100 segments par client, les demandes d'annonces peuvent avoir un regroupement de segments réduit et tronquer les segments dans la requête.

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.

1. Créer des segments
2. Facultatif : accès au segment du gestionnaire
3. Créer des clients
4. 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: The segments API uses bearer authorisation used by the Partner API. You will need to generate a bearer token and use it. Learn more: Authentication requests.

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"
  }
}

View the reference for the Create a segment endpoint here.

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"
        ]
}

View the reference for the Manage access to a specific segment endpoint here.

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.

View the specification for the API to Create or update a customer here.

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.

View the specification for the API to manage segments and customers here.