Cadastrar um pixel de conversão
Precisa de um token com pixels:write.
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).
Como os pixels são aplicados
Seção intitulada “Como os pixels são aplicados”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.