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 aggregatie 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 Destination SDK gebruiken 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.
IMPORTANTOndersteunde integratietypen
Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.
| Type integratie | Ondersteunt functionaliteit |
|---|---|
| Integraties in realtime (streaming) | Ja |
| Op bestanden gebaseerde (batch) integratie | Nee |
Beste inspanningsaggregatie
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
}
}
| Parameter | Type | Beschrijving |
|---|---|---|
aggregationType | String |
Wijst op het type van samenvoegingsbeleid dat uw bestemming zou moeten gebruiken. Ondersteunde aggregatietypen:
|
bestEffortAggregation.maxUsersPerRequest | Geheel | Experience Platform kan meerdere geëxporteerde profielen samenvoegen in één HTTP-oproep. 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 Experience 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 | Boolean | Gebruik deze vlag als de vraag aan de bestemming door identiteit zou moeten worden verdeeld. Stel deze markering in op true als uw server slechts één identiteit per aanroep accepteert, voor een opgegeven naamruimte voor de identiteit. |
TIPConfigureerbare samenvoeging
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"
]
}
]
}
}
}
| Parameter | Type | Beschrijving |
|---|---|---|
aggregationType | String |
Wijst op het type van samenvoegingsbeleid dat uw bestemming zou moeten gebruiken. Ondersteunde aggregatietypen:
|
configurableAggregation.splitUserById | Boolean | Gebruik deze vlag als de vraag aan de bestemming door identiteit zou moeten worden verdeeld. Stel deze markering in op true als uw server slechts één identiteit per aanroep accepteert, voor een opgegeven naamruimte voor de identiteit. |
configurableAggregation.maxBatchAgeInSecs | Geheel |
Deze parameter wordt gebruikt in combinatie met
Als u bijvoorbeeld de maximumwaarde voor beide parameters gebruikt, wacht Experience Platform 3600 seconden OF tot er 10000 gekwalificeerde profielen zijn voordat de API-aanroep wordt uitgevoerd, afhankelijk van wat zich het eerst voordoet. |
configurableAggregation.maxNumEventsInBatch | Geheel |
Deze parameter wordt gebruikt in combinatie met
Als u bijvoorbeeld de maximumwaarde voor beide parameters gebruikt, wacht Experience Platform 3.600 seconden OF tot er 10.000 gekwalificeerde profielen zijn voordat de API-aanroep wordt uitgevoerd, afhankelijk van wat zich het eerst voordoet. |
configurableAggregation.aggregationKey | - | Hiermee kunt u de geëxporteerde profielen samenvoegen die aan de bestemming zijn toegewezen op basis van de hieronder beschreven parameters. |
configurableAggregation.aggregationKey.includeSegmentId | Boolean | Stel deze parameter in op true als u profielen wilt groeperen die naar uw doel zijn geëxporteerd op basis van gebruikers-id. |
configurableAggregation.aggregationKey.includeSegmentStatus | Boolean | Stel deze parameter en 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 | Boolean | Stel deze parameter in op true als u profielen wilt groeperen die via naamruimte naar uw doel worden geëxporteerd. |
configurableAggregation.aggregationKey.oneIdentityPerGroup | Boolean | Stel deze parameter in op 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 | Array | Maak lijsten met identiteitsgroepen als u profielen wilt groeperen die naar uw doel zijn geëxporteerd door groepen naamruimten. U kunt bijvoorbeeld profielen die de mobiele id's IDFA en GAID bevatten, combineren in één aanroep naar uw bestemming en e-mails in een andere via de configuratie die in het bovenstaande voorbeeld wordt getoond. |