API Báo cáo phiên bản 2

Tài liệu này hướng dẫn bạn cách triển khai API Báo cáo phiên bản 2 (v2) của Audience Network để lấy dữ liệu hiệu quả cho doanh nghiệp của mình.

Điều kiện tiên quyết

• Ứng dụng trên Meta có trường hợp sử dụng phương thức Đăng nhập bằng Facebook và quyền `read_audience_network_insights`
• Phương thức Đăng nhập bằng Facebook trong ứng dụng của bạn
• Truy vấn thử nghiệm thành công cho điểm cuối API Đồ thị và quyền read_audience_network_insights
• Hoàn tất thành công quy trình Xét duyệt ứng dụng trên Meta
• Mã truy cập dài hạn dành cho người dùng

Đề xuất

• Do lượng dữ liệu lớn được trả về trong mỗi truy vấn, bạn nên sử dụng phương thức phân trang dựa vào con trỏ . Hệ thống sẽ lập tức trả về kết quả được phân trang cho các yêu cầu đồng bộ. Đây cũng là phương thức ưu tiên để truy xuất số liệu chia nhỏ.

Giới hạn

• Tất cả dữ liệu đều được trả về theo múi giờ GMT
• Hệ thống trả về số liệu doanh thu dựa trên số lượt hiển thị

  • Nếu dữ liệu không có sẵn, bạn nên truy vấn tổng số lượt hiển thị và doanh thu
• Bạn không thể sử dụng mã truy cập dành cho người dùng được tạo trong Trình quản lý kiếm tiền hoặc Trình quản lý kinh doanh

Thông tin mới cho phần tổng hợp

Lượt hiển thị và doanh thu hàng ngày

Truy vấn lượt hiển thị và doanh thu cho vị trí quảng cáo trong khoảng thời gian từ 01 - 04/05/2022 với số liệu chia nhỏ hàng ngày.

Điều gì có thể thay đổi: Bạn có thể thấy rằng một số dữ liệu không được cung cấp sau khi thay đổi.

Doanh thu và điểm dữ liệu CPM không có sẵn do số lượt hiển thị không đủ sẽ không được đưa vào trường results trong phản hồi API. Thay vào đó, các mục nhập tương ứng sẽ được thêm vào trường omitted_results. Các mục nhập này bao gồm trường thời gian, số liệu và số liệu chia nhỏ, nhưng sẽ không bao gồm giá trị. Vui lòng tham khảo phản hồi mẫu ở cuối trang này.

Cú pháp yêu cầu

Sử dụng điểm cuối GET ID > adnetworkanalytics để lấy thông tin chi tiết về Audience Network cho doanh nghiệp, tài sản hoặc ứng dụng.

GET /<ID>/adnetworkanalytics

Ví dụ về yêu cầu GET

Để lấy thông tin chi tiết, hãy gửi yêu cầu GET đến điểm cuối /<ID>/adnetworkanalytics kèm theo danh sách số liệu được phân tách bằng dấu phẩy và danh sách số liệu chia nhỏ được phân tách bằng dấu phẩy (không bắt buộc), trong đó <ID> là ID doanh nghiệp của bạn trên Meta, ID tài sản hoặc ID ứng dụng. Ví dụ sau lấy số liệu trong một khoảng thời gian 24 giờ và giới hạn kết quả ở 2 phản hồi cho mỗi số liệu.

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

Phản hồi mẫu

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

Tài liệu tham khảo

Thông số truy vấn

Số liệu có sẵn

Khắc phục sự cố

Trình gỡ lỗi mã truy cập

Sử dụng Trình gỡ lỗi mã truy cập để lấy thông tin chi tiết về mã truy cập, bao gồm các quyền, tính hiệu lực, quyền truy cập vào tài sản và ID ứng dụng được liên kết với mã đó.

Thông báo lỗi