Atributos do perfil

Os atributos de perfil em Adobe Target são parâmetros específicos de um visitante. Estes atributos são armazenados no perfil do visitante para fornecer informações sobre ele que podem ser usadas em suas atividades.

Um perfil de usuário contém informações demográficas e comportamentais de um visitante da página da Web. Essas informações podem incluir idade, gênero, produtos comprados, última visita e assim por diante, que Target usa para personalizar o conteúdo que serve ao visitante.

Conforme um visitante navega em seu site, ou quando ele retorna para outra sessão, os atributos do perfil salvos no perfil podem ser usados para direcionar o conteúdo ou registrar informações para a filtragem de segmentos.

Para configurar os atributos do perfil:

  1. Clique em Públicos-alvo > Scripts de perfil.

    Guia Scripts de perfil

  2. Clique em Criar script.

    Caixa de diálogo Criar scripts de perfil

    Os tipos a seguir de atributos de perfil estão disponíveis:

    Tipo do parâmetro Descrição
    mbox Passado diretamente pelo código de página ao criar a mbox. Consulte Envio de parâmetros para uma mbox global.
    Observação: o tem um limite de 50 atributos de perfil exclusivos por chamada de mbox. Target Se você precisar passar mais de 50 atributos de perfil para Target, passe-os usando o método de Atualização do perfil da API. Para obter mais informações, consulte Atualização do perfil na Adobe Target documentação da API.
    Perfil Definido diretamente com um trecho de código JavaScript. Esses trechos podem armazenar totais, como o dinheiro total gasto pelo consumidor e são executados em cada solicitação de mbox. Consulte Atributos de script de perfil abaixo.

Atributos de script de perfil

Defina um atributo de perfil de script com o snippet do código JavaScript associado.

Você pode usar scripts de perfil para capturar os atributos do visitante em várias visitas. Os scripts de perfil são trechos de código definidos em Target usando um formulário de JavaScript do lado do servidor. Por exemplo, você pode usar um script de perfil para capturar a frequência com que um visitante acessa seu site e quando esse visitante visitou pela última vez.

Os scripts de perfil não são os mesmos que os parâmetros de perfil. Os parâmetros de perfil capturam as informações sobre visitantes que usam a implementação do código de mbox do Target.

Criar scripts de perfil

Os scripts de perfil estão disponíveis na guia Públicos-alvo na interface Target.

Para adicionar um script de perfil, clique na guia Scripts de perfil, Criar script, em seguida, escreva o script.

Ou

Para copiar um script de perfil existente, na lista Scripts de perfil, clique no ícone de reticências do script desejado e em Duplicar.

Você pode editar o público-alvo para criar um público-alvo semelhante.

Scripts de perfil executam os "coletores" de atributo de perfil em cada solicitação de localização. Quando uma solicitação de local é recebida, Target determina qual atividade deve ser executada e exibe o conteúdo apropriado para essa atividade e experiência. Target também rastreia o sucesso da atividade e executa qualquer script de perfil relevante. Esse processo permite que você rastreie informações sobre a visita, como o local do visitante, a hora do dia, o número de vezes que o visitante esteve no site, se ele já fez uma compra anteriormente e assim por diante. Estas informações são então adicionadas ao perfil do visitante para que você possa melhor rastrear a atividade do visitante no seu site.

Os atributos de script de perfil têm a tag de user. inserida antes dos nomes dos atributos. Por exemplo:

if (mbox.name == 'Track_Interest') { 
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") { 
        return (user.get('A5KS6') || 0) + 1; 
    } 
}

Lembre-se das seguintes informações:

  • Consulte os atributos de script do perfil (incluindo ele mesmo) no código com user.get('parameterName').
  • Salve variáveis que podem ser acessadas na próxima vez que o script for executado (na próxima solicitação da mbox) com user.setLocal('variable_name', 'value'). Faça referência à variável com user.getLocal('variable_name'). Esse processo é útil para situações em que você deseja fazer referência à data e hora da última solicitação.
  • Os parâmetros e valores distinguem maiúsculas de minúsculas. Verifique as letras maiúsculas e minúsculas e os valores recebidos durante a atividade ou o teste.
  • Consulte a seção "Referência de JavaScript para os parâmetros do perfil de script" abaixo para obter mais sintaxe de JavaScript.
  • O parâmetro permanece no perfil após desativar o script. Os usuários cujos perfis já contêm um parâmetro que é usado no público-alvo de uma atividade são qualificados nessa atividade.
  • Os scripts de perfil não podem ser excluídos enquanto estiverem sendo usados em uma atividade.
  • Não é recomendável criar scripts de perfil dependentes que usam o resultado de um script de perfil em outro script de perfil. A ordem de execução do script de perfil não é garantida.

Exibição dos cartões de informações do script de perfil

Você pode exibir os cartões pop-up com as informações do script de perfil de forma semelhante aos cartões com as informações da oferta. Esses cartões com as informações do script de perfil permitem exibir a lista de atividades que fazem referência ao script de perfil selecionado, juntamente com outros metadados úteis.

Por exemplo, o seguinte cartão de informações do script de perfil é acessado clicando no ícone Info para o script de perfil desejado na lista (Públicos-alvo > Scripts de perfil).

A guia Informações do script contém as seguintes informações: Nome, Descrição e código de script.

Cartão de informações do script de perfil

Clique em Exibir detalhes completos para ver os públicos-alvo e as atividades que fazem referência ao script de perfil selecionado.

Cartão de informações do script de perfil > guia Uso do script

OBSERVAÇÃO

A guia Uso do script não exibe atividades que fazem referência ao script de perfil selecionado nas seguintes situações:

  • A atividade está no estado Rascunho.
  • O conteúdo ou a oferta usada na atividade utiliza variáveis de script (seja uma oferta na linha dentro da atividade ou dentro da biblioteca Oferta).

O Target desativa os scripts de perfil em determinadas situações

Target desativa automaticamente os scripts de perfil em determinadas situações, como em caso de demora para execução ou de excesso de instruções.

Quando um script de perfil é desativado, um ícone de alerta amarelo é exibido perto do script de perfil na interface de usuário do Target, conforme ilustrado abaixo:

Ao passar o cursor do mouse, os detalhes do erro são exibidos, conforme ilustrado abaixo:

Os motivos típicos para o sistema desativar os scripts de perfil incluem o seguinte:

  • Uma variável indefinida a ser referenciada.
  • Um valor inválido é referenciado. Esse erro geralmente é causado pela referência a valores de URL e outros dados inseridos pelo usuário sem a validação adequada.
  • Muitas instruções de JavaScript usadas. Target O tem limite de 2.000 instruções JavaScript por script, mas esse limite não pode ser calculado apenas pela leitura manual do JavaScript. Por exemplo, o Rhino trata todas as chamadas de função e as "novas" chamadas como 100 instruções. Qualquer chamada para qualquer função consome 100 instruções. Além disso, o tamanho dos dados de entrada, como os valores de URL, pode afetar a contagem das instruções.
  • Não seguir os itens destacados na seção Práticas recomendadas abaixo.

Práticas recomendadas

As orientações a seguir destinam-se a ajudar a escrever scripts de perfil simplificados que são os mais livres de erros possíveis, ao escrever código com falhas leves, para que os scripts sejam processados sem forçar uma interrupção do script do sistema. Essas orientações resultam das práticas recomendadas com execução eficaz comprovada. Essas diretrizes devem ser aplicadas juntamente com os princípios e as recomendações formulados pela comunidade de desenvolvimento Rhino.

  • Defina o valor do script atual para uma variável local no script do usuário, defina um failover para uma string em branco.

  • Valide a variável local, certificando-se de que ela não seja uma sequência de caracteres em branco.

  • Use funções de manipulação com base em sequência de caracteres x Expressões Regulares.

  • Use limitado para loops e abertos para ou enquanto nos loops.

  • Não exceda 1.300 caracteres ou 50 iterações de loop.

  • Não exceda 2.000 instruções do JavaScript. Target O tem limite de 2.000 instruções JavaScript por script, mas esse limite não pode ser calculado apenas pela leitura manual do JavaScript. Por exemplo, o Rhino trata todas as chamadas de função e as "novas" chamadas como 100 instruções. Além disso, o tamanho dos dados de entrada, como os valores de URL, pode afetar a contagem das instruções.

  • Lembre-se não apenas do desempenho do script, mas do desempenho combinado de todos os scripts. Como prática recomendada, Adobe recomenda menos de 5.000 instruções no total. Contar o número de instruções não é óbvio, mas o importante a ser observado é que scripts que excedem 2.000 instruções são automaticamente desativados. O número de scripts de perfil ativos não deve exceder 300. Cada script é executado com cada chamada de mbox. Execute somente a quantidade de scripts necessária.

  • Em um regex, tendo ponto-estrela no início (por exemplo: /.*match/, /a|.*b/) quase nunca é necessário. A pesquisa de regex começa em todas as posições em uma string (a menos que vinculada a ^), portanto, o ponto-estrela já foi considerado. A execução do script pode ser interrompida se esse regex corresponder a dados de entrada longos o suficiente (que podem ter centenas de caracteres).

  • Se tudo falhar, envolva o script em um try/catch.

  • As recomendações a seguir podem ajudar a limitar a complexidade do script de perfil. Os scripts de perfil podem executar um número limitado de instruções.

    Como prática recomendada:

    • Mantenha os scripts de perfil pequenos e tão simples quanto possível.
    • Evite expressões regulares ou use somente expressões regulares simples. Até mesmo expressões simples podem levar muitas instruções para serem avaliadas.
    • Evite a recursão.
    • Os scripts de perfil devem ser testados no desempenho antes de serem adicionados a Target. Todos os scripts de perfil são executados em cada solicitação de mbox. Se os scripts de perfil não forem executados corretamente, as solicitações da mbox levarão mais tempo para serem executadas, o que pode afetar o tráfego e a conversão.
    • Se os scripts de perfil se tornarem muito complexos, considere usar tokens de resposta.
  • Consulte a documentação do mecanismo JS Rhino para obter mais informações.

Depurar scripts de perfil

Os métodos a seguir podem ser usados para depurar scripts de perfil:

OBSERVAÇÃO

Usar console.log em um script de perfil não resulta no valor do perfil, pois os scripts de perfil são executados no lado do servidor.

  • Adicione scripts de perfil como tokens de resposta para depurar scripts de perfil:

    Em Target, clique em Administração, clique em Tokens de Resposta e ative o script de perfil que deseja depurar.

    Sempre que você carregar uma página para seu site com Target nela, parte da resposta de Target conterá seu valor para o script de perfil específico, conforme mostrado abaixo:

  • Use a ferramenta de depuração mboxTrace para depurar scripts de perfil.

    Este método requer um token de autorização que pode ser gerado clicando em Target > Administration > Implementation > Generate Authorization Token na seção Debugger tools.

    Em seguida, adicione esses dois parâmetros ao URL da página após o "?": mboxTrace=window&authorization=YOURTOKEN.

    Adicionar esses parâmetros é um pouco mais informativo do que o token de resposta, pois você obtém um instantâneo do perfil executado antes e um depois. Ele também mostra todos os perfis disponíveis.

Perguntas frequentes do script de perfil

É possível usar os scripts de perfil para capturar informações de uma página localizada em uma camada de dados?

Os scripts de perfil não podem ler a página diretamente porque são executados no lado do servidor. Os dados devem ser enviados por uma solicitação mbox ou através de outros métodos para colocar os dados no Target. Depois que os dados estiverem em Target, os scripts de perfil poderão ler os dados como um parâmetro mbox ou parâmetro de perfil.

Referência de JavaScript para os parâmetros do perfil de script

É necessário o conhecimento simples de Javascript para usar o perfil de script de maneira eficaz
parâmetros. Esta seção serve como uma referência rápida para torná-lo produtivo com essa funcionalidade em apenas alguns minutos.

Os parâmetros do perfil de script são encontrados na guia mboxes/perfis. É possível gravar programas de JavaScript que retornam qualquer tipo de JavaScript (sequência de caracteres, inteiro, matriz, etc.).

Exemplos de parâmetro do perfil de script

Nome: user.recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

Cria uma variável para o dia, conforme medido em milissegundos. Se o nome da mbox for orderThankyouPage, defina um atributo de perfil de usuário local (invisível) chamado lastPurchaseTime para mostrar o valor da data e hora atuais. O valor do último horário de compra é lido e, se definido, Target retorna o tempo decorrido desde o último horário de compra, dividido pelo número de milissegundos em um dia (o que resulta no número de dias desde a última compra).

Nome: user.frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

Cria uma variável chamada frequency, inicializando-a para o valor anterior ou 0, se não houver um valor anterior. Se o nome da mbox for orderThankyouPage, o valor incrementado será retornado.

Nome: user.monetaryValue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

Cria uma variável chamada monetaryValue, que pesquisa o valor atual de um determinado visitante (ou define como 0 se não houver um valor anterior). Se o nome da mbox for orderThankyouPage, o novo valor monetário será retornado adicionando o anterior e o valor do parâmetro orderTotal passado para a mbox.

Nome: adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

Cria uma variável chamada adobeQA para rastrear um usuário para Controle de qualidade da atividade.

Objetos e métodos

As seguintes propriedades e métodos podem ser referenciados pelos parâmetros do perfil de script:

Objeto ou método Detalhes
page.url O URL atual.
page.protocol O protocolo usado pela página (http ou https).
page.domain O domínio do URL atual (tudo antes da primeira barra). Por exemplo, www.acme.com em http://www.acme.com/categories/men_jeans?color=blu e&size=small.
page.query A sequência de consulta da página atual. Tudo depois de "?". Por exemplo, blue&size=small em http://www.acme.com/categories/mens_jeans?color=blue&size=small.
page.param(‘<par_name>’) O valor do parâmetro indicado por <par_name>. Se o URL atual for a página de pesquisa do Google e você digitou page.param('hl'), “en” seria obtido para o URL http://www.google.com/search?hl=en& q=what+is+asdf&btnG=Google+Search.
page.referrer O mesmo conjunto de operações acima se aplica ao referenciador e à landing page (ou seja, referrer.url é o endereço de url do referenciador).
landing.url, landing.protocol, landing.query, e landing.param Semelhante ao da página, mas para a landing page.
mbox.name O nome da mbox ativa.
mbox.param(‘<par_name>’) Um parâmetro de mbox pelo nome fornecido na mbox ativa.
profile.get(‘<par_name>’) O parâmetro do perfil de usuário criado pelo cliente pelo nome <par_name>. Por exemplo, se o usuário definir um parâmetro de perfil chamado de "gênero", o valor poderá ser extraído usando "profile.gender". Retorna o valor do "profile.<par_name>" definido para o visitante atual; retorna nulo se nenhum valor foi definido. Observe que profile.get(<par_name>) é qualificado como uma chamada de função.
user.get(‘<par_name>’) Retorna o valor do "user.<par_name>" definido para o visitante atual; retorna nulo se nenhum valor foi definido.
user.categoryAffinity Retorna o nome da melhor categoria.
user.categoryAffinities Retorna uma matriz com as melhores categorias.
user.isFirstSession Retorna verdadeiro se for a primeira sessão do visitante.
user.browser Retorna o agente do usuário no cabeçalho HTTP. Como exemplo, você pode criar um direcionamento de expressão somente para usuários do Safari: if (user.browser != null && user.browser.indexOf('Safari') != -1) { return true; }

Operadores comuns

Todos os operadores JavaScript padrão estão presentes e utilizáveis. Os operadores JavaScript podem ser usados em sequências e números (e outros tipos de dados). Uma breve informação:

Operador Descrição
== Indica a igualdade. Permanece verdadeiro quando os operandos em ambos os lados são iguais.
!= Indica a desigualdade. Permanece verdadeiro quando os operandos em ambos os lados não são iguais.
< Indica que a variável à esquerda é inferior à da direita. Avalia como falso se as variáveis forem iguais.
> Indica que a variável à esquerda é superior à da direita. Avalia como falso se as variáveis forem iguais.
<= Igual a < exceto se as variáveis forem iguais, então, a avaliação será verdadeira.
>= Igual a > exceto se as variáveis forem iguais, então, a avaliação será verdadeira.
&& Na lógica, o "AND" entre as expressões, à esquerda e à direita - é verdadeiro somente quando ambos os lados são verdadeiros (caso contrário, é falso).
`
// Verifica se a origem contém todos os elementos que os booleanos de destino contém (origem da matriz, destino da matriz).
// extrai a subsequência do destino (correspondente ao regexp) e decodifica-aArray/*String*/ decode(String encoding, String regexp, String target).
O recurso também suporta o uso de valores de sequência constantes, agrupando-os (`condition1

Vídeo de treinamento: Scripts de perfil Selo tutorial

Esse vídeo inclui informações sobre o uso e a criação de scripts de perfil.

  • Explique o que é um script de perfil
  • Explique como um script de perfil é diferente de um parâmetro de perfil
  • Crie um script de perfil simples
  • Use o menu Token disponível para acessar as opções disponíveis
  • Ative e desative os scripts de perfil

Nesta página