Politique d’agrégation

Pour garantir une efficacité maximale pendant l’exportation des données vers le point d’entrée de l’API, vous pouvez agréger à l’aide de divers paramètres les profils exportés en lots plus ou moins petits, les regrouper par identité et d’autres cas d’utilisation. Cela vous permet également d’adapter les exportations de données à toutes les limitations en aval du point d’entrée de l’API (limitation de débit, nombre d’identités par appel API, etc.).

Utilisez l’agrégation configurable pour vous plonger dans les paramètres de Destination SDK ou utilisez l’agrégation des meilleurs efforts pour indiquer à Destination SDK de traiter le mieux possible les appels API par lots.

Pendant la création d’une destination en temps réel (streaming) avec Destination SDK, vous pouvez configurer la manière dont les profils exportés doivent être combinés dans les exportations résultantes. Ce comportement est déterminé par les paramètres de la politique d’agrégation.

Pour comprendre où ce composant entre dans une intégration créée avec Destination SDK, reportez-vous au diagramme de la documentation options de configuration ou consultez le guide sur la utilisation de la Destination SDK pour configurer une destination de diffusion en continu.

Vous pouvez configurer les paramètres de la politique d’agrégation via le point d’entrée /authoring/destinations. Pour obtenir des exemples d’appels API détaillés dans lesquels vous pouvez configurer les composants affichés sur cette page, consultez les pages de référence de l’API suivantes.

Cet article décrit tous les paramètres de politique d’agrégation pris en charge que vous pouvez utiliser pour la destination.

Vous êtes arrivé au bout de ce document. À présent, consultez la documentation relative à l’utilisation de modèles ainsi que les exemples de clés d’agrégation pour comprendre comment inclure la politique d’agrégation dans le modèle de transformation des messages en fonction de la politique d’agrégation que vous avez sélectionnée.

Types d’intégration pris en charge supported-integration-types

Pour en savoir plus sur les types d’intégration qui prennent en charge les fonctionnalités décrites sur cette page, consultez le tableau ci-dessous.

Agrégation des meilleurs efforts best-effort-aggregation

L’agrégation des meilleurs efforts fonctionne mieux pour les destinations avec moins de profils par requête et qui préfèrent recevoir plus de requêtes avec moins de données.

L’exemple de configuration ci-dessous montre une configuration d’agrégation des meilleurs efforts. Pour obtenir un exemple d’agrégation configurable, consultez la section Agrégation configurable. Les paramètres applicables à l’agrégation des meilleurs efforts sont présentés dans le tableau ci-dessous.

"aggregation":{
   "aggregationType":"BEST_EFFORT",
   "bestEffortAggregation":{
      "maxUsersPerRequest":10,
      "splitUserById":false
   }
}

Agrégation configurable configurable-aggregation

L’agrégation configurable fonctionne mieux si vous préférez accepter des lots volumineux, avec des milliers de profils sur le même appel. Cette option permet également d’agréger les profils exportés en fonction de règles d’agrégation complexes.

L’exemple de configuration ci-dessous montre une configuration d’agrégation configurable. Pour obtenir un exemple d’agrégation des meilleurs efforts, consultez la section Agrégation des meilleurs efforts. Les paramètres applicables à l’agrégation configurable sont présentés dans le tableau ci-dessous.

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

Étapes suivantes next-steps

Vous êtes arrivé au bout de cet article. À présent, vous devriez mieux comprendre comment configurer les politiques d’agrégation pour la destination.

Pour en savoir plus sur les autres composants de destination, consultez les articles suivants :