Webhooks para contas de anúncios
Os webhooks para contas de anúncios permitem que você receba notificações em tempo real sobre determinadas alterações nos anúncios.
Para configurar webhooks em contas de anúncios, siga estas etapas:
Configurar o ponto de extremidade e os webhooks
Siga nosso guia de introdução para criar o ponto de extremidade e configurar os webhooks. Ao configurar seus webhooks, escolha Ad Account.
No momento, você pode receber notificações em tempo real sobre alterações de status de objetos do anúncio para WITH_ISSUES e IN_PROCESS. Faça a inscrição para um ou mais campos abaixo:
| Campo | Descrição |
|---|---|
| Envia uma notificação a você quando uma campanha, conjunto de anúncios ou anúncio na conta de anúncios recebe o status |
| Envia uma notificação a você quando uma campanha, conjunto de anúncios ou anúncio sai do status |
Inscrever seu app
Você precisa inscrever seu app para receber notificações de webhooks sobre a conta de anúncios. O app deve ter permissão de edição na conta de anúncios para concluir esta etapa. A permissão ads_management também é necessária.
Para inscrever seu app, envie uma solicitação POST de subscribed_apps para a conta de anúncios:
curl -i -X POST \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"
Se o processo for bem-sucedido, você verá a seguinte resposta:
{"success": "true"}Para ver quais apps estão inscritos na sua conta de anúncios, envie uma solicitação GET:
curl -i -X GET \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"
Se o processo for bem-sucedido, você verá a seguinte resposta:
{
"data": [
{
"name": "<APP_NAME>",
"id": "<APP_ID>"
} ]
}Para remover a inscrição de um app, envie uma solicitação DELETE:
Se o processo for bem-sucedido, você verá a seguinte resposta:
{"success": "true"}Fazer a inscrição com o Explorador da Graph API
Também é possível inscrever um app usando o Explorador da Graph API.
Substitua a consulta me?fields=id,name por act_AD_ACCOUNT_ID/subscribed_apps. Isso inscreverá o app usado para enviar a solicitação POST no Explorador da Graph API. Como opção, você pode inscrever outro app ao especificar subscribed_apps como um parâmetro de entrada com o ID do app.
Para fazer a inscrição, seu app deve ter permissão para editar a conta de anúncios.
[
{
"object": "ad_account",
"entry": [
{
"id": "0",
"time": 1568132516,
"changes": [
{
"field": "with_issues_ad_objects",
"value": {
"id": "111111111111",
"level": "AD",
"error_code": "567",
"error_summary": "error summary",
"error_message": "error message"
}
}
]
}
]
}
]