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
   }
}

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"
               ]
            }
         ]
      }
   }
}

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: