Serverspecifikationer för mål som skapats med Destination SDK

Målserverns specifikationer definierar vilken typ av målplattform som ska ta emot data från Adobe Experience Platform och kommunikationsparametrarna mellan plattformen och destinationen. Till exempel:

• A direktuppspelning målserverspecifikationen definierar HTTP-serverslutpunkten som tar emot HTTP-meddelanden från plattformen. Läs mer om hur du konfigurerar hur HTTP-anrop till slutpunkten formateras i mallange specifikationer sida.
• An Amazon S3 målserverspecifikationen definierar S3 namn och sökväg där Plattform exporterar filerna.
• An SFTP målserverspecifikationen definierar värdnamnet, rotkatalogen, kommunikationsporten och krypteringstypen för SFTP-servern där plattformen ska exportera filerna.

Mer information om var den här komponenten passar in i en integrering som skapas med Destination SDK finns i diagrammet i konfigurationsalternativ eller se följande sidor med översikt över målkonfigurationen:

• Använd Destination SDK för att konfigurera ett direktuppspelningsmål
• Använd Destination SDK för att konfigurera ett filbaserat mål

Du kan konfigurera målserverns specifikationer via /authoring/destination-servers slutpunkt. På följande API-referenssidor finns detaljerade API-anropsexempel där du kan konfigurera komponenterna som visas på den här sidan.

• Skapa en målserverkonfiguration
• Uppdatera en målserverkonfiguration

På den här sidan visas alla målservertyper som stöds av Destinationen SDK, med alla deras konfigurationsparametrar. Ersätt parametervärdena med dina egna när du skapar målet.

Integrationstyper som stöds

Se tabellen nedan för mer ingående information om vilka typer av integreringar som stöder de funktioner som beskrivs på den här sidan.

När skapa eller uppdatera en målserver använder du någon av de servertypskonfigurationer som beskrivs på den här sidan. Beroende på dina integrationskrav ska du se till att ersätta exempelparametervärdena från de här exemplen med dina egna.

Hårdkodade jämfört med mallsidesfält

När du skapar en målserver via Destination SDK kan du definiera parametervärden för konfiguration antingen genom att hårdkoda dem i konfigurationen eller genom att använda mallfält. I mallbaserade fält kan du läsa användardefinierade värden från plattformens användargränssnitt.

Målserverparametrar har två konfigurerbara fält. Dessa alternativ avgör om du använder hårdkodade eller mallsidiga värden.

När hårdkodade jämfört med mallsidesfält ska användas

Både hårdkodade och mallbaserade fält har sina egna användningsområden i Destinationen SDK, beroende på vilken typ av integrering du skapar.

Ansluta till målet utan användarindata

När användare ansluta till ditt mål i plattformsgränssnittet kanske du vill hantera målanslutningsprocessen utan indata.

Det gör du genom att hårdkoda anslutningsparametrarna för målplattformen i serverspecifikationen. När du använder hårdkodade parametervärden i målserverkonfigurationen hanteras anslutningen mellan Adobe Experience Platform och målplattformen utan indata från användaren.

I exemplet nedan skapar en partner en Data Landing Zone-målserver med path.value fält som hårdkodas.

{
   "name":"Data Landing Zone destination server",
   "destinationServerType":"FILE_BASED_DLZ",
   "fileBasedDlzDestination":{
      "path":{
         "templatingStrategy":"NONE",
         "value":"Your/hardcoded/path/here"
      },
      "useCase": "Your use case"
   }
}

Detta resulterar i att när användare går igenom självstudiekurs om målanslutning, kommer de inte att se autentiseringssteg. Autentiseringen hanteras i stället av Platform, vilket visas i bilden nedan.

Ansluta till målet med användarindata

När anslutningen mellan plattformen och målet ska upprättas efter en viss användarinmatning i plattformsgränssnittet, till exempel val av en API-slutpunkt eller tillhandahållande av ett fältvärde, kan du använda mallfält i serverspecifikationen för att läsa användarinmatningen och ansluta till målplattformen.

I exemplet nedan skapar en partner en realtid (direktuppspelning) integrering och url.value fältet använder den mallsidiga parametern {{customerData.region}} för att anpassa en del av API-slutpunkten baserat på användarindata.

{
   "name":"Templatized API endpoint example",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.yourcompany.com/data/{{customerData.region}}/items"
      }
   }
}

Om du vill att användarna ska kunna välja ett värde i användargränssnittet för plattformen väljer du region -parametern måste också definieras i målkonfiguration som ett kunddatafält, vilket visas nedan:

"customerDataFields":[
   {
      "name":"region",
      "title":"Region",
      "description":"Select an option",
      "type":"string",
      "isRequired":true,
      "readOnly":false,
      "enum":[
         "US",
         "EU"
      ]
   }

Detta resulterar i att när användare går igenom självstudiekurs om målanslutningmåste de välja en region innan de kan ansluta till målplattformen. När de ansluter till målet, det mallsidiga fältet {{customerData.region}} ersätts med det värde som användaren har valt i användargränssnittet, vilket visas i bilden nedan.

Målserver för realtid (direktuppspelning)

Med den här målservertypen kan du exportera data från Adobe Experience Platform till målet via HTTP-begäranden. Serverkonfigurationen innehåller information om servern som tar emot meddelandena (servern på din sida).

Den här processen levererar användardata som en serie HTTP-meddelanden till målplattformen. Parametrarna nedan utgör mallen för specifikationer för HTTP-servern.

I exemplet nedan visas ett exempel på en målserverkonfiguration för ett mål för realtidsströmning.

{
   "name":"Your destination server name",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{YOUR_API_ENDPOINT}"
      }
   }
}

Amazon S3 målserver

Med den här målservern kan du exportera filer som innehåller Adobe Experience Platform-data till din Amazon S3-lagring.

Exemplet nedan visar ett exempel på en målserverkonfiguration för ett Amazon S3-mål.

{
   "name":"Amazon S3 destination",
   "destinationServerType":"FILE_BASED_S3",
   "fileBasedS3Destination":{
      "bucket":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.bucket}}"
      },
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   }
}

SFTP målserver

Med den här målservern kan du exportera filer som innehåller Adobe Experience Platform-data till SFTP lagringsserver.

Exemplet nedan visar ett exempel på en målserverkonfiguration för ett SFTP-mål.

{
   "name":"File-based SFTP destination server",
   "destinationServerType":"FILE_BASED_SFTP",
   "fileBasedSFTPDestination":{
      "rootDirectory":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.rootDirectory}}"
      },
      "hostName":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.hostName}}"
      },
      "port":22,
      "encryptionMode":"PGP"
   }
}

Azure Data Lake Storage (ADLS) målserver

Med den här målservern kan du exportera filer som innehåller Adobe Experience Platform-data till Azure Data Lake Storage konto.

Exemplet nedan visar ett exempel på en målserverkonfiguration för en Azure Data Lake Storage mål.

{
   "name":"ADLS destination server",
   "destinationServerType":"FILE_BASED_ADLS_GEN2",
   "fileBasedAdlsGen2Destination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   }
}

Azure Blob Storage målserver

Med den här målservern kan du exportera filer som innehåller Adobe Experience Platform-data till Azure Blob Storage behållare.

Exemplet nedan visar ett exempel på en målserverkonfiguration för en Azure Blob Storage mål.

{
   "name":"Blob destination server",
   "destinationServerType":"FILE_BASED_AZURE_BLOB",
   "fileBasedAzureBlobDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "container":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.container}}"
      }
   }
}

Data Landing Zone (DLZ) målserver

Med den här målservern kan du exportera filer som innehåller plattformsdata till en Data Landing Zone lagring.

Exemplet nedan visar ett exempel på en målserverkonfiguration för en Data Landing Zone (DLZ).

{
   "name":"Data Landing Zone destination server",
   "destinationServerType":"FILE_BASED_DLZ",
   "fileBasedDlzDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "useCase": "Your use case"
   }
}

Google Cloud Storage målserver

Med den här målservern kan du exportera filer som innehåller plattformsdata till Google Cloud Storage konto.

Exemplet nedan visar ett exempel på en målserverkonfiguration för en Google Cloud Storage mål.

{
   "name":"Google Cloud Storage Server",
   "destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
   "fileBasedGoogleCloudStorageDestination":{
      "bucket":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.bucket}}"
      },
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   }
}

Nästa steg

När du har läst den här artikeln bör du få en bättre förståelse för vad en målserverspecifikation är och hur du kan konfigurera den.

Mer information om andra målserverkomponenter finns i följande artiklar:

• Mallspecifikationer
• Meddelandeformat
• Filformateringskonfiguration

Resurser för Business.Adobe.com