Documentatie Experience Platform Handleiding voor bestemmingen

Bestandsgebaseerde bestemming testen met voorbeeldprofielen

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Destinations

Gemaakt voor:

Beheerder
Gebruiker

Overzicht overview

Deze pagina verklaart hoe te om het /testing/destinationInstance API eindpunt te gebruiken om te testen als uw op dossier-gebaseerde bestemming correct wordt gevormd en om de integriteit van gegevensstromen aan uw gevormde bestemming te verifiëren.

U kunt verzoeken aan het het testen eindpunt met of zonder steekproefprofielenaan de vraag toe te voegen. Als u geen profielen verzendt op de aanvraag, genereert de API automatisch een voorbeeldprofiel en voegt deze toe aan de aanvraag.

De automatisch gegenereerde voorbeeldprofielen bevatten algemene gegevens. Als u uw bestemming met douane, intuïtievere profielgegevens wilt testen, gebruik de generatie API van het steekproefprofielom een steekproefprofiel te produceren, dan zijn reactie aan te passen en het te omvatten in het verzoek aan het /testing/destinationInstance eindpunt.

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 /testing/destinationInstance 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.
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.
Facultatief: Als u uw bestemmingsconfiguratie met een steekproefprofiel wilt testen dat aan de API vraag wordt toegevoegd, gebruik het /sample-profileseindpunt om een steekproefprofiel te produceren dat op uw bestaand bronschema wordt gebaseerd. Als u geen voorbeeldprofiel opgeeft, genereert de API er een en retourneert deze in de reactie.

Test uw bestemmingsconfiguratie zonder profielen aan de vraag toe te voegen test-without-adding-profiles

API formaat

POST /authoring/testing/destinationInstance/{DESTINATION_INSTANCE_ID}

Verzoek

curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/{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}' \

Padparameters

Beschrijving

{DESTINATION_INSTANCE_ID}

De id van de doelinstantie waarvoor u voorbeeldprofielen genereert. Zie de eerste vereistensectie voor details op hoe te om deze identiteitskaart te verkrijgen.

Reactie

Een succesvolle reactie keert HTTP status 200 samen met de antwoordlading terug.

{
   "activations":[
      {
         "segment":"6fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
         "flowRun":"81150d76-7909-46b6-83f4-fc855a92de07"
      },
      {
         "segment":"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
         "flowRun":"4706780a-2ab3-4d33-8c76-7c87fd318cd8"
      }
   ],
   "results":"/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=4706780a-2ab3-4d33-8c76-7c87fd318cd8,81150d76-7909-46b6-83f4-fc855a92de07",
   "inputProfiles":[
      {
         "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"
            }
         }
      }
   ]
}

Eigenschap

Beschrijving

activations

Retourneert de gebruikers-id en de flow-run-id voor elk geactiveerd publiek. Het aantal activeringsitems (en de bijbehorende gegenereerde bestanden) is gelijk aan het aantal soorten publiek dat is toegewezen aan de doelinstantie.

Voorbeeld: als u twee soorten publiek aan de doelinstantie toewijst, bevat de activations -array twee items. Elk geactiveerd publiek komt overeen met één geëxporteerd bestand.

results

Keert bestemmingsidentiteitskaart en de stroom in werking gestelde IDs terug die u kunt gebruiken om resultaten APIte roepen, om de integratie verder te testen.

inputProfiles

Retourneert de voorbeeldprofielen die automatisch door de API worden gegenereerd.

Test uw bestemmingsconfiguratie met profielen die aan de vraag worden toegevoegd test-with-added-profiles

Om uw bestemming met douane, meer intuïtieve profielgegevens te testen, kunt u de reactie aanpassen die van het wordt verkregen/steekproef-profieleneindpunt met waarden van uw keus, en het douaneprofiel in het verzoek aan het /testing/destinationInstance eindpunt omvatten.

API formaat

POST  /testing/destinationInstance/{DESTINATION_INSTANCE_ID}

Verzoek

curl -X POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/{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}' \
 -d '
 {
   "profiles":[
      {
         "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":"michaelsmith@example.com"
         },
         "identityMap":{
            "crmid":[
               {
                  "id":"Custom CRM ID"
               }
            ]
         },
         "person":{
            "name":{
               "firstName":"Michael",
               "lastName":"Smith"
            }
         }
      }
   ]
}'

Parameter

Beschrijving

{DESTINATION_INSTANCE_ID}

De doel-instantie-id van het doel dat u test. De id van de doelinstantie waarvoor u voorbeeldprofielen genereert. Zie de eerste vereistensectie voor details op hoe te om deze identiteitskaart te verkrijgen.

profiles

Array die een of meerdere profielen kan bevatten. Gebruik het eindpunt van steekproefAPI van het profielom profielen te produceren in deze API vraag te gebruiken.

Reactie

Een succesvolle reactie keert HTTP status 200 samen met de antwoordlading terug.

{
   "activations":[
      {
         "segment":"6fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
         "flowRun":"81150d76-7909-46b6-83f4-fc855a92de07"
      },
      {
         "segment":"5fa55d3a-18e1-4f65-95ed-ac8fdb03b45b",
         "flowRun":"4706780a-2ab3-4d33-8c76-7c87fd318cd8"
      }
   ],
   "results":"/authoring/testing/destinationInstance/fd3449fb-b929-45c8-9f3d-06b9d6aac328/results?flowRunIds=4706780a-2ab3-4d33-8c76-7c87fd318cd8,81150d76-7909-46b6-83f4-fc855a92de07",
   "inputProfiles":[
      {
         "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":"michaelsmith@example.com"
         },
         "identityMap":{
            "crmid":[
               {
                  "id":"Custom CRM ID"
               }
            ]
         },
         "person":{
            "name":{
               "firstName":"Michael",
               "lastName":"Smith"
            }
         }
      }
   ]
}

Eigenschap

Beschrijving

activations

results

Keert bestemmingsidentiteitskaart en de stroom in werking gestelde IDs terug die u kunt gebruiken om resultaten APIte roepen, om de integratie verder te testen.

inputProfiles

Retourneert de aangepaste voorbeeldprofielen die u hebt doorgegeven in de API-aanvraag.

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 uw op dossier-gebaseerde bestemmingsconfiguratie te testen.

Als u een geldige API-reactie hebt ontvangen, werkt de bestemming correct. Als u meer gedetailleerde informatie over uw activeringsstroom wilt zien, kunt u het results bezit van de reactie op mening gedetailleerde activeringsresultatengebruiken.

Als u een openbare bestemming bouwt, kunt u uw bestemmingsconfiguratieaan Adobe voor overzicht nu voorleggen.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6