Introdução para desenvolvedores get-started-developers

Nesta página: implemente os SDKs, o streaming de eventos, os pontos de acesso de ações personalizadas e as APIs que conectam seus aplicativos ao Adobe Journey Optimizer, para que suas jornadas possam ser executadas com dados em tempo real.

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 SDK móvel é uma coleção de bibliotecas incorporadas diretamente no aplicativo iOS ou Android. Ele age como a camada de comunicação entre o aplicativo e a 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 SDK móvel para buscar e renderizar conteúdo personalizado no tempo de execução, dando à sua equipe controle total sobre o posicionamento e a apresentação:

Implementar experiências da web web-implementation

Configurar o SDK da web da Adobe Experience Platform

O SDK da web (alloy.js) é uma única biblioteca JavaScript que substitui o conjunto fragmentado de tags separadas da Adobe de que seu site poderia precisar. Ele coleta dados comportamentais, transmite-os para a Adobe Experience Platform por meio de uma sequência de dados configurada por você e recebe instruções de personalização de volta — tudo em uma única ida e volta pela rede. 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 um conteúdo JSON com os dados de personalização; o código decide onde e como exibi-lo. 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 é um conteúdo JSON estruturada em XDM enviado para a API de ingestão de transmissão da Experience Platform; o Journey Optimizer o seleciona em milissegundos e direciona o perfil para qualquer jornada correspondente. O esquema de evento e a estrutura de conteúdo são definidos pelo seu Engenheiro de dados — coordene com ele 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 ponto de acesso REST. Seu trabalho é criar e expor esse ponto de acesso: defina o contrato de solicitação (forma de conteúdo, método de autenticação, formato de resposta), implemente a lógica de negócios por trás dele e garanta que ele possa lidar com o volume de chamadas gerado pelo Journey Optimizer. O Administrador registra o ponto de acesso 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 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 são acionados no momento certo, as jornadas são acionadas conforme esperado, as ações personalizadas se comportam sob carga realista e o conteúdo personalizado é renderizado corretamente. Esta seção aborda as ferramentas e técnicas para detectar problemas antecipadamente, desde o registro do SDK de baixo nível até execuções de testes de jornada de ponta a ponta com perfis reais.

Tópicos avançados do desenvolvedor advanced-topics

Quando seus SDKs, eventos e APIs principais estão em vigor, esses tópicos ajudam você a ir além: enriquecer dados da 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 da 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 opta por não receber comunicações de marketing, ou quando um rótulo de uso de dados restringe a forma como um campo pode ser utilizado, essas regras precisam ser propagadas pelas suas ações personalizadas e consultas a conjuntos de dados, não apenas bloquear ações na interface.

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 você a ajustar a integração para lidar com essa escala: entender os limites de taxa antes de atingi-los, evitar armadilhas comuns no design de jornadas que podem fazer com que perfis sejam silenciosamente descartados e implementar um tratamento de erros que permita uma degradação gradual, em vez de falhas sem uma causa aparente.

Chamar APIs REST do Journey Optimizer rest-apis

Além de implementar SDKs e o streaming de eventos, você também pode controlar o Journey Optimizer de forma programática a partir dos 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 acesso:

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

Limite e controle de pontos de acesso externos capping-throttling

Quando as jornadas chamam sistemas externos por meio de ações ou fontes de dados personalizadas, as APIs de limite e controle protegem esses sistemas contra sobrecarga. O limite rejeita chamadas que excedem o limite configurado; o controle 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 controle

Mais REST APIs more-rest-apis

Além de mensagens e limites de frequência, o Journey Optimizer disponibiliza pontos de acesso REST para gerenciamento de supressão, criação de modelos de conteúdo, recuperação de campanhas, provas e execução orquestrada de campanhas. Use-os quando precisar automatizar operações que, de outra forma, exigiriam etapas manuais na interface, por exemplo, suprimir endereços em massa após um pull de dados ou sincronizar modelos de um pipeline de conteúdo externo.

| Validar conjuntos de dados e acionar a execução de campanha orquestrada | Validação de conjunto de dados · Acionar · Habilitar conjuntos de dados |

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