Option 3 : synchronisation des audiences uniquement

🚧

Développement prévu !

Voici un aperçu en avant-première de nos capacités prévues. La structure générale reste inchangée, mais veuillez noter que les spécifications exactes peuvent évoluer au fur et à mesure du développement.

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

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.

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.

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.