Aggregationsrichtlinie

Letzte Aktualisierung: 2023-11-07
  • Erstellt für:
  • Developer
    User
    Admin
    Leader

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 im Konfigurationsoptionen Dokumentation oder lesen Sie das Handbuch zu Verwenden von Destination SDK zum Konfigurieren eines Streaming-Ziels.

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.

WICHTIG

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

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)

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.
TIPP

Verwenden Sie die Aggregation nach bestem Bemühen, wenn Ihr API-Endpunkt weniger als 100 Profile pro API-Aufruf akzeptiert.

Konfigurierbare 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

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:

Vorherige Seite
Next page

Auf dieser Seite