# Tracking server-side das conversões Pinterest

> Envie as conversões para a Pinterest Conversions API a partir do servidor: compra despoletada pela encomenda validada, identificadores cifrados, alojado na UE.

- Página original: https://server-side.datafirefly.com/pt/pinterest-conversions-api-server-side-tracking.html
- Idioma: pt
- Atualizado em: 2026-09-05
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

Pinterest Conversions API v5

As suas conversões saem do **seu servidor** para a API de Conversões do Pinterest. A compra é despoletada pela **encomenda validada** na sua loja, não pelo carregamento de uma página.

O Pinterest tem um ciclo de compra longo: alguém guarda um pin hoje e compra semanas depois. É precisamente o caso em que um envio do servidor, com um identificador utilizável, ainda sabe ligar a venda ao pin.

[Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) Ver o que é enviado

Enviado a partir do seu servidor Identificadores cifrados antes do envio Alojado na UE

O caminho de uma compra

**A sua loja** A encomenda validada despoleta o envio, mesmo semanas depois do pin

**Dispatcher DataFirefly** Consentimento verificado, identificadores cifrados (exceto webhooks do Shopify)

**Pinterest Conversions API v5** checkout, com o valor e os produtos

page_visit add_to_cart checkout lead

O problema

## Onde uma loja perde as suas conversões Pinterest

A etiqueta do Pinterest vive no navegador, e o intervalo entre a descoberta e a compra é justamente quando o navegador esquece.

### O prazo apaga o rasto

Entre o pin e a compra passam muitas vezes semanas. Os cookies de terceiros não sobrevivem a isso; um envio do servidor com identificador sobrevive.

### A etiqueta é bloqueada

Como em todo o lado, parte dos visitantes nunca a executa. Essas vendas existem, apenas não são contadas.

### Passos sem equivalente

O Pinterest não tem um evento para cada passo do funil. Enviados de qualquer maneira, inflacionam o número de compras: enviamo-los como evento genérico, o que os conserva sem falsear a contagem.

Instalação

## Três passos, e nada para reescrever

O conector instala-se na sua loja; o resto define-se na consola.

### 1: Instalar o conector

O módulo PrestaShop, o plugin WooCommerce ou a extensão Shopware, descarregados da sua consola.

### 2: Colar dois valores

O identificador da conta publicitária e o token da API de Conversões, da sua própria conta Pinterest.

### 3: Olhar o Inspector

Cada evento enviado aparece com a resposta do Pinterest, aceite ou recusado, e o motivo.

Correspondências

## O que o Pinterest recebe, evento a evento

O Pinterest chama «checkout» à compra. Os passos sem equivalente oficial saem como evento genérico em vez de serem forçados a um nome próximo: continuam visíveis sem inflacionar as suas compras.

| O nosso nome | Nome na plataforma |
| --- | --- |
| `page_view` | `page_visit` |
| `view_content` | `page_visit` |
| `add_to_cart` | `add_to_cart` |
| `initiate_checkout` | `custom` |
| `add_payment_info` | `custom` |
| `purchase` | `checkout` |
| `lead` | `lead` |
| `complete_registration` | `signup` |
| `search` | `search` |
| `view_item_list` | `view_category` |

Os limites

## O que o Pinterest não saberá fazer

O vocabulário do Pinterest é mais curto do que o nosso. É assim que tratamos a diferença, em vez de a esconder.

### Dois passos saem como evento genérico

O início da encomenda e a introdução do pagamento não têm equivalente no Pinterest. Enviamo-los como evento `custom`: continuam visíveis nos seus relatórios sem **inflacionar o número de compras**, que é o que aconteceria se os fizéssemos passar por `checkout`.

### A vista de conteúdo e a página vista confundem-se

O Pinterest só tem um `page_visit` para ambas. Não é uma perda de dados, a distinção mantém-se inteira na sua consola, mas do lado do Pinterest não existe, e convém sabê-lo antes de comparar as duas interfaces.

Verificável

## O que a consola lhe mostrará para este destino

Um argumento que podemos sustentar porque a página existe: não tem de acreditar em nós, olha.

### Cada evento, com a resposta da plataforma

O Inspector lista o que saiu, o que o destino fez com isso e o **motivo exato** de uma recusa. Um identificador inválido ou um token expirado leem-se em claro, no próprio dia.

### A cobertura dos identificadores

Quantos dos seus eventos levavam com que ligar a conversão a uma pessoa. É isso que decide a qualidade de correspondência e, portanto, o ROAS que lerá no anunciante.

### Os períodos em que nada saiu

A anomalia mais dispendiosa e a mais discreta: um painel vazio lê-se como uma semana fraca, nunca como uma avaria. A consola nomeia-os.

Requisitos

## O que precisa

Dois valores, da sua própria conta Pinterest.

### O identificador da conta publicitária

Ads Manager → Business Access → Ad accounts. É um número.

### Um token da API de Conversões

Gerado no mesmo espaço, enviado como Bearer. Cifrado em repouso.

### Mais nada

Sem palavra-passe, sem acesso à sua conta: nunca escrevemos nas suas campanhas, enviamos conversões.

Privacidade

## O que não sai da nossa infraestrutura

Um produto que manipula dados de clientes deve dizer onde para.

### Os identificadores são cifrados antes do envio

Normalizados e depois cifrados aqui: o destino recebe uma impressão, nunca o endereço de e-mail ou o número de telefone.

### O consentimento decide, também do lado do servidor

Cada evento leva o estado registado pelo seu banner. Uma recusa continua a ser uma recusa: passar pelo servidor não contorna nada. No Shopify, o pixel da DataFirefly segue o consentimento de marketing registado no Shopify, mas as encomendas chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a sua própria política de consentimento.

### Alojado na União Europeia

O dispatcher, a base de dados e a consola estão na Alemanha. Os seus tokens são cifrados em repouso e nunca reaparecem em claro numa página.

Sem surpresas

## Simples de instalar, e sem custo acrescentado

É uma opção de conceção, não uma promessa comercial: não há nada para alojar nem nada para desbloquear plano a plano.

### Um módulo, como os outros

O conector instala-se como qualquer outra extensão da sua loja. **Nada para alojar**: nenhum contentor para alugar, nenhum servidor para manter, nenhum subdomínio para configurar.

### Todos os destinos, em todos os planos

Incluindo o gratuito. Os planos diferem apenas no **número de sites e de eventos**: nenhum destino está reservado a um patamar, embora seja o hábito.

### Começar não custa nada

O plano gratuito cobre um site e 10 000 eventos por mês, **sem cartão**. Nada quebra se ultrapassar a quota.

Ce qu'on nous demande

## Questions fréquentes

### Porque é que o server-side conta tanto no Pinterest?

Porque o prazo é longo. Entre o pin e a compra passam muitas vezes semanas, e os cookies de terceiros não sobrevivem. Um envio do seu servidor, com identificador, ainda sabe ligar a venda à sua origem.

### As minhas conversões vão ser contadas duas vezes?

Não: a etiqueta do Pinterest e o envio do servidor levam o mesmo identificador de evento, construído a partir do número da encomenda.

### Que dados pessoais são enviados?

Os identificadores são normalizados e depois cifrados antes do envio. O Pinterest recebe uma impressão, nunca o endereço, e nada sai sem o consentimento registado pelo seu banner. No Shopify, o pixel da DataFirefly segue o consentimento de marketing registado no Shopify, mas as encomendas chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a sua própria política de consentimento.

### Posso verificar o que saiu realmente?

Sim. O Inspector da sua consola lista os eventos com a resposta do Pinterest para cada um e o motivo exato de uma recusa.

Ir mais longe

## O passo seguinte

Instalar o conector na sua loja, saber o que mede e verificar o que saiu realmente.

### [Módulo PrestaShop](https://server-side.datafirefly.com/pt/prestashop-server-side-tracking.html)

A instalação numa loja PrestaShop, passo a passo.

### [Plugin WooCommerce](https://server-side.datafirefly.com/pt/woocommerce-server-side-tracking.html)

A instalação em WordPress e WooCommerce.

### [Extensão Shopware](https://server-side.datafirefly.com/pt/shopware-server-side-tracking.html)

A instalação em Shopware 6.

### [O que medimos](https://server-side.datafirefly.com/pt/o-que-medimos.html)

Os 28 eventos em claro, e o que vê um site sem loja.

### [Insights: o painel](https://server-side.datafirefly.com/pt/insights.html)

Onde verifica o que saiu e o que o destino fez com isso.

### [Todos os destinos](https://server-side.datafirefly.com/pt/#destinations)

As sete plataformas para onde um mesmo evento pode ir.

## Ligue este destino em poucos minutos

O plano gratuito inclui todos os destinos. Sem compromisso e sem cartão.

[Começar grátis](https://admin.datafirefly.com/pricing?lang=pt) [Vamos conversar](https://server-side.datafirefly.com/pt/contact.html)
