Configurer les remplacements de trains de données
L’objet edgeConfigOverrides
vous permet de remplacer les paramètres de configuration des commandes exécutées sur la page active. Cet objet de remplacement n’est pas une commande, mais plutôt un objet que vous pouvez inclure dans la plupart des commandes du SDK Web.
Cet objet est utile lorsque vous disposez de différents sites web ou sous-domaines pour différents pays ou si vous disposez de plusieurs environnements de test Experience Platform pour stocker des données spécifiques à différentes unités opérationnelles.
Le remplacement de la configuration du flux de données est un processus en deux étapes :
-
Tout d’abord, vous devez définir le remplacement de la configuration de la banque de données dans la page de configuration de la banque de données, dans l’interface utilisateur des flux de données. Pour obtenir des instructions sur la configuration des remplacements, reportez-vous à la documentation Remplacements de configuration de la banque de données .
-
Après avoir configuré le remplacement de la banque de données dans l’interface utilisateur, vous devez envoyer les remplacements à l’Edge Network de l’une des manières suivantes :
- Par le biais du SDK Web extension de balise.
- Par le biais des commandes du SDK Web
sendEvent
ouconfigure
. - Par le biais de la commande SDK Mobile
sendEvent
.
Si vous définissez des remplacements dans la configuration du SDK Web et dans une commande spécifique (telle que sendEvent
), ceux de la commande spécifique sont prioritaires.
Envoi des remplacements de la banque de données à l’Edge Network par le biais de l’extension de balise SDK Web tag-extension
Pour obtenir des instructions de configuration détaillées, reportez-vous à la documentation sur la configuration des remplacements de jeux de données à partir de l’extension de balise SDK Web.
Si vous souhaitez configurer les remplacements de la banque de données à partir de l’extension de balise SDK Web, définissez chaque champ de votre choix sous Remplacements de configuration de la banque de données lors de la configuration de l’extension de balise.
- Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Extensions, puis cliquez sur Configurer sur la carte SDK Web Adobe Experience Platform.
- Faites défiler l’écran jusqu’à la section Remplacements de configuration du flux de données . Définissez chaque valeur de remplacement souhaitée.
- Cliquez sur Enregistrer, puis publiez vos modifications.
Si vous souhaitez définir des remplacements uniquement pour une commande spécifique, définissez chaque champ de votre choix dans les actions d’une règle de balise.
- Connectez-vous à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Rules, puis sélectionnez la règle de votre choix.
- Sous Actions, sélectionnez une action existante ou créez une action.
- Définissez le champ déroulant Extension sur SDK Web Adobe Experience Platform et définissez le Type d’action sur Envoyer l’événement.
- Faites défiler l’écran jusqu’à la section intitulée Remplacements de configuration du flux de données.
- Définissez chaque champ de cette section sur la valeur de remplacement souhaitée.
- Cliquez sur Conserver les modifications, puis exécutez votre processus de publication.
Des champs distincts sont fournis pour les environnements Development, Staging et Production. Veillez à renseigner chaque champ souhaité pour chaque environnement.
Envoyer les remplacements à l’Edge Network via la bibliothèque JavaScript SDK Web library
Après avoir configuré les remplacements de la banque de données dans l’interface utilisateur de collecte de données, vous pouvez désormais envoyer les remplacements à l’Edge Network, via la bibliothèque JavaScript du SDK Web.
Si vous utilisez le SDK Web, l’envoi des remplacements à l’Edge Network via la commande edgeConfigOverrides
constitue la deuxième et dernière étape de l’activation des remplacements de configuration de la banque 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 flux de données qui sont transmis à Edge Network sur la commande suivante. Si vous utilisez la commande configure
, les remplacements sont transmis pour chaque requête.
La commande edgeConfigOverrides
crée des remplacements de la banque de données qui sont transmis à Edge Network sur la commande suivante.
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.
Envoi des remplacements de configuration via la commande SDK Web sendEvent
send-event
L’exemple ci-dessous montre toutes les options de configuration de la chaîne de données dynamique prises en charge lors d’un appel sendEvent
.
Si tous les services pris en charge sont activés pour votre configuration de flux de données, l’exemple ci-dessous remplace ce paramètre et désactive tous les services (voir le paramètre enabled: false
sur chaque service).
alloy("sendEvent", {
renderDecisions: true,
edgeConfigOverrides: {
datastreamId: "bfa8fe21-6157-42d3-b47a-78310920b39d",
com_adobe_experience_platform: {
enabled: false,
datasets: {
event: {
datasetId: "64b6f949a8a6891ca8a28911",
},
},
com_adobe_edge_ode: {
enabled: false,
},
com_adobe_edge_segmentation: {
enabled: false,
},
com_adobe_edge_destinations: {
enabled: false,
},
com_adobe_edge_ajo: {
enabled: false,
},
},
com_adobe_analytics: {
enabled: false,
reportSuites: ["ujslconfigoverrides3"],
},
com_adobe_identity: {
idSyncContainerId: 34374,
},
com_adobe_target: {
enabled: false,
propertyToken: "f3fd55e1-a06d-8650-9aa5-c8356c6e2223",
},
com_adobe_audience_manager: {
enabled: false,
},
com_adobe_launch_ssf: {
enabled: false,
},
},
});
renderDecisions
edgeConfigOverrides.datastreamId
configure
.edgeConfigOverrides.com_adobe_experience_platform
edgeConfigOverrides.com_adobe_experience_platform.enabled
edgeConfigOverrides.com_adobe_experience_platform.datasets
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ajo.enabled
com_adobe_analytics.enabled
com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_audience_manager.enabled
sur true
. Sinon, le service d’Audience Manager est désactivé.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf
Envoi des remplacements de configuration via la commande SDK Web configure
send-configure
L’exemple ci-dessous illustre le remplacement d’une configuration à l’aide de la commande configure
.
Si tous les services pris en charge sont activés pour votre configuration de flux de données, l’exemple ci-dessous remplace ce paramètre et désactive tous les services (voir le paramètre enabled: false
sur chaque service).
alloy("configure", {
orgId: "97D1F3F459CE0AD80A495CBE@AdobeOrg",
datastreamId: "db9c70a1-6f11-4563-b0e9-b5964ab3a858",
edgeConfigOverrides: {
com_adobe_experience_platform: {
enabled: false,
datasets: {
event: {
datasetId: "64b6f930753dd41ca8d4fd77",
},
},
com_adobe_edge_ode: {
enabled: false,
},
com_adobe_edge_segmentation: {
enabled: false,
},
com_adobe_edge_destinations: {
enabled: false,
},
com_adobe_edge_ajo: {
enabled: false,
},
},
com_adobe_analytics: {
enabled: false,
reportSuites: ["ujslconfigoverrides2"],
},
com_adobe_identity: {
idSyncContainerId: 34373,
},
com_adobe_target: {
enabled: false,
propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94",
},
com_adobe_audience_manager: {
enabled: false,
},
com_adobe_launch_ssf: {
enabled: false,
},
},
});
orgId
edgeConfigOverrides.datastreamId
configure
.edgeConfigOverrides.com_adobe_experience_platform
edgeConfigOverrides.com_adobe_experience_platform.enabled
edgeConfigOverrides.com_adobe_experience_platform.datasets
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ajo.enabled
com_adobe_analytics.enabled
com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_audience_manager.enabled
sur true
. Sinon, le service d’Audience Manager est désactivé.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf