DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Superfícies de experiência baseada em código code-based-surface

Last update: Fri Dec 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador

O que é uma superfície? surface-definition

Uma experiência baseada em código superfície é qualquer entidade projetada para interação do usuário ou do sistema, exclusivamente identificada por um URI. A superfície é especificada na implementação do aplicativo e deve corresponder à superfície referenciada na configuração de canal de experiência baseada em código.

Uma superfície pode ser vista como um container em qualquer nível de hierarquia com uma entidade (ponto de contato) que existe.

  • Ela pode ser uma página da Web, um aplicativo móvel, um aplicativo de desktop, um local de conteúdo específico em uma entidade maior (por exemplo, um div) ou um modelo de exibição fora do padrão (por exemplo, um quiosque ou um banner de aplicativo de desktop).

  • Ela também pode se estender para partes específicas de containers de conteúdo para fins de não exibição ou exibição abstrata (por exemplo, blobs JSON fornecidos aos serviços).

  • Também pode ser uma superfície curinga que corresponde a várias definições de superfície do cliente (por exemplo, um local de Hero image em cada página do site pode ser traduzido em um URI de superfície como: web://mydomain.com/*#hero_image).

Identificador de superfície surface-uri

Um URI de superfície serve como um identificador preciso direcionado a elementos ou componentes distintos da interface do usuário em um aplicativo. Basicamente, um URI de superfície é composto de várias seções:

  1. Tipo: web, aplicativo móvel, ATM, quiosque, TVCD, serviço etc.
  2. Propriedade: URL da página ou pacote de aplicativos
  3. Container: local na atividade da página/aplicativo

A tabela abaixo lista alguns exemplos de definição de URI de superfície para vários dispositivos.

Web e dispositivos móveis

Tipo
URI
Descrição
Web
web://domain.com/path/page.html#element
Representa um elemento individual em uma página específica de um domínio específico, onde um elemento pode ser um rótulo, como nos seguintes exemplos: hero_banner, top_nav, menu, rodapé etc.
Aplicativo para iOS
mobileapp://com.vendor.bundle/activity#element
Representa um elemento específico em uma atividade do aplicativo nativo, como um botão ou outro elemento de exibição.
Aplicativo para Android
mobileapp://com.vendor.bundle/#element
Representa um elemento específico em um aplicativo nativo.

Outros tipos de dispositivo

Tipo
URI
Descrição
Desktop
desktop://com.vendor.bundle/#element
Representa um elemento específico em um aplicativo, como um botão, menu, banner hero, etc.
Aplicativo de TV
tvcd://com.vendor.bundle/#element
Representa um elemento específico de uma Smart TV ou um aplicativo em um dispositivo conectado a uma TV: ID do pacote.
Serviço
service://servicename/#element
Representa um processo do lado do servidor ou outra entidade manual.
Quiosque
kiosk://location/screen#element
Exemplo de possíveis tipos de superfície adicionais que podem ser adicionados facilmente.
ATM
atm://location/screen#element
Exemplo de possíveis tipos de superfície adicionais que podem ser adicionados facilmente.

Superfícies curingas

Tipo
URI
Descrição
Web com curinga
wildcard:web://domain.com/*#element
Superfície curinga: representa um elemento individual em cada uma das páginas em um domínio específico.
Web com curinga
wildcard:web://*domain.com/*#element
Superfície curinga: representa um elemento individual em cada uma das páginas em todos os domínios que terminam em “domain.com”.

Composição do URI uri-composition

No Journey Optimizer, o canal de experiência baseado em código oferece suporte a dois tipos de implementações de clientes:

NOTE
Saiba mais sobre os pré-requisitos de implementação em esta seção.

Usando experiências baseadas em código, você pode modificar o conteúdo em locais granulares que são identificados exclusivamente por Journey Optimizer usando URIs de superfície.

Esses URIs de superfície são compostos e manipulados dependendo do método de implementação:

  • SDK da Web/Móvel: o desenvolvedor da Web/móvel precisa definir esses locais granulares como cadeias de caracteres simples, pois o SDK da Web/Móvel é capaz de compor automaticamente o URI da superfície com base na URL/ID do aplicativo atual e na cadeia de caracteres do local.

  • APIs Edge Network: o desenvolvedor do aplicativo/página deve definir URIs de superfície completos que incluam o caminho completo e o local onde o conteúdo será consumido, pois os URIs completos são necessários neste tipo de implementação.

É por isso que, ao criar uma configuração de canal de experiência baseada em código, você tem duas maneiras de especificar a superfície de acordo com a plataforma selecionada:

  • Para as plataformas Web, iOS e Android, é necessário inserir a URL/ID do aplicativo e um local ou caminho para compor a superfície. Saiba mais sobre como configurar experiências baseadas em código para plataformas web e móveis

  • Se a plataforma for Outro, você precisará inserir o URI da superfície completo, como nos exemplos acima. Saiba mais sobre como configurar experiências baseadas em código para outras plataformas

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76