Feldergruppe Einverständnisse und Voreinstellungen

Einverständnisse und Voreinstellungen ist eine Standardfeldgruppe für die XDM Individual Profile Klasse, die Einwilligungs- und Präferenzinformationen für einen einzelnen Kunden erfasst.

Feldgruppenstruktur structure

Die Feldergruppe Einverständnis und Voreinstellungen enthält ein einzelnes Objektfeld, consents, um Einwilligungs- und Präferenzinformationen zu erfassen. Dieses Feld erweitert den Datentyp Einverständnis für Datenschutz, Personalization- und Marketing-Voreinstellungen, entfernt das Feld adID und fügt ein Zuordnungsfeld idSpecific hinzu.

Die folgende JSON-Datei zeigt ein Beispiel für den Datentyp, den die Feldergruppe Einverständnisse 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"
    }
  }
}

idSpecific

idSpecific kann verwendet werden, wenn eine bestimmte Zustimmung oder Voreinstellung 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 Erhalt von E-Mails an eine Adresse deaktivieren und gleichzeitig E-Mails an eine andere Adresse zulassen.

Jeder Schlüssel im Objekt idSpecific stellt einen bestimmten Identitäts-Namespace dar, der vom Adobe Experience Platform Identity Service erkannt wird. Sie können Ihre eigenen benutzerdefinierten Namespaces definieren, um verschiedene IDs zu kategorisieren. Es wird jedoch empfohlen, einen der Standard-Namespaces zu verwenden, die von Identity Service bereitgestellt werden, um die Speichergrößen für das Echtzeit-Kundenprofil zu reduzieren. Weitere Informationen zu Identitäts-Namespaces finden Sie unter Übersicht über Identitäts-Namespaces in der Dokumentation zu Identity Service.

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, der auf dieselbe Weise wie consents formatiert ist.

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

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

Es gibt auch eine Einwilligung, die nur im Abschnitt idSpecific bereitgestellt werden kann: adID. Dieses Feld wird im folgenden Unterabschnitt behandelt.

adID

Das Einverständnis adID stellt die Einwilligung des Kunden dar, ob eine Advertiser-ID (IDFA oder GAID) verwendet werden kann, um den Kunden über Apps auf diesem Gerät hinweg zu verknüpfen. Dieser Wert kann nur unter dem Identitäts-Namespace ECID im Abschnitt idSpecific konfiguriert werden und 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"
        }
      }
    }
  }
}

Erfassen von Daten mithilfe der Feldergruppe ingest

Um die Feldergruppe Einverständnis und Voreinstellungen zum Erfassen der Einwilligungsdaten Ihrer 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 finden Sie im Tutorial zum Erstellen eines Schemas in der Benutzeroberfläche 🔗 . Nachdem Sie ein Schema erstellt haben, das ein Feld mit der Feldergruppe Einverständnisse und Voreinstellungen enthält, lesen Sie den Abschnitt zum Erstellen eines Datensatzes 3} im Benutzerhandbuch zu Datensätzen und befolgen Sie die Schritte zum Erstellen eines Datensatzes mit einem vorhandenen Schema.

Handhabung von Zustimmungs- und Vorgabenänderungen

Wenn ein Kunde seine Zustimmung oder Voreinstellungen auf Ihrer Website ändert, sollten diese Änderungen erfasst und sofort mit dem Adobe Experience Platform Web SDK erzwungen werden. Wenn ein Kunde die Datenerfassung ablehnt, muss die Datenerfassung sofort eingestellt werden. Wenn ein Kunde die Personalisierung ablehnt, sollte auf der nächsten besuchten Seite keine Personalisierung vorhanden sein.

Nächste Schritte

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