Les cookies propriétaires sont de petits éléments de données stockés par le site Web (ou le domaine) consulté par l’utilisateur. Ils sont créés et stockés directement par le site Web et sont uniquement accessibles via ce dernier.

Lorsqu’un utilisateur consulte un site Web, un cookie propriétaire est créé dans son navigateur. Il peut contenir diverses informations telles que son identifiant unique ou des données sur ses interactions sur le site. Il persiste sur plusieurs sessions et visites. Le site Web peut ainsi reconnaître les utilisateurs récurrents et attribuer leurs actions au fil du temps. Ces identifiants sont disponibles pendant environ 13 mois.

Epsilon exploite ce cookie pour faciliter la création de rapports et d’attributions omnicanaux plus approfondies.

Conditions préalables

Pour une mise en œuvre réussie de l’attribution basée sur les cookies propriétaires (FPC) sur vos sites, assurez-vous de disposer des données suivantes avant d’intégrer vos activités sur site avec le cookie propriétaire d’Epsilon :

Préparer les données requises

Assurez-vous que vous disposez des données client, des données de conversion et des balises du site Epsilon.

• Données de conversion : les données de conversion permettent une attribution précise, améliorent le ciblage, optimisent les performances, garantissent la cohérence des données et fournissent des informations complètes sur les clients.
  • Données de conversion de la campagne : incluez les données de conversion pour tous les canaux d’achat (en magasin, en ligne, sur catalogue, par exemple).
  • Toutes les conversions : incluez toutes les conversions de clients connus et inconnus.
  • Ventes brutes uniquement : indiquez uniquement les ventes brutes, à l’exclusion des mises à jour ou des annulations de commandes.
  • Cohérence des identifiants de commande : assurez-vous que les identifiants de commande transmis dans le fichier de conversion correspondent à ceux transmis dans les balises du site Web.
• Balises du site Epsilon : le balisage du site consiste à intégrer un code de suivi dans vos pages Web afin de créer et lire des cookies propriétaires. Ce processus est essentiel pour saisir les interactions des utilisateurs et attribuer les actions avec précision au fil du temps.

  📘

  Pour une intégration optimale, vous devez collaborer avec vos équipes d’ingénieurs d’intégration client (CIE) et de gestionnaires de programmes d’intégration (IPM). Elles vous guideront tout au long du processus, notamment pour les opérations suivantes :

  • Stratégie de balisage : élaborez une stratégie pour capturer toutes les interactions pertinentes des utilisateurs.
  • Mise en œuvre : intégrez correctement le code de suivi dans vos pages Web.
  • Tests : effectuez des tests approfondis pour vous assurer que les cookies sont correctement créés et lus.

Fournir les attributs correspondants

Le client doit fournir des attributs correspondants aux points de données suivants.

Mettre en œuvre un cookie propriétaire

Cette section décrit les étapes à suivre pour intégrer le cookie propriétaire (FPC) d’Epsilon à vos activités sur site, en assurant un suivi et une attribution précis.

Étape 1 : identifier et capturer le cookie propriétaire

1. Déterminez quand le FPC est créé dans le navigateur du client.

2. Identifiez la valeur dtm_token_sc dans les données du cookie.

   

📘

Lorsqu’un utilisateur visite votre site pour la première fois, le FPC ne sera pas créé. La valeur First Party Cookie apparaîtra. Vous pouvez commencer à utiliser la valeur dtm_token_sc dès qu’elle est disponible.

Étape 2 : transmettez la valeur dtm_token_sc lors d’appels API de requête d’annonces sur site

1. Incluez la valeur dtm_token_sc dans le champ dtmCookieId lorsque vous passez des appels API de requête d’annonces sur site. Vous pourrez ainsi suivre et attribuer avec précision les interactions des utilisateurs.

2. Transmettez également le champ CustomerId dans le champ CustomerId pour faire correspondre le cookie à un client spécifique, et ainsi améliorer la précision du suivi. La valeur CustomerId est disponible lorsque le client se connecte au site du détaillant.

   Exemple de requête

   HTTP

   {
     "sessionid": "{SESSION_ID}", // Set to value advised by your CIE.
     "customerid": "{CUSTOMER_ID}", // Set to CustomerId value when available.
     "dtmCookieId": "{DTM_TOKEN_SC_VALUE}" // Set to dtm_token_sc value.
   }
   
   

   Exemple de réponse

   HTTP

   {
     "sessionid": "SESSION_1", // Set to value advised by your CIE.
     "customerid": "CUSTOMER_1", // Set to CustomerId value when available.
     "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE" // Set to dtm_token_sc value.
   }
   
   

Pour en savoir plus sur les appels API de requête d’annonces, consultez la section Générer des annonces de produits.

📘

Si votre système utilise la mise en cache pour améliorer les performances en stockant temporairement des données ou du contenu, la valeur dtm_token_sc doit être incluse dans tous les appels liés aux événements d’impression et de clic. Grâce à ce processus, les interactions des utilisateurs sont correctement suivies, même lorsque les données sont fournies à partir du cache.

Étape 2a : mettre en œuvre le cache

Si vous avez intégré la fonctionnalité de mise en cache, assurez-vous que vous envoyez la valeur dtm_token_sc dans tous les appels liés aux événements d’impression et de clic.

Exemple d’événement d’impression

GET {integration}.citrusad.com/v1/resource/first-i/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Exemple d’événement de clic

GET {integration}.citrusad.com/v1/resource/second-c/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Étape 3 : transmettez la valeur dtm_token_sc dans les appels API de commande sur site

1. Incluez la valeur dtm_token_sc dans le champ dtmCookieId lorsque vous passez des appels API de commande sur site. Vous pourrez ainsi suivre et attribuer avec précision les interactions des utilisateurs.
2. Transmettez également le champ CustomerId dans le champ CustomerId pour faire correspondre les données de commande au profil du client, et ainsi faciliter la génération de rapports et d’analyses plus détaillés. La valeur CustomerId est disponible lorsque le client se connecte au site du détaillant.

Exemple de réponse

{
    "orders": [
       {
        "customerId": "npc-s243-ir",
        "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
        "sessionId": "5cat7-9964-4f",
        "dtmCookieId": " AAAF8xLBTA968AB6TOthAAAAAAE"
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",  
                  "quantity": 3, 
                  "regularUnitPrice": 1.00,
                  "totalOrderItemPriceAfterDiscounts": 3.00,
                  "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
                  "citrusDiscountAmount": 0.0,
                  "substitutedFor": null,
                  "sellerId": "seller_id_601_64"
                }
              ]
            }
    ]
}

Pour en savoir plus sur les appels API de requête d’annonces, consultez la section Synchroniser les données de commande via AP.