광고 계정용 Webhooks

광고 계정용 Webhooks를 이용하면 특정 광고 변경 사항에 대한 실시간 알림을 받을 수 있습니다.

광고 계정의 Webhooks를 설정하려면 다음 단계를 수행해야 합니다.

1. 엔드포인트를 설정하고 Webhooks를 구성합니다.
2. 광고 계정에서 앱 구독을 설정합니다.

엔드포인트 및 Webhooks 설정

Webhooks 시작하기 가이드에 따라 엔드포인트를 만들고 Webhooks를 구성합니다. Webhooks를 구성할 때 Ad Account를 선택해야 합니다.

현재 WITH_ISSUES 및 IN_PROCESS의 광고 개체 상태 변경에 대한 실시간 알림을 받을 수 있습니다. 아래에서 하나 이상의 필드를 구독하세요.

앱 구독 설정

광고 계정 앱이 Webhooks 알림을 구독하도록 설정해야 합니다. 이 단계를 완료하려면 앱에 광고 계정에 대한 수정 권한이 있어야 합니다. 또한 앱에 ads_management 권한도 있어야 합니다.

앱 구독을 설정하려면 앱에서 해당 광고 계정에 대한 subscribed_apps에 POST 요청을 보내도록 해야 합니다.

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

성공 시 다음과 같은 응답이 표시됩니다.

{"success": "true"}

광고 계정에 대해 구독을 설정한 앱을 확인하려면 다음과 같이 GET 요청을 보냅니다.

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

성공 시 다음과 같은 응답이 표시됩니다.

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

앱을 구독에서 삭제하려면 다음과 같이 DELETE 요청을 보냅니다.

성공 시 다음과 같은 응답이 표시됩니다.

{"success": "true"}

그래프 API 탐색기로 구독

그래프 API 탐색기를 이용하여 앱 구독을 설정할 수도 있습니다.

me?fields=id,name 쿼리를 act_AD_ACCOUNT_ID/subscribed_apps로 교체합니다. 그러면 그래프 탐색기에서 POST 요청을 보내는 데 사용하는 앱에 대해 구독을 설정하게 됩니다. 또는 subscribed_apps를 입력 매개변수와 앱 ID로 지정하면 다른 앱에 대한 구독을 설정할 수 있습니다.

구독을 설정하려면 앱에 광고 계정을 수정할 권한이 있어야 합니다.

[
  {
    "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"
            }
          }
        ]
      }
    ]
  }
]