Samenvoegingsbeleid
Voor maximale efficiëntie bij het exporteren van gegevens naar het API-eindpunt kunt u verschillende instellingen gebruiken om geëxporteerde profielen samen te voegen tot grotere of kleinere batches, deze te groeperen op basis van identiteit en andere gebruiksgevallen. Hierdoor kunt u ook gegevens exporteren naar eventuele lagere beperkingen op het API-eindpunt (snelheidsbeperking, aantal identiteiten per API-aanroep, enz.).
Gebruik configureerbare samenvoeging om diep in de montages te duiken die door Destination SDK worden verstrekt of beste inspanningssamenvoeging te gebruiken om Destination SDK te vertellen om de API vraag zo best te partijgen als het kan.
Wanneer u een realtime (streaming) bestemming maakt met Destination SDK, kunt u configureren hoe de geëxporteerde profielen moeten worden gecombineerd in de resulterende export. Dit gedrag wordt bepaald door de instellingen van het aggregatiebeleid.
Om te begrijpen waar deze component in een integratie past die met Destination SDK wordt gecreeerd, zie het diagram in de configuratieoptiesdocumentatie of zie de gids op hoe te gebruiken Destination SDK om een het stromen bestemmingte vormen.
U kunt de montages van het samenvoegingsbeleid via het /authoring/destinations
eindpunt vormen. Zie de volgende API verwijzingspagina's voor gedetailleerde API vraagvoorbeelden waar u de componenten kunt vormen die in deze pagina worden getoond.
In dit artikel worden alle ondersteunde instellingen voor samenvoegingsbeleid beschreven die u voor uw bestemming kunt gebruiken.
Na het lezen door dit document, verwijs naar de documentatie op gebruikend het templatingen de belangrijkste voorbeelden van de samenvoegingom te begrijpen hoe te om het samenvoegingsbeleid in uw malplaatje van de berichttransformatie te omvatten dat op uw geselecteerd samenvoegingsbeleid wordt gebaseerd.
Ondersteunde integratietypen supported-integration-types
Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.
Beste inspanningsaggregatie best-effort-aggregation
De beste inspanningssamenvoeging werkt het best voor bestemmingen die minder profielen per verzoek verkiezen en eerder meer verzoeken met minder gegevens dan minder verzoeken met meer gegevens zouden nemen.
In de onderstaande voorbeeldconfiguratie ziet u een aggregatieconfiguratie voor de beste inspanning. Voor een voorbeeld van configureerbare samenvoeging, zie de configureerbare samenvoegingsectie. De parameters die van toepassing zijn op de aggregatie van de best mogelijke inspanning worden in de onderstaande tabel beschreven.
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
}
aggregationType
Wijst op het type van samenvoegingsbeleid dat uw bestemming zou moeten gebruiken. Ondersteunde aggregatietypen:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
bestEffortAggregation.maxUsersPerRequest
Deze waarde wijst op het maximumaantal profielen dat uw eindpunt in één enkele vraag van HTTP zou moeten ontvangen. Merk op dat dit een beste inspanningssamenvoeging is. Bijvoorbeeld, als u waarde 100 specificeert, zou Platform om het even welk aantal profielen kunnen verzenden kleiner dan 100 op een vraag.
Als uw server niet per aanvraag meerdere gebruikers accepteert, stelt u deze waarde in op
1
.bestEffortAggregation.splitUserById
true
als uw server slechts één identiteit per aanroep accepteert, voor een opgegeven naamruimte voor de identiteit.Configureerbare samenvoeging configurable-aggregation
De configureerbare samenvoeging werkt het best als u eerder in grote partijen, met duizenden profielen op de zelfde vraag zou nemen. Met deze optie kunt u ook de geëxporteerde profielen samenvoegen op basis van complexe aggregatieregels.
De voorbeeldconfiguratie toont hieronder een configureerbare samenvoegingsconfiguratie. Voor een voorbeeld van beste inspanningssamenvoeging, zie de best inspanningssamenvoegingsectie. De parameters die van toepassing zijn op configureerbare aggregatie worden in de onderstaande tabel beschreven.
"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
Wijst op het type van samenvoegingsbeleid dat uw bestemming zou moeten gebruiken. Ondersteunde aggregatietypen:
BEST_EFFORT
CONFIGURABLE_AGGREGATION
configurableAggregation.splitUserById
true
als uw server slechts één identiteit per aanroep accepteert, voor een opgegeven naamruimte voor de identiteit.configurableAggregation.maxBatchAgeInSecs
Deze parameter wordt gebruikt in combinatie met maxNumEventsInBatch
en bepaalt hoe lang Experience Platform moet wachten tot een API-aanroep naar het eindpunt wordt verzonden.
- Minimumwaarde (in seconden): 1.800
- Maximumwaarde (in seconden): 3.600
Bijvoorbeeld, als u de maximumwaarde voor beide parameters gebruikt, zal het Experience Platform of 3.600 seconden OF wachten tot er 10000 gekwalificeerde profielen zijn alvorens de API vraag te maken, welke eerst gebeurt.
configurableAggregation.maxNumEventsInBatch
Deze parameter wordt gebruikt in combinatie met maxBatchAgeInSecs
en bepaalt hoeveel gekwalificeerde profielen moeten worden samengevoegd in een API-aanroep.
- Minimumwaarde: 1.000
- Maximumwaarde: 10.000
Bijvoorbeeld, als u de maximumwaarde voor beide parameters gebruikt, zal het Experience Platform of 3.600 seconden OF wachten tot er 10.000 gekwalificeerde profielen zijn alvorens de API vraag te maken, welke eerst gebeurt.
configurableAggregation.aggregationKey
configurableAggregation.aggregationKey.includeSegmentId
true
als u profielen wilt groeperen die naar uw doel zijn geëxporteerd op basis van gebruikers-id.configurableAggregation.aggregationKey.includeSegmentStatus
includeSegmentId
in op true
als u profielen wilt groeperen die naar uw doel zijn geëxporteerd op basis van gebruikers-id en de status van het publiek.configurableAggregation.aggregationKey.includeIdentity
true
als u profielen wilt groeperen die via naamruimte naar uw doel worden geëxporteerd.configurableAggregation.aggregationKey.oneIdentityPerGroup
true
als u wilt dat de geëxporteerde profielen worden samengevoegd in groepen op basis van één identiteit (GAID, IDFA, telefoonnummers, e-mail, enz.).configurableAggregation.aggregationKey.groups
Volgende stappen next-steps
Na het lezen van dit artikel, zou u een beter inzicht in moeten hebben hoe u samenvoegingsbeleid voor uw bestemming kunt vormen.
Raadpleeg de volgende artikelen voor meer informatie over de andere doelcomponenten:
- Configuratie van klantverificatie
- OAuth2-vergunning
- Gegevensvelden van de klant
- UI-kenmerken
- Schema-configuratie
- Configuratie naamruimte voor identiteit
- Ondersteunde toewijzingsconfiguraties
- Levering bestemming
- Configuratie van metagegevens voor publiek
- Batchconfiguratie
- Historische profielkwalificaties