Samlingsprincip

För att vara så effektiv som möjligt när du exporterar data till API-slutpunkten kan du använda olika inställningar för att samla exporterade profiler i större eller mindre grupper, gruppera dem efter identitet och andra användningsfall. På så sätt kan du skräddarsy dataexport till eventuella efterföljande begränsningar för API-slutpunkten (hastighetsbegränsning, antal identiteter per API-anrop osv.).

Använd konfigurerbar aggregering för att fördjupa dig i inställningarna som tillhandahålls av Destinationen SDK eller använd bästa möjliga ansträngningsaggregering för att ange för Destinationen SDK att batchköra API-anropen så mycket som möjligt.

När du skapar ett mål för direktuppspelning i realtid med Destination SDK kan du konfigurera hur de exporterade profilerna ska kombineras i den resulterande exporten. Det här beteendet avgörs av inställningarna för aggregeringsprincipen.

Mer information om var den här komponenten passar in i en integrering som skapats med Destination SDK finns i diagrammet i dokumentationen för konfigurationsalternativ eller i guiden om hur du använder Destination SDK för att konfigurera ett direktuppspelningsmål.

Du kan konfigurera inställningar för aggregeringsprincip via slutpunkten /authoring/destinations. På följande API-referenssidor finns detaljerade API-anropsexempel där du kan konfigurera komponenterna som visas på den här sidan.

I den här artikeln beskrivs alla aggregeringsprincipinställningar som stöds och som du kan använda för ditt mål.

När du har läst igenom det här dokumentet kan du läsa dokumentationen för med mallar och exempel för aggregeringsnycklar för att förstå hur du inkluderar aggregeringsregeln i mallen för meddelandetransformering baserat på den valda aggregeringsregeln.

IMPORTANT
Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänsliga. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

Integrationstyper som stöds supported-integration-types

Se tabellen nedan för mer ingående information om vilka typer av integreringar som stöder de funktioner som beskrivs på den här sidan.

Integrationstyp
Stöder funktioner
Integrering i realtid (direktuppspelning)
Ja
Filbaserade (batch) integreringar
Nej

Bästa ansträngningsaggregering best-effort-aggregation

Bästa ansträngningsaggregering fungerar bäst för mål som föredrar färre profiler per begäran och som hellre vill ta in fler förfrågningar med mindre data än färre förfrågningar med mer data.

I exempelkonfigurationen nedan visas en aggregeringskonfiguration för bästa insats. Ett exempel på konfigurerbar aggregering finns i avsnittet konfigurerbar aggregering. De parametrar som är tillämpliga på bästa möjliga ansträngningsaggregering beskrivs i tabellen nedan.

"aggregation":{
   "aggregationType":"BEST_EFFORT",
   "bestEffortAggregation":{
      "maxUsersPerRequest":10,
      "splitUserById":false
   }
}
Parameter
Typ
Beskrivning
aggregationType
Sträng

Anger vilken typ av aggregeringsprincip som ditt mål ska använda. Aggregeringstyper som stöds:

  • BEST_EFFORT
  • CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
Heltal
Experience Platform kan samla flera exporterade profiler i ett enda HTTP-anrop.

Det här värdet anger det maximala antalet profiler som din slutpunkt ska ta emot i ett enda HTTP-anrop. Observera att detta är en bästa ansträngningsaggregering. Om du till exempel anger värdet 100 kan Platform skicka valfritt antal profiler som är mindre än 100 på ett samtal.

Om servern inte accepterar flera användare per begäran anger du det här värdet till 1.
bestEffortAggregation.splitUserById
Boolean
Använd den här flaggan om anropet till målet ska delas efter identitet. Ange den här flaggan som true om servern bara accepterar en identitet per anrop för ett givet ID-namnområde.
TIP
Använd aggregering av bästa möjliga ansträngning om API-slutpunkten accepterar färre än 100 profiler per API-anrop.

Konfigurerbar aggregering configurable-aggregation

Konfigurerbar aggregering fungerar bäst om du hellre vill ta med stora grupper, med tusentals profiler på samma samtal. Med det här alternativet kan du också sammanfoga de exporterade profilerna baserat på komplexa sammanställningsregler.

I exempelkonfigurationen nedan visas en konfigurerbar aggregeringskonfiguration. Ett exempel på bästa möjliga ansträngningsaggregering finns i avsnittet bästa ansträngningsaggregering. De parametrar som är tillämpliga på konfigurerbar aggregering beskrivs i tabellen nedan.

"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"
               ]
            }
         ]
      }
   }
}
Parameter
Typ
Beskrivning
aggregationType
Sträng

Anger vilken typ av aggregeringsprincip som ditt mål ska använda. Aggregeringstyper som stöds:

  • BEST_EFFORT
  • CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
Boolean
Använd den här flaggan om anropet till målet ska delas efter identitet. Ange den här flaggan som true om servern bara accepterar en identitet per anrop för ett givet ID-namnområde.
configurableAggregation.maxBatchAgeInSecs
Heltal

Den här parametern används tillsammans med maxNumEventsInBatch och avgör hur länge Experience Platform ska vänta tills ett API-anrop skickas till slutpunkten.

  • Minsta värde (sekunder): 1 800
  • Högsta värde (sekunder): 3 600

Om du till exempel använder maxvärdet för båda parametrarna väntar Experience Platform antingen 3600 sekunder ELLER tills det finns 1000 kvalificerade profiler innan API-anropet görs, beroende på vilket som inträffar först.

configurableAggregation.maxNumEventsInBatch
Heltal

Den här parametern används tillsammans med maxBatchAgeInSecs och avgör hur många kvalificerade profiler som ska aggregeras i ett API-anrop.

  • Minsta värde: 1000
  • Högsta värde: 10000

Om du till exempel använder maxvärdet för båda parametrarna väntar Experience Platform antingen 3600 sekunder ELLER tills det finns 1000 kvalificerade profiler innan API-anropet görs, beroende på vilket som inträffar först.

configurableAggregation.aggregationKey
Gör att du kan sammanställa de exporterade profilerna som är mappade till målet baserat på parametrarna som beskrivs nedan.
configurableAggregation.aggregationKey.includeSegmentId
Boolean
Ange den här parametern till true om du vill gruppera profiler som exporterats till målet efter målgrupps-ID.
configurableAggregation.aggregationKey.includeSegmentStatus
Boolean
Ange både den här parametern och includeSegmentId som true om du vill gruppera profiler som exporterats till ditt mål efter målgrupps-ID och målgruppsstatus.
configurableAggregation.aggregationKey.includeIdentity
Boolean
Ange den här parametern till true om du vill gruppera profiler som exporterats till målet efter identitetsnamnområde.
configurableAggregation.aggregationKey.oneIdentityPerGroup
Boolean
Ange den här parametern till true om du vill att de exporterade profilerna ska samlas i grupper baserat på en enda identitet (GAID, IDFA, telefonnummer, e-post osv.).
configurableAggregation.aggregationKey.groups
Array
Skapa listor med identitetsgrupper om du vill gruppera profiler som exporterats till ditt mål med grupper av identitetsnamnutrymmen. Du kan t.ex. kombinera profiler som innehåller IDFA- och GAID-mobilidentifierare i ett anrop till ditt mål och e-postmeddelanden i ett annat genom att använda konfigurationen som visas i exemplet ovan.

Nästa steg next-steps

När du har läst den här artikeln bör du få en bättre förståelse för hur du kan konfigurera aggregeringsregler för ditt mål.

Mer information om de andra målkomponenterna finns i följande artiklar:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6