Introdução para desenvolvedores get-started-developers

Nesta página: Implemente os SDKs, a transmissão de eventos, os pontos de extremidade de ação personalizados e as APIs que conectam seus aplicativos à Adobe Journey Optimizer para que suas jornadas possam ser executadas em dados dinâmicos.

Como desenvolvedor(a), você é responsável pela implementação e integração do Adobe Journey Optimizer nos aplicativos e sistemas. É possível começar a trabalhar com o Adobe Journey Optimizer assim que o(a) admin de sistema e o(a) engenheiro(a) de dados concederem acesso e prepararem o ambiente.

Sua função no ecossistema do Journey Optimizer

Enquanto outros membros da equipe configuram o Journey Optimizer por meio da interface, você se concentrará em:

O Engenheiro de dados manipulará esquemas de dados, configurações de eventos e fontes de dados. O Admin definirá as permissões e as configurações de canal. Os profissionais de marketing criarão as jornadas e o conteúdo que usa as implementações.

Este guia aborda as etapas essenciais de implementação técnica para uma introdução ao Journey Optimizer. Se estiver criando aplicativos para dispositivos móveis, experiências da web ou integrações de API, siga as seções abaixo para configurar a implementação.

Pré-requisitos prerequisites

Antes de iniciar a implementação, verifique se possui:

Compreender as bases técnicas technical-foundation

Antes de se aprofundar na implementação, familiarize-se com os conceitos técnicos principais:

Configurar integrações de aplicativos para dispositivos móveis mobile-integration

Configurar o SDK para dispositivos móveis da Adobe Experience Platform

O Mobile SDK é uma coleção de bibliotecas incorporadas diretamente no seu aplicativo iOS ou Android. Ele age como a camada de comunicação entre o aplicativo e o Adobe Experience Platform: identifica usuários, coleta eventos comportamentais e fornece instruções do Journey Optimizer, incluindo notificações por push, mensagens no aplicativo e conteúdo personalizado. Sem ele, o Journey Optimizer não tem visibilidade do que os usuários do aplicativo estão fazendo nem como acessá-los.

As etapas detalhadas para configurar notificações por push estão disponíveis nesta página.

Implementar experiências baseadas em código (SDK para dispositivos móveis)

Experiências baseadas em código permitem fornecer conteúdo personalizado a qualquer superfície em seu aplicativo móvel nativo, desde telas de integração e páginas de detalhes do produto até banners no aplicativo e sinalizadores de recursos, sem exigir uma nova versão do aplicativo. Use o Mobile SDK para buscar e renderizar conteúdo personalizado no tempo de execução, dando à sua equipe controle total sobre a disposição e a apresentação:

Implementar experiências da web web-implementation

Configurar o SDK da web da Adobe Experience Platform

O Web SDK (alloy.js) é uma única biblioteca JavaScript que substitui a manta de retalhos de tags Adobe separadas que o site poderia precisar. Ele coleta dados comportamentais, transmite-os para o Adobe Experience Platform por meio de uma sequência de dados configurada por você e recebe instruções de personalização de volta — tudo isso em uma rede de ida e volta. Uma vez implementado, o Journey Optimizer pode identificar visitantes, acionar jornadas de suas ações e fornecer conteúdo personalizado para suas páginas imediatamente.

Implementar experiências baseadas em código (SDK da web)

Diferentemente dos canais visuais, em que os profissionais de marketing controlam totalmente o layout, as experiências baseadas em código fornecem total propriedade sobre como o conteúdo personalizado é renderizado na página. O Journey Optimizer retorna uma carga JSON com os dados de personalização; seu código decide onde e como exibi-la. Esse modelo funciona para qualquer superfície da Web — banners ilustrados, carrosséis de recomendação, classificações de resultados de pesquisa, variantes de teste A/B — sem precisar de um editor visual ou fluxo de trabalho de publicação de página.

Explore implementações de exemplo no GitHub para ver as experiências baseadas em código em ação.

Saiba mais sobre a introdução a experiências baseadas em código.

Implementar a transmissão de eventos event-streaming

Enviar eventos para acionar jornadas

Jornadas executadas em eventos — um usuário faz logon, adiciona um item ao carrinho, conclui uma compra, abandona um formulário. Seu trabalho é emitir esses eventos do seu aplicativo no momento exato. Cada evento é uma carga JSON estruturada em XDM enviada para a API de assimilação de streaming do Experience Platform; o Journey Optimizer a seleciona em milissegundos e direciona o perfil para qualquer jornada correspondente. O esquema de evento e a estrutura de carga são definidos pelo seu Engenheiro de Dados — coordene com eles antes de começar a codificar.

Exemplo de implementação para enviar um evento via API:

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

Saiba mais sobre como trabalhar com eventos de jornada.

Desenvolver pontos de acesso de ações personalizadas custom-actions

Quando uma jornada atinge uma etapa de ação personalizada, o Journey Optimizer faz uma chamada HTTP de saída para um URL que você fornece — seu back-end, um CRM, uma plataforma de fidelidade, qualquer endpoint REST. Seu trabalho é criar e expor esse endpoint: definir o contrato de solicitação (forma de carga, método de autenticação, formato de resposta), implementar a lógica de negócios por trás dele e garantir que ele possa lidar com o volume de chamadas gerado pelo Journey Optimizer. O Administrador registra o ponto de extremidade no Journey Optimizer para que os profissionais de marketing possam usá-lo como uma etapa em suas jornadas.

Caso de uso de exemplo: gravação de eventos da jornada na Experience Platform usando ações personalizadas.

Trabalhar com APIs do Journey Optimizer apis

Nem tudo precisa acontecer por meio da interface do usuário do Journey Optimizer. Às vezes, você precisa acionar uma campanha do seu próprio back-end, suprimir um endereço de email após uma solicitação de privacidade ou sincronizar modelos de conteúdo de um CMS externo. As REST APIs do Journey Optimizer fornecem acesso programático aos principais recursos da plataforma. Todas as chamadas usam a autenticação de servidor para servidor OAuth — o método JWT mais antigo foi descontinuado.

Teste e depuração testing

Antes da implementação entrar em vigor, você precisa ter certeza de que os eventos serão acionados no momento certo, as jornadas serão acionadas conforme esperado, as ações personalizadas se comportarão sob carga realista e o conteúdo personalizado será renderizado corretamente. Esta seção aborda as ferramentas e técnicas para capturar problemas antecipadamente — desde o registro de baixo nível do SDK até a execução completa de testes de jornada com perfis reais.

Tópicos avançados do desenvolvedor advanced-topics

Quando seus SDKs, eventos e APIs principais estiverem em vigor, esses tópicos ajudarão você a ir além: enriquecer dados do jornada no tempo de execução sem sobrecarregar o perfil, manipular sinais de consentimento para que as recusas se propaguem por todas as integrações e ajustar a implementação para a taxa de transferência e a confiabilidade que a escala de produção exige.

Trabalho com dados contextuais e enriquecimento

As jornadas geralmente precisam de mais dados do que o que chega no evento de acionamento — um nome de produto, um nível de fidelidade, uma lista de itens de linha de pedido. Em vez de pré-carregar tudo isso em cada perfil, o enriquecimento contextual permite que a jornada o procure no tempo de execução dos conjuntos de dados do AEP ou o carregue a partir de uma resposta de ação personalizada. Suas mensagens e condições de ramificação podem fazer referência a esses dados sem que eles sejam armazenados permanentemente no perfil.

Trabalhar com consentimento e governança

O Journey Optimizer aplica políticas de consentimento e governança de dados no nível da plataforma, mas a integração também precisa respeitá-las. Quando um cliente recusa comunicações de marketing ou quando um rótulo de uso de dados restringe como um campo pode ser usado, essas regras precisam se propagar por meio de ações personalizadas e pesquisas de conjunto de dados, não apenas ações de bloco na interface do usuário.

Otimização e práticas recomendadas

As implementações de produção do Journey Optimizer lidam regularmente com milhões de eventos e milhares de execuções de jornadas por segundo. Esses recursos ajudam a ajustar a integração para essa escala: compreender limites de taxa antes de atingi-los, evitar armadilhas comuns do design de jornada que silenciosamente descartam perfis e criar um tratamento de erros que degrada normalmente em vez de falhar opaquamente.

Chamar APIs REST do Journey Optimizer rest-apis

Além de implementar SDKs e transmissão de eventos, você também pode impulsionar o Journey Optimizer de forma programática a partir de seus próprios sistemas. A referência completa da API, as especificações da OpenAPI e as amostras de código estão no portal do desenvolvedor do Journey Optimizer.

Executar campanhas acionadas por API api-triggered

Acione mensagens transacionais ou de marketing de um sistema externo usando a API REST de execução de mensagem interativa. Antes de chamar o ponto de extremidade:

Referência de API · Amostras de código · Trabalhar com campanhas acionadas por API

Limite e limitação para endpoints externos capping-throttling

Quando o jornada chama sistemas externos por meio de ações personalizadas ou fontes de dados, as APIs de limitação e limitação protegem esses sistemas contra sobrecarga. O limite rejeita chamadas que excedem o limite configurado; a limitação as enfileira por até 6 horas (sandboxes de produção, somente ações personalizadas).

Referência da API de Limite · Trabalhar com a API de Limite · Trabalhar com a API de Limitação

Mais REST APIs more-rest-apis

Além das mensagens e do limite, o Journey Optimizer expõe os endpoints REST para gerenciamento de supressão, modelos de conteúdo, recuperação de campanha, provas e execução de campanha orquestrada. Use-os quando precisar automatizar operações que, de outra forma, exigiriam etapas manuais na interface do usuário — por exemplo, suprimir endereços em massa após um pull de dados ou sincronizar modelos de um pipeline de conteúdo externo.

Recursos adicionais additional-resources

Colaborar entre funções next-steps

O trabalho de implementação cruza com o trabalho de outros membros da equipe:

Comece a implementar

Pronto(a) para começar a criar? Escolha a primeira área de implementação nas seções acima:

Cada seção inclui links para a documentação técnica detalhada, amostras de código e tutoriais para orientar a implementação.

Outros guias de função other-role-guides

Voltar à Visão geral de funções e responsabilidades · Voltar à Introdução