Introduction

Qu'est-ce qu'une page de marque ?

Les pages de marque sont des pages de renvoi personnalisées sur votre site Web destinées à mettre en avant des contenus de marque spécifiques. Elles sont hébergées sur votre domaine et s'affichent à l'aide de vos composants d'interface utilisateur.

Brand Pages are managed separately from standard ad campaigns in the Epsilon platform.
Although they use a similar creation and review workflow, they represent branded landing page experiences on a retailer’s site, not traditional advertisements.

Exemple : un utilisateur consulte le site yoursite.com/brands/nike et voit une page de marque Nike avec des produits Nike, mais celle-ci s'intègre parfaitement à votre site Web.

Ce que vous allez créer

En tant qu'ingénieur en commerce de détail, vous allez :

• Ajoutez une route pour les URL des pages de marque (par exemple, /brands/{slug}).

📘

Les détaillants ne sont pas tenus de fournir une URL pour chaque page de marque. Les URL sont gérées automatiquement par la plateforme.

Cependant, l’URL de base de la page de marque (y compris le préfixe) doit être configurée lors de l’intégration (par exemple, dans le guide de style du détaillant). Si l’URL complète ou le préfixe n’est pas fourni, l’URL de la page de marque ne s’affichera pas sur la page de configuration.

• Appelez l’API des pages de marque à l’aide du slug extrait.

• Affichez les modules de contenu renvoyés.

• Mettez en place le suivi des impressions, des clics et des ajouts au panier.

• Configurez un proxy inverse pour le suivi propriétaire.

📘

Cette étape n'est nécessaire que pour le suivi côté client.

Vos responsabilités et celles d'Epsilon

Comment fonctionnent les pages de marque

Flux de bout en bout

📘

Le contenu de la page de marque est configuré et prévisualisé dans l'interface utilisateur d'Epsilon. Les détaillants intègrent les pages de marque exclusivement via des API et sont responsables de la présentation finale de l'expérience sur leurs sites.

Au cours du processus de révision, les détaillants peuvent prévisualiser le contenu configuré de la page de marque avant de l'approuver.

Modèles et modules

Lors de l'intégration, Epsilon collabore avec votre équipe pour créer des modèles qui définissent :

• The content modules available (such as hero, product grid, text, and images), with module names configurable in the UI to align with your retailer taxonomy.

• The constraints for each module (character limits, image dimensions, etc.).

• Style conforme aux directives de votre marque.

Les marques sélectionnent un modèle lors de la création de leur campagne, puis remplissent le contenu en respectant ces contraintes.

📘

L'API des pages de marque renvoie des modules de contenu et les URL de suivi. Les détaillants sont chargés d'appliquer le style à l'aide de leurs propres composants d'interface utilisateur et de leur système de conception.

Exemples

Les exemples suivants illustrent comment les marques peuvent remplir des modules de contenu communs lors de la création d'une page de marque. Ce ne sont que des exemples d’entrées et peuvent être ajustées en fonction du modèle sélectionné et des objectifs de campagne.

Module HERO

• Titre : Découvrez la nouvelle collection d'été
• Sous-titre : des styles originaux pour toutes les occasions
• CTA : acheter

Module TEXTE

Découvrez nos dernières nouveautés conçues pour le confort, le style et la performance, parfaites pour la vie de tous les jours.

Module IMAGE

• Caption: New arrivals now available
• Alt text: Model wearing the summer collection
• URL : https://example-cdn.com/summer-collection.jpg

Module PRODUCT_GRID

Utilisez une grille de produits pour présenter les produits les plus vendus ou saisonniers, et favoriser l’engagement et les conversions.

Configuration du module :

📘

Chaque élément configurable peut être défini comme obligatoire, facultatif (autorisé) ou désactivé, selon les exigences du module et du détaillant.

Certains champs peuvent également imposer des limites maximales de caractères lorsqu'ils sont marqués comme obligatoires ou autorisés.

Module Tags

Templates may include an optional tags field on each module — a list of short string labels (e.g., ["header"]) that your integration can use for layout decisions, analytics, or mapping modules to your own components.

How tags work in the API response

• When a module has tags, they appear as a tags array on the corresponding item in contentData.
• When a module has no tags, the tags property is omitted entirely from the response - it will not appear as "tags": [].
• Treat a missing tags field the same as "no tags" - do not throw an error if it is absent.
• Tags are also supported on nested modules within SPLIT_LAYOUT - not only on the root split module.

📘

Important

Tags are opaque labels agreed upon between the retailer and their integration team. They are not related to ad tracking tags or any other system — always refer to these as "module tags" or "brand page module tags" to avoid confusion.

Example response module with a tag

{
  "id": "image-1",
  "contentType": "IMAGE",
  "order": 1,
  "tags": ["header"],
  "imageUrl": "https://example.com/images/banner.jpg"
}

Example response module with no tag (tags property omitted):

{
  "id": "image-2",
  "contentType": "IMAGE",
  "order": 2,
  "imageUrl": "https://example.com/images/promo.jpg"
}

What this means for the API response

The POST /ads/v3/brand-pages response reflects these same rules: a module type only appears in contentData when it is part of the live template and the brand page has configured content for that module.

Fields inside a module may be missing from the JSON, null, or empty when the template marks them optional or disabled, or when the brand leaves them unset - this is expected and does not indicate a defective payload.

Implement rendering with optional types and safe accessors - for example, only render a CTA block when ctaText and a navigation target are present; hide hero media when mediaUrlis absent.

trackersat the page level or on a node may be omitted when there is no trackable interaction. Compose URLs only when you have both an applicable template key from trackingTypes and the corresponding trackers..params, when provided by the API.