DocumentatieJourney Optimizer B2BJourney Optimizer B2B edition-documentatie

Configuratie van externe acties

Laatst bijgewerkt: 26 mei 2026

Gemaakt voor:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

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.
NOTE
De diensten voor extern optreden worden alleen ondersteund voor reizen voor rekening. Deze knooppunttypes zijn niet beschikbaar voor personenreizen.

Overzicht van implementatie

Voor het opzetten van externe acties is coördinatie nodig over drie opeenvolgende taken:

Functie
Taak
1
Ontwikkelaar
​ voert en publiceert de externe dienst ​ uit
2
Beheerder
​ vorm de actie in Journey Optimizer B2B edition ​
3
Marketer
​ voeg een externe knoop aan een rekeningsreis ​ toe

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.

NOTE
De callback functie vereist een dragertoken. Haal dit door vestiging ​ OAuth Server-aan-Server geloofsbrieven in Adobe Developer Console ​ voor uw organisatie IMS op.

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.

PREREQUISITES
Haal de URL naar de OpenAPI-specificatie en de verificatiereferenties op van de ontwikkelaar voordat u de configuratie toevoegt.
Om een externe actie te bepalen en te activeren, moet u de Manage B2B Admin Configurations​ producttoestemming ​ hebben.

  1. Ga naar Administration > Configurations .

  2. Klik op External Actions in het middelste deelvenster.

    ​ heb toegang tot de Externe de configuratieruimte van Acties ​ {width="800" modal="regular"}

  3. Klik op Create action rechtsboven.

  4. Voer de URL in naar de OpenAPI-specificatie voor uw externe service en klik op Create .

    ​ ga de dienst URL ​ {width="500"} in

    De externe dienst moet levend en bereikbaar voor deze stap zijn om te slagen. Als er een validatiefout optreedt, wordt in het dialoogvenster een bericht weergegeven met een beschrijving van de fout en een suggestie om deze op te lossen. Voor meer informatie, zie het Oplossen van problemen.

  5. 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.title
    Description Beschrijving van de actie info.description
    URL URL aan de specificatie OpenAPI die de externe dienst bepaalt servers.url

  6. Voer de Authentication referenties voor de externe service in (components.securitySchemes ).

    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.

    ​ voeg de authentificatiegeloofsbrieven toe ​ {width="600" modal="regular"}

    U kunt de geloofsbrieven veranderen zoals nodig wanneer de gevormde actie in het Ontwerp of Actieve status is.

  7. Klik op Next .

  8. Stel de eigenschappen van Configurations in om te bepalen hoe de handeling gegevens uitwisselen met de externe service.

    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.

    • 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 (supportedEntityType worden 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. Eigenschappen van servicedefinitie: invocationPayloadDef.accountFields , invocationPayloadDef.fields .

      ​ de externe actie van de Kaart uitgaande gebieden ​ {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. Eigenschappen van servicedefinitie: 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. Servicedefinitie-eigenschap: 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. Servicedefinitie-eigenschap: timeout.

    • Global attributes - ga een waarde voor elke rij in om als statisch gebied in het verzoeklichaam op te nemen. Servicedefinitie-eigenschap: invocationPayloadDef.globalAttributes.

      ​ Externe parameters van de actiekop, onderbreking, en globale attributen ​ {width="600" modal="regular"}

  9. 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.

Problemen oplossen troubleshooting

Wanneer u de URL naar de OpenAPI-specificatie voor uw externe service invoert en op Create klikt, wordt de service door het systeem gevalideerd. Als er een fout optreedt, wordt in het dialoogvenster een bericht weergegeven waarin de fout wordt beschreven.

​ Externe de dienstbevestiging van actie URL bericht ​ {width="600" modal="regular"}

NOTE
Veel van de volgende fouten vereisen dat u met de ontwikkelaar werkt die de openbare webservice heeft gemaakt en gepubliceerd om deze op te lossen.

Details van validatiefout

Weergegeven fout
Waarom het gebeurde
Wat moet u doen?
This URL is already used by another external action
Deze specifieke URL is al geregistreerd voor een andere actie op uw org.
Gebruik een andere specificatie-URL of verwijder de bestaande handeling die deze al gebruikt.
An action with this name already exists
De waarde info.title in uw specificatie komt overeen met een handeling die al bestaat
Wijzig de titel in het veld info.title van de specificatie in iets unique.
Duplicate operation ID found in the specification
Twee of meer bewerkingen in uw specificatie hebben hetzelfde effect operationId .
Geef elke bewerking een unieke waarde operationId .
Field in the specification exceeds the maximum allowed length
Een tekstveld in de specificatie (zoals een titel of beschrijving) is te lang.
Maak het veld dat wordt gemarkeerd korter.
The entity type value is invalid
Een Adobe-specifieke extensie x- voor een entiteitstype heeft een onbekende waarde
Corrigeer het entiteitstype in een ondersteunde waarde. Zie de ​ documentatie van de ontwikkelaar ​ voor de geldige opties.
The provided document is not a valid OpenAPI specification
De specificatie kan niet structureel geparseerd worden.
Valideer uw specificatie op basis van het OpenAPI 3.0-schema en los eventuele problemen op.
Required OpenAPI field is missing
Een standaard vereist veld voor OpenAPI ontbreekt (zoals info of paths ).
Voeg het ontbrekende veld toe.
Required endpoint is missing from the specification
Een eindpunt dat Adobe Journey Optimizer B2B edition nodig heeft, wordt niet gedefinieerd in uw specificatie.
Voeg het vereiste eindpunt toe. Zie de ​ ontwikkelaardocumentatie ​ waarvoor eindpunten nodig zijn.
Required extension field is missing
Een vereist Adobe x- -extensieveld ontbreekt in uw specificatie.
Voeg het veld voor ontbrekende extensies toe, zoals wordt beschreven in de documentatie.
Security schemes are missing from the specification
Uw specificatie is niet gedefinieerd onder securitySchemes . components
Definieer ten minste één beveiligingsschema.
Multiple authentication types are not supported
Uw specificatie bepaalt meer dan één authentificatieschema.
Werk uw specificatie bij om één enkel authentificatietype te gebruiken.
The authentication type is not supported
Het beveiligingsschematype dat u hebt gebruikt (zoals oauth2 of openIdConnect ), wordt niet ondersteund.
Schakel over naar een ondersteund autietype. Zie de documentatie voor ontwikkelaars voor de gesteunde opties.
The OpenAPI version is not supported
Versieverkeerde versie op specificatieniveau
Werk uw specificatie bij om OpenAPI 3.0.x te gebruiken.
An unexpected error occurred
Er is een niet-geclassificeerd probleem gevonden in uw specificatie.
Controleer de specificaties op ongebruikelijke wijze en probeer het opnieuw. Neem contact op met de ondersteuning als de fout zich blijft voordoen.

Een extern knooppunt aan een reis toevoegen add-journey-node

Nadat een handeling is geactiveerd, kunnen marketers een knooppunt External action​of​External 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 ​.

recommendation-more-help
journey-optimizer-b2b-help-user