API partenaire
Ressources API

Option 3 : synchronisation des audiences uniquement

Introduction

Pour les organisations ne pouvant partager des identifiants clients, l'activation de l'audience peut être réalisée en synchronisant les flux de segments et en transmettant les ID de segment dans les demandes d'annonce. Cette approche axée sur la confidentialité permet un ciblage à la fois personnalisé et général sans exposer les données des clients. Les demandes d'annonce doivent inclure des identifiants de segment pour permettre une activation ciblée.

Exigences d'intégration

  • Veuillez noter que le flux de segments doit spécifier quels segments d'audience sont disponibles pour les équipes d'annonceurs désignées.
  • Les demandes d'annonce doivent inclure des ID de segment pertinents pour chaque client.

Fonctionnement

Le CDP ou la plateforme d'audience fournit à Epsilon un flux de segments via une importation de fichier ou une API. Les ID de segment inclus dans les demandes d'annonce servent à associer les audiences aux campagnes. La correspondance entre les clients et les segments est gérée en interne dans les systèmes back-end du détaillant.

Exemples d'intégration

Exemple de demande d'annonce : demande d'annonce contenant des ID de segment :

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
	"audience": {
        "segments": [
            {
                "segmentIds": [
                    "segment-1"
                ]
            },
            {
                "sourceId": "RETAILER_SOURCE_2",
                "segmentIds": [
                    "general-segment-4","general-segment-3"
                ]
            }
        ]
    },
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
        "filterMode": "AndOr"
    },
    "maxNumberOfAds": 3
}

📘

Synchronisez-vous des segments provenant de plusieurs sources ?

Si c'est le cas, vous devrez également fournir le sourceId dans l'objet du segment. Cette valeur est convenue entre vous et Epsilon pour référencer la source du segment. Par exemple, customer-cdp-1.

Si vous synchronisez à partir d'une seule source/d'un seul CDP, il vous suffit d'envoyer le segmentIds dans la segment tableau.

Intégration avec synchronisation de fichiers (recommandé)

Pour synchroniser des segments, il suffit d'un seul fichier.

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_idNomDescriptionteam_ids
segment général 1Acheteurs aux dépenses élevéesAcheteurs dont les achats hebdomadaires moyens se situent dans les 15 % supérieurs.
general-segment-2Acheteurs soucieux du prixAcheteurs ayant un pourcentage plus élevé de produits axés sur la valeur dans leur panier.
segment général-3Clients réguliersAcheteurs qui achètent chaque semaine en moyenne.
segment personnalisé 1Personnalisé : Récence d'achat élevée BrandCoClients 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.

Intégration de synchronisation via l'API

Lors de la synchronisation des clients et des segments par API, une ou deux opérations doivent être effectuées.

  1. Créer des segments
  2. Facultatif : accès au segment du gestionnaire

Création de segments via API

Comme vous gérez la relation client-segment avant la demande de d'annonce, vous devez seulement envoyer des segments.

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.

📘

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.

Si vous synchronisez des segments via l'API. Ce sourceId s'aligne sur la demande d'annonce.

📘

Maximum de 100 segments par demande d'annonce.

Si vous synchronisez plus de 100 segments, 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.

En cas de troncature, le champ metadata.warningsapparaîtra et se remplira dans la réponse d'annonce, comme ci-dessous :

  "metadata": {
    "warnings": [
      "Audience Segment IDs exceeded the limit of 100 and were truncated"
     ]
  }

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.