Instale a integração Content Targeting
Instale Content Targeting a partir de Azion Marketplace e execute-a em uma aplicação para dar a cada usuário um valor ponderado em um cookie e um cabeçalho.
Content Targeting define um cookie e um cabeçalho em cada requisição, com um valor escolhido de uma lista ponderada. Use-a para segmentar conteúdo por contexto de aplicação, regra de negócio ou um cenário que você define, com suas próprias variantes e porcentagens de distribuição. Ela é uma das integrações do Marketplace que executam em uma aplicação.
A função executa na infraestrutura distribuída da Azion, e não na sua origem. Um valor pode selecionar sua própria cache key, e cada evento pode ser registrado por meio de Data Stream. Quatro objetos precisam existir antes que uma requisição receba um valor: a função instalada, uma aplicação com o módulo Functions ativado, uma instância de função com os argumentos e uma regra do Rules Engine com o behavior Run Function.
Pré-requisitos
- Uma conta Azion. Para entrar, consulte Como acessar o Azion Console.
- Uma aplicação servida por um workload. Para criar uma, consulte Primeiros passos com Applications.
- Ativar um produto ou um módulo pode gerar custos de uso. Para mais informações, consulte Preços.
Instale a integração
A instalação adiciona a função Content Targeting à sua conta. Para instalá-la pelo Azion Console:
Acesse Azion Console > Marketplace.
Digite Content Targeting no campo Search on Marketplace e selecione o card da integração. Navegar pelos cards e pelas categorias leva à mesma página.
O card exibe Successfully installed! e Latest version installed!. A função passa então a aparecer como Content Targeting [Global] na lista Function do drawer Create Instance.
Ative o módulo Functions
Uma aplicação executa uma função instalada apenas quando o módulo Functions dela está ativo. Para ativar o módulo:
Acesse Azion Console > Applications > sua aplicação.
Na aba Main Settings, vá até a seção Modules.
O Azion Console confirma que a aplicação foi atualizada.
Crie a instância de função
Uma instância de função guarda os argumentos que a função Content Targeting lê para uma aplicação. Para criar a instância na sua aplicação:
Em Applications, selecione sua aplicação e, em seguida, a aba Functions Instances.
Uma aplicação ainda sem instâncias oferece a mesma ação como Function Instance. O drawer Create Instance é aberto.
Em Name, insira um nome único que identifique a instância. Por exemplo: content-targeting-home.
Em Function, selecione Content Targeting [Global]. O editor Arguments é preenchido com os argumentos padrão da integração.
Em Arguments, substitua os valores padrão pelos valores do seu cenário. Cada chave é descrita na tabela abaixo.
A instância aparece na aba Functions Instances com o nome que você inseriu.
Argumentos
Os argumentos são um objeto JSON. Este exemplo define dois valores, A e B, e dá a A sua própria cache key:
| Chave | Formato de dado | Obrigatório | Descrição |
|---|---|---|---|
cookie_name | String | Sim | O cookie que armazena o valor escolhido |
header_name | String | Sim | O cabeçalho que armazena o valor escolhido |
domain | String | Sim | O domínio para o qual o cookie é definido |
max_age | Integer | Não | Por quanto tempo o valor do cookie é válido, em segundos |
expires | String | Não | A forma legada de definir por quanto tempo o cookie é armazenado. Insira uma data completa |
path | String | Sim | O caminho em que o cookie é válido |
values | Object | Sim. A lista precisa ter pelo menos uma entrada | Cada valor que a função pode escolher |
Nem max_age nem expires é obrigatório, mas defina pelo menos um deles. Sem os dois, o cookie não é armazenado. As duas chaves não substituem uma à outra: expires é um fallback para navegadores mais antigos que não suportam a diretiva max_age.
Cada entrada em values recebe estas chaves:
value, obrigatória: o valor definido no cookie e no cabeçalho quando esta entrada é escolhida.weight, obrigatória: a probabilidade de esta entrada ser escolhida.cache_key, opcional: uma cache key personalizada para a requisição quando esta entrada é escolhida.
Crie a regra
A instância executa apenas quando uma regra do Rules Engine a chama. A regra abaixo corresponde a todas as requisições. Para criar a regra:
Em Applications, selecione sua aplicação e, em seguida, a aba Rules Engine.
Em Name, insira um nome para a regra. Por exemplo: Run Content Targeting on every request.
Na seção Phase, selecione Request Phase.
Na seção Criteria, mantenha a variável ${uri} e o operador starts with e, em seguida, insira / como argumento.
Na seção Behaviors, selecione Run Function e, em seguida, selecione a instância que você criou pelo nome dela.
A regra aparece na aba Rules Engine, na fase de requisição, e executa a instância Content Targeting em toda requisição.
Para cada critério e behavior que uma regra aceita, consulte Rules Engine para Applications.