Een aangepaste handeling configureren configure-a-custom-action
Als u een derdesysteem gebruikt om berichten te verzenden of als u reizen API vraag naar een derdesysteem wilt verzenden, gebruik douaneacties om zijn verbinding aan uw reis te vormen. Bijvoorbeeld kunt u met de volgende systemen met douaneacties verbinden: Epsilon, Slack, Adobe Developer, Vuurbasis, enz.
Aangepaste acties zijn aanvullende acties die door technische gebruikers worden gedefinieerd en beschikbaar worden gesteld aan verkopers. Als deze zijn geconfigureerd, worden ze weergegeven in het linkerpalet van uw reis, in de categorie Action . Meer informatie vindt u op deze pagina.
Beperkingen custom-actions-limitations
De acties van de douane komen met een paar beperkingen die in worden vermeld deze pagina.
In parameters voor aangepaste handelingen kunt u een eenvoudige verzameling en een verzameling objecten doorgeven. Leer meer over inzamelingsbeperkingen in deze pagina.
De parameters voor aangepaste handelingen hebben een verwachte indeling (bijvoorbeeld tekenreeks, decimaal, enz.). U moet deze verwachte formaten zorgvuldig respecteren. Leer meer in dit gebruiksgeval.
De acties van de douane steunen JSON formaat slechts wanneer het gebruiken van verzoekof antwoordladloads.
Best practices custom-action-enhancements-best-practices
Wanneer het kiezen van een eindpunt om het gebruiken van een douaneactie te richten, ben zeker dat:
- Dit eindpunt kan de productie van de reis steunen, gebruikend configuraties van het Throttling APIof Capping APIom het te beperken. Wees voorzichtig dat een snelheidsbegrenzingsconfiguratie niet lager kan zijn dan 200 TPS. Om het even welk gericht eindpunt zal minstens 200 TPS moeten steunen.
- Dit eindpunt moet een reactietijd hebben zo laag mogelijk. Afhankelijk van uw verwachte productie, zou het hebben van een hoge reactietijd de daadwerkelijke productie kunnen beïnvloeden.
Een maximum van 300.000 vraag over één minuut wordt bepaald voor alle douaneacties. Daarnaast wordt de standaarduitlijning uitgevoerd per host en per sandbox. Als u bijvoorbeeld op een sandbox twee eindpunten met dezelfde host hebt (bijvoorbeeld: https://www.adobe.com/endpoint1 en https://www.adobe.com/endpoint2 ), wordt de aftopping toegepast op alle eindpunten onder de host adobe.com. De "eindpunt1"en "eindpunt2"zullen de zelfde het begrenzen configuratie delen en het hebben van één eindpunt bereikt de grens zal een effect op het andere eindpunt hebben.
Deze grens is geplaatst gebaseerd op klantengebruik, om externe eindpunten te beschermen die door douaneacties worden gericht. U moet hiermee rekening houden bij reizen voor uw publiek door een juiste leessnelheid te definiëren (5000 profielen/s wanneer aangepaste handelingen worden gebruikt). Indien nodig, kunt u deze het plaatsen met voeten treden door een grotere het maximum van het maximum of het vertragen grens door onze Capping/het Draaien APIs te bepalen. Zie deze pagina.
U zou openbare eindpunten met douaneacties niet om verschillende redenen moeten richten:
- Zonder behoorlijk het in kaart brengen of het vertragen, is er een risico om teveel vraag naar een openbaar eindpunt te verzenden dat zulk volume niet kan steunen.
- De gegevens van het profiel kunnen door douaneacties worden verzonden, zodat het richten van een openbaar eindpunt tot onbedoeld het delen van persoonlijke informatie buiten zou kunnen leiden.
- U hebt geen controle over de gegevens die door openbare eindpunten worden teruggekeerd. Als een eindpunt zijn API verandert of onjuiste informatie begint te verzenden, zullen die in verzonden mededelingen, met potentiële negatieve gevolgen ter beschikking worden gesteld.
Toestemming en gegevensbeheer privacy
In Journey Optimizer kunt u beleid voor gegevensbeheer en toestemming toepassen op uw aangepaste acties om te voorkomen dat bepaalde velden worden geëxporteerd naar systemen van derden of om klanten uit te sluiten die niet hebben ingestemd met het ontvangen van e-mail, push- of SMS-berichten. Raadpleeg de volgende pagina's voor meer informatie:
Configuratiestappen configuration-steps
Hier zijn de belangrijkste stappen die worden vereist om een douaneactie te vormen:
-
Selecteer Configurations in de sectie van het menu BEHEER. Klik in de sectie Actions op Manage . Klik op Create Action om een nieuwe handeling te maken. Het deelvenster Handelingsconfiguratie wordt aan de rechterkant van het scherm geopend.
-
Voer een naam in voor de handeling.
note note NOTE Alleen alfanumerieke tekens en onderstrepingstekens zijn toegestaan. De maximumlengte is 30 tekens. -
Voeg een beschrijving aan uw actie toe. Deze stap is optioneel.
-
Het aantal ritten dat deze handeling gebruikt, wordt weergegeven in het veld Used in . U kunt op de knop View journeys klikken om de lijst met ritten weer te geven die deze handeling gebruiken.
-
Definieer de verschillende URL Configuration -parameters. Zie deze pagina.
-
Configureer de sectie Authentication . Deze configuratie is het zelfde als voor gegevensbronnen. Zie deze sectie.
-
Definieer de Action parameters . Zie deze pagina.
-
Klik op Save.
De aangepaste handeling is nu geconfigureerd en klaar om te worden gebruikt tijdens uw reizen. Zie deze pagina.
note note NOTE Wanneer een douaneactie in een reis wordt gebruikt, zijn de meeste parameters read-only. U kunt alleen de velden Name , Description , URL en Authentication wijzigen.
Eindpuntconfiguratie url-configuration
Wanneer u een aangepaste handeling configureert, moet u de volgende Endpoint Configuration -parameters definiëren:
-
Geef in het veld URL de URL van de externe service op:
-
Als de URL statisch is, voert u de URL in dit veld in.
-
Als de URL een dynamisch pad bevat, voert u alleen het statische gedeelte van de URL in, dat wil zeggen het schema, de host, de poort en eventueel een statisch gedeelte van het pad.
Voorbeeld:
https://xxx.yyy.com/somethingstatic/U geeft het dynamische pad van de URL op wanneer u de aangepaste handeling aan een rit toevoegt. Meer informatie.
note note NOTE Om veiligheidsredenen raden we u ten zeerste aan het HTTPS-schema te gebruiken voor de URL. Wij staan niet het gebruik van Adobe adressen toe die niet openbaar en het gebruik van IP adressen zijn. Alleen de standaardpoorten zijn toegestaan bij het definiëren van een aangepaste handeling: 80 voor http en 443 voor https. -
-
Selecteer de aanroep Method : deze kan POST , GET of PUT zijn.
note note NOTE De DELETE methode wordt niet gesteund. Als u een bestaand middel moet bijwerken, selecteer de PUT methode. -
Definieer de headers en queryparameters:
- Klik in de sectie Headers op Add a header field om de HTTP-koppen te definiëren van het aanvraagbericht dat naar de externe service moet worden verzonden. De headervelden Content-Type en Charset worden standaard ingesteld. U kunt deze velden niet verwijderen. Alleen de header Content-Type kan worden gewijzigd. De waarde ervan moet de JSON-indeling respecteren. Hier is de standaardwaarde:
- Klik in de sectie Query parameters op Add a Query parameter field om de parameters te definiëren die u in de URL wilt toevoegen.
-
Voer het label of de naam van het veld in.
-
Selecteer het type: Constant of Variable . Als u Constant hebt geselecteerd, voert u de constante waarde in het veld Value in. Als u Variable hebt geselecteerd, geeft u deze variabele op wanneer u de aangepaste handeling aan een rit toevoegt. Meer informatie.
note note NOTE Nadat u de douaneactie aan een reis hebt toegevoegd, kunt u kopbal of vraagparametergebieden aan het nog toevoegen als de reis in ontwerpstatus is. Als u niet wilt dat de reis door configuratieveranderingen wordt beïnvloed, dupliceer de douaneactie en voeg de gebieden aan de nieuwe douaneactie toe. Kopteksten worden gevalideerd volgens veldparseringsregels. Leer meer in deze documentatie{_blank}.
mTLS-protocolondersteuning mtls-protocol-support
U kunt Wederzijdse Veiligheid van de Laag van het Vervoer (mTLS) gebruiken om verbeterde veiligheid in uitgaande verbindingen aan de douaneacties van Adobe Journey Optimizer te verzekeren. mTLS is een end-to-end veiligheidsmethode voor wederzijdse authentificatie die ervoor zorgt dat beide partijen die informatie delen wie zij beweren te zijn alvorens de gegevens worden gedeeld. mTLS bevat een extra stap in vergelijking met TLS, waarin de server ook om het certificaat van de client vraagt en dit aan het einde verifieert.
Wederzijdse TLS-verificatie (mTLS) wordt ondersteund in aangepaste handelingen. Er is geen extra configuratie vereist in de douaneactie of de reis om mTLS te activeren; het komt automatisch voor wanneer een mTLS-Toegelaten eindpunt wordt ontdekt. Meer informatie.
De parameters voor de nuttige lading definiëren define-the-message-parameters
U kunt de parameter payload als volgt definiëren:
-
Plak in de sectie Request een voorbeeld van de JSON-payload die u naar de externe service wilt verzenden. Dit gebied is facultatief en slechts beschikbaar voor POST en PUT die methodes roepen.
Schakel de optie Allow NULL values in om Null-waarden in de externe aanroep te behouden. Let op: het verzenden van arrays van int, string, etc. met Null-waarden binnen wordt niet volledig ondersteund. De volgende array met gehele getallen
[1, null, 2, 3]wordt bijvoorbeeld verzonden als[1, 2, 3], zelfs als deze optie is ingeschakeld. Als een dergelijke array null is, wordt deze als een lege array verzonden.
-
Plak in de sectie Response een voorbeeld van de lading die door de aanroep wordt geretourneerd. Dit veld is optioneel en beschikbaar voor alle aanroepmethoden. Voor gedetailleerde informatie over hoe te hefboomwerking API vraagreacties in douaneacties, verwijs naar deze pagina.
. -teken bevatten en mogen niet beginnen met een $ -teken.
In de gebiedsconfiguratie, moet u:
-
Selecteer het parametertype, bijvoorbeeld: tekenreeks, geheel getal, enz.
-
Definieer een constante of variabele parameter:
-
Constante betekent dat de waarde van de parameter in de ruit van de actieconfiguratie door een technische persoonlijkheid wordt bepaald. De waarde zal altijd het zelfde over reizen zijn. Het varieert niet en de marketeter ziet het niet wanneer het gebruiken van de douaneactie in de reis. Het kan bijvoorbeeld een id zijn die het externe systeem verwacht. In dat geval wordt de constante waarde ingesteld op het veld rechts van de schakelconstante/variabele.
-
Variabele betekent de waarde van de parameter kan variëren. Marktdeelnemers die deze aangepaste handeling tijdens een rit gebruiken, kunnen de gewenste waarde doorgeven of opgeven waar de waarde voor deze parameter moet worden opgehaald (bijvoorbeeld van het evenement, van Adobe Experience Platform, enz.). In dat geval, is het gebied op het recht van de knevelconstante/variabele de etiketmarketers in de reis zullen zien om deze parameter te noemen.
Schakel voor optionele parameters de optie Is optional aan het einde van de regel in. Door deze optie in te schakelen, markeert u de parameter als niet-verplicht en laat u de reisartsen kiezen deze al dan niet in te vullen wanneer u die aangepaste handeling op een reis ontwerpt.
-