Validera mallsidiga kundfält

Översikt overview

Slutpunkten /authoring/testing/template/render hjälper dig att visualisera hur de mallsidiga kunddatafälten som definieras i målkonfigurationen skulle se ut.

Slutpunkten genererar slumpmässiga värden för kunddatafälten och returnerar dem i svaret. Detta hjälper dig att validera den semantiska strukturen i kunddatafält, till exempel bucketnamn eller mappsökvägar.

Komma igång getting-started

Innan du fortsätter bör du läsa igenom kom igång-guiden för att få viktig information som du behöver känna till för att kunna ringa anrop till API:t, inklusive hur du får nödvändig behörighet för målredigering och nödvändiga rubriker.

Förhandskrav prerequisites

Innan du kan använda slutpunkten /template/render måste du kontrollera att följande villkor uppfylls:

  • Du har ett befintligt filbaserat mål som skapats via Destinationen SDK och du kan se det i din målkatalog.

  • För att kunna utföra API-begäran behöver du det målinstans-ID som motsvarar den målinstans som du ska testa. Hämta det målinstans-ID som du bör använda i API-anropet från webbadressen när du bläddrar i en anslutning till målet i plattformsgränssnittet.

    Gränssnittsbild som visar hur du hämtar målinstans-ID från URL:en.

Återge mallsidiga kundfält render-customer-fields

API-format

POST /authoring/testing/template/render/destination

Om du vill visa beteendet för den här API-slutpunkten ska du överväga ett filbaserat mål med följande konfiguration för kunddatafält:

"fileBasedS3Destination":{
   "bucket":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.bucket}}"
   },
   "path":{
      "templatingStrategy":"PEBBLE_V1",
      "value":"{{customerData.path}}"
   }
}

Begäran

Begäran nedan anropar slutpunkten /authoring/testing/template/render, som returnerar ett svar med slumpmässigt genererade värden för de två kunddatafälten som nämns ovan.

curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/template/render/destination' \
 -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}' \
 -d '
 {
    "destinationId": "{DESTINATION_CONFIGURATION_ID}",
    "templates": {
        "bucket": "{{customerData.bucket}}",
        "path": "{{customerData.bucket}}/{{customerData.path}}"
    }
}'
Parametrar
Beskrivning
destinationId
ID:t för den målkonfiguration som du testar.
templates
De mallsidiga fältnamnen som definieras i målserverkonfigurationen.

Svar

Ett lyckat svar returnerar statusen HTTP 200 OK och brödtexten innehåller slumpmässigt genererade värden för dina mallsidiga fält.

Detta svar kan hjälpa er att validera den korrekta strukturen i kunddatafälten, till exempel bucketnamn eller mappsökvägar.

{
    "results": {
        "bucket": "hfWpE-bucket",
        "path": "hfWpE-bucket/ceC"
    }
}

API-felhantering api-error-handling

Destination SDK-API-slutpunkter följer de allmänna felmeddelandeprinciperna för Experience Platform API. Se API-statuskoder och begäranrubrikfel i felsökningsguiden för plattformen.

Nästa steg next-steps

När du har läst det här dokumentet vet du nu hur du validerar konfigurationen av kunddatafält som definierats i målservern.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6