Levering bestemming

Als u meer controle wilt hebben over de plaats waar de gegevens die naar uw bestemming worden geëxporteerd, kunt u in Destination SDK instellingen voor de levering van de bestemming opgeven.

De sectie van de bestemmingslevering wijst op waar de uitgevoerde gegevens gaan en welke authentificatieregel in de plaats wordt gebruikt waar de gegevens zullen landen.

Om te begrijpen waar deze component in een integratie past die met Destination SDK wordt gecreeerd, zie het diagram in de ​ documentatie van configuratieopties ​ of zie de volgende pagina's van het overzicht van bestemmingsconfiguratie:

U kunt de montages van de bestemmingslevering via het /authoring/destinations eindpunt vormen. Zie de volgende API verwijzingspagina's voor gedetailleerde API vraagvoorbeelden waar u de componenten kunt vormen die in deze pagina worden getoond.

In dit artikel worden alle ondersteunde leveringsopties voor de bestemming beschreven.

IMPORTANT
Alle parameternamen en waarden die door Destination SDK worden gesteund zijn gevoelig geval. Om fouten in hoofdlettergevoeligheid te voorkomen, gebruikt u de namen en waarden van parameters exact zoals in de documentatie wordt getoond.

Ondersteunde integratietypen supported-integration-types

Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.

Type integratie
Ondersteunt functionaliteit
Integraties in realtime (streaming)
Ja
Op bestanden gebaseerde (batch) integratie
Ja

Ondersteunde parameters supported-parameters

Wanneer het vormen van uw montages van de bestemmingslevering, kunt u de parameters gebruiken die in de lijst hieronder worden beschreven om te bepalen waar de uitgevoerde gegevens zouden moeten worden verzonden.

Parameter
Type
Beschrijving
authenticationRule
String

Geeft aan hoe Experience Platform verbinding moet maken met uw doel. Ondersteunde waarden:

  • CUSTOMER_AUTHENTICATION: Gebruik deze optie als de klanten van Experience Platform aan uw systeem via om het even welke beschreven authentificatiemethodes ​ hier ​ login.
  • PLATFORM_AUTHENTICATION: Gebruik deze optie als er een wereldwijd verificatiesysteem is tussen Adobe en uw bestemming en de Experience Platform -klant geen verificatiereferenties hoeft op te geven om verbinding te maken met uw bestemming. In dit geval, moet u een geloofsbrieven tot stand brengen voorwerp gebruikend de ​ geloofsbrieven API ​ configuratie en de authenticationId parameter aan de waarde van referentie objecten identiteitskaart plaatsen.
  • NONE: gebruik deze optie als er geen verificatie vereist is om gegevens naar het doelplatform te verzenden.
authenticationId
String
The instanceId of the credential object's configuration ID to use for authentication. Deze parameter wordt slechts vereist wanneer u een bepaalde geloofsgeloofsconfiguratie moet specificeren.
destinationServerId
String
instanceId van de ​ bestemmingsserver ​ die u gegevens naar wilt uitvoeren.
deliveryMatchers.type
String
  • Wanneer het vormen van bestemmingslevering voor op dossier-gebaseerde bestemmingen, plaats altijd dit aan SOURCE.
  • Wanneer het vormen van bestemmingslevering voor een het stromen bestemming, wordt de deliveryMatchers sectie niet vereist.
deliveryMatchers.value
String
  • Wanneer het vormen van bestemmingslevering voor op dossier-gebaseerde bestemmingen, plaats altijd dit aan batch.
  • Wanneer het vormen van bestemmingslevering voor een het stromen bestemming, wordt de deliveryMatchers sectie niet vereist.

Instellingen voor levering van bestemming voor streamingdoelen destination-delivery-streaming

In het onderstaande voorbeeld ziet u hoe de instellingen voor de doellevering moeten worden geconfigureerd voor een streamingbestemming. De sectie deliveryMatchers is niet vereist voor streamingdoelen.

recommendation-more-help
{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

De leveringsmontages van de bestemming voor op dossier-gebaseerde bestemmingen destination-delivery-file-based

In het onderstaande voorbeeld ziet u hoe de instellingen voor de doellevering moeten worden geconfigureerd voor een op een bestand gebaseerde bestemming. De sectie deliveryMatchers is vereist voor op bestanden gebaseerde doelen.

{
   "destinationDelivery":[
      {
         "deliveryMatchers":[
            {
               "type":"SOURCE",
               "value":[
                  "batch"
               ]
            }
         ],
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Configuratie van platformverificatie platform-authentication

Wanneer u PLATFORM_AUTHENTICATION gebruikt, moet u de parameter authenticationId opgeven om uw doelconfiguratie te koppelen aan de configuratie van de referenties.

  1. Stel destinationDelivery.authenticationRule in op "PLATFORM_AUTHENTICATION" in de doelconfiguratie
  2. ​ creeer het referentie voorwerp ​.
  3. Stel de parameter authenticationId in op de waarde instanceId van het referentie-object.

configuratie van het voorbeeld met PLATFORM_AUTHENTICATION:

{
   "destinationDelivery":[
      {
         "authenticationRule":"PLATFORM_AUTHENTICATION",
         "authenticationId":"<string-here>",
         "destinationServerId":"<string-here>"
      }
   ]
}

Volgende stappen next-steps

Na het lezen van dit artikel, zou u een beter inzicht in moeten hebben hoe u de plaatsen kunt vormen waar uw bestemming gegevens, voor zowel het stromen als op dossier-gebaseerde bestemmingen zou moeten uitvoeren.

Raadpleeg de volgende artikelen voor meer informatie over de andere doelcomponenten:

7f4d1967-bf93-4dba-9789-bb6b505339d6