Personalização

O servidor faz a escolha

Uma leitura informa ao Fóir o que ela sabe sobre a requisição: o dispositivo, o locale e qualquer dimensão sua, como o tipo de produto no carrinho ou em qual mercado o visitante está comprando. O Fóir acrescenta o resto por conta própria: de onde veio a requisição, se o usuário está logado e a quais segmentos ele pertence.

Ele escolhe a variante cujas regras correspondem e devolve o registro com os valores dessa variante já aplicados. Seu código lê os mesmos campos, qualquer que seja a versão que volte.

O que um visitante não pode declarar

Localização, status de login, participação em segmentos e dados de perfil nunca são tomados do chamador. O Fóir determina a origem da requisição por conta própria e deduz o resto a partir do token do usuário, não importa o que a requisição afirme.

A regra de um segmento pode ler um campo de perfil que o cliente não tem permissão para ver, então um valor que você mantém privado ainda pode decidir o que um cliente vê.

Um público é definido uma só vez

Para quem é uma variante é uma entrada no catálogo de variantes: um conjunto nomeado de regras com uma prioridade. As regras podem combinar dimensões e segmentos com AND e OR.

Qualquer número de registros pode apontar para uma mesma entrada. Edite a entrada e todas as variantes que a usam são redirecionadas.

Uma página, um campo ou um parágrafo

Uma variante pode substituir um registro inteiro, com seus próprios rascunhos e histórico de versões. Ela também pode sobrescrever um único campo, ou uma entrada dentro de um campo de prosa ou de uma lista, e deixar o resto como está.

Os editores escrevem cada versão no mesmo editor e visualizam o rascunho como o público a que ele se destina.

Exemplo: a maratona de Paris

Uma marca de corrida quer que sua página inicial abra com a maratona, mas só para quem está em Paris e já comprou tênis de corrida dela.

Nenhum dos dois fatos vem do site. O Fóir determina a origem de cada requisição, então uma regra pode pedir visitantes a até 30 km de Paris. Um segmento lê o perfil do cliente logado: as categorias que ele já comprou incluem tênis de corrida.

Uma entrada do catálogo combina os dois, e uma variante da página inicial com o título e a imagem da maratona aponta para ela. Nada muda no front-end.

O que essa leitura devolve

A leitura é a mesma que a página de todo visitante já faz, enviada com o token do cliente. Um cliente em Paris que já comprou tênis de corrida recebe a página da maratona, e _variant na resposta indica qual variante foi servida.

Um visitante em Lyon, ou qualquer pessoa sem login, recebe a página padrão. O segmento é avaliado a cada requisição, então não há lista de corredores para manter sincronizada.

Exemplo: VIP por gasto total

Um público VIP é um segmento: uma regra sobre o perfil do cliente segundo a qual o gasto total dele está acima de um limite que você escolhe.

Aponte uma entrada do catálogo para ele e qualquer registro pode ter uma versão VIP, seja um banner, uma lista de preços ou uma landing page inteira. O cliente a vê na primeira leitura depois de ultrapassar o limite.

Visualização, cache e um rastreamento

O editor resolve um rascunho para o locale e o público que você escolher, então o que você aprova é o que vai ao ar. Uma resposta que contém uma variante resolvida é marcada como privada, para que um cache compartilhado não a armazene.

Uma chave de depuração em uma leitura informa quais variantes foram consideradas e por que uma foi servida, para uma chave que tenha o escopo de depuração.