Perguntas frequentes sobre integrações vendor-integration-faq

O que as integrações fazem no Journey Optimizer?

Ele conecta fontes de dados externas ao Journey Optimizer para que você possa extrair conteúdo e dados de sistemas de terceiros em suas campanhas e jornadas e personalizar mensagens usando esses dados.

➡️ Saiba mais sobre a visão geral de Integrações

Quem configura as Integrações e quem as usa no conteúdo?

Os administradores criam e ativam a configuração técnica (Configurações > Integrações > Gerenciar > Criar Integração). Os profissionais de marketing usam Adicionar personalização em componentes de Texto ou HTML, abrir Integrações, escolher uma integração ativa e mapear atributos.

➡️ Saiba mais sobre fluxos de trabalho de administrador e de profissional de marketing

Onde criar ou gerenciar integrações na interface do usuário como administrador?

Vá para a seção Configurações no menu esquerdo, abra Gerenciar no cartão Integrações e selecione Criar Integração.

➡️ Saiba mais sobre como criar uma integração

Quais são os casos de uso comuns para integrações?

Os exemplos incluem pontos de recompensa de sistemas de fidelidade, informações sobre preço do produto, recomendações de mecanismos de recomendação e atualizações de logística, como status de entrega.

➡️ Saiba mais sobre dados de exemplo de sistemas de terceiros

➡️ Saiba mais sobre exemplos de integração de fornecedor

Como configurar uma integração em alto nível como administrador?

Você fornece um nome e uma descrição, uma URL de ponto de extremidade de API (opcionalmente com variáveis de caminho), valores de modelo de caminho, GET ou POST, cabeçalhos e parâmetros de consulta opcionais, um método de autenticação, configurações de política (como tempo limite e cache opcional ou tentativa), uma resposta JSON de exemplo para mapear campos, e executa Enviar conexão de teste e Ativar quando for válido.

➡️ Saiba mais sobre a configuração de integração

Que tipos de autenticação são aceitos?

Estes tipos de autenticação estão disponíveis: Sem autenticação, Chave de API, Autenticação Básica e OAuth 2.0 (com configuração de carga para OAuth onde aplicável).

➡️ Saiba mais sobre tipos de autenticação

Para que a etapa de carga de resposta é usada?

Cole uma amostra de resposta JSON para que o sistema possa detectar tipos de dados e você possa escolher quais campos são expostos para personalização nas mensagens. É possível limitar quais campos estão disponíveis para profissionais de marketing durante a criação.

➡️ Saiba mais sobre o mapeamento de carga de resposta

Como os profissionais de marketing adicionam uma integração a uma mensagem?

No conteúdo da campanha ou da jornada, use Adicionar personalização em um componente de Texto ou HTML, vá para Integrações, selecione uma integração e salve. Com o modo Pills no editor de personalização, você pode mapear valores para variáveis na configuração (como parâmetros de cabeçalho ou consulta ou variáveis de caminho no URL).

➡️ Saiba mais sobre personalização com Integrações

Posso usar integrações em jornadas e campanhas?

Sim. O recurso está disponível para jornadas e campanhas para canais de saída (por exemplo, email, SMS e push), dentro dos limites atuais do produto.

➡️ Saiba mais sobre jornadas e campanhas

Posso usar integrações em fragmentos reutilizáveis?

O recurso Integrações é compatível com Fragmentos.

➡️ Saiba mais sobre fragmentos

Quais canais oferecem suporte a integrações?

Há suporte para canais de saída (por exemplo, email, SMS e push).

➡️ Saiba mais sobre os canais com suporte

Quais formatos de resposta da API são compatíveis?

Para respostas de chamada de API, há suporte para JSON e HTML para mapeamento de campos. A saída de imagem binária bruta e os formatos que não são JSON não estão disponíveis para este fluxo de trabalho.

➡️ Saiba mais sobre JSON e formatos de resposta

A quais padrões de API posso me conectar?

Recuperação APIs que direcionam conteúdo específico são suportadas. Não há suporte para APIs de Listagem (lista ampla ou padrões de paginação) neste modelo de integração.

➡️ Saiba mais sobre recuperação versus APIs de listagem

Quais permissões são necessárias para configurar integrações?

Para começar a usar Integrações, os usuários precisam receber as permissões Gerenciar configuração de integração do AJO e Exibir configuração de integração do AJO.

➡️ Saiba mais sobre permissões de integrações

As integrações substituem os conectores do Adobe Journey Optimizer nas Fontes do Experience Platform?

Não. Integrações são para campos de personalização no conteúdo da mensagem que você orienta das APIs. Fontes e outros recursos de assimilação de dados atendem a diferentes objetivos (por exemplo, assimilação de dados em lote e enriquecimento de perfil). Use cada recurso para o escopo desejado.

➡️ Saiba mais sobre o que são as integrações

➡️ Saiba mais sobre Fontes do Experience Platform

Por que a conexão de teste falha ou permanece inválida?

Verifique o URL do endpoint, o método HTTP, os modelos de caminho, os cabeçalhos e parâmetros de consulta, a autenticação e o tempo limite da política. Usar Enviar conexão de teste após ajustes. Para problemas de carga, verifique se a amostra reflete um JSON válido e se os campos selecionados correspondem ao que a API retorna.

➡️ Saiba mais sobre conexão de teste e validação de carga

Por que os profissionais de marketing não veem minha integração no seletor?

As integrações devem ser ativadas após um teste bem-sucedido. Somente integrações ativas aparecem quando os profissionais de marketing abrem Integrações. Se a integração ainda for de rascunho ou inativa, conclua a ativação primeiro.

➡️ Saiba mais sobre conexão de teste e ativação

Quais exemplos de fornecedores estão disponíveis e quem protege a API?

É possível integrar o a qualquer plataforma de terceiros que exponha um endpoint de API compatível. Padrões de fornecedor e exemplos de configuração ilustrativos podem ajudá-lo a modelar APIs compatíveis. A responsabilidade de proteger os endpoints é da plataforma de terceiros e da sua equipe.

➡️ Saiba mais sobre os procedimentos de integração de fornecedores

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page answers frequently asked questions about Integrations in Adobe Journey Optimizer, covering configuration, authentication, supported channels and formats, API patterns, permissions, and troubleshooting.

Intents:

• Understand what Integrations do and who configures versus uses them
• Learn how administrators configure and marketers add an integration to message content
• Determine which channels, response formats, and API patterns are supported
• Find the permissions required to configure Integrations
• Troubleshoot a failing test connection or an integration missing from the marketer picker

Glossary:

• Integrations: Feature that connects external data sources so you can pull content and data from third-party systems into campaigns and journeys and personalize messages (product-specific)
• Add personalization: Action on a Text or HTML component that marketers use to open Integrations, choose an active integration, and map attributes (product-specific)
• Pills mode: Personalization editor mode used to map values to variables in the configuration, such as header or query parameters or path variables in the URL (product-specific)
• Retrieval APIs: APIs that target specific content, which are supported for this integration model (product-specific)
• Listing APIs: Broad list or pagination patterns, which are not supported for this integration model (product-specific)

Guardrails:

• Outbound channels are supported (for example email, SMS, and push).
• For API call responses, JSON and HTML are supported for field mapping; raw binary image output and formats that are not JSON are not available.
• Retrieval APIs that target specific content are supported; Listing APIs (broad list or pagination patterns) are not supported.
• To configure Integrations, users need the Manage AJO integration configuration and View AJO integration configuration permissions.
• Only active integrations appear when marketers open Integrations; the integration must be activated after a successful test.
• Supported authentication types: No Authentication, API key, Basic Auth, and OAuth 2.0.
• The Integrations feature is supported in Fragments.

Terminology:

• Canonical name: Integrations — Acronym: n/a — variants: external integrations, third-party integrations
• Synonyms: administrators “create and activate the technical configuration” = the setup marketers later select via “Add personalization”
• Do not confuse: “Integrations” (personalization fields in message content driven from APIs) ≠ “Sources” (Experience Platform data ingestion, such as batch ingestion and profile enrichment)
• Do not confuse: “Retrieval” APIs (supported) ≠ “Listing” APIs (not supported)

FAQ:

• Q: Which channels support Integrations? — Outbound channels (for example email, SMS, and push).
• Q: Which API response formats are supported? — JSON and HTML; raw binary image output and non-JSON formats are not available.
• Q: Which API patterns can I connect to? — Retrieval APIs that target specific content; Listing (broad list or pagination) APIs are not supported.
• Q: Can I use Integrations in reusable fragments? — Yes, the feature is supported in Fragments.
• Q: Do Integrations replace Experience Platform Sources? — No; Integrations drive personalization fields from APIs, while Sources handle data ingestion such as batch ingestion and profile enrichment.
• Q: Why do marketers not see my integration in the picker? — Integrations must be activated after a successful test; only active integrations appear.