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

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

    note note
    NOTE
    Uw externe dienst moet levend en bereikbaar voor deze stap zijn om te slagen.
  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
    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
    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. Servicedefinitie-eigenschappen: 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. 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.

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

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
6ef00091-a233-4243-8773-0da8461f7ef0