---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com.tr/support/metrica/en/data/offline-params.md
  - https://yandex.com.tr/support/metrica/es/data/offline-params.md
  - https://yandex.com.tr/support/metrica/pt/data/offline-params.md
  - https://yandex.com.tr/support/metrica/ru/data/offline-params.md
  - https://yandex.com.tr/support/metrica/tr/data/offline-params.md
title: Importação de dados offline
description: Quando os usuários visitam seu site, o Yandex Metrica automaticamente coleta dados sobre como eles interagem com as páginas do site e as principais ações que realizam nessas páginas.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/pt/llms.txt


# Importação de dados offline

Quando os usuários visitam seu site, o Yandex Metrica automaticamente coleta dados sobre como eles interagem com as páginas do site e as principais ações que realizam nessas páginas.

No entanto, o funil de vendas do seu negócio pode ir além das ações no site e abranger chamadas telefônicas, pagamento presencial ao entregador, assinatura de contrato após negociações com um cliente, pagamento em um ponto de venda offline, entre outros. Os dados sobre essas ações (por exemplo, pedidos pagos, chamadas, chats em app de mensagem) podem ser enviados para o Yandex Metrica, para vincular o comportamento dos seus clientes no site com as ações realizadas fora do site e usar esses dados para promoção.


## O que é possível fazer com o auxílio de dados offline {#what}

O envio de dados offline ajuda os donos de sites a resolverem uma ampla gama de tarefas. Eis algumas delas:


{% cut "Construir análises de dados ponta a ponta" %}


Ao enviar os dados sobre ações offline para o Yandex Metrica (sejam elas vendas efetivas ou estágios da transação no [CRM](https://yandex.com.tr/support/metrica/pt/crm/about.md)), você pode vinculá-las ao histórico online dos usuários no seu site, obtendo assim uma análise completa do funil de vendas.


{% endcut %}

{% cut "Otimizar anúncios do Yandex Direct para conversões offline" %}


Crie objetivos para ações confirmadas dos usuários e use-os para otimizar a publicidade para pedidos pagos, contratos assinados, pagamentos após o recebimento de solicitações no seu site, entre outras ações.


{% endcut %}

{% cut "Criar segmentos" %}


Crie segmentos de usuários com base em dados offline e identificação de usuários de perfil semelhante. Os segmentos também podem incluir clientes que não visitaram o site antes de fazer uma compra.


{% endcut %}

{% cut "Obter dados mais precisos" %}


Minimize discrepâncias entre os dados do Yandex Metrica e as informações do seu sistema de CRM ou do seu departamento de vendas. As conversões offline também podem auxiliar quando seus clientes pagarem uma compra no site através de adquirência, mas não retornarem ao site após o pagamento (não chegam à página "Obrigado pelo seu pedido").


{% endcut %}

{% cut "Classificar submissões de formulários" %}


Nem sempre as submissões de formulário e os pedidos realizados no site resultam em pagamentos. Envie dados sobre submissões "efetivadas" para identificar seus canais de vendas mais eficazes.


{% endcut %}

{% cut "Construir relatórios de ROPO" %}


Se você possuir lojas físicas, poderá enviar dados sobre vendas nesses locais para medir o impacto da publicidade online nas suas vendas offline.


{% endcut %}



## Quais dados offline é possível enviar {#data}

### Conversões offline de usuários do site {#conversion}

Você pode complementar os dados de sessões de usuário, registrando para isso conversões do tipo evento JavaScript enviadas após a sessão. Isso permite segmentar e analisar as ações dos usuários fora do site, assim como utilizar conversões que reflitam com precisão as suas métricas comerciais para promoção.

Este método baseia-se na busca pela sessão de usuário apropriada no Yandex Metrica, com o auxílio de identificadores transferidos e o registro da conversão dessa sessão.

Para encontrar a sessão e uma conversão que ocorreu nela, é preciso enviar o seguinte:

- **Identificadores de usuário no Yandex Metrica**: [ClientID](https://yandex.com.tr/support/metrica/pt/general/clientid-userid.md), [UserID](https://yandex.com.tr/support/metrica/pt/objects/set-user-id.md), [Yclid](https://yandex.com.tr/support/metrica/pt/data/get-yclid.md) ou [PurchaseId](https://yandex.com.tr/support/metrica/pt/ecommerce/data.md#purchase). Eles podem ser obtidos durante a sessão no site.
- **ID do objetivo**. Defina o objetivo que deve ser alcançado na sessão do usuário. Apenas objetivos do tipo [evento JavaScript](https://yandex.ru/support/metrica/general/goal-js-event.html) são adequados para envio. Se você já tiver objetivos adequados desse tipo, use-os. Caso contrário, crie um objetivo novo.
- **Data e horário da conversão**. Use o formato [Unix Time Stamp](http://www.unixtimestamp.com/index.php) para fazer a correspondência do objetivo com uma sessão de usuário específica. O Yandex Metrica buscará a correspondência com a sessão mais próxima da data que você forneceu para vincular a conversão.

Além disso, é possível especificar o valor (receita) da conversão e a moeda utilizada. Os dados podem ser enviados através de um arquivo CSV na interface do Yandex Metrica ou usando a [API](https://yandex.ru/dev/metrika/doc/api2/practice/offline-conv.html).

[Upload de conversões offline pela interface do Yandex Metrica](https://yandex.com.tr/support/metrica/pt/data/offline-conversion-data.md)

[Transmissão de dados usando a API](https://tech.yandex.com.tr/metrika/doc/api2/practice/offline-conv-docpage/)

### Informações sobre clientes e pedidos do seu CRM {#crm}

Este formato permite acessar os seguintes dados no Yandex Metrica: informações sobre seus clientes do CRM, as interações deles com o site, pedidos, o status desses pedidos, assim como dados enviados junto com o pedido sobre conversões e itens comprados.

O envio de dados sobre clientes e pedidos permite criar segmentos com base em clientes de alto padrão, produtos específicos dos pedidos, status de transações no CRM e muito mais. Além disso, o formato proporciona o envio de dados sobre e-mails e telefones, permitindo a criação de relatórios ROPO.

Para usar essa funcionalidade, é preciso enviar o seguinte:

**Informações sobre clientes**

 
:    
    - ID do cliente no seu CRM.
    - Nomes.
    - Outros parâmetros de sua escolha.
    - Identificadores pelos quais o Yandex Metrica possa encontrar as sessões deles na tag ([`ClientID`](https://yandex.com.tr/support/metrica/pt/general/clientid-userid.md), `telefones`, `e-mails`, `telefones_md5`, `e-mails_md5`).


**Pedidos (transações)**

 
:    
    - ID do pedido no seu CRM.
    - ID do cliente que fez o pedido.
    - Horário do pedido.
    - Status, receita e custo do pedido.
    
    Dependendo do status transmitido, as conversões serão alcançadas na sessão encontrada para a correspondência com o pedido. Além disso, você pode enviar dados sobre os produtos contidos no pedido.

Para habilitar o envio de dados, configure a coleta de identificadores de cliente e salve-os no seu CRM. Em seguida, faça o upload de dados sobre clientes e pedidos através da [API do Yandex Metrica](https://yandex.com/dev/metrika/doc/api2/practice/crm/contacts.html) ou usando a [integração com o CRM](https://metrica.yandex.com.tr/marketplace?id=44147844&filter=crm).

Você pode analisar os dados usando os relatórios [Origens de pedidos do CRM](https://yandex.com.tr/support/metrica/pt/sources/order-sources.md) e [Origens, custos e ROI](https://yandex.com.tr/support/metrica/pt/sources/ad-expenses.md).

[Configuração de transmissão de dados de um CRM](https://yandex.com.tr/support/metrica/pt/crm/about.md)

### Informações sobre chamadas {#calls}

Se, após visitarem o seu site, os clientes frequentemente pedem esclarecimentos, agendam horários ou confirmam pedidos por telefone, é possível rastrear essas chamadas e vinculá-las às ações dos usuários no site.

Por exemplo, você pode analisar o número, a qualidade e o resultado final das chamadas, como a realização de uma compra após a visita ao site.

Além disso, o envio de informações sobre chamadas permite o uso de objetivos com base nas características dos dados de chamada transmitidos — por exemplo, você pode definir um objetivo para primeiras chamadas com mais de 5 minutos, marcadas com a tag "Chamada Proveitosa" no serviço de rastreamento de chamadas.

Com frequência, utilizam-se serviços de rastreamento de chamada de terceiros para rastrear chamadas. Normalmente, isso exige que você coloque, além da tag Yandex Metrica, um código especial de rastreamento de chamadas no seu site. Esse código troca os números de telefone do site por números substitutos, permitindo que a [`ClientID`](https://yandex.com.tr/support/metrica/pt/general/clientid-userid.md) do Yandex Metrica seja vinculada ao fato de ter havido uma chamada de usuário.

Assim, é possível definir o atributo de concluir certas conversões relativas a sessões de usuário no site com base nas características das chamadas ou no número total de chamadas. A análise de dados pode ser realizada no [grupo de relatórios "Chamadas"](https://yandex.com.tr/support/metrica/pt/reports/calls.md) ou pela seleção de objetivos de chamada nos relatórios padrão do Yandex Metrica.

Se o seu serviço de rastreamento de chamadas comporta o envio de chamadas para um sistema de CRM, é possível rastrear o funil de vendas de chamadas inteiro no Yandex Metrica, usando a transmissão de [informações sobre clientes e pedidos do seu CRM](https://yandex.com.tr/support/metrica/pt/crm/about.md), junto com as informações sobre as chamadas.

[Transmissão de chamadas para o Yandex Metrica](https://yandex.com.tr/support/metrica/pt/data/calls.md)

## Como o Yandex Metrica vincula dados offline a sessões {#ids}

A implementação do envio de dados sobre conversões offline pressupõe que você salva um ou mais identificadores Yandex Metrica de eventos-chave no seu site (p. ex., preenchimento de um formulário de lead, efetuação de um pedido ou chamada para um número substituto). Esses identificadores são posteriormente usados para enviar dados.

Para vincular dados offline a usuários e suas respectivas sessões no site, o Yandex Metrica utiliza os seguintes identificadores:


{% cut "ClientID" %} {#clientid}


ID exclusiva de usuário do site criada automaticamente pelo Yandex Metrica. [valor _ym_uid](https://yandex.com.tr/support/metrica/pt/general/cookie-usage.md) no Cookie.

Usado para enviar dados sobre conversões offline, chamadas, parâmetros de usuário, bem como dados de clientes e pedidos do seu CRM. Para obter o identificador, use o método [getClientID](https://yandex.com.tr/support/metrica/pt/objects/get-client-id.md).

Usar a `ClientID` é a maneira mais precisa de associar dados a sessões. Esse é o parâmetro recomendado para dados offline.

A `ClientID` está disponível em todos os formatos de transmissão de dados offline — conversões offline, dados de CRM e chamadas.


{% endcut %}

{% cut "UserID" %} {#userid}


A ID de usuário definida pelo dono do site (por exemplo, quando o usuário do site faz login numa conta pessoal).

Use a `UserID` caso você já tenha configurado um sistema de identificação de usuários no seu site e trabalhe ativamente com esses dados. Se você desejar que o Yandex Metrica detecte usuários únicos através do seu framework dedicado, será preciso vincular a `UserID` à `ClientID` com o método [setUserID](https://yandex.com.tr/support/metrica/pt/objects/set-user-id.md).

<!-- source: pt/_includes/objects/set-user-id/id-set-user-id/2.md -->
As IDs personalizadas serão vinculadas à [ClientID](*ClientID) do usuário do site somente nas sessões em que o método `setUserID` tiver sido chamado.
<!-- endsource: pt/_includes/objects/set-user-id/id-set-user-id/2.md -->


A `UserID` está disponível para o envio de dados sobre conversões offline e chamadas.


{% endcut %}

{% cut "yclid" %} {#yclid}


A ID de um clique em um anúncio do Yandex Direct, atribuída pelo Yandex Direct. Use esse identificador caso só esteja interessado em enviar dados offline para promoção no Yandex.

Disponível apenas para o envio de dados sobre conversões offline e chamadas. [Rastreamento de conversões por yclid](https://yandex.com.tr/support/metrica/pt/data/yclid.md)


{% endcut %}

{% cut "PurchaseId" %} {#purchaseid}


Identificador de compra de e-commerce definido pelo dono do site quando um item é comprado.

Use a PurchaseId quando precisar complementar objetivos de compra com informações adicionais. Por exemplo, você pode enviá-lo para pedidos pagos se a compra no seu site não levar ao pagamento integral no momento do checkout.

A PurchaseId está disponível para o envio de dados sobre conversões offline.


{% endcut %}

{% cut "E-mails (incluindo algoritmo de hash MD5)" %} {#email}


O endereço de e-mail do cliente. É usado apenas para vincular dados de clientes a dados de pedidos do CRM. Esse identificador será útil se você estiver com dificuldades para configurar o envio da [`ClientID`](https://yandex.com.tr/support/metrica/pt/general/clientid-userid.md) junto com solicitações ou compras, ou se estiver enviando dados de compras em pontos de venda offline e quiser ver o efeito ROPO do seu tráfego.

O Yandex Metrica não armazena os endereços de e-mail importados em seu formato bruto; eles são criptografados pelo Yandex Metrica no momento da importação.

Se você mesmo hashear endereços de e-mail que estavam num formato errado, o Yandex Metrica não saberá determinar a qual sessão a conversão está relacionada.

É possível usar o endereço de e-mail `mail@yandex.ru` para testar seu algoritmo de hash. O hash esperado para esse endereço é `3c56ff8fef0f6c65b36b2d25720fe276`.

Os endereços de e-mail só estão disponíveis na transmissão de dados do CRM.


{% endcut %}

{% cut "Telefones (incluindo algoritmo de hash MD5)" %} {#phones}


Números de telefone do cliente. É usado apenas para vincular dados de clientes a dados de pedidos do CRM. Semelhante aos endereços de e-mail, este identificador será útil se você estiver com dificuldades para configurar o envio da [`ClientID`](https://yandex.com.tr/support/metrica/pt/general/clientid-userid.md) junto com solicitações ou compras, ou se estiver enviando dados de compras em pontos de venda offline e quiser ver o efeito ROPO do seu tráfego.

O Yandex Metrica não armazena os números de telefone importados em seu formato bruto; eles são criptografados pelo Yandex Metrica no momento da importação.

Se você mesmo criptografar números de telefone que estavam num formato errado, o Yandex Metrica não saberá determinar a qual sessão a conversão está relacionada.

Para checar o algoritmo que você usa para hash, é possível usar o número de telefone `79995551111`. O hash esperado para esse número é `f09f2c3d48f31e2a802944ade2e5aec5`.

Os telefones só estão disponíveis na transmissão de dados do CRM.


{% endcut %}



## Período para inclusão de dados offline nas sessões {#conversion-period}

**Período para inclusão de dados offline nas sessões** é o intervalo durante o qual as sessões podem ser complementadas com dados offline enviados para o Yandex Metrica.

Para todos os dados offline (conversões offline, chamadas, pedidos do CRM), o período para inclusão de dados offline nas sessões é de 21 dias. Os dados serão adicionados à sessão se não houver passado mais de 21 dias entre a última sessão do usuário no site e o momento em que o arquivo de dados de conversão for processado.

Os pedidos do CRM contam adicionalmente com um período ampliado para modificação de pedidos já adicionados a sessões: você pode modificar informações sobre esse pedido ou adicioná-lo a uma sessão no prazo de 111 dias da data da sessão a que esse pedido foi adicionado. Isso pode ser útil quando você precisar alterar a receita da conversão após o pedido ser pago e mudar o status da conversão de **Em andamento** para **Pago** ou algo semelhante.

**Se você usar IDs diferentes, os métodos de atribuição de conversão serão diferentes:**

- **ClientID**, **UserID**, **e-mail** e **telefone** (incluindo hash). Conversões offline e chamadas são adicionadas à sessão de usuário que as precedeu diretamente.
    
    Por exemplo, o usuário teve três sessões: em 1º de março, 5 de março e 11 de março. Em 10 de março, esse usuário pagou por um pedido em uma loja física, e essa data foi registrada no CRM. Em 20 de março, o gerente enviou os dados para o Yandex Metrica. O pedido pago em 10 de março foi adicionado à sessão de 5 março do cliente no site.
    
- **yclid**. As conversões serão adicionadas a uma sessão iniciada através do anúncio vinculado à `yclid` transmitida.

- **PurchaseId**. As conversões serão adicionadas à sessão em que se deu a compra de e-commerce com o identificador transferido.
    


## Perguntas e respostas {#ganda}

**É possível rastrear uma conversão se o usuário visualizou minha página, mas fez o pedido offline?**

 
:   Para rastrear essas conversões, transfira dados de clientes e pedidos, incluindo endereços de e-mail ou números de telefone, [do seu CRM](https://yandex.com.tr/support/metrica/pt/crm/about.md) para o Yandex Metrica. Caso queira vincular uma sessão do site a uma ação offline, é possível exibir códigos promocionais exclusivos para os usuários apresentarem na loja.

<!-- source: pt/_includes/buttons/chat-button.md -->
[Fale conosco](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: pt/_includes/styles/href-to-button.md -->

<!-- endsource: pt/_includes/styles/href-to-button.md -->
<!-- endsource: pt/_includes/buttons/chat-button.md -->

<!-- source: pt/_includes/reports/support-button.md -->
<div class="cut-button">

{% cut "Escrever um e-mail" %}

<!-- source: pt/_includes/popup/id-popup/wrong-sup.md -->
Observe, por gentileza, que nossa equipe de suporte jamais iniciará uma chamada com você. Se alguém ligar para você e se apresentar como a equipe de suporte do Yandex Metrica, não siga as instruções dessa pessoa.
<!-- endsource: pt/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com.tr/surveys/1705/?&iframe=1&lang=tr">
  </iframe>
</div>

{% endcut %}

</div>



<!-- source: pt/_includes/styles/cut-button.md -->

<!-- endsource: pt/_includes/styles/cut-button.md -->

<!-- source: pt/_includes/styles/href-to-button.md -->

<!-- endsource: pt/_includes/styles/href-to-button.md -->
<!-- endsource: pt/_includes/reports/support-button.md -->

<!-- source: pt/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Links úteis

- [Tag de demonstração](https://metrica.yandex.com.tr/r/dashboard?)
- [Adicionar uma tag](https://metrica.yandex.com.tr/add/)
- [Configuração gratuita de tag](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [API do Yandex Metrica](https://tech.yandex.com.tr/metrika/)
- [Sugerir uma idea](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Debater no Telegram](https://t.me/yandexmetrika)
|
Treinamento online

- [Obter um certificado do Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Fazer um curso](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: pt/_includes/styles/table-style.md -->

<!-- endsource: pt/_includes/styles/table-style.md -->
<!-- endsource: pt/_includes/footer-links.md -->

[*ClientID]: ID exclusiva de usuário do site criada automaticamente pelo Yandex Metrica.