Einverständnis und Voreinstellungen Feldergruppe

Einverständnisse und Voreinstellungen ist eine Standardfeldgruppe für die XDM Individual Profile Klasse die Einverständnis- und Voreinstellungsinformationen für einen einzelnen Kunden erfasst.

NOTE
Da diese Feldergruppe nur mit XDM Individual Profile kompatibel ist, kann sie nicht für XDM ExperienceEvent verwendet werden. Wenn Sie Einverständnis- und Präferenzdaten in Ihr Erlebnisereignisschema aufnehmen möchten, fügen Sie stattdessen den Datentyp Einverständnis für Datenschutz, Personalization und Marketing-Voreinstellungen mithilfe einer benutzerdefinierten Feldergruppe zum Schema hinzu.

Feldgruppenstruktur structure

Die Einverständnis und Voreinstellungen bietet consents ein einzelnes Feld vom Typ „Objekt“, um Einverständnis- und Voreinstellungsinformationen zu erfassen. Dieses Feld erweitert den Datentyp Einverständnis für Datenschutz, Personalization- und ​, entfernt das adID und fügt ein idSpecific hinzu.

TIP
Anweisungen zum Suchen einer XDMRessource und Überprüfen ihrer Struktur in der PlatformBenutzeroberfläche finden Sie im Handbuch zu XDM-Ressourcen zu .

Die folgende JSON-Datei zeigt ein Beispiel für den Datentyp, den die Feldergruppe Einverständnis und Voreinstellungen verarbeiten kann. Informationen zur Verwendung der meisten von der Feldergruppe bereitgestellten Felder finden Sie im Handbuch zum Datentyp Einverständnisse und Voreinstellungen. Die folgenden Unterabschnitte konzentrieren sich auf die eindeutigen Attribute, die die Feldergruppe zum Datentyp hinzufügt.

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
Sie können JSON-Beispieldaten für jedes XDM-Schema generieren, das Sie in Experience Platform definieren, um zu visualisieren, wie Ihre Kundeneinwilligungs- und Präferenzdaten zugeordnet werden sollten. In der folgenden Dokumentation finden Sie weitere Informationen:

idSpecific

idSpecific kann verwendet werden, wenn eine bestimmte Einwilligung oder Präferenz nicht allgemein für einen Kunden gilt, sondern auf ein einzelnes Gerät oder eine einzelne ID beschränkt ist. Beispielsweise kann ein Kunde den Empfang von E-Mails an eine Adresse deaktivieren und gleichzeitig möglicherweise E-Mails an eine andere Adresse senden.

IMPORTANT
Einverständnisse und Voreinstellungen auf Kanalebene (d. h. diejenigen, die unter consents außerhalb von idSpecific bereitgestellt werden) gelten für alle IDs innerhalb dieses Kanals. Daher wirken sich alle Einverständnisse und Voreinstellungen auf Kanalebene direkt darauf aus, ob äquivalente ID- oder gerätespezifische Einstellungen berücksichtigt werden:
  • Wenn der Kunde sich auf Kanalebene abgemeldet hat, werden alle entsprechenden Einverständnisse oder Voreinstellungen in idSpecific ignoriert.
  • Wenn das Einverständnis oder die Voreinstellung auf Kanalebene nicht festgelegt ist oder der Kunde sich dafür entschieden hat, werden die entsprechenden Einverständnisse oder Voreinstellungen in idSpecific berücksichtigt.

Jeder Schlüssel im idSpecific-Objekt repräsentiert einen bestimmten Identity-Namespace, der vom Adobe Experience Platform Identity Service erkannt wird. Sie können zwar eigene benutzerdefinierte Namespaces definieren, um verschiedene Kennungen zu kategorisieren, es wird jedoch empfohlen, einen der von Identity Service bereitgestellten Standard-Namespaces zu verwenden, um die Speichergröße für das Echtzeit-Kundenprofil zu reduzieren. Weitere Informationen zu Identity-Namespaces finden Sie unter Übersicht zu Identity-Namespaces in der Identity Service-Dokumentation.

Die Schlüssel für jedes Namespace-Objekt stellen die eindeutigen Identitätswerte dar, für die der Kunde Voreinstellungen festgelegt hat. Jeder Identitätswert kann einen vollständigen Satz von Einverständnissen und Voreinstellungen enthalten, die auf die gleiche Weise formatiert sind wie consents.

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Innerhalb marketing im Abschnitt idSpecific angegebenen Objekte werden die Felder any und preferred nicht unterstützt. Diese Felder können nur auf Benutzerebene konfiguriert werden. Darüber hinaus unterstützen die idSpecific Marketing-Voreinstellungen für email, sms und push keine subscriptions.

Es gibt auch ein Einverständnis, das nur im idSpecific Abschnitt erteilt werden kann: adID. Dieses Feld wird im folgenden Unterabschnitt behandelt.

adID

Das adID Einverständnis stellt das Einverständnis des Kunden dar, ob eine Advertiser-ID (IDFA oder GAID) verwendet werden kann, um den Kunden über Apps hinweg auf diesem Gerät zu verknüpfen. Dieser Wert kann nur unter dem ECID Identity-Namespace im Abschnitt idSpecific konfiguriert werden und kann nicht für andere Namespaces oder auf Benutzerebene für diese Feldergruppe festgelegt werden.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
Es wird nicht erwartet, dass Sie diesen Wert direkt festlegen, da Adobe Experience Platform Mobile SDK ihn bei Bedarf automatisch festlegt.

Aufnehmen von Daten mithilfe der Feldergruppe ingest

Um die Feldergruppe Einverständnisse und Voreinstellungen zum Aufnehmen von Einverständnisdaten von Ihren Kunden zu verwenden, müssen Sie einen Datensatz erstellen, der auf einem Schema basiert, das diese Feldergruppe enthält.

Anweisungen zum Zuweisen von Feldergruppen zu Feldern Sie im TutorialErstellen eines Schemas in der Benutzeroberfläche“. Nachdem Sie ein Schema erstellt haben, das ein Feld mit der Feldergruppe Einverständnis und Voreinstellungen enthält, lesen Sie den Abschnitt Erstellen eines Datensatzes im Benutzerhandbuch zu Datensätzen, indem Sie die Schritte zum Erstellen eines Datensatzes mit einem vorhandenen Schema befolgen.

IMPORTANT
Wenn Sie Einverständnisdaten an Real-Time Customer Profile senden möchten, müssen Sie ein Profile-aktiviertes Schema erstellen, das auf der XDM Individual Profile-Klasse basiert, die die Feldergruppe Einverständnis und Voreinstellungen enthält. Der Datensatz, den Sie basierend auf diesem Schema erstellen, muss auch für die Profile aktiviert sein. Die einzelnen Schritte im Zusammenhang mit den Real-Time Customer Profile für Schemata und Datensätze finden Sie in den oben verlinkten Tutorials.
Darüber hinaus müssen Sie auch sicherstellen, dass Ihre Zusammenführungsrichtlinien so konfiguriert sind, dass die Datensätze, die die neuesten Einverständnis- und Präferenzdaten enthalten, priorisiert werden, damit Kundenprofile korrekt aktualisiert werden. Weitere Informationen finden Sie in der Übersicht Zusammenführungsrichtlinien .

Umgang mit Einverständnis- und Voreinstellungsänderungen

Wenn ein Kunde sein Einverständnis oder seine Voreinstellungen auf Ihrer Website ändert, sollten diese Änderungen erfasst und sofort mithilfe der Adobe Experience Platform Web SDK durchgesetzt. Wenn ein Kunde die Datenerfassung ablehnt, muss diese sofort eingestellt werden. Wenn ein Kunde die Personalisierung ablehnt, sollte auf der nächsten Seite, die er besucht, keine Personalisierung vorhanden sein.

Nächste Schritte

In diesem Dokument wurden die Struktur und Verwendung der Feldergruppe Einverständnis und Voreinstellungen behandelt. Weitere Informationen zu den anderen von der Feldergruppe bereitgestellten Feldern finden Sie im Dokument zum Datentyp Einverständnis für Datenschutz, Personalization- und Marketing-.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07