Visão Geral de Experience APIs

As Experience APIs são um conjunto de terminais que você pode chamar através do código do seu site. Nossas APIs permitem as mesmas funcionalidades de personalização e coleta de dados que o script que nosso site fornece, mas elas precisam ser chamadas pela sua base de código para que a Dynamic Yield saiba que deve retornar os dados relevantes. Ao receber os dados, fica a seu critério o que fazer com eles no código do seu site.

As Experience APIs oferecem vários benefícios. Elas:

• Proporcionam uma experiência perfeita no site, sem tremulação. 
• Dão aos usuários a mesma experiência digital em diferentes canais.
• Não expõem suas campanhas ao navegador, evitando a exposição de estratégias internas.
• Ajuda a proteger a privacidade do usuário e cumprir com as regulações.

Pré-requisitos

Os pontos principais que você precisa confirmar para começar sua jornada de personalização de APIs são:

1. Você tem recursos de desenvolvedores disponíveis para colaboração.
2. Você está em uma área atendida por um dos nossos datacenters.
3. Se você trabalha em uma CDN (rede de distribuição de conteúdo), certifique-se de que possa distribuir conteúdo dinâmico (em vez de páginas estáticas armazenadas em cache).

Para mais detalhes, consulte Verifique sua Prontidão em nosso Developer Docs (Documentação para Desenvolvedores).

As Experience APIs

A família de Experience APIs da Dynamic Yield inclui as seguintes APIs.

Escolhendo variações

A escolha de variações, ou o terminal Choose (Escolher), é o seu terminal primário. As chamadas de Choose ativam uma ou mais campanhas da Dynamic Yield pelo nome. A ativação resolve as regras de direcionamento e as alocações de grupos de teste automaticamente e retorna a variação correta ao usuário. Tipicamente, você usa essa chamada como parte do seu pipeline maior de renderização de página e conteúdo. As configurações da campanha são todas controladas no console do Experience OS. 

Nas páginas que não rodam o script da Dynamic Yield, a API Choose também pode reportar visualizações de página.

Reportando visualizações de página

Use esse terminal para reportar uma visualização de página sem nenhuma campanha conectada. Pageview (visualização de página) é basicamente um alias para Choose, mas sem nenhum nome de campanha. Observe que, se você estiver usando o script da Dynamic Yield, as visualizações de páginas são reportadas implicitamente na chamada de Choose, enquanto, se você tiver o script da Dynamic Yield no seu site, elas não serão reportadas na chamada, porque é o script que reporta as visualizações de páginas.

Reportando interações

Depois de receber as variações através da chamada de Choose e renderizá-las (ou realizar qualquer outra ação relevante), o próximo passo é receber um relatório de interações com qualquer variação renderizada. Geralmente, você mede os cliques do usuário na página, embora também possa medir impressões. Essas métricas permitem que você analise o sucesso das suas campanhas e aprimore o desempenho.

Reportando eventos

Reportar eventos significativos do usuário (como login, inclusão no carrinho, compra, reprodução de vídeo etc.) é crucial para segmentação e experimentação: você geralmente faz o direcionamento aos usuários com base em suas ações passadas ou define um evento como uma métrica primária ou secundária para suas campanhas. Consulte mais informações sobre eventos integrados e personalizados em Reportando Eventos.

Usando personalização baseada em script e Experience APIs 

Não importa se você é novo na Dynamic Yield ou se já usa nosso script no seu site, você pode aproveitar o melhor dos dois mundos combinando as campanhas de API e as campanhas que você cria no console do Experience OS. Por exemplo, se estiver acostumado com as ferramentas de teste e personalização do lado cliente e quiser minimizar o prazo de retorno enquanto mantém suas opções futuras abertas, você pode começar rapidamente com o script do site e, depois, implementar gradualmente campanhas baseadas em APIs. Os casos de uso para os quais as campanhas de API são especialmente recomendados incluem:

• Você quer executar campanhas sensíveis a desempenho (por exemplo, conteúdo acima da dobra).
• Você tem campanhas com dados sensíveis que não quer que sejam expostos no navegador.
• Você planeja executar um grande número de testes simultaneamente.

Saiba mais sobre Usando Experience APIs e o Script da Dynamic Yield Juntos para Personalização da Web.

Implementando campanhas

As Experience APIs permitem que você forneça conteúdo para aplicativos móveis e web através do mesmo site e crie um perfil de usuário unificado em diferentes dispositivos implementando eventos de identificação com valores que correspondam. Você pode criar os seguintes tipos de campanha com Experience APIs no Experience OS:

• Campanhas de Recommendation (Recomendação): exiba automaticamente os itens mais relevantes para cada usuário.
  Para Web Personalization (Personalização da Web) | Para App Personalization (Personalização do Aplicativo)     

• Campanhas personalizadas: use o poder dos testes A/B e da alocação automática da Dynamic Yield, enquanto controla totalmente como as campanhas são renderizadas no seu site.
  Para Web Personalization (Personalização da Web) | Para App Personalization (Personalização do Aplicativo)

Saiba mais sobre a implementação de Experience APIs para aplicativos móveis.

Depois de criar uma campanha de API, você pode pré-visualizá-la no Experience OS:

• Pré-visualização de Campanhas de API para Web Personalization
• Pré-visualização de Campanhas de API para App Personalization