Política de agregación
Para garantizar la máxima eficacia al exportar datos al extremo de la API, puede utilizar varias configuraciones para acumular perfiles exportados en lotes más grandes o más pequeños, agruparlos por identidad y otros casos de uso. Esto también le permite adaptar las exportaciones de datos a cualquier limitación descendente de su punto final de API (limitación de velocidad, número de identidades por llamada de API, etc.).
Utilice la agregación configurable para profundizar en la configuración proporcionada por el Destination SDK o utilice la agregación de mejor esfuerzo para indicar al Destination SDK que agrupe las llamadas de API lo mejor que pueda.
Al crear un destino en tiempo real (de flujo continuo) con Destination SDK, puede configurar cómo se deben combinar los perfiles exportados en las exportaciones resultantes. Este comportamiento está determinado por la configuración de la directiva de agregación.
Para saber dónde encaja este componente en una integración creada con Destination SDK, consulte el diagrama en la documentación de opciones de configuración o consulte la guía sobre cómo usar Destination SDK para configurar un de flujo continuo.
Puede configurar las opciones de la directiva de agregación a través del extremo /authoring/destinations
. Consulte las siguientes páginas de referencia de la API para ver ejemplos detallados de llamadas de la API donde puede configurar los componentes que se muestran en esta página.
Este artículo describe todas las configuraciones de directiva de agregación admitidas que puede utilizar para el destino.
Después de leer este documento, consulte la documentación de usando la creación de plantillas y los ejemplos de claves de agregación para saber cómo incluir la directiva de agregación en la plantilla de transformación de mensajes en función de la directiva de agregación seleccionada.
Tipos de integración admitidos supported-integration-types
Consulte la tabla siguiente para obtener detalles sobre qué tipos de integraciones admiten la funcionalidad descrita en esta página.
Agregación del mejor esfuerzo best-effort-aggregation
La agregación de mejor esfuerzo funciona mejor para los destinos que prefieren menos perfiles por solicitud y que preferirían aceptar más solicitudes con menos datos que menos solicitudes con más datos.
La configuración de ejemplo siguiente muestra una configuración de agregación de mejor esfuerzo. Para ver un ejemplo de agregación configurable, consulte la sección agregación configurable. Los parámetros aplicables a la agregación del mejor esfuerzo se documentan en la tabla siguiente.
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
}
aggregationType
Indica el tipo de directiva de agregación que debe utilizar el destino. Tipos de agregación admitidos:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
Este valor indica el número máximo de perfiles que su extremo debe recibir en una sola llamada HTTP. Tenga en cuenta que se trata de una agregación de mejor esfuerzo. Por ejemplo, si especifica el valor 100, Platform puede enviar cualquier número de perfiles inferior a 100 en una llamada.
Si el servidor no acepta varios usuarios por solicitud, establezca este valor en
1
.bestEffortAggregation.splitUserById
true
si el servidor solo acepta una identidad por llamada, para un área de nombres de identidad determinada.Agregación configurable configurable-aggregation
La agregación configurable funciona mejor si prefiere utilizar lotes grandes, con miles de perfiles en la misma llamada. Esta opción también le permite agregar los perfiles exportados en función de reglas de agregación complejas.
La configuración de ejemplo siguiente muestra una configuración de agregación configurable. Para ver un ejemplo de agregación de esfuerzo recomendado, vea la sección agregación de esfuerzo recomendado. Los parámetros aplicables a la agregación configurable se documentan en la siguiente tabla.
"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
Indica el tipo de directiva de agregación que debe utilizar el destino. Tipos de agregación admitidos:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
true
si el servidor solo acepta una identidad por llamada, para un área de nombres de identidad determinada.configurableAggregation.maxBatchAgeInSecs
Este parámetro, que se usa junto con maxNumEventsInBatch
, determina cuánto tiempo debe esperar el Experience Platform hasta que envíe una llamada de API al extremo.
- Valor mínimo (segundos): 1800
- Valor máximo (segundos): 3600
Por ejemplo, si utiliza el valor máximo para ambos parámetros, Experience Platform esperará 3600 segundos O hasta que haya 10000 perfiles cualificados antes de realizar la llamada de API, lo que ocurra primero.
configurableAggregation.maxNumEventsInBatch
Este parámetro, que se usa junto con maxBatchAgeInSecs
, determina cuántos perfiles completos se deben agregar en una llamada de API.
- Valor mínimo: 1000
- Valor máximo: 10000
Por ejemplo, si utiliza el valor máximo para ambos parámetros, Experience Platform esperará 3600 segundos O hasta que haya 10000 perfiles cualificados antes de realizar la llamada de API, lo que ocurra primero.
configurableAggregation.aggregationKey
configurableAggregation.aggregationKey.includeSegmentId
true
si desea agrupar los perfiles exportados a su destino por ID de audiencia.configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
en true
, si desea agrupar los perfiles exportados a su destino por ID de audiencia y estado de audiencia.configurableAggregation.aggregationKey.includeIdentity
true
si desea agrupar los perfiles exportados a su destino por área de nombres de identidad.configurableAggregation.aggregationKey.oneIdentityPerGroup
true
si desea que los perfiles exportados se agreguen en grupos según una sola identidad (GAID, IDFA, números de teléfono, correo electrónico, etc.).configurableAggregation.aggregationKey.groups
Pasos siguientes next-steps
Después de leer este artículo, debería tener una mejor comprensión de cómo puede configurar las directivas de agregación para su destino.
Para obtener más información acerca de los demás componentes de destino, consulte los siguientes artículos:
- Configuración de autenticación del cliente
- Autorización de OAuth2
- Campos de datos del cliente
- Atributos de IU
- Configuración del esquema
- Configuración del área de nombres de identidad
- Configuraciones de asignación compatibles
- Envío de destino
- Configuración de metadatos de audiencia
- Configuración por lotes
- Cualificaciones históricas del perfil