Configuratie van externe acties
Met externe maatregelen kunnen reizen van accounts in Journey Optimizer B2B edition rechtstreeks vanaf het canvas verbinding maken met externe systemen. Wanneer een rekeningspubliek een externe actieknoop bereikt, doet het systeem een asynchrone uitgaande vraag aan de gevormde externe dienst, die de gegevens van de publieksattributen voor rekeningen, mensen, of allebei overgaat. De externe dienst verwerkt de gegevens en antwoordt gebruikend callback, terugkerende publieksgegevens en meta-gegevens die kunnen worden gebruikt om reisuitvoering te begeleiden.
Deze eigenschap steunt twee types van wegknooppunten:
- Externe actie - roept de externe dienst en gaat langs één enkele uitgaande weg verder. Ideaal voor brand-en-vergeet integratie, zoals het bijwerken van een verslag van CRM of het teweegbrengen van een stroomafwaarts bericht.
- Externe gespleten wegen - roept de externe dienst en evalueert de reactie op routerekeningen langs één van verscheidene bepaalde wegen.
Overzicht van implementatie
Voor het opzetten van externe acties is coördinatie nodig over drie opeenvolgende taken:
De externe service implementeren implement-service
De ontwikkelaar moet tot stand brengen en publiceren de openbaar-onder ogen ziet Webdienst die aan de Interface van de Leverancier van de Dienst van de Actie van Adobe Journey Optimizer B2B edition voldoet.
Nadat de service live is, geeft u de URL naar de OpenAPI-specificatie en de verificatiegegevens door aan de productbeheerder die verantwoordelijk is voor het configureren van de handeling.
De handeling configureren configure-action
Een actie moet worden gevormd en geactiveerd alvorens de verkopers het in een reis kunnen gebruiken. De acties worden gecreeerd in Laag staat en uw veranderingen worden automatisch bewaard. Het blijft een concept totdat u het activeert.
-
Ga naar Administration > Configurations .
-
Klik op External Actions in het middelste deelvenster.
{width="800" modal="regular"}
-
Klik op Create action rechtsboven.
-
Voer de URL in naar de OpenAPI-specificatie voor uw externe service en klik op Create .
{width="500"} in
note note NOTE Uw externe dienst moet levend en bereikbaar voor deze stap zijn om te slagen. -
Wanneer de URL is omgezet, controleert u de Service details .
De servicedetails worden rechtstreeks gelezen uit de OpenAPI-specificatie wanneer de handeling wordt gemaakt. U kunt deze eigenschappen niet wijzigen in de configuratie nadat u ze hebt gemaakt.
table 0-row-3 1-row-3 2-row-3 3-row-3 Eigenschap Beschrijving De eigenschap OpenAPI Spec Name Naam voor de actie info.titleDescription Beschrijving van de actie info.descriptionURL URL aan de specificatie OpenAPI die de externe dienst bepaalt servers.url -
Voer de Authentication referenties voor de externe service in (
components.securitySchemes).note note NOTE De weergegeven referentie-velden zijn afhankelijk van het verificatiemechanisme dat in de externe service is gedefinieerd. Ondersteunde typen zijn API-sleutel, OAuth2 en HTTP Basic-verificatie. {width="600" modal="regular"}
U kunt de geloofsbrieven veranderen zoals nodig wanneer de gevormde actie in het Ontwerp of Actieve status is.
-
Klik op Next .
-
Stel de eigenschappen van Configurations in om te bepalen hoe de handeling gegevens uitwisselen met de externe service.
note note NOTE De eigenschappen die als worden gemerkt Statisch zijn niet updatable in configuratietijd en zijn gebaseerd op de de dienstdefinitie. -
Action type (Statisch) - het gesteunde type van de wegknoop:
- External action (
enableSplitPath= false) - External action split path (
enableSplitPath= true)
U kunt het actietype niet wijzigen nadat u de actieconfiguratie hebt gemaakt.
- External action (
-
Accessors (Statisch) - (De Externe actie gespleten weg slechts) de variabelen die door de externe dienst zijn teruggekeerd om als wegvoorwaarden in een Externe gespleten wegknoop beschikbaar te zijn. (
invocationPayloadDef.accessorsMetadata) -
Journey context (Statisch) - het werkingsgebied van publieksgegevens die in het verzoek (
supportedEntityTypeworden verzonden):-
Account - alleen accounts verzenden
-
People - Verzendt alleen personen
-
People in Account - Hiermee verzendt u accounts en personen die met een account te maken hebben
-
-
Outgoing Fields - kaart elk gebied in de lijst aan een XDM gebied in kaart. Deze velden worden in de aanvraaginstantie naar de externe service verzonden. Servicedefinitie-eigenschappen:
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
{width="600" modal="regular"}
-
Incoming Fields - kaart elk gebied in de lijst aan een updatable XDM gebied in kaart. Deze gebieden worden bevolkt van de externe de dienstreactie. Servicedefinitie-eigenschappen:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Kan na het maken worden bijgewerkt. -
Header parameters - Voer een waarde in voor elke rij die als HTTP-header in de aanvraag moet worden doorgegeven. Service definition property:
invocationPayloadDef.headers. -
Timeout - ga het aantal minuten in te wachten op de externe dienst om callback aan te halen alvorens het verzoek als ontbroken wordt beschouwd. Service definition property:
timeout. -
Global attributes - ga een waarde voor elke rij in om als statisch gebied in het verzoeklichaam op te nemen. Service definition property:
invocationPayloadDef.globalAttributes.
{width="600" modal="regular"}
-
-
Klik de Achterpijl om aan de lijst terug te keren en de actie in de staat van het a Ontwerp te houden.
Of, klik Activate om de actieconfiguratie in de Actieve staat te veranderen. De geconfigureerde externe actie moet actief zijn om deze beschikbaar te maken voor gebruik tijdens reizen op account.
Een extern knooppunt aan een reis toevoegen add-journey-node
Nadat een handeling is geactiveerd, kunnen marketers een knooppunt External actionofExternal split path toevoegen aan elke accountreis. Voor informatie over hoe te om deze knopen in het canvas van de rekeningsreis toe te voegen en te gebruiken, zie Externe knopen .