Configurer les remplacements de trains de données
La variable edgeConfigOverrides
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 votre remplacement de configuration du flux de données dans la variable page de configuration de datastream, dans l’interface utilisateur des flux de données. Voir remplacements de la configuration du flux de données documentation pour obtenir des instructions sur la configuration des remplacements.
-
Après avoir configuré le remplacement de la banque de données dans l’interface utilisateur, vous devez envoyer les remplacements au réseau Edge de l’une des manières suivantes :
- Par le biais du SDK Web extension de balise.
- Par le biais de la
sendEvent
ouconfigure
Commandes du SDK Web. - Via le SDK Mobile
sendEvent
.
Si vous définissez des valeurs de remplacement dans la configuration du SDK Web et dans une commande spécifique (telle que sendEvent
), les remplacements dans la commande spécifique sont prioritaires.
Propriétés de l’objet
Les propriétés suivantes sont disponibles dans cet objet :
- Remplacement du flux de données: envoie des appels à un autre flux de données. Si vous définissez cette valeur, d’autres remplacements qui nécessitent la configuration du flux de données doivent être configurés dans le flux de données défini ici.
- Conteneur de synchronisation des identifiants tiers: identifiant du conteneur de synchronisation des identifiants tiers de destination dans Adobe Audience Manager. La configuration d’un remplacement de conteneur d’ID tiers dans les paramètres de la banque de données est requise avant d’utiliser ce champ.
- Jeton de propriété Target: jeton de la propriété de destination dans Adobe Target. Avant d’utiliser ce champ, vous devez configurer un remplacement de jeton de propriété Target dans les paramètres de la banque de données.
- Suites de rapports: identifiants de suite de rapports à remplacer dans Adobe Analytics. Avant d’utiliser ce champ, vous devez configurer les remplacements de suite de rapports dans les paramètres de la banque de données.
Envoi des remplacements de flux de données vers le réseau Edge par le biais de l’extension de balise SDK Web tag-extension
Consultez la documentation relative à configuration des remplacements de flux de données à partir de l’extension de balise SDK Web pour obtenir des instructions de configuration détaillées.
Si vous souhaitez configurer les remplacements de flux de données à partir de l’extension de balise SDK Web, définissez chaque champ de votre choix sous Remplacements de la configuration des flux de données when configuration de l’extension de balise.
- Connexion à 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 le SDK Web Adobe Experience Platform carte.
- Faites défiler l’écran vers le bas jusqu’à Remplacements de la configuration des 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.
- Connexion à 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 à Règles, puis sélectionnez la règle de votre choix.
- Sous Actions, sélectionnez une action existante ou créez-en une.
- Définissez la variable Extension du champ déroulant vers SDK Web Adobe Experience Platform, puis définissez la variable Type d’action to Envoyer un événement.
- Faites défiler jusqu’à la section intitulée Remplacements de la configuration des 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 workflow de publication.
Des champs distincts sont fournis pour Développement, Évaluation, et Production des environnements. Veillez à renseigner chaque champ souhaité pour chaque environnement.
Envoyez les remplacements au réseau Edge via la bibliothèque JavaScript du SDK Web library
Après configuration des remplacements de la banque de données Dans l’interface utilisateur de la collecte de données, vous pouvez désormais envoyer les remplacements au réseau Edge, par l’intermédiaire de la bibliothèque JavaScript du SDK Web.
Si vous utilisez un SDK Web, envoyez les remplacements au réseau Edge via le edgeConfigOverrides
est la deuxième et dernière étape d’activation des remplacements de configuration datastream.
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 à la variable Edge Network sur la commande suivante. Si vous utilisez la variable configure
, les remplacements sont transmis pour chaque requête.
La variable edgeConfigOverrides
crée des remplacements de flux de données qui sont transmis au 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 de remplacements de configuration via le SDK Web sendEvent
command send-event
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: "SampleEventDatasetIdOverride"
}
}
},
com_adobe_analytics: {
reportSuites: [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
com_adobe_identity: {
idSyncContainerId: "1234567"
},
com_adobe_target: {
propertyToken: "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
}
});
edgeConfigOverrides.datastreamId
configure
.com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken
Envoi de remplacements de configuration via le SDK Web configure
command send-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: "SampleProfileDatasetIdOverride"
}
}
},
"com_adobe_analytics": {
"reportSuites": [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
"com_adobe_identity": {
"idSyncContainerId": "1234567"
},
"com_adobe_target": {
"propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
},
onBeforeEventSend: function() { /* … */ });
};
edgeConfigOverrides.datastreamId
configure
.com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken