Konfigurieren eines Datensatzes zur Erfassung von Einwilligungs- und Präferenzdaten

Damit Adobe Experience Platform Ihre Einverständnis-/Präferenzdaten von Kunden verarbeiten kann, müssen diese Daten an einen Datensatz gesendet werden, dessen Schema Felder enthält, die mit Einverständnissen und anderen Berechtigungen in Verbindung stehen. Insbesondere muss dieser Datensatz auf der XDM Individual Profile-Klasse basieren und für die Verwendung in Real-Time Customer Profile aktiviert sein.

In diesem Dokument werden die Schritte zum Konfigurieren eines Datensatzes für die Verarbeitung von Einverständnisdaten im Experience Platform beschrieben. Einen Überblick über den vollständigen Workflow für die Verarbeitung von Einverständnis-/Voreinstellungsdaten in Platform erhalten Sie im Abschnitt Übersicht zur Einverständnisverarbeitung.

Voraussetzungen

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:

Details zu Einverständnis und Voreinstellungen Feldergruppenstruktur structure

Die Einverständnis- und Voreinstellungsdetails stellt standardisierte Einverständnisfelder für ein Schema bereit. Derzeit ist diese Feldergruppe nur mit Schemata kompatibel, die auf der XDM Individual Profile-Klasse basieren.

Die Feldergruppe stellt das Feld consents vom Typ „Objekt“ bereit, dessen Untereigenschaften einen Satz standardisierter Einverständnisfelder erfassen. Die folgende JSON-Datei ist ein Beispiel für die Art von Daten, die consents bei der Datenaufnahme erwartet:

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  },
  "metadata": {
    "time": "2019-01-01T15:52:25+00:00"
  }
}

Hinzufügen erforderlicher Feldergruppen zu Ihrem Profile add-field-group

Um Einverständnisdaten mit dem Adobe-Standard zu erfassen, müssen Sie über ein profilaktiviertes Schema verfügen, das die folgenden beiden Feldergruppen enthält:

Wählen Sie in der Platform Benutzeroberfläche im linken Navigationsbereich die Option Schemata“ und dann die Registerkarte Durchsuchen aus, um eine Liste der vorhandenen Schemata anzuzeigen. Wählen Sie hier den Namen des Profile Schemas aus, dem Sie Einverständnisfelder hinzufügen möchten. Die Screenshots in diesem Abschnitt verwenden das Schema „Mitglieder des Treueprogramms“, das im Tutorial zur Schemaerstellung erstellt wurde.

Das Schema Editor wird angezeigt und zeigt die Struktur des Schemas auf der Arbeitsfläche an. Wählen Sie auf der linken Seite der Arbeitsfläche Hinzufügen im Abschnitt Feldergruppen aus.

Der Feldergruppe hinzufügen wird angezeigt. Wählen Sie von hier aus Einverständnis und) aus der Liste aus. Sie können optional die Suchleiste verwenden, um die Ergebnisse einzugrenzen und die Feldergruppe leichter zu finden.

Suchen Sie als Nächstes die IdentityMap-Feldergruppe aus der Liste und wählen Sie sie ebenfalls aus. Sobald beide Feldergruppen in der rechten Leiste aufgeführt sind, wählen Sie Feldergruppen hinzufügen.

Die Arbeitsfläche wird erneut angezeigt und zeigt an, dass die Felder consents und identityMap zur Schemastruktur hinzugefügt wurden. Wenn Sie zusätzliche Einverständnis- und Präferenzfelder benötigen, die nicht von der Standardfeldgruppe erfasst werden, finden Sie weitere Informationen im Anhang unter Hinzufügen benutzerdefinierter Einverständnis- und Präferenzfelder zum Schema. Wählen Sie andernfalls Speichern, um die Änderungen am Schema abzuschließen.

Wenn das von Ihnen bearbeitete Schema von dem Profildatensatz) verwendet wird, ​ in Ihrem Platform Web SDK-Datenstrom angegeben ist, enthält dieser Datensatz jetzt die neuen Einverständnisfelder. Sie können jetzt zum Handbuch zur Einverständnisverarbeitung“ zurückkehren um mit dem Konfigurieren von Experience Platform zur Verarbeitung von Einverständnisdaten fortzufahren. Wenn Sie keinen Datensatz für dieses Schema erstellt haben, befolgen Sie die Schritte im nächsten Abschnitt.

Erstellen eines Datensatzes basierend auf Ihrem Einverständnisschema dataset

Nachdem Sie ein Schema mit Einverständnisfeldern erstellt haben, müssen Sie einen Datensatz erstellen, der letztendlich die Einverständnisdaten Ihrer Kunden aufnimmt. Dieser Datensatz muss für Real-Time Customer Profile aktiviert sein.

Wählen Sie zunächst linken Navigationsbereich Datensätze“ und dann oben rechts Datensatz erstellen aus.

Wählen Sie auf der nächsten Seite Datensatz aus Schema erstellen aus.

Der Datensatz aus Schema erstellen wird angezeigt, beginnend mit dem Schritt Schema auswählen. Suchen Sie in der bereitgestellten Liste nach einem der Einverständnisschemata, die Sie zuvor erstellt haben. Sie können optional die Suchleiste verwenden, um die Ergebnisse einzugrenzen und Ihr Schema leichter zu finden. Klicken Sie auf das Optionsfeld neben dem gewünschten Schema und dann auf Weiter um fortzufahren.

Der Schritt Datensatz konfigurieren wird angezeigt. Geben Sie einen eindeutigen, leicht identifizierbaren Namen und eine Beschreibung für den Datensatz an, bevor Sie Beenden auswählen.

Die Detailseite für den neu erstellten Datensatz wird angezeigt. Wenn der Datensatz auf Ihrem Zeitreihenschema basiert, ist der Prozess abgeschlossen. Wenn der Datensatz auf Ihrem Datensatzschema basiert, besteht der letzte Schritt des Prozesses darin, den Datensatz für die Verwendung in Real-Time Customer Profile zu aktivieren.

Wählen Sie in der rechten Leiste den Profil aus.

Wählen Sie abschließend Aktivieren im Bestätigungs-Pop-up aus, um das Schema für die Profile zu aktivieren.

Der Datensatz ist jetzt gespeichert und für die Verwendung in Profile aktiviert. Wenn Sie planen, mit der Platform Web SDK Einverständnisdaten an Profile zu senden, müssen Sie diesen Datensatz als Profildatensatz beim Einrichten Ihres Datenstroms auswählen.

Nächste Schritte

In diesem Tutorial haben Sie Einverständnisfelder zu einem Profile Schema hinzugefügt, dessen Datensatz zum Aufnehmen von Einverständnisdaten mithilfe der Platform Web SDK oder der direkten XDM-Aufnahme verwendet wird.

Sie können jetzt zur Übersicht über die Einverständnisverarbeitung) zurückkehren,mit der Konfiguration von Experience Platform zur Verarbeitung von Einverständnisdaten fortzufahren.

Anhang

Der folgende Abschnitt enthält zusätzliche Informationen zum Erstellen eines Datensatzes zur Aufnahme von Einverständnis- und Präferenzdaten von Kunden.

Hinzufügen benutzerdefinierter Einverständnis- und Präferenzfelder zum Schema custom-consent

Wenn Sie zusätzliche Einverständnissignale erfassen müssen, die nicht in der standardmäßigen Feldergruppe "​ und Präferenzdetails enthalten sind, können Sie benutzerdefinierte XDM-Komponenten verwenden, um Ihr Einverständnisschema an Ihre speziellen Geschäftsanforderungen anzupassen. In diesem Abschnitt werden die grundlegenden Prinzipien beschrieben, wie Sie Ihr Einverständnisschema anpassen können, um diese Signale in Profile aufzunehmen.

Es wird dringend empfohlen, die Feldergruppe Einverständnis und Voreinstellungsdetails als Grundlage für die Struktur Ihrer Einverständnisdaten zu verwenden und bei Bedarf zusätzliche Felder hinzuzufügen, anstatt zu versuchen, die gesamte Struktur von Grund auf neu zu erstellen.

Um benutzerdefinierte Felder zur Struktur einer Standardfeldergruppe hinzuzufügen, müssen Sie zunächst eine benutzerdefinierte Feldergruppe erstellen. Nachdem Sie die Feldergruppe Einverständnis und Voreinstellungsdetails zum Schema hinzugefügt haben, wählen Sie das Symbol Plus (+) im Abschnitt Feldergruppen aus und klicken Sie dann auf Neue Feldergruppe erstellen. Geben Sie einen Namen und eine optionale Beschreibung für die Feldergruppe ein und wählen Sie dann Feldergruppe hinzufügen aus.

Der Schema Editor wird erneut angezeigt, wobei die neue benutzerdefinierte Feldergruppe in der linken Leiste ausgewählt ist. Auf der Arbeitsfläche werden Steuerelemente angezeigt, mit denen Sie der Schemastruktur benutzerdefinierte Felder hinzufügen können. Um ein neues Einverständnis- oder Präferenzfeld hinzuzufügen, klicken Sie auf das Plus (+) Symbol neben dem consents.

Ein neues Feld wird innerhalb des consents-Objekts angezeigt. Da Sie ein benutzerdefiniertes Feld zu einem standardmäßigen XDM-Objekt hinzufügen, wird das neue Feld unter einem -Objekt erstellt, das den Namespace zu Ihrer Mandanten-ID erhält.

Geben Sie in der rechten Leiste unter Feldeigenschaften einen Namen und eine Beschreibung für das Feld ein. Bei der Auswahl des Felds Typ müssen Sie den entsprechenden Standarddatentyp für ein benutzerdefiniertes Einverständnis- oder Präferenzfeld verwenden:

Wenn Sie fertig sind, wählen Sie Anwenden aus.

Das Feld Einverständnis oder Voreinstellung wird zur Schemastruktur hinzugefügt. Beachten Sie, ​ der in ​ rechten Leiste angezeigte „Pfad“ den _tenantId Namespace enthält. Dieser Namespace muss immer dann eingeschlossen werden, wenn Sie in Ihren Datenvorgängen auf den Pfad zu diesem Feld verweisen.

Führen Sie die oben genannten Schritte aus, um weiterhin die erforderlichen Einverständnis- und Voreinstellungsfelder hinzuzufügen. Klicken Sie abschließend auf Speichern, um Ihre Änderungen zu bestätigen.

Wenn Sie keinen Datensatz für dieses Schema erstellt haben, fahren Sie mit dem Abschnitt über das eines Datensatzes.