Aggregationsrichtlinie

Um beim Export von Daten in Ihren API-Endpunkt maximale Effizienz zu gewährleisten, können Sie verschiedene Einstellungen verwenden, um etwa exportierte Profile in größere oder kleinere Batches zu aggregieren, sie nach Identität zu gruppieren, und andere Anwendungsfälle. Auf diese Weise können Sie Datenexporte auch auf nachgelagerte Einschränkungen Ihres API-Endpunkts anpassen (Ratenbegrenzung, Anzahl der Identitäten pro API-Aufruf usw.).

Verwenden Sie eine konfigurierbare Aggregation, um sich einen tiefen Einblick in die von Destination SDK bereitgestellten Einstellungen zu verschaffen, oder nutzen Sie die Aggregation nach bestem Bemühen, um Destination SDK anzuweisen, die API-Aufrufe so gut wie möglich zu bündeln.

Beim Erstellen eines Echtzeit-Ziels (Streaming) mit Destination SDK können Sie konfigurieren, wie die exportierten Profile in den resultierenden Exporten kombiniert werden sollen. Dieses Verhalten wird durch die Einstellungen der Aggregationsrichtlinie bestimmt.

Informationen dazu, wo diese Komponente in eine mit Destination SDK erstellte Integration passt, finden Sie im Diagramm in der Dokumentation zu Konfigurationsoptionen oder im Handbuch dazu, wie Sie mit der Destination SDK ein Streaming-Ziel konfigurieren.

Sie können die Einstellungen der Aggregationsrichtlinie über den Endpunkt /authoring/destinations konfigurieren. 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.

In diesem Artikel werden alle unterstützten Einstellungen für Aggregationsrichtlinien beschrieben, die Sie für Ihr Ziel verwenden können.

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

IMPORTANT
Bei allen von Destination SDK unterstützten Parameternamen und Werten wird nach Groß-/Kleinschreibung unterschieden. Um Fehler bei der Groß-/Kleinschreibung zu vermeiden, verwenden Sie bitte die Parameternamen und -werte genau wie in der Dokumentation dargestellt.

Unterstützte Integrationstypen supported-integration-types

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

Integrationstyp
Unterstützt Funktionen
Echtzeit-Integrationen (Streaming)
Ja
Dateibasierte (Batch-)Integrationen
Nein

Aggregation nach bestem Bemühen (Best-Effort-Aggregation) best-effort-aggregation

Die Aggregation nach bestem Bemühen 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.

Die folgende Beispielkonfiguration zeigt eine Konfiguration einer Aggregation nach bestem Bemühen. Ein Beispiel für eine konfigurierbare Aggregation finden Sie im Abschnitt konfigurierbare Aggregation. Die Parameter für die Aggregation nach bestem Bemühen sind in der folgenden Tabelle beschrieben.

"aggregation":{
   "aggregationType":"BEST_EFFORT",
   "bestEffortAggregation":{
      "maxUsersPerRequest":10,
      "splitUserById":false
   }
}
Parameter
Typ
Beschreibung
aggregationType
Zeichenfolge

Gibt den Typ der Aggregationsrichtlinie an, die Ihr Ziel verwenden soll. Unterstützte Aggregationstypen:

  • BEST_EFFORT
  • CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
Ganzzahl
Experience Platform kann mehrere exportierte Profile in einem einzigen HTTP-Aufruf aggregieren.

Geben Sie hier die maximale Anzahl von Profilen an, die Ihr Endpunkt in einem einzelnen HTTP-Aufruf erhalten soll. Beachten Sie, dass dies eine bestmögliche Aggregation ist. Wenn Sie beispielsweise den Wert 100 angeben, kann Platform eine beliebige Anzahl von Profilen senden, solange es weniger als 100 sind.

Wenn Ihr Server nicht mehrere Benutzerinnen oder Benutzer pro Anfrage akzeptiert, setzen Sie diesen Wert auf 1.
bestEffortAggregation.splitUserById
Boolesch
Verwenden Sie dieses Flag, wenn der Aufruf an das Ziel nach Identität aufgeteilt werden soll. Setzen Sie dieses Flag auf true, wenn Ihr Server für einen gegebenen Namespace nur eine Identität pro Aufruf akzeptiert.
TIP
Verwenden Sie die Aggregation nach bestem Bemühen, wenn Ihr API-Endpunkt weniger als 100 Profile pro API-Aufruf akzeptiert.

Konfigurierbare Aggregation configurable-aggregation

Die konfigurierbare Aggregation 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.

Die folgende Beispielkonfiguration zeigt eine konfigurierbare Aggregationskonfiguration. Ein Beispiel für die Aggregation nach bestem Bemühen finden Sie im Abschnitt Aggregation nach bestem Bemühen. Die Parameter für die konfigurierbare Aggregation sind in der folgenden Tabelle beschrieben.

"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"
               ]
            }
         ]
      }
   }
}
Parameter
Typ
Beschreibung
aggregationType
Zeichenfolge

Gibt den Typ der Aggregationsrichtlinie an, die Ihr Ziel verwenden soll. Unterstützte Aggregationstypen:

  • BEST_EFFORT
  • CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
Boolesch
Verwenden Sie dieses Flag, wenn der Aufruf an das Ziel nach Identität aufgeteilt werden soll. Setzen Sie dieses Flag auf true, wenn Ihr Server für einen gegebenen Namespace nur eine Identität pro Aufruf akzeptiert.
configurableAggregation.maxBatchAgeInSecs
Ganzzahl

Zusammen mit maxNumEventsInBatch bestimmt dieser Parameter, wie lange Experience Platform warten soll, bis ein API-Aufruf an Ihren Endpunkt gesendet wird.

  • Mindestwert (Sekunden): 1800
  • Höchstwert (Sekunden): 3600

Wenn Sie beispielsweise den Maximalwert für beide Parameter verwenden, wartet Experience Platform entweder 3.600 Sekunden ODER, bis 10000 qualifizierte Profile vorhanden sind, bevor der API-Aufruf erfolgt (je nachdem, was früher eintritt).

configurableAggregation.maxNumEventsInBatch
Ganzzahl

Zusammen mit maxBatchAgeInSecs bestimmt dieser Parameter, wie viele qualifizierte Profile in einem API-Aufruf aggregiert werden sollen.

  • Mindestwert: 1000
  • Höchstwert: 10.000

Wenn Sie beispielsweise den Maximalwert für beide Parameter verwenden, wartet Experience Platform entweder 3.600 Sekunden ODER, bis 10000 qualifizierte Profile vorhanden sind, bevor der API-Aufruf erfolgt (je nachdem, was früher eintritt).

configurableAggregation.aggregationKey
Ermöglicht die Aggregation der dem Ziel zugeordneten exportierten Profile anhand der folgenden Parameter.
configurableAggregation.aggregationKey.includeSegmentId
Boolesch
Legen Sie diesen Parameter auf true fest, wenn Sie Profile gruppieren möchten, die nach Zielgruppen-ID in Ihr Ziel exportiert wurden.
configurableAggregation.aggregationKey.includeSegmentStatus
Boolesch
Sie müssen sowohl diesen Parameter als auch den Parameter includeSegmentId auf true festlegen, wenn Sie die an Ihr Ziel exportierten Profile nach Zielgruppen-ID und Zielgruppenstatus gruppieren möchten.
configurableAggregation.aggregationKey.includeIdentity
Boolesch
Legen Sie diesen Parameter auf true fest, wenn Sie Profile gruppieren möchten, die nach Identity-Namespace zu Ihrem Ziel exportiert wurden.
configurableAggregation.aggregationKey.oneIdentityPerGroup
Boolesch
Legen Sie diesen Parameter auf true fest, um anzugeben, ob die exportierten Profile in Gruppen einer einzigen Identität zusammengefasst werden sollen (GAID, IDFA, Telefonnummern, E-Mail usw.).
configurableAggregation.aggregationKey.groups
Array
Erstellen Sie Listen mit Identitätsgruppen, wenn Sie Profile gruppieren möchten, die nach Gruppen von Identity-Namespaces in Ihr Ziel exportiert wurden. Beispielsweise können Sie Profile, die die Kennungen IDFA und GAID für Mobilgeräte enthalten, mithilfe der im obigen Beispiel beschriebenen Konfiguration zu einem Aufruf an Ihr Ziel und E-Mails an ein anderes kombinieren.

Nächste Schritte next-steps

Nach dem Lesen dieses Artikels sollten Sie besser verstehen, wie Sie Aggregationsrichtlinien für Ihr Ziel konfigurieren können.

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6