Konfigurieren von Datenstromüberschreibungen

Mit Datenstromüberschreibungen können Sie zusätzliche Konfigurationen für Ihre Datenströme definieren, die über das Web SDK an das Edge-Netzwerk übergeben werden.

Dies hilft Ihnen beim Auslösen anderer Datenstromverhaltensweisen als der standardmäßigen, ohne einen neuen Datenstrom zu erstellen oder Ihre vorhandenen Einstellungen zu ändern.

Das Überschreiben der Datenstromkonfiguration besteht aus zwei Schritten:

  1. Zunächst müssen Sie Ihre Überschreibungen der Datenstromkonfiguration auf der Seite Datenstromkonfiguration definieren.
  2. Anschließend müssen Sie die Überschreibungen entweder über einen Web SDK-Befehl oder mithilfe der Tag-Erweiterung des Web SDK an das Edge-Netzwerk senden.

In diesem Artikel wird der Prozess zur Überschreibung der End-to-End-Datenstromkonfiguration für jeden unterstützten Überschreibungstyp erläutert.

WICHTIG

Datenstromüberschreibungen werden nur für Web SDK-Integrationen unterstützt. Mobile SDK- und Server-API-Integrationen unterstützen derzeit keine Datenstromüberschreibungen.



Datenstromüberschreibungen sollten verwendet werden, wenn Sie verschiedene Daten an verschiedene Datenströme senden müssen. Sie sollten keine Datenstromüberschreibungen für Personalisierungsanwendungsfälle oder Einverständnisdaten verwenden.

Anwendungsfälle

Damit Sie besser verstehen können, wie und wann Sie Datenstromüberschreibungen verwenden sollten, finden Sie hier einige Beispiele für Anwendungsfälle, die Kundinnen und Kunden von Adobe Experience Platform mit dieser Funktion bewältigen können.

Datenerfassung für mehrere Regionen

Ein Unternehmen hat verschiedene Websites oder Subdomains für verschiedene Länder, in denen es tätig ist. Es hat separate Datenströme mit entsprechenden analysespezifischen Report Suites, länderspezifischen Adobe Target-Eigenschafts-Token, länderspezifischen Schemata, Datensätzen, Journey Optimizer-Konfigurationen usw. konfiguriert. Das Unternehmen verfügt außerdem über einen globalen Satz an Konfigurationen, in denen alle landesspezifischen Daten aggregiert werden.

Durch die Verwendung von Datenstromüberschreibungen kann das Unternehmen den Datenfluss dynamisch in verschiedene Datenströme umstellen, anstatt das Standardverhalten zu ändern, Daten an einen Datenstrom zu senden.

Ein gängiger Anwendungsfall könnte darin bestehen, Daten an einen länderspezifischen Datenstrom zu senden und Daten auch an einen globalen Datenstrom zu senden, wo Kundinnen und Kunden wichtige Aktionen ausführen, wie z. B. eine Bestellung aufgeben oder ihr Benutzerprofil aktualisieren.

Unterscheiden von Profilen und Identitäten für verschiedene Geschäftseinheiten

Ein Unternehmen mit mehreren Geschäftseinheiten möchte mehrere Experience Platform-Sandboxes verwenden, um Daten zu speichern, die für jede Geschäftseinheit spezifisch sind.

Anstatt Daten an einen standardmäßigen Datenstrom zu senden, kann das Unternehmen Datenstromüberschreibungen verwenden, um sicherzustellen, dass jede Geschäftseinheit über einen eigenen Datenstrom verfügt, über den Daten empfangen werden können.

Konfigurieren von Datenstromüberschreibungen in der Datenstrom-Benutzeroberfläche

Überschreibungen der Datenstromkonfiguration ermöglichen es Ihnen, die folgenden Datenstromkonfigurationen zu ändern:

  • Experience Platform-Ereignisdatensätze
  • Adobe Target-Eigenschafts-Token
  • Audience Manager-ID-Synchronisierungs-Container
  • Report Suites in Adobe Analytics

Datenstromüberschreibungen für Adobe Target

Um Datenstromüberschreibungen für einen Adobe Target-Datenstrom zu konfigurieren, müssen Sie zunächst einen Adobe Target-Datenstrom erstellen lassen. Befolgen Sie die Anweisungen, mit dem Adobe Target-Dienst einen Datenstrom zu konfigurieren.

Nachdem Sie den Datenstrom erstellt haben, bearbeiten Sie den Adobe Target-Dienst, den Sie hinzugefügt haben, und verwenden Sie den Abschnitt Eigenschafts-Token-Überschreibungen, um die gewünschten Datenstromüberschreibungen hinzuzufügen, wie in der Abbildung unten dargestellt. Fügen Sie pro Zeile ein Eigenschafts-Token hinzu.

Screenshot der Datenstrom-Benutzeroberfläche mit den Einstellungen des Adobe Target-Dienstes, wobei die Eigenschafts-Token-Überschreibungen hervorgehoben sind.

Nachdem Sie die gewünschten Überschreibungen hinzugefügt haben, speichern Sie Ihre Datenstromeinstellungen.

Ihre Adobe Target-Datenstromüberschreibungen sollten jetzt konfiguriert sein. Jetzt können Sie die Überschreibungen über das Web SDK an das Edge-Netzwerk senden.

Datenstromüberschreibungen für Adobe Analytics

Um Datenstromüberschreibungen für einen Adobe Analytics-Datenstrom zu konfigurieren, müssen Sie zunächst einen Adobe Analytics-Datenstrom erstellen lassen. Befolgen Sie die Anweisungen, mit dem Adobe Analytics-Dienst einen Datenstrom zu konfigurieren.

Nachdem Sie den Datenstrom erstellt haben, bearbeiten Sie den Adobe Analytics-Dienst, den Sie hinzugefügt haben, und verwenden Sie den Abschnitt Report Suite-Überschreibungen, um die gewünschten Datenstromüberschreibungen hinzuzufügen, wie in der Abbildung unten dargestellt.

Wählen Sie Batch-Modus anzeigen aus, um die Stapelbearbeitung der Report Suite-Überschreibungen zu aktivieren. Sie können eine Liste mit Report Suite-Überschreibungen kopieren und einfügen und dabei pro Zeile eine Report Suite eingeben.

Screenshot der Datenstrom-Benutzeroberfläche mit den Einstellungen des Adobe Analytics-Dienstes, wobei die Report Suite-Überschreibungen hervorgehoben sind.

Nachdem Sie die gewünschten Überschreibungen hinzugefügt haben, speichern Sie Ihre Datenstromeinstellungen.

Ihre Adobe Analytics-Datenstromüberschreibungen sollten jetzt konfiguriert sein. Jetzt können Sie die Überschreibungen über das Web SDK an das Edge-Netzwerk senden.

Datenstromüberschreibungen für Experience Platform-Ereignisdatensätze

Um Datenstromüberschreibungen für Experience Platform-Ereignisdatensätze zu konfigurieren, müssen Sie zunächst einen Adobe Experience Platform-Datenstrom erstellt haben. Befolgen Sie die Anweisungen, mit dem Adobe Experience Platform-Dienst einen Datenstrom zu konfigurieren.

Nachdem Sie den Datenstrom erstellt haben, bearbeiten Sie den Adobe Experience Platform-Dienst, den Sie hinzugefügt haben, und wählen Sie die Option Ereignisdatensatz hinzufügen aus, um einen oder mehrere Ereignisdatensätze zur Überschreibung hinzuzufügen, wie in der Abbildung unten dargestellt.

Screenshot der Datenstrom-Benutzeroberfläche mit den Einstellungen des Adobe Experience Platform-Dienstes, wobei die Überschreibungen des Ereignisdatensatzes hervorgehoben sind.

Nachdem Sie die gewünschten Überschreibungen hinzugefügt haben, speichern Sie Ihre Datenstromeinstellungen.

Sie sollten jetzt die Adobe Experience Platform-Datenstromüberschreibungen konfiguriert haben. Jetzt können Sie die Überschreibungen über das Web SDK an das Edge-Netzwerk senden.

Datenstromüberschreibungen für ID-Synchronisierungs-Container von Drittanbietern

Um Datenstromüberschreibungen für ID-Synchronisierungs-Container von Drittanbietern zu konfigurieren, müssen Sie zunächst einen Datenstrom erstellen lassen. Befolgen Sie die Anweisungen zum Konfigurieren eines Datenstroms, um einen Datenstrom zu erstellen.

Nachdem Sie den Datenstrom erstellt haben, navigieren Sie zu Erweiterte Optionen und aktivieren Sie die Option Synchronisierung der Drittanbieter-ID.

Verwenden Sie dann den Abschnitt Container-ID-Überschreibungen, um die Container-IDs hinzuzufügen, für die Sie die Standardeinstellung überschreiben möchten, wie in der Abbildung unten dargestellt.

WICHTIG

Container-IDs müssen numerische Werte sein, z. B. 1234567, nicht aber Zeichenfolgen wie "1234567". Wenn Sie einen Zeichenfolgenwert über das Web SDK als Container-ID-Überschreibung senden, erhalten Sie einen Fehler.

Screenshot der Datenstrom-Benutzeroberfläche mit den Einstellungen des Datenstroms, wobei der Container für die ID-Synchronisierung von Drittanbietern hervorgehoben ist.

Nachdem Sie die gewünschten Überschreibungen hinzugefügt haben, speichern Sie Ihre Datenstromeinstellungen.

Sie sollten jetzt die Überschreibungen des ID-Synchronisierungs-Containers konfiguriert haben. Jetzt können Sie die Überschreibungen über das Web SDK an das Edge-Netzwerk senden.

Senden der Überschreibungen an das Edge-Netzwerk über das Web SDK

HINWEIS

Alternativ zum Senden der Konfigurationsüberschreibungen über Web SDK-Befehle können Sie auch die Konfigurationsüberschreibungen zur Tag-Erweiterung des Web SDK hinzufügen.

Nach dem Konfigurieren der Datenstromüberschreibungen in der Datenerfassungs-Benutzeroberfläche können Sie die Überschreibungen jetzt über das Web SDK an das Edge-Netzwerk senden.

Das Senden der Überschreibungen an das Edge-Netzwerk über das Web SDK ist der zweite und letzte Schritt beim Aktivieren von Überschreibungen der Datenstromkonfiguration.

Die Überschreibungen der Datenstromkonfiguration werden über den Web SDK-Befehl edgeConfigOverrides gesendet. Mit diesem Befehl werden Datenstromüberschreibungen erstellt, die mit dem nächsten Befehl (bzw. im Fall des Befehls configure mit jeder Anfrage) an das Edge Network weitergegeben werden.

Der Befehl edgeConfigOverrides erstellt Datenstromüberschreibungen, die mit dem nächsten Befehl (bzw. im Fall des Befehls configure mit jeder Anfrage) an das Edge Network weitergegeben 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 Befehl sendEvent

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: "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"
    }
  }
});
Parameter Beschreibung
edgeConfigOverrides.datastreamId Verwenden Sie diesen Parameter, um zuzulassen, dass eine einzelne Anfrage an einen anderen Datenstrom als den vom Befehl configure definierten gehen kann.

Senden von Konfigurationsüberschreibungen über den Befehl 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: "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() { /* … */ });
};

Payload-Beispiel

Die obigen Beispiele generieren eine Edge Network-Payload, die wie folgt aussieht:

{
  "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"
      ]
    }
  }
}

Auf dieser Seite