Configurar a experiência baseada em código code-based-configuration

Antes de criar sua experiência, é necessário criar uma configuração de experiência baseada em código na qual você define onde o conteúdo será entregue e consumido dentro do seu aplicativo.

Uma configuração de experiência baseada em código deve fazer referência à superfície, que é basicamente o local em que você deseja renderizar as alterações. De acordo com a plataforma selecionada, você precisa inserir um local/caminho ou o URI de superfície completo. Saiba mais

Criar uma configuração de experiência baseada em código create-code-based-configuration

Para criar uma configuração de canal de experiência baseada em código, siga estas etapas:

  1. Acesse o menu Canais > Configurações gerais > Configurações de canal e clique em Criar configuração de canal.

  2. Insira um nome e uma descrição (opcional) para a configuração.

    note note
    NOTE
    Os nomes devem começar com uma letra (A-Z). Ele só pode conter caracteres alfanuméricos. Também é possível usar sublinhado _, ponto. e hífen - caracteres.
  3. Para atribuir rótulos de uso de dados personalizados ou de núcleo à configuração, você pode selecionar Gerenciar acesso. Saiba mais sobre OLAC (Controle de Acesso em Nível de Objeto)

  4. Selecione Ação de marketing(s) para associar políticas de consentimento às mensagens que usam essa configuração. Todas as políticas de consentimento associadas à ação de marketing são utilizadas para respeitar as preferências dos clientes. Saiba mais

  5. Selecione o canal de experiência baseada em código.

  6. Selecione a plataforma para a qual a experiência de base de código será aplicada:

    note note
    NOTE
    Você pode selecionar várias plataformas. Ao escolher várias plataformas, o conteúdo é entregue a todas as páginas ou aplicativos selecionados.
  7. Escolha o formato esperado pelo aplicativo para este local específico. Isso será usado ao criar a experiência baseada em código em campanhas e jornadas.

  8. Clique em Enviar para salvar suas alterações.

Agora você pode selecionar essa configuração ao criar uma experiência baseada em código em suas campanhas e jornadas.

NOTE
A equipe de implementação do aplicativo é responsável por fazer chamadas explícitas de API ou SDK para buscar conteúdo para as superfícies definidas na configuração de experiência baseada em código selecionada. Saiba mais sobre as diferentes implementações de clientes em esta seção.

Plataformas da Web web

Para definir as configurações de experiência baseada em código para plataformas da Web, siga as etapas abaixo.

  1. Selecione uma das seguintes opções:

    • Página única - Se quiser aplicar as alterações a uma única página exclusivamente, insira uma URL da página.

    • Regra de correspondência de páginas - Para direcionar várias URLs correspondentes à mesma regra, crie uma ou mais regras. Saiba mais

      Por exemplo, se você deseja editar elementos que são exibidos em todas as páginas de produtos femininas do seu site Luma, selecione Domínio > Começa com > luma e Página > Contém > women.

  2. O seguinte se aplica ao URL de visualização:

    • Se um único URL de página for inserido, esse URL será usado para a pré-visualização, sem a necessidade de inserir outro URL.

    • Se uma regra de correspondência de páginas for selecionada, você deverá inserir uma URL de criação e visualização padrão que será usada para visualizar a experiência no navegador. Saiba mais

  3. O campo Local na página especifica o destino exato dentro da página que você deseja que os usuários acessem. Pode ser uma seção específica em uma página na estrutura de navegação do site, como "banner principal" ou "painel do produto".

Plataformas para dispositivos móveis (iOS e Android) mobile

Para definir as configurações de experiência baseada em código para plataformas móveis, siga as etapas abaixo.

  1. Insira sua ID do aplicativo. Isso permite a identificação e a configuração precisas no ambiente operacional do aplicativo e garante integração e funcionalidade perfeitas.

  2. Forneça o Local ou caminho dentro do aplicativo. Este campo especifica o destino exato no aplicativo que você deseja que os usuários acessem. Pode ser uma seção ou página específica na profundidade da estrutura de navegação do aplicativo, como "banner principal" ou "painel do produto".

  3. Preencha o campo Visualizar URL para habilitar visualizações no dispositivo. Esse URL informa ao serviço de visualização o URL específico a ser usado ao acionar a visualização no dispositivo. Saiba mais

    O URL de visualização é um deep link configurado pelo desenvolvedor do aplicativo. Isso garante que todos os URLs correspondentes ao esquema de deep link sejam abertos no aplicativo, em vez de em um navegador móvel da Web. Entre em contato com o desenvolvedor do aplicativo para obter o esquema de deep link configurado para ele.

Os seguintes recursos podem ajudá-lo a configurar deep links para a implementação do seu aplicativo
NOTE
Se você encontrar problemas ao visualizar a experiência, consulte esta documentação.

Outras plataformas other

Para definir as configurações de experiência baseadas em código para outras plataformas (como consoles de vídeo, dispositivos conectados à TV, TVs inteligentes, quiosques, ATMs, assistentes de voz, dispositivos de IoT etc.), siga as etapas abaixo.

  1. Selecione Outros como a plataforma se sua implementação não for para Web, iOS ou Android, ou se você precisar direcionar URIs específicos.

  2. Insira o URI da superfície. Um URI de superfície é um identificador exclusivo que corresponde à entidade em que você deseja fornecer sua experiência. Saiba mais

    note caution
    CAUTION
    Insira um URI de superfície que corresponda ao usado em sua própria implementação. Caso contrário, as alterações não poderão ser entregues.
  3. Adicione outro URI de superfície, se necessário. Você pode adicionar até 10 URIs.

    note note
    NOTE
    Ao adicionar vários URIs, o conteúdo é entregue a todos os componentes listados.

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, que é exclusivamente identificada por um URI. A superfície é especificada na implementação do aplicativo e deve corresponder à superfície referenciada na configuração do canal de experiência baseado 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).

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 um local ou caminho para compor a superfície.

  • Se a plataforma for Outro, você precisará inserir o URI da superfície completo, como nos exemplos abaixo.

Um URI de superfície serve como um identificador preciso que direciona para 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”.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76