Een transformatiesjabloon voor een voorbeeldbericht genereren get-sample-template-api-operations
https://platform.adobe.io/data/core/activation/authoring/testing/template/sampleDeze pagina maakt een lijst en beschrijft alle API verrichtingen die u het gebruiken van het /authoring/testing/template/sample API eindpunt kunt uitvoeren, om het malplaatje van de a berichttransformatievoor uw bestemming te produceren. Voor een beschrijving van de functionaliteit die door dit eindpunt wordt gesteund, lees creeer malplaatje.
Aan de slag met API-voorbeeldbewerkingen voor sjablonen get-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.
Voorbeeldsjabloon ophalen generate-sample-template
U kunt een steekproefmalplaatje krijgen door een verzoek van de GET tot het authoring/testing/template/sample/ eindpunt te richten en bestemmingsidentiteitskaart van de bestemmingsconfiguratie te verstrekken die op wordt gebaseerd die u uw malplaatje creeert.
- De doel-id die u hier moet gebruiken, is de
instanceIddie overeenkomt met een doelconfiguratie die is gemaakt met het/destinations-eindpunt. Verwijs naar terugwinnen een bestemmingsconfiguratievoor meer details.
API formaat
GET authoring/testing/template/sample/{DESTINATION_ID}
{DESTINATION_ID}Verzoek
Het volgende verzoek produceert een nieuw steekproefmalplaatje, dat door de parameters wordt gevormd die in de lading worden verstrekt.
curl --location --request GET 'https://platform.adobe.io/data/core/activation/authoring/testing/template/sample/5114d758-ce71-43ba-b53e-e2a91d67b67f' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
Reactie
Een geslaagde reactie retourneert HTTP-status 200 met een voorbeeldsjabloon die u kunt bewerken om aan te passen aan de verwachte gegevensindeling.
Als bestemmingsidentiteitskaart u verstrekt aan een bestemmingsconfiguratie met beste inspanningssamenvoegingen maxUsersPerRequest=1 in het samenvoegingsbeleid beantwoordt, keert het verzoek een steekproefmalplaatje gelijkend op dit terug:
{#- THIS is an example template for a single profile -#}
{#- A '-' at the beginning or end of a tag removes all whitespace on that side of the tag. -#}
{
"identities": [
{%- for idMapEntry in input.profile.identityMap -%}
{%- set namespace = idMapEntry.key -%}
{%- for identity in idMapEntry.value %}
{
"type": "{{ namespace }}",
"id": "{{ identity.id }}"
}{%- if not loop.last -%},{%- endif -%}
{%- endfor -%}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{%- for segment in input.profile.segmentMembership.ups | added %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"remove": [
{#- Alternative syntax for filtering audiences by status: -#}
{% for segment in removedSegments(input.profile.segmentMembership.ups) %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
}
Als bestemmingsidentiteitskaart u verstrekt aan een malplaatje van de bestemmingsserver met configureerbare samenvoegingof beste inspanningssamenvoegingmet maxUsersPerRequest groter dan één beantwoordt, keert het verzoek een steekproefmalplaatje gelijkend op dit terug:
{#- THIS is an example template for multiple profiles -#}
{#- A '-' at the beginning or end of a tag removes all whitespace on that side of the tag. -#}
{
"profiles": [
{%- for profile in input.profiles %}
{
"identities": [
{%- for idMapEntry in profile.identityMap -%}
{%- set namespace = idMapEntry.key -%}
{%- for identity in idMapEntry.value %}
{
"type": "{{ namespace }}",
"id": "{{ identity.id }}"
}{%- if not loop.last -%},{%- endif -%}
{%- endfor -%}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{%- for segment in profile.segmentMembership.ups | added %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
],
"remove": [
{#- Alternative syntax for filtering audiences by status: -#}
{% for segment in removedSegments(profile.segmentMembership.ups) %}
"{{ segment.key }}"{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
}{%- if not loop.last -%},{%- endif -%}
{% endfor %}
]
}
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 next-steps
Nadat u dit document hebt gelezen, weet u nu hoe u een sjabloon voor berichttransformatie kunt genereren met behulp van het API-eindpunt van /authoring/testing/template/sample . Daarna, kunt u gebruiken teruggeeft malplaatje API eindpuntom uitgevoerde profielen te produceren die op het malplaatje worden gebaseerd en hen tegen het verwachte gegevensformaat van uw bestemming te vergelijken.