Consents and Preferences Feldergruppe

Consents and Preferences ist eine Standardfeldgruppe für die XDM Individual Profile Klasse die Einverständnis- und Präferenzinformationen für einen einzelnen Kunden erfasst.

Feldgruppenstruktur structure

Die Consents and Preferences Feldergruppe bietet ein einzelnes Feld vom Typ „Objekt“, consents. B. , um Einverständnis- und Voreinstellungsinformationen zu erfassen. Dieses Feld erweitert den Datentyp Consent for Privacy, Personalization and Marketing Preferences entfernt das adID Feld und fügt ein idSpecific Zuordnungsfeld hinzu.

Die folgende JSON-Datei zeigt ein Beispiel für den Datentyp, den die Consents and Preferences-Feldergruppe 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 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.

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"
        }
      }
    }
  }
}

Aufnehmen von Daten mithilfe der Feldergruppe ingest

Damit Sie die Consents and Preferences Feldergruppe verwenden können, um Einverständnisdaten von Ihren Kunden aufzunehmen, 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 Tutorial ​Erstellen eines Schemas in der Benutzeroberfläche“. Nachdem Sie ein Schema erstellt haben, das ein Feld mit der Consents and Preferences Feldergruppe enthält, lesen Sie den Abschnitt Erstellen eines ​) im Benutzerhandbuch zu Datensätzen, indem Sie die Schritte zum Erstellen eines Datensatzes mit einem vorhandenen Schema befolgen.

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 durchgesetzt werden, indem das Einverständnis in der verwendeten Datenerfassungsbibliothek festgelegt wird. Wenn ein Kunde die Datenerfassung ablehnt, muss diese sofort eingestellt werden. Wenn sich ein Kunde gegen die Personalisierung entscheidet, sollte auf der nächsten Seite, die er lädt, keine Personalisierung vorhanden sein. Weitere Informationen finden Sie unter setConsent mit der JavaScript-Bibliothek oder unter Set consent mit der SDK-Web-Tag-Erweiterung .

Nächste Schritte

In diesem Dokument wurden die Struktur und Verwendung der Consents and Preferences Feldergruppe behandelt. Weitere Informationen zu den anderen Feldern, die von der Feldergruppe bereitgestellt werden, finden Sie im Dokument zum Consent for Privacy, Personalization and Marketing Preferences Datentyp ​.