Transmissão de dados sobre eventos adicionais

Para enviar dados de eventos adicionais para o Yandex Metrica, você pode usar métodos JavaScript padrão. Recomendamos usar métodos distintos para transmitir diferentes tipos de dados.

Limites para transmissão de dados

• Número máximo de níveis aninhados: 10.
• Tamanho máximo por JSON: 8 KB.
• Número máximo de parâmetros por sessão: 512.

Para mais informações, consulte Restrições.

Envio de dados de visualização de página

Recomendamos usar estes métodos para enviar dados de visualização de página:

• init: ao inicializar a tag.
• hit: para transmitir grandes quantidades de dados e para sites AJAX ou Flash.

método init

Observação

Use o método init para pequenas quantidades de dados e o método hit para grandes quantidades.

O método init é normalmente usado para a inicialização normal da tag no site e por padrão é especificado no snippet de código:

ym(XXXXXX, "init", {});

Amostra de código de tag com parâmetros adicionais:

ym(XXXXXX, "init", {
    clickmap: true,
    trackLinks: true,
    accurateTrackBounce: true,
    webvisor: true,
    ecommerce: "dataLayer",
    params: {
        user_info: {
            user_id: "123456",
            user_type: "customer"
        }
    }
});

Atenção

Tenha cuidado ao introduzir parâmetros adicionais ao método init. Se ocorrerem erros durante a transmissão de dados, a visualização da página pode não ser registrada para o usuário e quaisquer ações subsequentes na página podem não ser incluídas na sessão.

Mais detalhes sobre o método init.

método hit

Use este método para enviar grandes quantidades de dados. O método hit também é adequado para sites AJAX ou Flash, em que o usuário navega entre páginas dentro da mesma janela, sem carregar novas páginas.

ym(XXXXXX, 'hit', url[, options])

Eis um exemplo de uso do método com dados adicionais:

 ym(XXXXXX, 'hit', '#contacts', {
    params: {
        page_info: {
            title: "Page title",
            referrer: "Page referrer"
        },
        user_info: {
            user_id: "123456",
            user_type: "customer"
        }
    }
}); 

Mais detalhes sobre o método hit.

Envio de dados sobre objetivos e eventos

Para enviar dados sobre eventos e ações do usuário no seu site, recomendamos estes métodos:

• reachGoal: para enviar dados de objetivos.
• params: para enviar dados sobre eventos adicionais que você deseja analisar.

método reachGoal

Use este método para eventos que você planeja definir como objetivo no Yandex Direct ou para visualizar dados sobre a conclusão de objetivos no Yandex Metrica.

ym(XXXXXX, 'reachGoal', target[, params[, callback[, ctx]]]);

Exemplo de uso do método com parâmetros adicionais:

ym(XXXXXX,'reachGoal','TARGET_NAME', {
    page_info: {
        title: "Page title",
        referrer: "Page referrer"
    },
    user_info: {
        user_id: "123456",
        user_type: "customer"
    },
    action_info: {
        action_type: "select",
        action_placement: "action_placement"
    }
}); 

Mais detalhes sobre o método reachGoal.

método params

Use este método para os eventos que você queira analisar sem definir como objetivo:

ym(XXXXXX, 'params', parameters);

Exemplo de uso do método com parâmetros:

ym(XXXXXX, 'params', {
    action_info: {
        action_type: "select",
        action_placement: "action_placement"
    }
});

Mais detalhes sobre o método params.

Fale conosco