Configurer les remplacements de trains de données

Les remplacements de trains de données vous permettent de définir des configurations supplémentaires pour vos trains de données, qui sont transmises au réseau Edge via le SDK Web.

Vous pouvez ainsi déclencher des comportements de trains de données différents de ceux par défaut, sans créer de train de données ni modifier vos paramètres existants.

Le remplacement de la configuration du train de données comporte deux étapes :

  1. Tout d’abord, vous devez définir vos remplacements de configuration de trains de données sur la page de configuration des trains de données.
  2. Ensuite, vous devez envoyer les remplacements au réseau Edge par le biais d’une commande de SDK Web ou à l’aide de l’extension de balise du SDK Web.

Cet article décrit le processus de remplacement de configuration des trains de données de bout en bout pour chaque type de remplacement pris en charge.

IMPORTANT

Les remplacements de trains de données ne sont pris en charge que pour les intégrations du SDK Web. Les intégrations du SDK Mobile et de l’API Server ne prennent actuellement pas en charge les remplacements de trains de données.



Utilisez les remplacements de trains de données pour envoyer différentes données à différents trains de données. À l’inverse, ne les utilisez pas pour les cas d’utilisation de personnalisation ou les données de consentement.

Cas d’utilisation

Pour découvrir les avantages des remplacements de trains de données et leur utilisation, consultez les cas d’utilisation ci-dessous que la clientèle d’Adobe Experience Platform peut résoudre.

Collecte de données dans plusieurs zones géographiques

Une entreprise possède des sites web ou des sous-domaines distincts pour chaque pays dans lequel elle opère. Elle a configuré des trains de données distincts avec des suites de rapports d’analyse spécifiques, des jetons de propriété Adobe Target et des schémas spécifiques à chaque pays, ainsi que des jeux de données, des configurations Journey Optimizer, etc. L’entreprise dispose également d’un jeu global de configurations où toutes les données spécifiques à un pays sont agrégées.

Grâce aux remplacements de trains de données, l’entreprise peut acheminer dynamiquement le flux de données vers différents trains de données, au lieu du comportement par défaut consistant à envoyer des données à un train de données unique.

Voici un cas d’utilisation courant : vous envoyez certaines données à un train de données spécifique à un pays et d’autres données à un train de données global où les clientes et les clients effectuent une action importante, comme passer une commande ou mettre à jour leur profil utilisateur.

Différencier les profils et les identités pour chaque unité commerciale

Une entreprise qui dispose de plusieurs unités commerciales souhaite stocker les données spécifiques à chaque unité commerciale dans une sandbox Experience Platform dédiée.

Au lieu d’envoyer les données à un train de données par défaut, l’entreprise peut utiliser les remplacements de trains de données pour s’assurer que chaque unité commerciale dispose de son propre train de données pour recevoir les données.

Configurer les remplacements de trains de données dans l’interface utilisateur des trains de données

Les remplacements de configuration des trains de données vous permettent de modifier les configurations de trains de données suivantes :

  • Jeux de données d’événement Experience Platform
  • Jetons de propriété Adobe Target
  • Conteneurs de synchronisation d’identifiants Audience Manager
  • Suites de rapports Adobe Analytics

Remplacements de trains de données pour Adobe Target

Pour configurer les remplacements de trains de données pour un train de données Adobe Target, vous devez d’abord créer un train de données Adobe Target. Suivez la procédure pour configurer un train de données avec le service Adobe Target.

Une fois que vous avez créé le train de données, modifiez le service Adobe Target que vous avez ajouté et consultez la section Remplacements de jetons de propriété pour ajouter les remplacements de trains de données souhaités, comme illustré dans l’image ci-dessous. Ajoutez un jeton de propriété par ligne.

Copie d’écran de l’interface utilisateur des trains de données montrant les paramètres du service Adobe Target, avec les remplacements de jetons de propriété mis en surbrillance.

Une fois que vous avez ajouté les remplacements souhaités, enregistrez les paramètres du train de données.

La configuration des remplacements de trains de données pour Adobe Target est terminée. Vous pouvez maintenant envoyer les remplacements au réseau Edge via le SDK Web.

Remplacements de trains de données pour Adobe Analytics

Pour configurer les remplacements de trains de données d’un train de données Adobe Analytics, vous devez d’abord créer un train de données Adobe Analytics. Suivez la procédure pour configurer un train de données avec le service Adobe Analytics.

Une fois que vous avez créé le train de données, modifiez le service Adobe Analytics que vous avez ajouté et consultez la section Remplacements de suites de rapports pour ajouter les remplacements de trains de données souhaités, comme illustré dans l’image ci-dessous.

Sélectionnez Afficher le mode par lots pour activer la modification par lots des remplacements de suites de rapports. Vous pouvez copier et coller une liste de remplacements de suites de rapports. Saisissez une suite de rapports par ligne.

Copie d’écran de l’interface utilisateur des trains de données montrant les paramètres du service Adobe Analytics, avec les remplacements de suites de rapports mis en surbrillance.

Une fois que vous avez ajouté les remplacements souhaités, enregistrez les paramètres du train de données.

La configuration des remplacements de trains de données Adobe Analytics est terminée. Vous pouvez maintenant envoyer les remplacements au réseau Edge via le SDK Web.

Remplacements de trains de données pour les jeux de données d’événements Experience Platform

Pour configurer les remplacements de trains de données pour les jeux de données d’événements Experience Platform, vous devez d’abord créer un train de données Adobe Experience Platform. Suivez la procédure pour configurer un train de données avec le service Adobe Experience Platform.

Une fois que vous avez créé le train de données, modifiez le service Adobe Experience Platform que vous avez ajouté et sélectionnez l’option Ajouter un jeu de données d’événement pour ajouter un ou plusieurs jeux de données d’événement de remplacement, comme illustré dans l’image ci-dessous.

Copie d’écran de l’interface utilisateur des trains de données présentant les paramètres du service Adobe Experience Platform, avec les remplacements de jeux de données d’événement mis en surbrillance.

Une fois que vous avez ajouté les remplacements souhaités, enregistrez les paramètres du train de données.

Vous avez terminé la configuration des remplacements de trains de données Adobe Experience Platform. Vous pouvez maintenant envoyer les remplacements au réseau Edge via le SDK Web.

Remplacements de trains de données pour les conteneurs de synchronisation d’identifiants tiers

Avant de configurer les remplacements de trains de données pour les conteneurs de synchronisation d’identifiants tiers, vous devez créer un train de données. Pour ce faire, consultez la section Configurer un train de données.

Une fois que vous avez créé le train de données, accédez aux Options avancées et activez l’option Synchronisation des identifiants tiers.

Consultez ensuite la section Remplacements d’ID de conteneur pour ajouter les ID de conteneur que vous souhaitez remplacer par le paramètre par défaut, comme illustré dans l’image ci-dessous.

IMPORTANT

Les identifiants de conteneur doivent contenir des valeurs numériques, comme 1234567, et non des chaînes, telles que "1234567". Si vous envoyez une valeur de chaîne via le SDK Web en tant que remplacement d’identifiant de conteneur, vous recevrez une erreur.

Copie d’écran de l’interface utilisateur des trains de données montrant les paramètres des trains de données, avec les remplacements des conteneurs de synchronisation d’identifiants tiers mis en surbrillance.

Une fois que vous avez ajouté les remplacements souhaités, enregistrez les paramètres du train de données.

Vous avez terminé la configuration des remplacements de conteneurs de synchronisation d’identifiants. Vous pouvez maintenant envoyer les remplacements au réseau Edge via le SDK Web.

Envoyer les remplacements au réseau Edge via le SDK Web

REMARQUE

Au lieu d’envoyer les remplacements de configuration via les commandes du SDK Web, vous pouvez ajouter les remplacements de configuration à l’extension de balise du SDK Web.

Une fois que vous avez terminé la configuration des remplacements de trains de données dans l’interface utilisateur de la collecte de données, vous pouvez envoyer les remplacements au réseau Edge, via le SDK Web.

L’envoi des remplacements au réseau Edge via le SDK Web constitue la deuxième et dernière étape de l’activation des remplacements de configuration des trains de données.

Les remplacements de configuration de trains de données sont envoyés au réseau Edge par l’intermédiaire de la commande edgeConfigOverrides du SDK Web. Cette commande crée des remplacements de trains de données qui sont transmis au Edge Network dans la commande suivante, ou, dans le cas de la commande configure, pour chaque requête.

La commande edgeConfigOverrides crée des remplacements de trains de données qui sont transmis au Edge Network lors de la commande suivante, ou, dans le cas de configure, pour chaque requête.

Lorsqu’un remplacement de configuration est envoyé avec la commande configure, elle est incluse dans les commandes suivantes du SDK Web.

Les options spécifiées globalement peuvent être remplacées par l’option de configuration des commandes individuelles.

Envoyer des remplacements de configuration via la commande sendEvent

L’exemple ci-dessous illustre le remplacement d’une configuration à l’aide de la commande sendEvent.

alloy("sendEvent", {
  xdm: {
    /* ... */
  },
  edgeConfigOverrides: {
    datastreamId: "{DATASTREAM_ID}"
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "MyOverrideDataset"
        },
        profile: {
          datasetId: "www"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
        ]
    },
    com_adobe_identity: {
      idSyncContainerId: "1234567"
    },
    com_adobe_target: {
      propertyToken: "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    }
  }
});
Paramètre Description
edgeConfigOverrides.datastreamId Ce paramètre permet à une requête unique d’accéder à un train de données différent de celui défini par la commande configure.

Envoyer des remplacements de configuration via la commande configure

L’exemple ci-dessous illustre le remplacement d’une configuration à l’aide de la commande configure.

alloy("configure", {
  defaultConsent: "in",
  edgeDomain: "etc",
  edgeBasePath: "ee",
  datastreamId: "{DATASTREAM_ID}",
  orgId: "org",
  debugEnabled: true,
  edgeConfigOverrides: {
    "com_adobe_experience_platform": {
      "datasets": {
        "event": {
          datasetId: "MyOverrideDataset"
        },
        "profile": {
          datasetId: "www"
        }
      }
    },
    "com_adobe_analytics": {
      "reportSuites": [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
      ]
    },
    "com_adobe_identity": {
      "idSyncContainerId": "1234567"
    },
    "com_adobe_target": {
      "propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    }
  },
  onBeforeEventSend: function() { /* … */ });
};

Exemple de payload

Les exemples ci-dessus génèrent une payload Edge Network qui ressemble à ceci :

{
  "meta": {
    "configOverrides": {
      "com_adobe_experience_platform": {
        "datasets": {
          "event": {
            "datasetId": "MyOverrideDataset"
          },
          "profile": {
            "datasetId": "www"
          }
        }
      },
      "com_adobe_analytics": {
        "reportSuites": [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
        ]
      },
      "com_adobe_identity": {
        "idSyncContainerId": "1234567"
      },
      "com_adobe_target": {
        "propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
      }
    },
    "state": {  }
  },
  "events": [  ],
  "query": {
    "identity": {
      "fetch": [
        "ECID"
      ]
    }
  }
}

Sur cette page