Configurar uma ação personalizada configure-an-action
Se você estiver usando um sistema de terceiros para enviar mensagens ou se quiser que as jornadas enviem chamadas de API para um sistema de terceiros, use ações personalizadas para configurar a conexão com sua jornada. Por exemplo, você pode conectar aos seguintes sistemas com ações personalizadas: Epsilon, Slack, Adobe Developer, Firebase etc.
As ações personalizadas são ações adicionais definidas por usuários técnicos e disponibilizadas aos profissionais de marketing. Depois de configuradas, elas são exibidas na paleta esquerda da jornada, no Ação categoria. Saiba mais nesta página.
Limitações custom-actions-limitations
As ações personalizadas vêm com algumas limitações listadas na esta página.
Em parâmetros de ação personalizados, você pode passar uma coleção simples, bem como uma coleção de objetos. Saiba mais sobre as limitações de coleção no esta página.
Observe também que os parâmetros de ações personalizadas têm um formato esperado (por exemplo: sequência, decimal etc.). Você deve ter cuidado para respeitar esses formatos esperados. Saiba mais nesta página caso de uso.
As ações personalizadas oferecem suporte ao formato JSON somente ao usar solicitação ou cargas de resposta.
Práticas recomendadas custom-action-enhancements-best-practices
Ao escolher um ponto de acesso para destino usando uma ação personalizada, verifique se:
- Esse ponto de acesso pode suportar a taxa de transferência da jornada, usando configurações da API de limitação ou da API de limite para limitá-la. Tenha cuidado, pois uma configuração de limitação não pode ficar abaixo de 200 TPS. Qualquer ponto de acesso como destino precisará oferecer suporte a pelo menos 200 TPS.
- Esse ponto de acesso precisa ter um tempo de resposta o mais baixo possível. Dependendo da taxa de transferência esperada, ter um tempo de resposta alto pode afetar a taxa de transferência real.
Um limite máximo de 300.000 chamadas em um minuto é definido para todas as ações personalizadas. Além disso, o limite padrão é executado por host e por sandbox. Por exemplo, em uma sandbox, se você tiver dois pontos de acesso com o mesmo host (por exemplo: https://www.adobe.com/endpoint1 e https://www.adobe.com/endpoint2), o limite será aplicado a todos os pontos de acesso no host adobe.com. "endpoint1" e "endpoint2" compartilharão a mesma configuração de limitação e fazer com que um endpoint atinja o limite terá impacto no outro endpoint.
Esse limite foi definido com base no uso pelos clientes, para proteger pontos de acesso externos direcionados por ações personalizadas. É necessário considerar isso em jornadas baseadas em público-alvo, definindo uma taxa de leitura apropriada (5.000 perfis por segundo ao utilizar ações personalizadas). Se necessário, é possível substituir essa configuração aumentando o limite máximo por meio das APIs de limite e limitação. Consulte esta página.
Você não deve direcionar endpoints públicos com ações personalizadas por vários motivos:
- Sem limitação ou limitação adequada, há o risco de enviar muitas chamadas para um endpoint público que pode não suportar esse volume.
- Os dados do perfil podem ser enviados por meio de ações personalizadas, portanto, o direcionamento a um endpoint público pode levar ao compartilhamento externo inadvertido de informações pessoais.
- Você não tem controle sobre os dados que estão sendo retornados por pontos de extremidade públicos. Se um endpoint alterar sua API ou começar a enviar informações incorretas, elas serão disponibilizadas nas comunicações enviadas, com possíveis impactos negativos.
Consentimento e governança de dados privacy
No Journey Optimizer, você pode aplicar políticas de consentimento e governança de dados às ações personalizadas para impedir que campos específicos sejam exportados para sistemas de terceiros ou excluir clientes que não consentiram em receber comunicações por email, push ou SMS. Para obter mais informações, consulte as seguintes páginas:
Etapas de configuração configuration-steps
Estas são as principais etapas necessárias para configurar uma ação personalizada:
-
Na seção de menu ADMINISTRAÇÃO, selecione Configurações. No Ações clique em Gerenciar. Clique em Criar ação para criar uma nova ação. O painel de configuração de ação é aberto no lado direito da tela.
-
Digite um nome para a ação.
note note NOTE Não use espaços ou caracteres especiais. Não use mais de 30 caracteres. -
Adicione uma descrição à ação. Esta etapa é opcional.
-
O número de jornadas que usam esta ação é exibido no Usado em campo. Você pode clicar no link Exibir jornadas botão para exibir a lista de jornadas usando esta ação.
-
Definir o diferente Configuração de URL parâmetros. Consulte esta página.
-
Configure o Autenticação seção. Essa configuração é a mesma das fontes de dados. Consulte esta seção.
-
Defina o Parâmetros de ação. Consulte esta página.
-
Clique em Salvar.
A ação personalizada agora está configurada e pronta para ser usada em suas jornadas. Consulte esta página.
note note NOTE Quando uma ação personalizada é usada em uma jornada, a maioria dos parâmetros é somente leitura. Você só pode modificar a variável Nome, Descrição, URL e os Autenticação seção.
Configuração do endpoint url-configuration
Ao configurar uma ação personalizada, você precisa definir o seguinte Configuração do endpoint parâmetros:
-
No URL especifique o URL do serviço externo:
-
Se o URL for estático, insira o URL neste campo.
-
Se o URL incluir um caminho dinâmico, insira apenas a parte estática do URL, ou seja, o esquema, o host, a porta e, opcionalmente, uma parte estática do caminho.
Exemplo:
https://xxx.yyy.com/somethingstatic/Você especificará o caminho dinâmico do URL ao adicionar a ação personalizada a uma jornada. Saiba mais.
note note NOTE Por motivos de segurança, recomendamos que você use o esquema HTTPS para o URL. Não permitimos o uso de endereços Adobe que não sejam públicos e o uso de endereços IP. Somente as portas padrão são permitidas ao definir uma ação personalizada: 80 para http e 443 para https. -
-
Selecionar a chamada Método: pode ser POST, GET ou PUT.
note note NOTE A variável DELETE não há suporte para o método. Se precisar atualizar um recurso existente, selecione o PUT método. -
Defina os cabeçalhos e parâmetros de consulta:
- No Cabeçalhos clique em Adicionar um campo de cabeçalho para definir os cabeçalhos HTTP da mensagem de solicitação a ser enviada ao serviço externo. A variável Tipo de conteúdo e Conjunto de caracteres os campos de cabeçalho são definidos por padrão. Não é possível excluir esses campos. Somente o Tipo de conteúdo cabeçalho pode ser modificado. Seu valor deve respeitar o formato JSON. Este é o valor padrão:
- No Parâmetros de consulta clique em Adicionar um campo de parâmetro de Query para definir os parâmetros que deseja adicionar ao URL.
-
Insira o rótulo ou o nome do campo.
-
Selecione o tipo: Constante ou Variável. Se você selecionou Constante, em seguida, insira o valor constante na variável Valor campo. Se você selecionou Variável, em seguida, você especificará essa variável ao adicionar a ação personalizada a uma jornada. Saiba mais.
note note NOTE Depois de ter adicionado a ação personalizada a uma jornada, ainda será possível adicionar campos de parâmetros de cabeçalho ou consulta a ela se a jornada estiver em status de rascunho. Se não quiser que a jornada seja afetada pelas alterações de configuração, duplique a ação personalizada e adicione os campos à nova ação personalizada. Os cabeçalhos são validados de acordo com as regras de análise de campo. Saiba mais em esta documentação.
Definir os parâmetros de carga define-the-message-parameters
-
No Solicitação cole um exemplo da carga JSON para enviar ao serviço externo. Esse campo é opcional e só está disponível para métodos de chamada POST e PUT.
-
No Resposta cole um exemplo da carga útil retornada pela chamada. Este campo é opcional e está disponível para todos os métodos de chamada. Para obter informações detalhadas sobre como aproveitar as respostas de chamada da API em ações personalizadas, consulte esta página.
Você poderá definir o tipo de parâmetro (por exemplo: sequência, número inteiro etc.).
Você também terá uma escolha entre especificar se um parâmetro é uma constante ou uma variável:
- Constante significa que o valor do parâmetro é definido no painel de configuração de ação por uma pessoa técnica. O valor será sempre o mesmo nas jornadas. Ela não variará e o profissional de marketing não a verá ao usar a ação personalizada na jornada. Pode ser, por exemplo, uma ID que o sistema de terceiros espera. Nesse caso, o campo à direita da constante/variável de alternância é o valor transmitido.
- Variável significa que o valor do parâmetro varia. Os profissionais de marketing que usam essa ação personalizada em uma jornada poderão passar o valor desejado ou especificar onde recuperar o valor desse parâmetro (por exemplo, do evento, do Adobe Experience Platform etc.). Nesse caso, o campo à direita da constante/variável de alternância é o rótulo que os comerciantes verão na jornada para nomear esse parâmetro.
