Konfiguration des Streaming-Ziels

Übersicht

Mit dieser Konfiguration können Sie wichtige Informationen für Ihr Streaming-Ziel angeben, z. B. Ihren Zielnamen, Ihre Kategorie, eine Beschreibung und mehr. Die Einstellungen in dieser Konfiguration bestimmen auch, wie Experience Platform-Benutzer sich bei Ihrem Ziel authentifizieren, wie es in der Experience Platform-Benutzeroberfläche angezeigt wird und welche Identitäten an Ihr Ziel exportiert werden können.

Diese Konfiguration verbindet auch die anderen Konfigurationen, die für das Funktionieren Ihres Ziels erforderlich sind (Ziel-Server und Zielgruppen-Metadaten), mit dieser Konfiguration. Wie Sie die beiden Konfigurationen referenzieren können, erfahren Sie in einem Abschnitt weiter unten.

Sie können die in diesem Dokument beschriebenen Funktionen mithilfe des /authoring/destinations-API-Endpunkts konfigurieren. Eine vollständige Liste der Vorgänge, die Sie mit dem Endpunkt durchführen können, finden Sie unter API-Endpunktvorgänge für Ziele.

Beispiel für eine Streaming-Konfiguration

Dies ist eine Beispielkonfiguration des fiktiven Streaming-Ziels Moviestar, das Endpunkte an vier Orten auf der Welt hat. Das Ziel gehört zur Kategorie der mobilen Ziele.

{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointRegion",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{

            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "schemaConfig":{
      "profileRequired":false,
      "segmentRequired":true,
      "identityRequired":true
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "aggregation":{
      "aggregationType":"CONFIGURABLE_AGGREGATION",
      "configurableAggregation":{
         "splitUserById":true,
         "maxBatchAgeInSecs":2400,
         "maxNumEventsInBatch":5000,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":true,
            "groups":[
               {
                  "namespaces":[
                     "IDFA",
                     "GAID"
                  ]
               },
               {
                  "namespaces":[
                     "EMAIL"
                  ]
               }
            ]
         }
      }
   },
   "backfillHistoricalProfileData":true
}

Konfigurationen der Benutzerauthentifizierung

Mit diesem Abschnitt in der Zielkonfiguration wird die Seite Neues Ziel konfigurieren in der Experience Platform-Benutzeroberfläche generiert, auf der Benutzer Experience Platform mit den Konten verbinden, die sie an Ihrem Ziel haben. Je nachdem, welche Authentifizierungsoption Sie im Feld authType angeben, wird die Experience Platform-Seite für die Benutzer folgendermaßen generiert:

Bearer-Authentifizierung

Wenn Sie den Bearer-Authentifizierungstyp konfigurieren, müssen Benutzer das Bearer-Token eingeben, das sie von Ihrem Ziel erhalten.

OAuth 2-Authentifizierung

Benutzer wählen Mit Ziel verbinden aus, um den OAuth 2-Authentifizierungsfluss für Ihr Ziel auszulösen (siehe folgendes Beispiel für das Ziel „Twitter Custom Audiences“). Detaillierte Informationen zum Konfigurieren der OAuth 2-Authentifizierung für Ihren Ziel-Endpunkt finden Sie in der entsprechenden Authentifizierungsseite für Destination SDK OAuth 2.

Benutzerdefinierte Datenfelder

Verwenden Sie diesen Abschnitt, um Benutzer aufzufordern, benutzerdefinierte Felder für Ihr Ziel auszufüllen, wenn sie in der Experience Platform-Benutzeroberfläche eine Verbindung zum Ziel herstellen. Die Konfiguration wird wie unten dargestellt im Authentifizierungsfluss sichtbar.

Benutzeroberflächenattribute

Dieser Abschnitt bezieht sich auf die Benutzeroberflächenelemente in der obigen Konfiguration, die von Adobe für Ihr Ziel in der Adobe Experience Platform-Benutzeroberfläche verwendet werden sollte. Siehe unten:

Schemakonfiguration im Zuordnungsschritt

Verwenden Sie die Parameter in schemaConfig, um den Zuordnungsschritt des Zielaktivierungs-Workflows zu aktivieren. Mithilfe der unten beschriebenen Parameter können Sie bestimmen, ob Experience Platform-Benutzer Profilattribute und/oder Identitäten dem gewünschten Schema auf der Zielseite zuordnen können.

Identitäten und Attribute

Die Parameter in diesem Abschnitt bestimmen, welche Identitäten Ihr Ziel akzeptiert. Durch diese Konfiguration werden auch die Zielidentitäten und -attribute im Zuordnungsschritt der Experience Platform-Benutzeroberfläche ausgefüllt, in dem Benutzer Identitäten und Attribute aus ihren XDM-Schemata dem Schema in Ihrem Ziel zuordnen.

Sie müssen angeben, welche Platform-Identitäten Kunden in Ihr Ziel exportieren können. Einige Beispiele: Experience Cloud ID, gehashte E-Mail, Geräte-ID (IDFA, GAID). Diese Werte sind Identitäts-Namespaces von Platform, die Kunden von Ihrem Ziel aus Identitäts-Namespaces zuordnen können. Sie können auch angeben, ob Kunden benutzerdefinierte Namespaces den von Ihrem Ziel unterstützten Identitäten zuordnen können (acceptsCustomNamespaces: true) und ob Kunden standardmäßige XDM-Attribute Identitäten zuordnen können, die von Ihrem Ziel unterstützt werden (acceptsAttributes: true).

Identitäts-Namespaces erfordern keine 1:1-Korrespondenz zwischen Platform und Ihrem Ziel.
Kunden können beispielsweise einen IDFA-Namespace in Platform einem IDFA-Namespace Ihres Ziels zuordnen oder sie können denselben IDFA-Namespace in Platform einem Customer ID-Namespace in Ihrem Ziel zuordnen.

Weitere Informationen zu Identitäten finden Sie im Abschnitt Übersicht über Identity Namespace.

Zielbereitstellung

Konfiguration der Segmentzuordnung

Dieser Abschnitt der Zielkonfiguration bezieht sich darauf, wie Segmentmetadaten, etwa Segmentnamen oder IDs, zwischen Experience Platform und Ihrem Ziel freigegeben werden sollen.

Durch die audienceTemplateId verknüpft dieser Abschnitt diese Konfiguration auch mit der Konfiguration von Zielgruppen-Metadaten.

Die in der obigen Konfiguration angezeigten Parameter werden im Abschnitt Referenz für die Ziel-Endpunkt-API beschrieben.

Aggregationsrichtlinie

In diesem Abschnitt können Sie die Aggregationsrichtlinien festlegen, die Experience Platform beim Exportieren von Daten in Ihr Ziel verwenden soll.

Eine Aggregationsrichtlinie bestimmt, wie die exportierten Profile in den Datenexporten kombiniert werden. Verfügbare Optionen sind:

• Best-Effort-Aggregation
• Konfigurierbare Aggregation (siehe Konfiguration oben)

Lesen Sie den Abschnitt über die Verwendung von Vorlagen und die Aggregations-Beispiele, um zu verstehen, wie Sie die Aggregationsrichtlinie basierend auf Ihrer ausgewählten Aggregationsrichtlinie in Ihre Nachrichten-Umwandlungsvorlage einschließen.

Best-Effort-Aggregation

Diese Option eignet sich am besten für Ziele, die weniger Profile pro Anfrage bevorzugen und lieber mehr Anfragen mit weniger Daten als weniger Anfragen mit mehr Daten hätten.

Geben Sie über den Parameter maxUsersPerRequest die maximale Anzahl der Profile an, die Ihr Ziel in einer Anfrage aufnehmen kann.

Konfigurierbare Aggregation

Diese Option eignet sich am besten, wenn Sie im selben Aufruf große Batches mit Tausenden Profilen verwenden möchten. Mit dieser Option können Sie die exportierten Profile auch anhand komplexer Aggregationsregeln aggregieren.

Diese Option ermöglicht Ihnen Folgendes:

• Legen Sie vor einem eines API-Aufruf an Ihr Ziel die maximale Zeit und die maximale Anzahl von Profilen fest, die aggregiert werden sollen.
• Aggregieren Sie die exportierten, dem Ziel zugeordneten Profile anhand folgender Kriterien:
  • Segment-ID;
  • Segmentstatus;
  • Identität oder Gruppen von Identitäten.

Ausführliche Erläuterungen der Aggregationsparameter finden Sie auf der Seite API-Endpunktvorgänge für Ziele, wo jeder Parameter beschrieben wird.

Historische Profilqualifikationen

Sie können den Parameter backfillHistoricalProfileData in der Zielkonfiguration verwenden, um festzulegen, ob historische Profilqualifikationen in Ihr Ziel exportiert werden sollen.

Wie diese Konfiguration alle erforderlichen Informationen für Ihr Ziel verbindet

Einige Ihrer Zieleinstellungen müssen über den Ziel-Server oder die Zielgruppen-Metadatenkonfiguration konfiguriert werden. Die hier beschriebene Zielkonfiguration verbindet alle diese Einstellungen, indem sie wie folgt auf die beiden anderen Konfigurationen verweist:

• Verwenden Sie die destinationServerId, um auf den Ziel-Server und die Vorlagenkonfiguration zu verweisen, die für Ihr Ziel eingerichtet sind.
• Verwenden Sie die audienceMetadataId, um auf die für Ihr Ziel eingerichtete Zielgruppen-Metadatenkonfiguration zu verweisen.

Ressourcen für Business.Adobe.com