Voorbeeldprofielen genereren op basis van een bronschema
De eerste stap in het testen van uw op bestand gebaseerde bestemming is het /sample-profiles eindpunt te gebruiken om een steekproefprofiel te produceren dat op uw bestaand bronschema wordt gebaseerd.
Voorbeeldprofielen kunnen u helpen de JSON-structuur van een profiel te begrijpen. Bovendien geven ze u een standaardinstelling die u kunt aanpassen met uw eigen profielgegevens voor verdere doeltests.
Aan de slag getting-started
Alvorens verder te gaan, te herzien gelieve begonnen gidsvoor belangrijke informatie die u moet kennen om vraag aan API met succes te maken, met inbegrip van hoe te om de vereiste toestemming van de bestemmings authoring en vereiste kopballen te verkrijgen.
Vereisten prerequisites
Voordat u het eindpunt /sample-profiles kunt gebruiken, moet u controleren of aan de volgende voorwaarden is voldaan:
-
U hebt een bestaande op dossier-gebaseerde bestemming die door de Destination SDK wordt gecreeerd en u kunt het in uw catalogus van bestemmingenzien.
-
U hebt minstens één activeringsstroom voor uw bestemming in de gebruikersinterface van het Experience Platform gemaakt. Het
/sample-profileseindpunt leidt tot profielen die op het bronschema worden gebaseerd dat u in uw activeringsstroom bepaalde. Zie het activeringsleerprogrammaleren hoe te om een activeringsstroom tot stand te brengen. -
Als u de API-aanvraag met succes wilt uitvoeren, hebt u de id van de doelinstantie nodig die overeenkomt met de doelinstantie die u wilt testen. Krijg bestemmingsidentiteitskaart die u in de API vraag, van URL zou moeten gebruiken, wanneer het doorbladeren van een verbinding met uw bestemming in Platform UI.
Voorbeeldprofielen genereren voor doeltesten generate-sample-profiles
U kunt steekproefprofielen produceren die op uw bronschema worden gebaseerd door een verzoek van de GET aan het /sample-profiles eindpunt met bestemmingsidentiteitskaart van de instantie van de bestemming te doen die u wilt testen.
API formaat
GET /authoring/sample-profiles?destinationInstanceId={DESTINATION_INSTANCE_ID}&count={NUMBER_OF_GENERATED_PROFILES}
destinationInstanceIdcount1 - 1000 . Als deze eigenschap niet is gedefinieerd, genereert de API één voorbeeldprofiel.Verzoek
Met de volgende aanvraag wordt een voorbeeldprofiel gegenereerd op basis van het bronschema dat in de doelinstantie met de bijbehorende destinationInstanceId is gedefinieerd.
curl -X GET 'https://platform.adobe.io/data/core/activation/authoring/sample-profiles?destinationInstanceId={DESTINATION_INSTANCE_ID}' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Reactie
Een succesvolle reactie keert status 200 van HTTP met het gespecificeerde aantal steekproefprofielen, met publiekslidmaatschap, identiteiten, en profielattributen terug die aan het bronXDM schema beantwoorden.
[
{
"segmentMembership":{
"ups":{
"fea8d394-5a8c-4cea-bebc-df020ce37f5c":{
"lastQualificationTime":"2022-01-13T11:33:28.211895Z",
"status":"realized"
},
"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b":{
"lastQualificationTime":"2022-01-13T11:33:28.211893Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"john.smith@abc.com"
},
"identityMap":{
"crmid":[
{
"id":"crmid-P1A7l"
}
]
},
"person":{
"name":{
"firstName":"string",
"lastName":"string"
}
}
}
]
segmentMembershipsegmentMembership, lees de Details van het Lidmaatschap van de Publiek.lastQualificationTimestatusEen tekenreeksveld dat aangeeft of het publieklidmaatschap is gerealiseerd als onderdeel van de huidige aanvraag. De volgende waarden worden geaccepteerd:
realized: Het profiel maakt deel uit van het segment.exited: Het profiel sluit het publiek af als onderdeel van de huidige aanvraag.
identityMapidentityMap, zie basis van schemacompositie.API-foutafhandeling api-error-handling
Destination SDK API-eindpunten volgen de algemene API-foutberichtbeginselen voor Experience Platforms. Verwijs naar API statuscodesen de fouten van de verzoekkopbalin de het oplossen van problemengids van het Platform.
Volgende stappen
Na het lezen van dit document, weet u nu hoe te om steekproefprofielen te produceren die op het bronschema worden gebaseerd dat u in uw bestemmings activeringsstroomvormde.
U kunt deze profielen nu aanpassen of hen gebruiken aangezien zij door API zijn teruggekeerd, om uw op dossier-gebaseerde bestemmingsconfiguratiete testen.