Visa detaljerade aktiveringsresultat view-test-results

Översikt overview

På den här sidan beskrivs hur du använder API-slutpunkten /testing/destinationInstance för att visa fullständig information om filbaserade måltestningsresultat.

Om du redan har testat ditt mål och fått ett giltigt API-svar fungerar ditt mål korrekt.

Om du vill se mer detaljerad information om aktiveringsflödet kan du använda egenskapen results från slutpunktssvaret för måltestning enligt beskrivningen nedan.

NOTE
Denna API-slutpunkt returnerar samma resultat som du skulle få när du använde Flow Service API för att övervaka dataflöden.

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 /testing/destinationInstance 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.

  • Du har skapat minst ett aktiveringsflöde för destinationen i användargränssnittet i Experience Platform.

  • 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.

  • Du har tidigare testat målkonfigurationen och fått ett giltigt API-svar, som innehåller en results -egenskap. Du kommer att använda det här results-värdet för att testa målet ytterligare.

Visa detaljerade testresultat för destinationer test-activation-results

När du har verifierat målkonfigurationen kan du visa detaljerade aktiveringsresultat genom att göra en GET-förfrågan till authoring/testing/destinationInstance/-slutpunkten och ange målinstans-ID:t för det mål som du testar samt ID:n för flödeskörning för de aktiverade målgrupperna.

Du kan hitta den fullständiga API-URL som du behöver använda i egenskapen results som returneras i svaret för destinationstestningsanropet.

API-format

GET /authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}/results?flowRunIds=id1,id2
Sökvägsparametrar
Beskrivning
{DESTINATION_INSTANCE_ID}
ID:t för målinstansen som du genererar exempelprofiler för. I avsnittet Krav finns mer information om hur du får detta ID.
Frågesträngsparametrar
Beskrivning
flowRunIds
ID för flödeskörning som motsvarar de aktiverade målgrupperna. Du kan hitta ID:n för flödeskörning i egenskapen results som returneras i svaret på anropet till måltestningen.

Begäran

curl -X GET 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=30d34875-e7ba-4520-ab6e-5705e01dfb16,86c00ad7-443c-459a-855d-0e8cbee43c4f,12305c58-42a9-4230-8fad-1661ee49cb70' \
 -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}' \

Svar

Svaret innehåller en fullständig beskrivning av aktiveringsflödet. Du kan få samma svar genom att anropa Flow Service API för att övervaka dataflöden.

{
   "items":[
      {
         "id":"18efd5d2-40ae-4f5c-afd1-37a39a45183a",
         "flowId":"a02071ad-f3a4-496c-a2b1-468812301d5d",
         "flowSpec":{
            "id":"25473b67-0801-418a-ab49-ed74ebf88137",
            "version":"1.0"
         },
         "metrics":{
            "durationSummary":{
               "startedAtUTC":1646652235124,
               "completedAtUTC":1646652270439
            },
            "latencySummary":null,
            "sizeSummary":{
               "inputBytes":122,
               "outputBytes":122
            },
            "recordSummary":{
               "inputRecordCount":1,
               "outputRecordCount":1,
               "createdRecordCount":1,
               "skippedRecordCount":0,
               "sourceSummaries":[
                  {
                     "id":"76e4b969-9700-4557-8330-0a8390afbdde",
                     "entitySummaries":[
                        {
                           "inputRecordCount":1,
                           "skippedRecordCount":0,
                           "id":"segment:4326c566-f81c-4ab0-8a80-9e741a5d0b1f"
                        }
                     ]
                  }
               ],
               "targetSummaries":[
                  {
                     "id":"b43607b6-0dca-43b3-a0bc-ecdea4fa6aa9",
                     "entitySummaries":[
                        {
                           "outputRecordCount":1,
                           "createdRecordCount":1,
                           "id":"segment:4326c566-f81c-4ab0-8a80-9e741a5d0b1f"
                        }
                     ]
                  }
               ]
            },
            "fileSummary":{
               "inputFileCount":1,
               "outputFileCount":1
            },
            "statusSummary":{
               "status":"success"
            }
         },
         "activities":[
            {
               "id":"c4f238e3-7334-4933-8b56-64d7ea43ea54",
               "name":"Activation Batch XdmProcessor Activity",
               "updatedAtUTC":0,
               "durationSummary":{
                  "startedAtUTC":1646652235124,
                  "completedAtUTC":1646652255157
               },
               "latencySummary":{

               },
               "sizeSummary":{
                  "inputBytes":122,
                  "outputBytes":122
               },
               "recordSummary":{
                  "inputRecordCount":1,
                  "outputRecordCount":1,
                  "createdRecordCount":1,
                  "skippedRecordCount":0
               },
               "fileSummary":{
                  "inputFileCount":1,
                  "outputFileCount":1
               },
               "statusSummary":{
                  "status":"success",
                  "extensions":{
                     "incremental.batchId":"",
                     "snapshot.batchId":"",
                     "snapshot.datasetId":"",
                     "incremental.datasetId":""
                  }
               },
               "sourceInfo":null,
               "targetInfo":null
            },
            {
               "id":"51d82b36-6b8f-11eb-9439-0242ac130002",
               "name":"Activation Batch Publisher Activity",
               "updatedAtUTC":0,
               "durationSummary":{
                  "startedAtUTC":1646652270326,
                  "completedAtUTC":1646652270439
               },
               "latencySummary":{

               },
               "sizeSummary":{
                  "outputBytes":122
               },
               "recordSummary":{
                  "inputRecordCount":1,
                  "outputRecordCount":1,
                  "createdRecordCount":1,
                  "skippedRecordCount":0
               },
               "fileSummary":{
                  "outputFileCount":1
               },
               "statusSummary":{
                  "status":"success",
                  "extensions":{

                  }
               },
               "sourceInfo":null,
               "targetInfo":null
            }
         ],
         "predecessors":null
      }
   ],
   "_links":{

   }
}

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

När du har läst det här dokumentet vet du nu hur du testar din filbaserade destinationskonfiguration och ser alla detaljer om aktiveringsresultaten.

Om du skapar ett offentligt mål kan du nu skicka målkonfigurationen till Adobe för granskning.

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