Câu hỏi thường gặp về báo cáo

API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới mang đến khả năng linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng và quy trình báo cáo. Hãy tìm hiểu thêm về việc di chuyển sang và sử dụng API Báo cáo Search Ads 360 mới.

Phạm vi báo cáo của tôi nên là gì?

Đối với hầu hết các báo cáo, bạn nên đặt Reports.reportScope thành một tài khoản công cụ hoặc nhà quảng cáo cụ thể. Đối với các báo cáo rất lớn (chẳng hạn như báo cáo từ khoá, báo cáo lượt chuyển đổi hoặc báo cáo được phân đoạn nhỏ), bạn nên giới hạn phạm vi ở một tài khoản công cụ cụ thể. API có thể trả về lỗi cho các báo cáo lớn hơn 10 triệu hàng.

Tại sao tôi gặp lỗi Bị cấm (403)?

Khả năng cao nhất là bạn cần phải nhận mã thông báo OAuth làm mới.

Làm cách nào để tìm ID cho đại lý và nhà quảng cáo?

Nếu bạn chưa có mã nhận dạng cho các đại lý và nhà quảng cáo mà bạn có quyền xem, hãy yêu cầu báo cáo advertiser chứa cột agencyIdadvertiserId, nhưng đừng chỉ định reportScope. Search Ads 360 sẽ trả về danh sách tất cả mã nhận dạng công ty quảng cáo và mã nhận dạng nhà quảng cáo mà Tài khoản Google của bạn có quyền xem.

Dưới đây là một yêu cầu mẫu:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

Dữ liệu báo cáo được cập nhật ở mức nào?

Một số chỉ số mới hơn các chỉ số khác. Để biết thông tin chi tiết, hãy xem dữ liệu báo cáo được cập nhật ở mức độ nào trong Search Ads 360?

Để đảm bảo báo cáo chứa tất cả chỉ số có sẵn, bạn nên đợi khoảng 4 giờ sau nửa đêm (múi giờ tài khoản công cụ) trước khi yêu cầu báo cáo về các chỉ số của ngày hôm qua; đối với báo cáo conversion, bạn nên đợi 12 giờ sau nửa đêm (múi giờ của nhà quảng cáo Campaign Manager). Nếu bạn sử dụng API này để tải dữ liệu lượt chuyển đổi lên, hãy xem insert.operation để biết thông tin chi tiết về tình trạng có sẵn của dữ liệu đã tải lên.

Ngay cả sau vài ngày, một chỉ số vẫn có thể thay đổi do bộ lọc nội dung rác của công cụ hoặc lượt chuyển đổi ngoại tuyến được tải lên thông qua API. Để tải dần những thay đổi này xuống, hãy yêu cầu gửi báo cáo về dữ liệu đã thay đổi kể từ lần tải xuống gần đây nhất của bạn. Nếu tải các thay đổi tăng dần xuống, bạn nên thỉnh thoảng yêu cầu nhận báo cáo đầy đủ. Ví dụ: bạn có thể tải các thay đổi tăng dần xuống mỗi vài ngày rồi yêu cầu báo cáo đầy đủ mỗi tháng một lần.

Khi nào các thay đổi về thuộc tính sẽ xuất hiện trong báo cáo?

Sẽ mất khoảng 1 phút để các thay đổi về thuộc tính mà một người thực hiện trong Search Ads 360 xuất hiện trong các báo cáo mà bạn tải xuống thông qua API. Trước tiên, những thay đổi thực hiện trực tiếp trên công cụ bên ngoài (không thông qua Search Ads 360) cần phải nhập vào Search Ads 360 bằng tính năng đồng bộ hoá đến.

Bạn nên chỉ trả về dữ liệu đã thay đổi để xác định những thực thể có thay đổi về thuộc tính.

Quảng cáo và từ khoá không có phân bổ là gì?

Đôi khi, Search Ads 360 không thể quy các chỉ số cho một quảng cáo cụ thể. Ví dụ: một quảng cáo có định dạng không được hỗ trợ hoặc URL máy chủ lượt nhấp bị lỗi có thể ngăn Search Ads 360 phân bổ các chỉ số cho một quảng cáo. Đối với mỗi nhóm quảng cáo, Search Ads 360 sẽ báo cáo mọi chỉ số chưa được phân bổ thuộc về "quảng cáo chưa được phân bổ". Để yêu cầu các chỉ số này trong một báo cáo, hãy đặt includeRemovedEntities thành true. Để giúp bạn dễ dàng biết được quảng cáo nào chưa được phân bổ, hãy thêm cột isUnattributedAd vào yêu cầu.

Tương tự, đôi khi, Search Ads 360 không thể quy các chỉ số cho một từ khoá cụ thể. Điều này xảy ra khi có sự khác biệt trong báo cáo. Trong những trường hợp như vậy, cột keywordId cho từ khoá không được phân bổ sẽ được đặt thành 0.

Báo cáo có bao gồm số lượt chuyển đổi được điều chỉnh theo tỷ lệ không?

Trong một số trường hợp, lượt chuyển đổi rất khó đo lường, chẳng hạn như khi cookie của trang web lưu trữ thông tin về các lượt nhấp vào quảng cáo không có sẵn do các yếu tố như chế độ cài đặt của trình duyệt. Trong những trường hợp này, Floodlight sẽ sử dụng phương thức điều chỉnh theo tỷ lệ để tính đến dữ liệu lượt chuyển đổi không đo lường trực tiếp được. Tức là Floodlight áp dụng công nghệ học máy vào dữ liệu trong quá khứ để lập mô hình số lượt chuyển đổi và doanh thu từ lượt chuyển đổi không đo lường được. Sau đó, Floodlight có thể thêm số liệu ước tính kết quả vào các chỉ số về lượt chuyển đổi để cung cấp thông tin đầy đủ hơn về cách quảng cáo thúc đẩy lượt chuyển đổi.

Floodlight luôn áp dụng tỷ lệ cho các cột báo cáo sau đây:

  • dfaActions
  • dfaRevenue
  • dfaTransactions
  • dfaWeightedActions
  • Các cột đã lưu báo cáo về các hoạt động Floodlight

Báo cáo conversion không bao gồm số lượt chuyển đổi được điều chỉnh theo tỷ lệ. Báo cáo này chỉ cho thấy những lượt chuyển đổi được đo lường trực tiếp. Số lượt chuyển đổi và doanh thu trong báo cáo conversion dự kiến không khớp với số lượt chuyển đổi và doanh thu được báo cáo trong các cột nêu trên.

Tại sao các lượt chuyển đổi thô không tính tổng bằng chỉ số tổng hợp X?

Trong trường hợp hiếm gặp mà các chỉ số tổng hợp không đồng ý với các sự kiện thô trong Search Ads 360, hãy tin tưởng vào chỉ số tổng hợp đó. Khi tổng hợp chỉ số điện toán, Search Ads 360 sẽ cố gắng dọn dẹp nguồn dữ liệu bằng cách loại bỏ các lượt chuyển đổi mà hệ thống nghi ngờ là trùng lặp.

Nếu câu hỏi của tôi không được trả lời tại đây thì sao?

Nếu có vấn đề mà bạn không thể giải quyết sau khi đọc các tài nguyên trên trang web này, hãy liên hệ với bộ phận hỗ trợ và chuẩn bị sẵn các thông tin sau:

  • Mã đại lý và Mã nhận dạng nhà quảng cáo Search Ads 360 mà bạn đang cố gắng truy cập

  • Số dự án trên Google API Console

  • Tên người dùng của Tài khoản Google mà bạn đang sử dụng để truy cập API.
    Đây là tài khoản đã được cấp quyền truy cập vào Search Ads 360, chính là tài khoản mà bạn dùng để thiết lập quyền truy cập.

  • Đoạn mã trong yêu cầu của bạn

  • Phản hồi JSON
    Nếu phản hồi là lỗi, hãy nhớ gửi kèm thông báo lỗi chứ không chỉ mã lỗi dạng số.