Destinos de rastreamento
Um destino é a configuração que envia conversões server-side para uma única conta de uma plataforma de anúncios ou analytics; esta página lista os endpoints que gerenciam cada destino, por plataforma. Os caminhos são relativos à autoridade do servidor e exigem o token Bearer descrito em Autenticação.
Convenções desta página
- Todos os endpoints têm escopo de conta: a posse é verificada por
account_id. Uma escrita incondicional sobre um destino de outra conta falha com400 could not insert or update <recurso> <id>. Do you own it?, e oDELETEdevolve{ "deleted": false }(não404). - Criar ou atualizar é um
PUTno recurso. HonraIf-Match(escrita condicional,412em conflito) e devolve o cabeçalhoETag. - Listar é um
GET; cada item traz seuetag. Trate oetagcomo token opaco e devolva-o como veio emIf-Match, com ou sem aspas. Excluir é umDELETE, com resposta{ "deleted": <bool> }. - Para o envelope de resposta, os códigos de status e o mecanismo de
ETageIf-Match, consulte Convenções e erros. Para os níveis de acesso (Standard, ReadOnly), consulte Autenticação.
Facebook (Conversions API)
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /pixels | Cria ou atualiza um pixel Facebook | Standard |
GET | /pixels | Lista os pixels Facebook da conta | ReadOnly |
DELETE | /pixels/{pixel_id} | Exclui pelo pixel_id numérico | Standard |
A credencial (CAPI access token) vai no corpo da escrita.
Google Analytics 4
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /measurement-ids | Cria ou atualiza um measurement id GA4 | Standard |
GET | /measurement-ids | Lista os measurement ids da conta | ReadOnly |
DELETE | /measurement-ids/{measurement_id} | Exclui pelo measurement_id (texto) | Standard |
A credencial (api secret) vai no corpo da escrita.
TikTok
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /tiktok-pixels | Cria ou atualiza um pixel TikTok | Standard |
GET | /tiktok-pixels | Lista os pixels TikTok da conta | ReadOnly |
DELETE | /tiktok-pixels/{pixel_code} | Exclui pelo pixel_code (texto) | Standard |
A credencial (access token) vai no corpo da escrita.
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /linkedin-conversions | Cria ou atualiza uma conversão LinkedIn | Standard |
GET | /linkedin-conversions | Lista as conversões LinkedIn da conta | ReadOnly |
DELETE | /linkedin-conversions/{conversion_urn} | Exclui pela conversion_urn (texto) | Standard |
Importante
A escrita exige que você já tenha conectado as conversões do LinkedIn por OAuth; sem isso, ela retorna 400 ("connect LinkedIn conversions first"). Não se envia token no corpo: o destino referencia a credencial OAuth do usuário que conectou.
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /pinterest-ad-accounts | Cria ou atualiza uma ad account Pinterest | Standard |
GET | /pinterest-ad-accounts | Lista as ad accounts Pinterest da conta | ReadOnly |
DELETE | /pinterest-ad-accounts/{ad_account_id} | Exclui pelo ad_account_id (texto) | Standard |
A credencial (access token) vai no corpo da escrita.
Google Ads: customers
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
PUT | /gads-customers | Cria ou atualiza um customer Google Ads vinculado; customer_name é obrigatório (nas outras plataformas o nome é opcional) e login_customer_id é opcional | Standard |
GET | /gads-customers | Lista os customers vinculados da conta | ReadOnly |
DELETE | /gads-customers/{customer_id} | Exclui pelo customer_id numérico | Standard |
Importante
A escrita exige conexão OAuth de conversões do Google Ads; sem isso, ela retorna 400 ("connect Google Ads conversions first"). Não se envia token no corpo: o destino referencia a credencial OAuth do usuário.
Google Ads: ações de conversão
| Método | Caminho | Ação | Acesso |
|---|---|---|---|
GET | /gads-conversion-actions?customer_id={customer_id} | Lista as ações de conversão de um customer (o parâmetro customer_id é obrigatório) | ReadOnly |
PUT | /gads-conversion-actions | Cria uma ação (sem id no corpo) ou a atualiza condicionalmente (com If-Match e o id da ação existente no corpo); retorna { "id": <número> } | Standard |
DELETE | /gads-conversion-actions/{id} | Exclui pelo id numérico da ação | Standard |
Importante
O PUT valida a posse do customer_id do corpo antes de qualquer escrita; se o customer não pertence à conta, rejeita com 400 customer_id <id> not found.
Veja também
- Convenções e erros: o envelope de resposta, os códigos de status e a escrita condicional com
ETageIf-Match. - Métricas de eventos: as métricas e os erros dos eventos enviados a estes destinos.