Konfigurieren von Datenstromüberschreibungen
Die edgeConfigOverrides
-Objekt 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 Datastream-Konfigurationsüberschreibungen im Datastream-Konfigurationsseite, in der Benutzeroberfläche von Datastreams. Siehe Überschreibungen der Datenspeicherkonfiguration Dokumentation für Anweisungen zum Konfigurieren von Außerkraftsetzungen.
-
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-Netzwerk senden:
- Über das Web SDK Tag-Erweiterung.
- Durch die
sendEvent
oderconfigure
Web SDK-Befehle. - Über das Mobile SDK
sendEvent
Befehl.
Wenn Sie Überschreibungen sowohl in der Web SDK-Konfiguration als auch in einem bestimmten Befehl festlegen (z. B. sendEvent
), haben die Überschreibungen im spezifischen Befehl Priorität.
Objekteigenschaften
Die folgenden Eigenschaften sind in diesem Objekt verfügbar:
- Datastream override: Senden Sie Aufrufe an einen anderen Datenspeicher. Wenn Sie diesen Wert festlegen, müssen andere Überschreibungen, die eine Konfiguration des Datenspeichers erfordern, im hier festgelegten Datastream konfiguriert werden.
- ID-Synchronisierungs-Container von Drittanbietern: Die ID für den Ziel-ID-Synchronisierungs-Container von Drittanbietern in Adobe Audience Manager. Bevor Sie dieses Feld verwenden, ist es erforderlich, einen Drittanbieter-ID-Container zu konfigurieren, der in den Einstellungen des Datenspeichers überschrieben wird.
- Target-Eigenschafts-Token: Das Token für die Ziel-Property in Adobe Target. Bevor Sie dieses Feld verwenden, ist es erforderlich, eine Target-Eigenschafts-Token-Überschreibung in den Einstellungen des Datastreams zu konfigurieren.
- Report Suites: Die Report Suite-IDs, die in Adobe Analytics überschrieben werden sollen. Vor der Verwendung dieses Felds ist es erforderlich, die Report Suite-Überschreibung in den Einstellungen des Datenspeichers zu konfigurieren.
Senden von Datastream-Überschreibungen an das Edge-Netzwerk über die Web SDK-Tag-Erweiterung tag-extension
Siehe die Dokumentation unter Konfigurieren von Überschreibungen von Datastreams von der Web SDK-Tag-Erweiterung , um detaillierte Konfigurationsanweisungen zu erhalten.
Wenn Sie Datastream-Überschreibungen aus der Web SDK-Tag-Erweiterung konfigurieren möchten, legen Sie jedes gewünschte Feld unter Überschreibungen der Datastream-Konfiguration when Konfigurieren der Tag-Erweiterung.
- Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
- Navigieren Sie zu Datenerfassung > Tags.
- Wählen Sie die gewünschte Tag-Eigenschaft aus.
- Navigieren Sie zu Erweiterungen Klicken Sie auf Konfigurieren auf Adobe Experience Platform Web SDK Karte.
- Scrollen Sie nach unten zum Überschreibungen der Datastream-Konfiguration Abschnitt. Legen Sie jeden gewünschten Überschreibungswert fest.
- Klicks 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.
- Anmelden bei experience.adobe.com mit Ihren Adobe ID-Anmeldedaten.
- 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.
- under Aktionen, wählen Sie eine vorhandene Aktion aus oder erstellen Sie eine Aktion.
- Legen Sie die Erweiterung Dropdown-Feld zu Adobe Experience Platform Web SDK und legen Sie die Aktionstyp nach Ereignis senden.
- Scrollen Sie nach unten zum Abschnitt mit der Bezeichnung Überschreibungen der Datastream-Konfiguration.
- Legen Sie für jedes Feld in diesem Abschnitt den gewünschten Wert zum Außerkraftsetzen fest.
- Klicks Änderungen beibehalten und führen Sie dann Ihren Veröffentlichungs-Workflow aus.
Separate Felder werden bereitgestellt für Entwicklung, Staging, und Produktion Umgebungen. Vergewissern Sie sich, dass Sie jedes gewünschte Feld für jede Umgebung ausfüllen.
Senden der Überschreibungen an das Edge-Netzwerk über die Web SDK-JavaScript-Bibliothek library
Nachher Konfigurieren der Überschreibungen des Datastreams In der Datenerfassungs-Benutzeroberfläche können Sie die Überschreibungen jetzt über die Web SDK-JavaScript-Bibliothek an das Edge-Netzwerk senden.
Wenn Sie das Web SDK verwenden, senden Sie die Überschreibungen über das edgeConfigOverrides
-Befehl ist der zweite und letzte Schritt zum Aktivieren 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 an die Edge Network auf dem nächsten Befehl. Wenn Sie die configure
-Befehl, werden die Überschreibungen für jede Anfrage übergeben.
Die edgeConfigOverrides
-Befehl erstellt Datastream-Überschreibungen, die an die Edge Network auf dem nächsten Befehl.
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 das Web SDK sendEvent
command send-event
Das folgende Beispiel zeigt, wie eine Konfigurationsüberschreibung beim Befehl sendEvent
aussehen könnte.
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
definierten gehen kann.com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken
Senden von Konfigurationsüberschreibungen über das Web SDK configure
command send-configure
Das folgende Beispiel zeigt, wie eine Konfigurationsüberschreibung beim Befehl configure
aussehen könnte.
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
definierten gehen kann.com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken