Konfiguration des Partnerschemas

Experience Platform verwendet Schemata, um die Struktur von Daten konsistent und wiederverwendbar zu beschreiben. Wenn Sie Daten in Experience Platform aufnehmen, werden sie nach einem XDM-Schema strukturiert. Weitere Informationen zum Schemakompositionsmodell, einschließlich Planungsgrundsätzen und Best Practices, finden Sie in den Grundlagen der Schemakomposition.

Beim Erstellen eines Ziels mit Destination SDK können Sie Ihr eigenes Partnerschema definieren, das von Ihrer Zielplattform verwendet werden soll. Verwenden Sie das Partnerschema, um Profilattribute von Experience Platform bestimmten Feldern zuzuordnen, die Ihre Zielplattform erkennt, und zwar alles in der Experience Platform-Benutzeroberfläche.

Beim Konfigurieren des Partnerschemas für Ihr Ziel können Sie die von Ihrer Zielplattform unterstützte Feldzuordnung anpassen, z. B.:

Informationen dazu, wo diese Komponente in eine mit Destination SDK erstellte Integration passt, finden Sie im Diagramm in der Dokumentation Konfigurationsoptionen oder im Handbuch Verwenden von Destination SDK zum Konfigurieren eines dateibasierten Ziels.

Die Schemaeinstellungen können über den Endpunkt /authoring/destinations konfiguriert werden. Detaillierte Beispiele für API-Aufrufe, in denen Sie die auf dieser Seite angezeigten Komponenten konfigurieren können, finden Sie auf den folgenden API-Referenzseiten.

Dieser Artikel beschreibt alle unterstützten Schemakonfigurationsoptionen, die Sie für Ihr Ziel verwenden können, und zeigt, was Sie in der Experience Platform-Benutzeroberfläche sehen.

Unterstützte Integrationstypen supported-integration-types

Die nachstehende Tabelle beschreibt ausführlich, welche Integrationstypen die auf dieser Seite beschriebenen Funktionen unterstützen.

Unterstützte Schemakonfiguration supported-schema-types

Destination SDK unterstützt mehrere Schemakonfigurationen:

Der Abschnitt schemaConfig verwendet mehrere Konfigurationsparameter, je nach dem benötigten Schematyp, wie in den folgenden Abschnitten dargestellt.

Erstellen eines statischen Schemas attributes-schema

Um ein statisches Schema mit Profilattributen zu erstellen, definieren Sie die Zielattribute im Array profileFields wie unten dargestellt.

"schemaConfig":{
      "profileFields":[
           {
              "name":"phoneNo",
              "title":"phoneNo",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the mobilePhone.number value in Experience Platform could be phoneNo on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           },
                      {
              "name":"firstName",
              "title":"firstName",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the person.name.firstName value in Experience Platform could be firstName on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           },
                      {
              "name":"lastName",
              "title":"lastName",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the person.name.lastName value in Experience Platform could be phoneNo on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           }
        ],
      "useCustomerSchemaForAttributeMapping":false,
      "profileRequired":true,
      "segmentRequired":true,
      "identityRequired":true,
      "segmentNamespaceAllowList": ["someNamespace"],
      "segmentNamespaceDenyList": ["someOtherNamespace"]

}

Das daraus resultierende Benutzeroberflächenerlebnis wird in den unten stehenden Bildern gezeigt.

Wenn Sie das Zielgruppen-Mapping auswählen, können Sie die im profileFields-Array definierten Felder sehen.

Nach Auswahl der Attribute werden sie in der Spalte Zielfeld angezeigt.

Erstellen eines dynamischen Schemas dynamic-schema-configuration

Destination SDK unterstützt die Erstellung dynamischer Partnerschemata. Im Gegensatz zu statischen Schemata verwendet ein dynamisches Schema kein Array profileFields. Stattdessen verwenden dynamische Schemata einen dynamischen Schema-Server, der eine Verbindung zu Ihrer eigenen API herstellt, von der aus die Schemakonfiguration abgerufen wird.

In einer dynamischen Schemakonfiguration wird das Array profileFields durch den Abschnitt dynamicSchemaConfig ersetzt, wie unten dargestellt.

"schemaConfig":{
   "dynamicSchemaConfig":{
      "dynamicEnum": {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"DYNAMIC_SCHEMA_SERVER_ID",
         "value": "Schema Name",
         "responseFormat": "SCHEMA"
      }
   },
   "profileRequired":true,
   "segmentRequired":true,
   "identityRequired":true
}

Erforderliche Zuordnungen required-mappings

Innerhalb der Schemakonfiguration haben Sie neben Ihrem statischen oder dynamischen Schema die Möglichkeit, erforderliche (oder vordefinierte) Zuordnungen hinzuzufügen. Hierbei handelt es sich um Zuordnungen, die Sie in der Experience Platform-Benutzeroberfläche anzeigen können. Sie können sie jedoch beim Einrichten einer Verbindung zu Ihrem Ziel nicht ändern.

Beispielsweise können Sie erzwingen, dass das Feld für die E-Mail-Adresse immer an das Ziel gesendet wird.

Nachfolgend finden Sie zwei Beispiele für eine Schemakonfiguration mit erforderlichen Zuordnungen und dafür, wie diese im Zuordnungsschritt des Workflows „Daten für Batch-Ziele aktivieren“ aussehen.

"schemaConfig": {
    "requiredMappingsOnly": true,
    "requiredMappings": [
      {
        "sourceType": "text/x.schema-path",
        "source": "personalEmail.address",
        "destination": "personalEmail.address"
      }
    ]
}

"schemaConfig": {
    "requiredMappingsOnly": true,
    "requiredMappings": [
      {
        "destination": "identityMap.ExamplePartner_ID",
        "mandatoryRequired": true,
        "primaryKeyRequired": true
      }
    ]
}

Konfigurieren der Unterstützung für externe Zielgruppen external-audiences

Um Ihr Ziel so zu konfigurieren, dass es die Aktivierung extern generierter Zielgruppen unterstützt, fügen Sie den folgenden Ausschnitt im Abschnitt schemaConfig ein.

"schemaConfig": {
  "segmentNamespaceDenyList": [],
  ...
}

Weitere Informationen zur segmentNamespaceDenyList-Funktion finden Sie ​ den Eigenschaftsbeschreibungen in ​Tabelle) weiter oben auf dieser Seite.

Nächste Schritte next-steps

Jetzt wissen Sie, welche statischen und dynamischen Schematypen von Destination SDK unterstützt werden, wie Sie erforderliche Zuordnungen hinzufügen und wie Sie Ihr Ziel konfigurieren, um externe Zielgruppen zu unterstützen.

Weitere Informationen zu den anderen Zielkomponenten finden Sie in den folgenden Artikeln: