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.
Unterstützte Integrationstypen supported-integration-types
Die nachstehende Tabelle beschreibt ausführlich, welche Integrationstypen die auf dieser Seite beschriebenen Funktionen unterstützen.
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
}
}
aggregationType
Gibt den Typ der Aggregationsrichtlinie an, die Ihr Ziel verwenden soll. Unterstützte Aggregationstypen:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
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
true
, wenn Ihr Server für einen gegebenen Namespace nur eine Identität pro 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"
]
}
]
}
}
}
aggregationType
Gibt den Typ der Aggregationsrichtlinie an, die Ihr Ziel verwenden soll. Unterstützte Aggregationstypen:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
true
, wenn Ihr Server für einen gegebenen Namespace nur eine Identität pro Aufruf akzeptiert.configurableAggregation.maxBatchAgeInSecs
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
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
configurableAggregation.aggregationKey.includeSegmentId
true
fest, wenn Sie Profile gruppieren möchten, die nach Zielgruppen-ID in Ihr Ziel exportiert wurden.configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
auf true
festlegen, wenn Sie die an Ihr Ziel exportierten Profile nach Zielgruppen-ID und Zielgruppenstatus gruppieren möchten.configurableAggregation.aggregationKey.includeIdentity
true
fest, wenn Sie Profile gruppieren möchten, die nach Identity-Namespace zu Ihrem Ziel exportiert wurden.configurableAggregation.aggregationKey.oneIdentityPerGroup
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
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:
- Konfiguration der Kundenauthentifizierung
- OAuth2-Autorisierung
- Benutzerdefinierte Datenfelder
- Benutzeroberflächenattribute
- Schemakonfiguration
- Konfiguration von Identity-Namespaces
- Unterstützte Zuordnungskonfigurationen
- Zielbereitstellung
- Konfiguration von Zielgruppen-Metadaten
- Batch-Konfiguration
- Historische Profilqualifikationen