Criterio di aggregazione

Per garantire la massima efficienza durante l’esportazione dei dati nell’endpoint API, puoi utilizzare varie impostazioni per aggregare i profili esportati in batch più o meno grandi, raggrupparli per identità e altri casi d’uso. Questo ti consente anche di adattare le esportazioni di dati a qualsiasi limite a valle dell’endpoint API (limitazione di frequenza, numero di identità per chiamata API, ecc.).

Utilizza l’aggregazione configurabile per immergerti nelle impostazioni fornite da Destination SDK oppure utilizza l’aggregazione della massima diligenza per dire a Destination SDK di raggruppare le chiamate API nel miglior modo possibile.

Quando crei una destinazione in tempo reale (streaming) con Destination SDK, puoi configurare il modo in cui i profili esportati devono essere combinati nelle esportazioni risultanti. Questo comportamento è determinato dalle impostazioni dei criteri di aggregazione.

Per capire dove questo componente si inserisce in un’integrazione creata con Destination SDK, consulta il diagramma riportato di seguito. opzioni di configurazione o consulta la guida su come utilizzare Destination SDK per configurare una destinazione di streaming.

È possibile configurare le impostazioni dei criteri di aggregazione tramite /authoring/destinations endpoint. Consulta le seguenti pagine di riferimento API per esempi dettagliati di chiamate API, in cui puoi configurare i componenti mostrati in questa pagina.

In questo articolo vengono descritte tutte le impostazioni dei criteri di aggregazione supportate che è possibile utilizzare per la destinazione.

Dopo aver letto questo documento, consulta la documentazione su utilizzo dei modelli e esempi chiave di aggregazione per informazioni su come includere il criterio di aggregazione nel modello di trasformazione dei messaggi in base al criterio di aggregazione selezionato.

Tipi di integrazione supportati supported-integration-types

Consulta la tabella seguente per informazioni dettagliate sui tipi di integrazioni che supportano le funzionalità descritte in questa pagina.

Aggregazione ottimale best-effort-aggregation

L’aggregazione basata sullo sforzo migliore funziona meglio per le destinazioni che preferiscono meno profili per richiesta e che accettano più richieste con meno dati rispetto a meno richieste con più dati.

L’esempio di configurazione seguente mostra una configurazione dell’aggregazione ottimale. Per un esempio di aggregazione configurabile, vedi aggregazione configurabile sezione. I parametri applicabili all’aggregazione della migliore sforzo sono documentati nella tabella seguente.

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

Aggregazione configurato configurable-aggregation

L’aggregazione configurabile funziona meglio se si preferisce gestire batch di grandi dimensioni con migliaia di profili nella stessa chiamata. Questa opzione consente inoltre di aggregare i profili esportati in base a regole di aggregazione complesse.

L’esempio di configurazione seguente mostra una configurazione dell’aggregazione configurabile. Per un esempio di aggregazione della migliore sforzo, vedi aggregazione della migliore fatica sezione. I parametri applicabili all’aggregazione configurabile sono indicati nella tabella seguente.

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

Passaggi successivi next-steps

Dopo aver letto questo articolo, sarai in grado di comprendere meglio come configurare i criteri di aggregazione per la tua destinazione.

Per ulteriori informazioni sugli altri componenti di destinazione, consulta i seguenti articoli: