Como instalar a solução Content Targeting através do Marketplace da Azion
Visão geral
A solução Content Targeting é uma solução serverless do Marketplace da Azion.
Esta solução permite que você manipule cookies e cabeçalhos para lógicas de uso flexíveis. Ela pode lidar com contextos específicos de aplicativos, regras de negócios ou outros cenários definidos pelo cliente, bem como segmentação de conteúdo.
Você pode criar diferentes cenários e definir variantes e porcentagens de distribuição para cada cenário usando os parâmetros da solução. Isso permite uma maior assertividade sem gastar recursos e interações na fonte. Além disso, você pode criar a lógica de processamento diretamente no edge, ampliando as possibilidades de aplicação da função e obtendo benefícios como cache direcionado, absorção de picos de acesso, alto desempenho, lógica de processamento distribuído e registro de eventos via streaming de dados.
1. Obtendo a solução
Para usar a solução Content Targeting fornecida no Marketplace da Azion, siga estes passos:
- Acesse o Real-Time Manager (RTM) e faça login.
- Se você ainda não tem uma conta, crie uma visitando a página de inscrição.
- No canto superior esquerdo da página, selecione Products menu, representado pelas três linhas horizontais, > Marketplace.
- Na página inicial do Marketplace, digite “Content” na caixa de busca ou navegue pelos cards para encontrar a solução Content Targeting.
- Depois de encontrar o card para a sua solução, selecione-o para ir para à página da solução.
- Na página da solução, procure pela seção Subscribe for no canto inferior direito.
- Clique no botão Get it now.
Uma mensagem de sucesso irá aparecer indicando que a sua solução está instalada e pronta para uso.
Usando a solução
Depois de obter sua solução no Marketplace, ela estará disponível em sua lista de edge functions. Você terá que selecionar uma edge application para usar a solução.
Para esta tarefa, você tem vários modos de ação. Os principais são:
- Visite a documentação de ponto de partida para criar uma nova edge application.
- Crie uma edge application no RTM selecionando Products menu > Edge Application e siga as instruções.
- Use uma edge application já existente.
3. Configurando a solução
Para configurar sua solução, proceda da seguinte forma:
- No canto superior esquerdo, selecione Products menu > Edge Application na seção BUILD.
- Na página de listagem de suas edge applications, selecione aquela que você deseja usar com a solução Content Targeting.
- Na página da aplicação, na aba Main Settings, localize a opção Edge Functions e ative-a para habilitar Functions em sua edge application.
- Clique no botão Save
Você receberá uma mensagem de sucesso indicando que sua edge application foi atualizada.
4. Instanciando a solução
Para habilitar a função relacionada a solução, enquanto ainda estiver na página da Edge Application:
- Selecione a guia Functions na lista superior.
- Clique no botão Add Function.
- Escolha um nome fácil de lembrar para sua função.
- No menu suspenso, selecione a função Content Targeting [Global].
Esta ação carregará a função, mostrando um formulário com o código-fonte desta e, logo acima dele, duas abas: Code e Args. Clique na guia Code e você poderá navegar pelo código-fonte da função, mas não poderá alterá-lo. As configurações da sua função se darão na aba Args.
Na aba Args, você terá um arquivo json
como mostrado abaixo:
{
"cookie_name": "azion-cookie",
"header_name": "azion_header",
"domain": ".azion.com",
"max_age": 600,
"expires": "Tue, 19 Jan 2038 03:14:07 GMT",
"path": "/",
"values": [
{
"value": "A",
"weight": 7.1,
"cache_key": "custom_a"
},
{
"value": "B",
"weight": 14.9
}
]
}
Onde:
Key | Data Format | Obrigatório | Descrição | Notas |
---|---|---|---|---|
cookie_name |
String | Sim | Representa o cookie que será usado para armazenar o valor desejado. | - |
header_name |
String | Sim | Representa o cabeçalho que será usado para armazenar o valor desejado. | - |
domain |
String | Sim | Define o domínio para o qual o cookie será definido. | - |
max_age |
Inteiro | Não | Define por quanto tempo (em segundos) o valor do cookie será válido. | Ainda que os campos max_age e expires não sejam obrigatórios, é recomendado usar pelo menos um deles, caso contrário, o cookie não será armazenado.Outro fato importante é que este campo não substitui um ao outro, na verdade, o campo expires é apenas um fallback para navegadores mais antigos que ainda não funcionam com a diretiva max_age . |
expires |
String | Não | Modo legado usado para definir por quanto tempo um cookie será armazenado. Ao usar este formato, você deve inserir uma data inteira. |
- |
path |
String | Sim | Define o caminho onde o cookie será válido. | - |
values |
Objeto | Sim (a lista deve ter pelo menos uma entrada). | Descreve cada valor possível que será usado. | O campo value (obrigatório) representa o valor que será definido no cookie/cabeçalho se esta opção for passada.O campo weight (obrigatório) define as probabilidades da opção ser escolhida.O campo cache_key (opcional) define uma cache key personalizada para a solicitação sempre que esta opção for escolhida. |
5. Configurando uma regra no Rules Engine
Ainda na página Edge Application, na aba Rules Engine, você deverá configurar as regras que deseja (criteria e behavior) aplicar para executar sua função.
Para fazer isso, siga estes passos:
- Selecione a aba Rules Engine.
- Clique em Default Rule.
- Você não pode alterar o campo criteria (critério) para a Default Rule no Rules Engine.
- No campo de behavior (comportamento), selecione Run Function no menu suspenso e, em seguida, selecione a função Content Targeting de acordo com o nome que você deu na etapa de instanciação.
- Clique no botão Save
Pronto. Sua solução Content Targeting está sendo executada no edge.
Para maiores informações sobre como utilizar a solução de Content Targeting, visite o Use Case em Use cookies e lógicas de Edge Computing para segmentar conteúdo
Não encontrou o que procurava? Abra um ticket.