보고 API 버전 2

이 가이드는 Audience Network Reporting API 버전 2(v2)를 구현하여 비즈니스의 성과 데이터를 가져오는 방법을 보여줍니다.

필수 조건

• Facebook 로그인 사용 사례가 적용된 Meta 앱 과 'read_audience_network_insights' 권한
• 앱의 Facebook 로그인
• 그래프 API 엔드포인트에 대한 성공적인 테스트 쿼리 및 read_audience_network_insights 권한
• Meta 앱 검수의 성공적인 완료
• 장기 실행 사용자 액세스 토큰

권장 사항

• 각 쿼리에서 대량의 데이터가 반환되기 때문에 커서 기반 페이지 매김 을 권장합니다. 페이지 매김된 결과는 동기화 요청에 대해서는 즉시 반환되고 분석 데이터를 가져올 때 선호되는 방법입니다.

제한 사항

• 모든 데이터는 GMT 시간대에 반환됩니다.
• 수익 지표는 노출 수를 기준으로 반환됩니다.

  • 데이터가 없을 경우 총 노출과 수익을 쿼리하는 것이 좋습니다.
• 수익 관리자 또는 비즈니스 관리자에서 생성된 사용자 액세스 토큰은 사용할 수 없습니다.

집계에 대한 업데이트

일일 노출 및 수익

2022년 5월 1~4일 기간의 노출 위치에 대한 노출 및 수익 쿼리(일별 분석 데이터 포함)입니다.

변경될 수 있는 사항: 변경 후 일부 데이터를 사용하지 못할 수 있습니다.

노출 수가 부족해서 사용할 수 없는 수익 및 CPM 데이터 포인트는 API 응답의 results 필드에 포함되지 않습니다. 대신 해당 항목이 omitted_results 필드에 추가됩니다. 여기에는 시간, 지표 및 분석 데이터 필드가 포함되지만 값은 포함되지 않습니다. 이 페이지 아래에서 응답 샘플을 참조하세요.

요청 구문

GET ID > adnetworkanalytics 엔드포인트를 사용하여 비즈니스, 자산 또는 앱에 대한 Audience Network 인사이트를 가져오세요.

GET /<ID>/adnetworkanalytics

GET 요청의 예

인사이트를 가져오려면 쉼표로 구분된 지표의 리스트와 쉼표로 구분된 분석 데이터의 리스트(선택 사항)를 포함하여 /<ID>/adnetworkanalytics 엔드포인트로 GET 요청을 보냅니다. 여기서 <ID>는 Meta 비즈니스 ID, 속성 ID 또는 앱 ID입니다. 다음의 예시는 지표당 응답 2개로 결과를 제한하여 단일한 24시간 기간 동안의 지표를 가져옵니다.

curl -X GET https://graph.facebook.com/v19.0/BUSINESS_ID/adnetworkanalytics
  ?metrics=["fb_ad_network_request","fb_ad_network_imp","fb_ad_network_click","fb_ad_network_revenue"]
  &breakdowns=["placement","country"]
  &since=2021-08-06
  &until=2021-08-06
  &limit=2

응답 예시

{
  "data": [
    {
      "query_id": "531234567890123456789012345683d6",
      "results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1200"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_imp",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ],
          "value": "35"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "21.212345"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AD"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_request",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "12"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AE"
            }
          ],
          "value": "1"
        },
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_click",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "CA"
            }
          ],
          "value": "2"
        }
      ],
      "omitted_results": [
        {
          "time": "2021-08-06T07:00:00+0000",
          "metric": "fb_ad_network_revenue",
          "breakdowns": [
            {
              "key": "placement",
              "value": "123456789012345"
            },
            {
              "key": "country",
              "value": "AU"
            }
          ]
        }
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MQZDZD"
    },
    "next": "https://graph.facebook.com/v10.0/142440604406900/adnetworkanalytics?access_token=<ACCESS_TOKEN>&since=2021-08-06&until=2021-08-06&breakdowns=%5B%22placement%22%2C%22country%22%5D&limit=2&metrics=%5B%22fb_ad_network_request%22%2C%22fb_ad_network_imp%22%2C%22fb_ad_network_click%22%2C%22fb_ad_network_revenue%22%5D&after=MQZDZD"
  }
}

참고 자료

쿼리 매개변수

사용 가능한 지표

문제 해결

액세스 토큰 디버거

액세스 토큰 디버거 를 사용하여 권한, 유효성, 속성 액세스, 토큰과 연결된 앱 ID를 포함한 액세스 토큰의 상세 정보를 가져옵니다.

오류 메시지