Konfigurieren von Datenstromüberschreibungen
Mit dem Objekt edgeConfigOverrides
können Sie Konfigurationseinstellungen für Befehle überschreiben, die auf der aktuellen Seite ausgeführt werden. Dieses Override-Objekt ist kein Befehl, sondern ein Objekt, das Sie in die meisten Web SDK-Befehle einbeziehen können.
Dieses Objekt ist nützlich, wenn Sie verschiedene Websites oder Subdomänen für verschiedene Länder haben oder wenn Sie mehrere Experience Platform-Sandboxes zum Speichern von Daten haben, die für verschiedene Geschäftseinheiten spezifisch sind.
Die Außerkraftsetzung der Datastream-Konfiguration erfolgt in zwei Schritten:
-
Zunächst müssen Sie Ihre Außerkraftsetzung der Datastraam-Konfiguration auf der Datastream-Konfigurationsseite in der Benutzeroberfläche von Datastreams definieren. Anweisungen zum Konfigurieren von Überschreibungen finden Sie in der Dokumentation Überschreibungen der Datastream-Konfiguration .
-
Nachdem Sie das Überschreiben des Datastreams in der Benutzeroberfläche konfiguriert haben, müssen Sie die Überschreibungen auf eine der folgenden Arten an das Edge Network senden:
- Über die Web SDK Tag-Erweiterung.
- Über die Befehle
sendEvent
oderconfigure
Web SDK. - Über den Mobile SDK-Befehl
sendEvent
.
Wenn Sie Überschreibungen sowohl in der Web SDK-Konfiguration als auch in einem bestimmten Befehl (z. B. sendEvent
) festlegen, haben die Überschreibungen im spezifischen Befehl Priorität.
Senden von Datastream-Überschreibungen an das Edge Network über die Web SDK-Tag-Erweiterung tag-extension
Detaillierte Konfigurationsanweisungen finden Sie in der Dokumentation zu Konfigurieren von Datastream Overrides der Web SDK-Tag-Erweiterung.
Wenn Sie Datastream-Überschreibungen aus der Web SDK-Tag-Erweiterung konfigurieren möchten, legen Sie jedes gewünschte Feld unter Datastream-Konfiguration überschreibt fest, wenn die Tag-Erweiterung konfigurieren.
- Melden Sie sich mit Ihren Adobe ID-Anmeldedaten bei experience.adobe.com an.
- Navigieren Sie zu Datenerfassung > Tags.
- Wählen Sie die gewünschte Tag-Eigenschaft aus.
- Navigieren Sie zu Erweiterungen und klicken Sie dann auf der Karte Adobe Experience Platform Web SDK auf Konfigurieren .
- Scrollen Sie nach unten zum Abschnitt Datastream configuration overrides . Legen Sie jeden gewünschten Überschreibungswert fest.
- Klicken Sie auf Speichern und veröffentlichen Sie dann Ihre Änderungen.
Wenn Sie Überschreibungen nur für einen bestimmten Befehl festlegen möchten, legen Sie jedes gewünschte Feld innerhalb der Aktionen einer Tag-Regel fest.
- Melden Sie sich mit Ihren Adobe ID-Anmeldedaten bei experience.adobe.com an.
- Navigieren Sie zu Datenerfassung > Tags.
- Wählen Sie die gewünschte Tag-Eigenschaft aus.
- Navigieren Sie zu Regeln und wählen Sie dann die gewünschte Regel aus.
- Wählen Sie unter Aktionen eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Setzen Sie das Dropdown-Feld Erweiterung auf Adobe Experience Platform Web SDK und legen Sie den Aktionstyp auf Ereignis senden fest.
- Scrollen Sie nach unten zum Abschnitt mit der Bezeichnung Außerkraftsetzungen der Datastream-Konfiguration.
- Legen Sie für jedes Feld in diesem Abschnitt den gewünschten Wert zum Außerkraftsetzen fest.
- Klicken Sie auf Änderungen beibehalten und führen Sie dann Ihren Veröffentlichungs-Workflow aus.
Separate Felder werden für die Umgebungen Entwicklung, Staging und Produktion bereitgestellt. Vergewissern Sie sich, dass Sie jedes gewünschte Feld für jede Umgebung ausfüllen.
Senden der Überschreibungen an das Edge Network über die Web SDK JavaScript-Bibliothek library
Nachdem das Konfigurieren des Datastreamsin der Datenerfassungs-Benutzeroberfläche konfiguriert hat, können Sie die Überschreibungen jetzt über die Web SDK JavaScript-Bibliothek an das Edge Network senden.
Wenn Sie das Web SDK verwenden, ist das Senden der Überschreibungen an das Edge Network über den Befehl edgeConfigOverrides
der zweite und letzte Schritt bei der Aktivierung von Überschreibungen der Datastream-Konfiguration.
Die Überschreibungen der Datenstromkonfiguration werden über den Web SDK-Befehl edgeConfigOverrides
gesendet. Mit diesem Befehl werden Datastream-Überschreibungen erstellt, die beim nächsten Befehl an Edge Network übergeben werden. Wenn Sie den Befehl configure
verwenden, werden die Überschreibungen für jede Anfrage übergeben.
Mit dem Befehl edgeConfigOverrides
werden Datastream-Überschreibungen erstellt, die beim nächsten Befehl an die Edge Network übergeben werden.
Wenn eine Konfigurationsüberschreibung mit dem Befehl configure
gesendet wird, ist sie in den folgenden Web SDK-Befehlen enthalten.
Global angegebene Optionen können durch die Konfigurationsoption bei einzelnen Befehlen überschrieben werden.
Senden von Konfigurationsüberschreibungen über den Web SDK sendEvent
-Befehl send-event
Das folgende Beispiel zeigt alle Konfigurationsoptionen für dynamische Datastreams, die bei einem sendEvent
-Aufruf unterstützt werden.
Wenn für Ihre Datastream-Konfiguration alle unterstützten Dienste aktiviert sind, überschreibt das Beispiel unten diese Einstellung und deaktiviert alle Dienste (siehe die Einstellung enabled: false
für jeden Dienst).
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
definierten gehen kann.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
auf true
setzen. Andernfalls ist der Audience Manager-Dienst deaktiviert.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf
Senden von Konfigurationsüberschreibungen über den Web SDK configure
-Befehl send-configure
Das folgende Beispiel zeigt, wie eine Konfigurationsüberschreibung beim Befehl configure
aussehen könnte.
Wenn für Ihre Datastream-Konfiguration alle unterstützten Dienste aktiviert sind, überschreibt das Beispiel unten diese Einstellung und deaktiviert alle Dienste (siehe die Einstellung enabled: false
für jeden Dienst).
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
definierten gehen kann.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
auf true
setzen. Andernfalls ist der Audience Manager-Dienst deaktiviert.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf