A API JavaScript da Navegg oferece um conjunto de funções que facilitam o acesso “client-side” aos dados dos usuários.

Consultar dados com API JavaScript

Para obter dados de um usuário, dentro dos critérios de segmentos da Navegg, devemos utilizar a seguinte função:

Exemplo – para obter dados sobre a idade de um usuário, utilize o seguinte código:

Critérios de segmentos multi-valorados

Alguns critérios de segmentos tem resultado único, onde o usuário só pode ter um segmento por critério. Outros critérios podem ter resultados multi-valorados, onde o usuário pode ter mais de um segmento por critério. Nestes casos os segmentos são separados pelo caractere “–”. Veja a lista de segmentos e seus respectivos exemplos de consulta:

Chamadas assíncronas

A API Javascript busca os dados dos usuários de forma assíncrona. Para garantir a disponibilidade dos dados de cada usuário no momento da utilização dos mesmos, a API Javascript possui dois modelos de “callback”.

O código implementado dentro desses métodos é executado apenas após o recebimento dos dados do usuário.

Critérios e Segmentos

A lista de “Critérios de segmentos” e “Segmentos” disponíveis pode ser consultada na seção Segmentos.

Segmentos Custom com API JavaScript

O recurso Segmentos Personalizados permite criar uma audiência com base em determinados conteúdos e/ou ações dos usuários. Você também tem o poder de criar uma audiência fora do seu site para depois impactá-lo dentro dele (retargeting).

Estes segmentos devem ser previamente criados no DMP Navegg. Ambos são ativados dentro da API JavaScript pelo mesmo critério, chamado “custom”.

É possível utilizar a API JavaScript para marcar um usuário em um Segmento Personalizado. Para isso é necessário consultar o ID do Segmento, previamente criado no DMP Navegg. A implementação se dará da seguinte forma:

• ID representado na tag refere-se ao ID da conta. É o número informado pela Navegg no início do processo de criação da conta.
• CUSTOM_ID representado no script refere-se ao ID do Segmento Personalizado previamente criado no painel DMP Navegg.

Conversões com API JavaScript

Clientes Navegg Brands, podem implementar a chamada de conversão em seu site para monitorar suas conversões. O código Javascript que deve ser inserido na página de conversão (normalmente a página de confirmação da compra), é o seguinte:

• ID representado no código refere-se ao ID da conta. É o número informado pela Navegg no início do processo de criação da conta.
• O “0.00” deve ser substituído pelo valor de cada compra. Assim, o nosso sistema receberá os valores e processará essa informação.

É importante ressaltar que a chamada de conversão tem como pré-requisito, a implementação da Tag Javascript, conforme documentação específica.

Exemplo de implementação

A presença de um profissional com skills em programação é fundamental para essa etapa. Se você é da equipe técnica, veja dois exemplos de como essa integração pode ser feita, em JavaScript e PHP:

JavaScript – Se você tem acesso ao valor da compra em uma variável javascript, use a variável “sale_value”:

• O “98.99” deve ser substituído pelo valor de cada compra. Assim, o nosso sistema receberá os valores e processará essa informação.

PHP – Se você tem acesso ao valor da compra em uma variável PHP, neste caso a variável “$sale_value”: