Konfigurieren von Datenstromüberschreibungen

Letzte Aktualisierung: 2024-01-26
  • Erstellt für:
  • Developer
    User
    Admin
    Leader

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.

Auf diese Weise können Sie andere Verhaltensweisen von Datastreams als die Standardeinstellungen Trigger haben, ohne einen Datastream zu erstellen oder Ihre vorhandenen Einstellungen zu ändern.

Die Außerkraftsetzung der Datastream-Konfiguration erfolgt in zwei Schritten:

  1. Zunächst müssen Sie Ihre Datastream-Konfigurationsüberschreibungen im Datastream-Konfigurationsseite.
  2. Anschließend müssen Sie die Überschreibungen auf eine der folgenden Arten 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

Datenspeicherüberschreibungen werden nur für Web SDK und Mobile SDK Integrationen. Server-API -Integrationen unterstützen derzeit keine Überschreibungen von Datastream.


Datenstromüberschreibungen sollten verwendet werden, wenn Sie verschiedene Daten an verschiedene Datenströme senden müssen. Verwenden Sie keine Datastream-Überschreibungen für Anwendungsfälle zur Personalisierung oder Einverständnisdaten.

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 das Senden von Daten an einen länderspezifischen Datastream und auch an einen globalen Datastream sein, wo 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 für jede Geschäftseinheit spezifische Daten zu speichern.

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 Datastream erstellt haben, bearbeiten Sie die Adobe Target -Dienst, den Sie hinzugefügt haben, und verwenden Sie Eigenschafts-Token - Überschreibungen -Abschnitt, um die gewünschten Datastream-Umgehungen 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 Datastream erstellt haben, bearbeiten Sie die Adobe Analytics -Dienst, den Sie hinzugefügt haben, und verwenden Sie Report Suite - Überschreibungen -Abschnitt, um die gewünschten Datastream-Umgehungen 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 Datastream erstellt haben, bearbeiten Sie die Adobe Experience Platform den Sie hinzugefügt haben, und wählen Sie Ereignis-Datensatz hinzufügen -Option zum Hinzufügen eines oder mehrerer Ereignis-Datensätze überschreiben, 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.

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.

Überschreibungen der Konfiguration über das Web SDK senden sendEvent command

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"
    }
  }
});
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.

Überschreibungen der Konfiguration über das Web SDK senden configure command

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() { /* … */ });
};

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

Nachher Konfigurieren der Überschreibungen des Datastreams In der Datenerfassungs-Benutzeroberfläche können Sie die Überschreibungen jetzt über das Mobile SDK an das Edge-Netzwerk senden.

Informationen zum Senden der Außerkraftsetzungen an das Edge-Netzwerk finden Sie im Abschnitt Handbuch zum Senden von Überschreibungen mit sendEvent oder Handbuch zum Senden von Überschreibungen mithilfe von Regeln.

Payload-Beispiel

Die obigen Beispiele generieren eine Edge Network Nutzlast ähnlich der unten stehenden.

{
  "meta": {
    "configOverrides": {
      "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"
      }
    },
    "state": {  }
  },
  "events": [  ]
}

Auf dieser Seite