Konfiguration för externa åtgärder
Externa åtgärder gör det möjligt för kontoresor i Journey Optimizer B2B edition att ansluta till externa system direkt från arbetsytan. När en kontopublik når en extern åtgärdsnod gör systemet ett asynkront utgående anrop till en konfigurerad extern tjänst, skickar målgruppsattributdata för konton, personer eller både och. Den externa tjänsten bearbetar data och svarar med ett återanrop och returnerar målgruppsdata och metadata som kan användas som vägledning vid körning av resan.
Den här funktionen har stöd för två typer av kundnoder:
- Extern åtgärd - Anropar en extern tjänst och fortsätter längs en enda utgående sökväg. Idealiskt för eld-och-glöm-integreringar, som att uppdatera en CRM-post eller utlösa ett meddelande längre fram i kedjan.
- Externa delade sökvägar - Anropar en extern tjänst och utvärderar svaret för att dirigera konton längs en av flera definierade sökvägar.
Implementeringsöversikt
Konfigurering av externa åtgärder kräver samordning mellan tre roller i följd:
Implementera den externa tjänsten implement-service
Utvecklaren måste skapa och publicera en offentlig webbtjänst som är kompatibel med Adobe Journey Optimizer B2B edition External Actions Service Provider Interface.
När tjänsten är aktiv anger du URL:en till OpenAPI-specifikationen och autentiseringsuppgifterna till produktadministratören som ansvarar för att konfigurera åtgärden.
Konfigurera åtgärden configure-action
En åtgärd måste konfigureras och aktiveras innan marknadsförarna kan använda den på en resa. Åtgärder skapas i läget Utkast och dina ändringar sparas automatiskt. Det förblir som ett utkast tills du aktiverar det.
-
Gå till Administration > Configurations.
-
Klicka på External Actions på panelen mellan.
-
Klicka på Create action överst till höger.
-
Ange URL:en till OpenAPI-specifikationen för den externa tjänsten och klicka på Create.
note note NOTE Din externa tjänst måste vara tillgänglig och åtkomlig för att det här steget ska lyckas. -
Granska Service details när URL:en har lösts.
Tjänstinformationen läses direkt från OpenAPI-specifikationen när åtgärden skapas. Du kan inte ändra dessa egenskaper i konfigurationen efter att du har skapat den.
table 0-row-3 1-row-3 2-row-3 3-row-3 Egenskap Beskrivning OpenAPI-specifikationsegenskap Name Åtgärdens namn info.titleDescription Beskrivning av åtgärden info.descriptionURL URL till OpenAPI-specifikationen som definierar den externa tjänsten servers.url -
Ange autentiseringsuppgifterna Authentication för den externa tjänsten (
components.securitySchemes).note note NOTE Vilka inloggningsfält som visas beror på vilken autentiseringsmekanism som har definierats i den externa tjänsten. De typer som stöds är API Key, OAuth2 och HTTP Basic Authentication. 
Du kan ändra autentiseringsuppgifterna efter behov när den konfigurerade åtgärden har statusen Utkast eller Aktiv.
-
Klicka på Next.
-
Ange egenskaperna Configurations för att definiera hur åtgärden ska utbyta data med den externa tjänsten.
note note NOTE Egenskaper som har markerats som Statisk kan inte uppdateras vid konfigurationstiden och baseras på tjänstdefinitionen. -
Action type (Statisk) - Den typ av resenod som stöds:
- External action (
enableSplitPath= false) - External action split path (
enableSplitPath= true)
Du kan inte ändra åtgärdstypen efter att du har skapat åtgärdskonfigurationen.
- External action (
-
Accessors (Statisk) - (Endast delad sökväg för extern åtgärd) Variablerna som returneras av den externa tjänsten som ska vara tillgängliga som sökvägsvillkor i en extern delad sökvägsnod. (
invocationPayloadDef.accessorsMetadata) -
Journey context (Statisk) - Omfånget för målgruppsdata som skickats i begäran (
supportedEntityType):-
Account - Skickar endast konton
-
People - Skickar endast personer
-
People in Account - Skickar konton och kontorelaterade personer
-
-
Outgoing Fields - Mappa varje fält i tabellen till ett XDM-fält. Dessa fält skickas i begärandetexten till den externa tjänsten. Tjänstedefinitionsegenskaper:
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
-
Incoming Fields - Mappa varje fält i tabellen till ett uppdateringsbart XDM-fält. Dessa fält fylls i från det externa tjänstsvaret. Tjänstedefinitionsegenskaper:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Uppdateringsbart efter att det har skapats. -
Header parameters - Ange ett värde för varje rad som ska skickas som en HTTP-rubrik i begäran. Tjänstedefinitionsegenskap:
invocationPayloadDef.headers. -
Timeout - Ange hur många minuter det ska ta att vänta på att den externa tjänsten ska anropa återanropet innan begäran anses vara misslyckad. Tjänstedefinitionsegenskap:
timeout. -
Global attributes - Ange ett värde för varje rad som ska inkluderas som ett statiskt fält i begärandetexten. Tjänstedefinitionsegenskap:
invocationPayloadDef.globalAttributes.
-
-
Klicka på Bakåtpilen för att gå tillbaka till listan och behålla åtgärden i läget Utkast.
Du kan också klicka på Activate om du vill ändra åtgärdskonfigurationen till läget Aktiv. Den konfigurerade externa åtgärden måste vara aktiv för att den ska kunna användas på kontoresor.
Lägg till en extern nod till en resa add-journey-node
När en åtgärd har aktiverats kan marknadsförarna lägga till en External action- ellerExternal split path-nod till en kontoresa. Mer information om hur du lägger till och använder de här noderna i kontoresans arbetsyta finns i Externa noder.