Introdução para desenvolvedores get-started-developers
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:
- Implementar SDKs em aplicativos para dispositivos móveis e web
- Enviar eventos a partir dos aplicativos para acionar jornadas
- Criar pontos de acesso de API que o Journey Optimizer pode chamar por meio de ações personalizadas
- Integrar o Journey Optimizer aos sistemas e infraestrutura existentes
- Testar e depurar implementações
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:
* Noções básicas sobre APIs RESTful e JSON
* Familiaridade com programação assíncrona e arquiteturas orientadas por eventos
* Conhecimento da arquitetura de aplicativos da organização
* Ambiente de desenvolvimento com acesso à base do código do aplicativo
* Ferramentas de teste como o Postman para teste de API
* Ferramentas de desenvolvedor do navegador ou ferramentas de depuração para dispositivos móveis
* e definições de evento do Engenheiro de dados
* Requisitos e casos de uso dos Profissionais de marketing
Compreender as bases técnicas technical-foundation
Antes de se aprofundar na implementação, familiarize-se com os conceitos técnicos principais:
-
Integração da Adobe Experience Platform: o Journey Optimizer foi criado nativamente na Adobe Experience Platform. Compreender a arquitetura subjacente ajudará a criar implementações mais eficazes. Saiba mais sobre como o Journey Optimizer funciona.
-
Modelos de dados XDM: o Journey Optimizer usa o Experience Data Model (XDM) para estruturar dados de evento e perfil. Como desenvolvedor(a), será necessário entender como enviar dados que estejam em conformidade com os esquemas configurados pelo Engenheiro de dados. Saiba mais sobre esquemas XDM.
-
Autenticação e segurança: todas as implementações exigem autenticação adequada. Entenda como configurar a autenticação para SDKs e APIs. Saiba mais sobre Autenticação de API.
Configurar integrações de aplicativos para dispositivos móveis mobile-integration
Configurar o SDK para dispositivos móveis da Adobe Experience Platform
Para habilitar notificações por push, mensagens no aplicativo e outros recursos móveis, integre o SDK para dispositivos móveis da Adobe Experience Platform nos aplicativos móveis.
-
Instalar e configurar o SDK para dispositivos móveis: siga a documentação do SDK para dispositivos móveis da Adobe Experience Platform para ver uma introdução à integração do SDK.
-
Criar uma propriedade móvel: configure uma propriedade móvel na Adobe Experience Platform Data Collection. Saiba como criar e configurar uma propriedade móvel.
-
Configurar notificações por push:
- Para aplicativos iOS: registre o aplicativo com APNs (serviço de notificação por push da Apple). Saiba mais na documentação da Apple.
- Para aplicativos Android: configure o Firebase Cloud Messaging para seu aplicativo Android. Saiba mais na documentação do Google.
-
Testar a integração móvel: use o fluxo de trabalho de início rápido da integração para dispositivos móveis para definir e testar rapidamente a configuração para dispositivos móveis.
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)
Para personalização nativa de aplicativos móveis com experiências baseadas em código:
- Siga este tutorial para a implementação do SDK para dispositivos móveis
- Revise as implementações de exemplo do iOS e do Android
Implementar experiências da web web-implementation
Configurar o SDK da web da Adobe Experience Platform
Para implementações baseadas na web, o SDK da web é o principal ponto de integração:
-
Instalar o SDK da web: siga o guia de implementação do SDK da web para configurar o SDK no site.
-
Configurar sequências de dados: crie e configure uma sequência de dados na Adobe Experience Platform Data Collection com o Journey Optimizer habilitado. Saiba mais na documentação das sequências de dados.
-
Habilitar notificações por push da web (opcional): configure a propriedade pushNotifications na configuração do SDK da web e use o comando sendPushSubscription para registrar assinaturas por push.
Implementar experiências baseadas em código (SDK da web)
Experiências baseadas em código permitem personalizar qualquer ponto de contato digital:
-
Escolha o método de implementação: lado do cliente, lado do servidor ou híbrido. Revise os exemplos de implementação para cada abordagem.
-
Definir superfícies: identifique os locais no aplicativo em que deseja fornecer conteúdo personalizado. Saiba mais sobre a configuração da superfície.
-
Implementar renderização de conteúdo: use o SDK da web para buscar e aplicar conteúdo de personalização. Consulte tutoriais de implementação baseados em código.
-
Enviar eventos de exibição e interação: controle quando o conteúdo é exibido e quando os usuários interagem com ele para fins de análise e otimização.
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
Como desenvolvedor(a), você implementará o código para enviar eventos que acionam jornadas. O Engenheiro de dados configurará os esquemas e as definições de eventos no Journey Optimizer.
-
Entender o conteúdo do evento: trabalhe com o Engenheiro de dados para obter o esquema do evento e a estrutura de conteúdo necessária. O conteúdo deve estar em conformidade com o esquema XDM configurado. Saiba mais sobre os requisitos do esquema de evento.
-
Implementar a transmissão de eventos: envie eventos para a Adobe Experience Platform usando as APIs de ingestão de transmissão. Saiba mais sobre as etapas para enviar eventos.
-
Tipos de evento de processamento:
- Eventos unitários: implementam o envio de eventos para ações específicas de pessoas (por exemplo: clique de botão, conclusão de compra)
- Eventos de negócios: enviar eventos relacionados a negócios (por exemplo: atualizações de estoque, alterações de preço)
-
Entrega de evento de teste: verifica se os eventos são recebidos corretamente e acionam as jornadas conforme o esperado. Saiba mais sobre a solução de problemas de eventos.
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
As ações personalizadas permitem que as jornadas chamem as APIs. Como desenvolvedor(a), você criará os pontos de acesso da API invocados pelas ações personalizadas:
-
Criar ponto de acesso de API: crie pontos de acesso da API RESTful que o Journey Optimizer chamará durante a execução da jornada. Seu ponto de acesso deve:
- Aceitar conteúdos JSON
- Autenticar solicitações (OAuth, chave de API ou JWT)
- Processar solicitações dentro dos limites de tempo apropriados
- Retornar respostas no formato esperado
-
Entenda os recursos das ações personalizadas: as ações personalizadas podem se conectar a sistemas de terceiros, como Epsilon, Slack, Firebase ou os seus próprios serviços. Saiba mais sobre ações personalizadas.
-
Trabalhar com configurações de ação: o Admin ou o Engenheiro de dados configurará a ação personalizada no Journey Optimizer, definindo a URL do ponto de acesso da API, o método de autenticação e os parâmetros. Você fornecerá a eles a especificação da API. Saiba mais sobre a configuração da ação personalizada.
-
Retornar dados acionáveis: crie a API para retornar dados que possam ser usados nas etapas seguintes da jornada. Saiba mais sobre as respostas de ação.
-
Implementar a limitação de taxa: certifique-se de que os pontos de acesso possam lidar com o volume esperado. O Journey Optimizer aplica um limite de 5000 chamadas/segundo, mas o sistema deve ser resiliente. Saiba mais sobre limitação e controle.
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
O Journey Optimizer fornece APIs REST abrangentes para acesso programático:
-
Entender os recursos da API: as APIs do Journey Optimizer permitem criar, ler, atualizar e excluir vários recursos de forma programática. Saiba mais sobre as APIs do Journey Optimizer.
-
Autenticação: siga este tutorial para configurar a autenticação de API com o Adobe Developer Console.
-
Explorar referências de API: navegue pela documentação completa da API e experimente APIs diretamente na Referência da API do Adobe Journey Optimizer.
-
Campanhas acionadas por API: crie mensagens transacionais com campanhas acionadas por API. Para cenários com alto volume (até 5000 TPS), explore o modo de Alta taxa de transferência (requer licença complementar).
-
APIs de Gestão de decisões: use APIs especializadas para gerenciamento de ofertas e decisioning. Saiba mais no Guia da API de Gestão de Decisões.
Teste e depuração testing
-
Depurar implementação do SDK: use o Adobe Experience Platform Assurance para inspecionar eventos do SDK, validar a coleta de dados e solucionar problemas de integração em tempo real. Saiba mais sobre o Assurance.
-
Entrega de evento de teste: verifica se os eventos do aplicativo são recebidos corretamente pela Adobe Experience Platform e acionam jornadas conforme o esperado. Monitore a ingestão de eventos e valide a estrutura do conteúdo.
-
Validar integrações de API: teste os pontos de acesso de ações personalizadas para garantir que eles processem corretamente as solicitações do Journey Optimizer, respondam dentro dos limites de tempo e retornem formatos de dados esperados.
-
Usar o modo de teste com perfis de teste: trabalhe com o Engenheiro de dados para obter acesso aos perfis de teste e validar a implementação com o modo de teste de jornada. Saiba como testar jornadas.
-
Monitorar logs do SDK: habilite os logs de depuração na implementação do SDK para solucionar problemas durante o desenvolvimento:
- SDK para dispositivos móveis: habilite logs para ver eventos do SDK e chamadas de API
- SDK da web: use o console do navegador para monitorar a atividade do SDK
-
Verificar configuração da sequência de dados: verifique se a sequência de dados está configurada corretamente para enviar dados ao Journey Optimizer. Verifique se os eventos fluem pela sequência de dados para os destinos corretos.
-
Consultar dados da jornada para análise: use consultas SQL no data lake para analisar eventos de etapa da jornada, depurar problemas e monitorar o desempenho da ação personalizada. Explore exemplos de consulta para análise da jornada incluindo:
- Rastreamento de entrada/saída de perfil e motivos de descarte
- Métricas de desempenho de ação personalizada (latência, taxa de transferência, erros)
- Entrega de eventos e padrões de erro
- Estados da instância da jornada
Tópicos avançados do desenvolvedor advanced-topics
Trabalho com dados contextuais e enriquecimento
- Iterar em matrizes: use a sintaxe de manipuladores para exibir listas dinâmicas de eventos, respostas da ação personalizada e pesquisas de conjuntos de dados em mensagens. Saiba mais sobre a iteração de dados contextuais.
- Pesquisa de conjunto de dados: implemente pesquisas de conjunto de dados para enriquecer os dados da jornada a partir de conjuntos de dados da Adobe Experience Platform. Trabalhe com o(a) engenheiro(a) de dados na configuração. Saiba mais sobre pesquisa de conjunto de dados.
Trabalhar com consentimento e governança
Implemente políticas de consentimento e governança de dados nas integrações:
- Governança de dados: aplica políticas de uso de dados a ações personalizadas. Saiba mais sobre a governança de dados.
- Gerenciamento de consentimento: lida com as preferências de consentimento do cliente nas implementações. Saiba mais sobre consentimento.
Otimização e práticas recomendadas
- Limite e controle: entenda os limites de taxa e implemente o controle apropriado. Saiba mais sobre sistemas externos.
- Otimização de jornada: siga as práticas recomendadas para a otimização de jornada.
- Gerenciamento de erros: implemente um gerenciamento de erros robusto. Revise códigos de erro e guias de solução de problemas.
Recursos adicionais additional-resources
- Developer Console: acesse o Adobe Developer Console para criar integrações e gerenciar credenciais de API.
- Código de exemplo: explore implementações de exemplo no GitHub.
- Vídeos tutoriais: aprenda com tutoriais práticos na Experience League.
- Comunidade de desenvolvedores: conecte-se com outros desenvolvedores e obtenha suporte nos fóruns da comunidade da Adobe.
Colaborar entre funções next-steps
O trabalho de implementação cruza com o trabalho de outros membros da equipe:
Colabore com Engenheiros de dados em configurações de dados e eventos:
-
Obter os esquemas XDM e as estruturas de evento necessárias para implementar
-
Entenda quais eventos você precisa enviar e o formato de conteúdo necessário
-
Alinhe os requisitos de coleta de dados e os padrões de qualidade dos dados
-
Teste a entrega de eventos e a ingestão de dados em conjunto
Colabore com os Admins no acesso e nas configurações:
-
Forneça especificações de API para ações personalizadas que serão configuradas
-
Solicite as permissões necessárias e as credenciais de API
-
Coordene os requisitos de configuração de canais (por exemplo: certificados de push)
-
Alinhe os ambientes de teste e a estratégia de sandbox
Colabore com os Profissionais de marketing nos requisitos e testes da jornada:
-
Entenda quais interações do usuário devem acionar eventos
-
Implemente o rastreamento para o desempenho do conteúdo e o engajamento do usuário
-
Dê suporte a testes de jornadas com os recursos implementados
-
Solucione problemas com a entrega ou personalização de mensagens
Comece a implementar
Pronto(a) para começar a criar? Escolha a primeira área de implementação nas seções acima:
- Aplicativo móvel? Iniciar com a Integração do SDK para dispositivos móveis
- Site? Começar com a configuração do SDK da web
- Integração da API? Ir para Trabalho com APIs
- Sistema personalizado? Confira as Ações personalizadas
Cada seção inclui links para a documentação técnica detalhada, amostras de código e tutoriais para orientar a implementação.