DokumentationExperience PlatformÜbersicht zu Experience Platform

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

Last update: Tue Nov 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler

Damit Adobe Experience Platform Ihre Zustimmungs-/Präferenzdaten von Kunden verarbeiten kann, müssen diese Daten an einen Datensatz gesendet werden, dessen Schema Felder enthält, die mit Zustimmung und anderen Berechtigungen zusammenhängen. 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 Schritte zum Konfigurieren eines Datensatzes zur Verarbeitung von Einwilligungsdaten in Experience Platform beschrieben. Einen Überblick über den gesamten Workflow zur Verarbeitung von Zustimmungs-/Voreinstellungsdaten in Platform finden Sie in der Übersicht zur Verarbeitung der Einwilligung .

IMPORTANT
Die Beispiele in diesem Handbuch verwenden einen standardisierten Satz von Feldern, um die Zustimmungswerte des Kunden darzustellen, wie in der Schemafeldgruppe Einverständnis und Präferenzdetails definiert. Die Struktur dieser Felder soll ein effizientes Datenmodell für viele gängige Nutzungsszenarien bei der Einwilligungserfassung bieten.
Sie können jedoch auch Ihre eigenen Feldergruppen definieren, um die Zustimmung gemäß Ihren eigenen Datenmodellen darzustellen. Wenden Sie sich an Ihr Rechtsteam, um die Genehmigung für ein Datenmodell zur Einwilligung zu erhalten, das Ihren geschäftlichen Anforderungen entspricht. Mögliche Optionen sind:
  • Die standardisierte Einwilligungsfeldgruppe
  • Eine benutzerdefinierte Einwilligungsfeldgruppe, die von Ihrer Organisation erstellt wurde
  • Eine Kombination aus der standardisierten Einwilligungsfeldgruppe und zusätzlichen Feldern, die von einer benutzerdefinierten Einwilligungsfeldgruppe bereitgestellt werden

Voraussetzungen

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

  • Experience-Datenmodell (XDM): Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
  • Echtzeit-Kundenprofil: Konsolidiert Kundendaten aus unterschiedlichen Quellen in einer vollständigen, einheitlichen Ansicht und bietet gleichzeitig ein ausführbares, mit Zeitstempel versehenes Konto für jede Kundeninteraktion.
IMPORTANT
In diesem Tutorial wird davon ausgegangen, dass Sie das Schema Profile in Platform kennen, das Sie zum Erfassen von Kundenattributinformationen verwenden möchten. Unabhängig von der Methode, mit der Sie Einwilligungsdaten erfassen, muss dieses Schema für das Echtzeit-Kundenprofil 🔗 aktiviert sein. Darüber hinaus darf die primäre Identität des Schemas nicht ein direkt identifizierbares Feld sein, das in interessensbasierter Werbung, wie z. B. einer E-Mail-Adresse, nicht verwendet werden darf. Wenden Sie sich an Ihren Rechtsbeistand, wenn Sie sich nicht sicher sind, welche Felder eingeschränkt sind.

Feldergruppenstruktur Einverständniserklärung und Präferenzdetails structure

Die Feldergruppe Einverständniserklärung und Präferenzdetails enthält standardisierte Einwilligungsfelder für ein Schema. Diese Feldergruppe ist derzeit nur mit Schemas kompatibel, die auf der XDM Individual Profile -Klasse basieren.

Die Feldergruppe stellt ein einzelnes Objekt-Feld bereit, consents, dessen Untereigenschaften eine Reihe standardisierter Zustimmungsfelder erfassen. Die folgende JSON-Datei ist ein Beispiel für die Art der Daten, die consents bei der Datenerfassung 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"
  }
}
NOTE
Weitere Informationen zur Struktur und Bedeutung der Untereigenschaften in consents finden Sie in der Übersicht über die Feldergruppe Einverständnis und Präferenzdetails.

Hinzufügen erforderlicher Feldergruppen zum Profile-Schema add-field-group

Um Einwilligungsdaten mithilfe des Adobe-Standards zu erfassen, müssen Sie über ein Profil-aktiviertes Schema verfügen, das die beiden folgenden Feldgruppen enthält:

Wählen Sie in der Platform-Benutzeroberfläche im linken Navigationsbereich Schemas und dann die Registerkarte Durchsuchen aus, um eine Liste der vorhandenen Schemas anzuzeigen. Wählen Sie von hier den Namen des Schemas mit aktiviertem Code Profile aus, dem Sie Einwilligungsfelder hinzufügen möchten. Die Screenshots in diesem Abschnitt verwenden als Beispiel das Schema "Mitglieder des Treueprogramms", das im Tutorial zur Erstellung von Schemas erstellt wurde.

TIP
Sie können die Such- und Filterfunktionen des Arbeitsbereichs verwenden, um Ihr Schema leichter zu finden. Weitere Informationen finden Sie im Handbuch zum Erkunden von XDM-Ressourcen .

Der Wert "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 unter dem Abschnitt Feldergruppen die Option Hinzufügen aus.

Das Dialogfeld Feldergruppe hinzufügen wird angezeigt. Wählen Sie hier Einverständniserklärung und Präferenzdetails aus der Liste aus. Sie können optional die Suchleiste verwenden, um die Ergebnisse einzugrenzen und die Feldergruppe leichter zu finden.

Suchen Sie anschließend die Feldergruppe IdentityMap aus der Liste und wählen Sie sie auch aus. Sobald beide Feldergruppen in der rechten Leiste aufgelistet sind, wählen Sie Feldergruppen hinzufügen aus.

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

IMPORTANT
Wenn Sie ein neues Schema erstellen oder ein vorhandenes Schema bearbeiten, das nicht für Profil aktiviert wurde, müssen Sie vor dem Speichern das Schema für Profil 🔗 aktivieren.

Wenn das von Ihnen bearbeitete Schema vom Profildatensatz verwendet wird, der in Ihrem Platform Web SDK-Datenspeicher angegeben ist, enthält dieser Datensatz jetzt die neuen Einwilligungsfelder. Sie können jetzt zum Handbuch zur Verarbeitung der Einwilligung zurückkehren, um die Konfiguration von Experience Platform zur Verarbeitung von Einwilligungsdaten fortzusetzen. Wenn Sie keinen Datensatz für dieses Schema erstellt haben, führen Sie die Schritte im nächsten Abschnitt aus.

Datensatz basierend auf Ihrem Einverständnisschema erstellen dataset

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

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

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

Der Workflow Datensatz aus Schema erstellen wird angezeigt, beginnend mit dem Schritt Schema auswählen . Suchen Sie in der bereitgestellten Liste eines der zuvor erstellten Einwilligungsschemas. Sie können optional die Suchleiste verwenden, um Ergebnisse einzuschränken und Ihr Schema leichter zu finden. Wählen Sie das Optionsfeld neben dem gewünschten Schema aus und wählen Sie dann Weiter aus, um fortzufahren.

Der Schritt Datensatz konfigurieren wird angezeigt. Geben Sie einen eindeutigen, leicht identifizierbaren Namen und eine Beschreibung für den Datensatz ein, 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 im Prozess darin, den Datensatz zur Verwendung in Real-Time Customer Profile zu aktivieren.

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

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

Der Datensatz wird jetzt gespeichert und für die Verwendung in Profile aktiviert. Wenn Sie planen, das Platform Web SDK zum Senden von Zustimmungsdaten an Profile zu verwenden, müssen Sie diesen Datensatz beim Einrichten Ihres Datastraams als Profildatensatz auswählen.

Nächste Schritte

In diesem Tutorial haben Sie Einwilligungsfelder zu einem Profile-aktivierten Schema hinzugefügt, dessen Datensatz verwendet wird, um Einwilligungsdaten mithilfe des Platform Web SDK oder der direkten XDM-Erfassung zu erfassen.

Sie können jetzt zur Übersicht über die Verarbeitung der Zustimmung zurückkehren, um mit der Konfiguration von Experience Platform zur Verarbeitung von Zustimmungsdaten fortzufahren.

Anhang

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

Wenn Sie zusätzliche Zustimmungssignale erfassen müssen, die nicht von denen der standardmäßigen Feldergruppe Einwilligung und Voreinstellungsdetails dargestellt werden, können Sie benutzerdefinierte XDM-Komponenten verwenden, um Ihr Einwilligungsschema entsprechend Ihren jeweiligen Geschäftsanforderungen zu erweitern. In diesem Abschnitt werden die grundlegenden Prinzipien erläutert, wie Sie Ihr Einverständnisschema anpassen können, um diese Signale in das Profil aufzunehmen.

IMPORTANT
Die Platform Web- und Mobile-SDKs unterstützen keine benutzerdefinierten Felder in ihren Befehlen zur Änderung der Zustimmung. Derzeit ist die einzige Möglichkeit, benutzerdefinierte Zustimmungsfelder in das Profil aufzunehmen, über die Batch-Erfassung oder eine Quellverbindung.

Es wird dringend empfohlen, die Feldergruppe Einverständniserklärung und Präferenzdetails als Grundlage für die Struktur Ihrer Einwilligungsdaten zu verwenden und nach Bedarf zusätzliche Felder hinzuzufügen, anstatt zu versuchen, die gesamte Struktur von Grund auf neu zu erstellen.

Um der Struktur einer Standardfeldgruppe benutzerdefinierte Felder hinzuzufügen, müssen Sie zunächst eine benutzerdefinierte Feldergruppe erstellen. Nachdem Sie die Feldergruppe Einverständniserklärung und Präferenzdetails zum Schema hinzugefügt haben, wählen Sie im Abschnitt Feldergruppen das Symbol Plus (+) aus und wählen Sie dann 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.

Die Schema Editor wird wieder angezeigt, wobei die neue benutzerdefinierte Feldergruppe in der linken Leiste ausgewählt ist. Auf der Arbeitsfläche werden Steuerelemente angezeigt, mit denen Sie benutzerdefinierte Felder zur Schemastruktur hinzufügen können. Um ein neues Einverständnis- oder Vorgabefeld hinzuzufügen, wählen Sie das Symbol plus (+) neben dem Objekt consents aus.

Innerhalb des Objekts consents wird ein neues Feld angezeigt. Da Sie ein benutzerdefiniertes Feld zu einem Standard-XDM-Objekt hinzufügen, wird das neue Feld unter einem Objekt erstellt, das mit Ihrer Mandanten-ID benannt ist.

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

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

Das Einverständnis- oder Präferenzfeld wird der Schemastruktur hinzugefügt. Beachten Sie, dass der in der rechten Leiste angezeigte Pfad den Namespace _tenantId enthält. Dieser Namespace muss immer dann enthalten sein, wenn Sie in Ihren Datenvorgängen auf den Pfad zu diesem Feld verweisen.

Führen Sie die oben beschriebenen Schritte aus, um mit dem Hinzufügen der erforderlichen Zustimmungs- und Voreinstellungsfelder fortzufahren. Wählen Sie abschließend Speichern aus, um Ihre Änderungen zu bestätigen.

Wenn Sie keinen Datensatz für dieses Schema erstellt haben, fahren Sie mit dem Abschnitt zum Erstellen eines Datensatzes fort.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5