Pular para o conteúdo

Cadastrar um pixel de conversão

Precisa de um token com pixels:write.

Janela do terminal
curl -s -X POST "$API/v1/meta/datasets?accountId=<id da conta>" -H "Authorization: Bearer $CF" -H "Content-Type: application/json" -d '{
"name": "Pixel principal",
"metaDatasetId": "123456789012345",
"accessToken": "<token da API de Conversões, do Gerenciador de Eventos da Meta>",
"websiteEventName": "Lead",
"messagingEventName": "LeadSubmitted",
"isActive": true,
"appliesToAllPages": true
}'
curl -s "$API/v1/meta/datasets?accountId=<id da conta>" -H "Authorization: Bearer $CF"

Para cobrir só alguns nichos, envie "appliesToAllPages": false e "categoryIds": [...] com ids de GET /v1/categories (account:read).

Uma conta registra datasets da Meta que recebem as conversões atribuídas a ela. Cada dataset cobre todas as páginas da conta (appliesToAllPages: true) ou só as páginas de algumas categorias (categoryIds). O token da API de Conversões só é gravado: as respostas mostram hasAccessToken, nunca o valor.

Método Rota Observação
GET /v1/meta/datasets?accountId= Lista, com limit, cursor e sort (name, createdAt).
POST /v1/meta/datasets?accountId= 201 com o dataset. id é o GUID do Chatfood; metaDatasetId é o id do dataset na Meta.
GET /v1/meta/datasets/{datasetId}?accountId= Um dataset. 404 para dataset de outra conta.
PATCH /v1/meta/datasets/{datasetId}?accountId= Qualquer campo acima; sem accessToken, mantém o token gravado.
DELETE /v1/meta/datasets/{datasetId}?accountId= 204.

Validação (400): name de 1 a 100 caracteres; metaDatasetId só dígitos, até 32; accessToken obrigatório na criação, sem espaços, até 1024; testEventCode letras e dígitos, até 32; websiteEventName entre Lead (padrão), CompleteRegistration, Contact, Schedule, SubmitApplication, ViewContent, FindLocation, Search; messagingEventName entre LeadSubmitted (padrão), QualifiedLead, ViewContent, InitiateCheckout, AddToCart, RatingProvided, ReviewProvided; appliesToAllPages: true exige categoryIds vazio, e false exige ao menos uma categoria.