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.
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.
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
}
}
aggregationType
Anger vilken typ av aggregeringsprincip som ditt mål ska använda. Aggregeringstyper som stöds:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
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
true
om servern bara accepterar en identitet per anrop för ett givet ID-namnområde.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"
]
}
]
}
}
}
aggregationType
Anger vilken typ av aggregeringsprincip som ditt mål ska använda. Aggregeringstyper som stöds:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
true
om servern bara accepterar en identitet per anrop för ett givet ID-namnområde.configurableAggregation.maxBatchAgeInSecs
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
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
configurableAggregation.aggregationKey.includeSegmentId
true
om du vill gruppera profiler som exporterats till målet efter målgrupps-ID.configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
som true
om du vill gruppera profiler som exporterats till ditt mål efter målgrupps-ID och målgruppsstatus.configurableAggregation.aggregationKey.includeIdentity
true
om du vill gruppera profiler som exporterats till målet efter identitetsnamnområde.configurableAggregation.aggregationKey.oneIdentityPerGroup
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
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: