Loại báo cáo: quảng cáo

Chỉ số hiệu suất và thuộc tính cấu hình cho quảng cáo.

Báo cáo này chỉ có thể được trả về nếu có một yêu cầu không đồng bộ (tức là thông qua Reports.request()).

Yêu cầu trích dẫn

Gửi thông báo Reports.request() nội dung yêu cầu nhưng chỉ định "reportType": "ad". 

{
...
  "reportType": "ad",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Đối với mỗi cột mà bạn muốn trả về hoặc lọc trong báo cáo, chỉ định columnName được liệt kê trong bảng bên dưới. Bạn cũng có thể tuỳ ý chỉ định headerText, startDate, và endDate. Lưu ý rằng một số cột không thể lọc được; tham khảo "Có thể lọc" trong bảng dưới đây.

columnNameMô tảHành viLoạiCó thể lọc
status Trạng thái của quảng cáo: Active, Paused hoặc Removed. Xin lưu ý rằng mỗi chiến dịch, nhóm quảng cáo, từ khoá và quảng cáo đều có trạng thái riêng. Xem trạng thái. phân bổ Status Có
engineStatus Trạng thái bổ sung của quảng cáo trong tài khoản công cụ bên ngoài. Các trạng thái có thể có (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm active, eligible, creative deleted, creative approved family safe, v.v. phân bổ String Có
creationTimestamp Dấu thời gian tạo quảng cáo, được định dạng theo ISO 8601. phân bổ Timestamp Có
lastModifiedTimestamp Dấu thời gian của lần sửa đổi quảng cáo gần đây nhất, được định dạng theo ISO 8601. phân bổ Timestamp Có
agency Tên công ty quảng cáo. phân bổ String Có
agencyId Mã công ty quảng cáo DS. phân bổ ID Có
advertiser Tên nhà quảng cáo. phân bổ String Có
advertiserId Mã nhận dạng nhà quảng cáo DS. phân bổ ID Có
account Tên tài khoản công cụ. phân bổ String Có
accountId Mã tài khoản công cụ DS. phân bổ ID Có
accountEngineId Mã của tài khoản trong tài khoản công cụ bên ngoài. phân bổ String Có
accountType Loại tài khoản công cụ: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu hoặc Comparison Shopping. phân bổ Engine type Có
campaign Tên chiến dịch. phân bổ String Có
campaignId Mã chiến dịch DS. phân bổ ID Có
campaignStatus Trạng thái của chiến dịch chứa mục này. phân bổ Status Có
adGroup Tên nhóm quảng cáo. phân bổ String Có
adGroupId Mã nhóm quảng cáo DS. phân bổ ID Có
adGroupStatus Trạng thái của nhóm quảng cáo chứa mục này. phân bổ Status Có
ad Tên quảng cáo. phân bổ String Có
adId Mã quảng cáo DS. Giá trị 0 cho biết rằng quảng cáo không được phân bổ. phân bổ ID Có
adEngineId Mã của quảng cáo trong tài khoản công cụ bên ngoài. phân bổ ID Có
isUnattributedAd Cho biết liệu các chỉ số trong hàng này có phải không thể phân bổ cho một quảng cáo cụ thể hay không. Ví dụ: một quảng cáo có định dạng không được hỗ trợ hoặc URL của máy chủ theo dõi lượt nhấp bị lỗi có thể khiến DS phân bổ chỉ số cho một quảng cáo. phân bổ Boolean Có
adHeadline Dòng tiêu đề quảng cáo. phân bổ String Có
adHeadline2 Dòng tiêu đề quảng cáo 2; không được hỗ trợ đối với một số công cụ. phân bổ String Có
adHeadline3 Dòng tiêu đề quảng cáo 3; không được hỗ trợ đối với một số công cụ. phân bổ String Có
adDescription1 Dòng mô tả quảng cáo 1. phân bổ String Có
adDescription2 Dòng mô tả quảng cáo 2; không được hỗ trợ đối với một số công cụ. phân bổ String Có
adDisplayUrl URL hiển thị của quảng cáo. phân bổ String Có
adLandingPage Trang đích quảng cáo. Hãy xem bài viết URL trang đích và URL máy chủ lượt nhấp. phân bổ String Có
adType Loại quảng cáo: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text hoặc Expanded dynamic search. phân bổ Ad type Có
adPromotionLine Dòng quảng cáo. Thông điệp quảng cáo ngắn cho quảng cáo sản phẩm. phân bổ String Có
adLabels Tên của nhãn được chỉ định trực tiếp cho quảng cáo này; không bao gồm nhãn kế thừa. phân bổ String list Có
adPathField1 Trường đường dẫn quảng cáo 1. Các trường đường dẫn 1 và 2 được kết hợp với adDisplayUrl để tạo thành URL hiển thị trên quảng cáo. phân bổ String Có
adPathField2 Trường đường dẫn quảng cáo 2. Các trường đường dẫn 1 và 2 được kết hợp với adDisplayUrl để tạo thành URL hiển thị trên quảng cáo. phân bổ String Có
effectiveLabels Tên của tất cả các nhãn được kế thừa hoặc gán trực tiếp cho quảng cáo này. phân bổ String list Có
dfaActions Tổng số hành động trên Campaign Manager. chỉ số Integer Có
dfaRevenue Tổng doanh thu do các giao dịch Campaign Manager tạo ra. chỉ số Money Có
dfaTransactions Tổng số giao dịch Campaign Manager. chỉ số Integer Có
dfaWeightedActions Tổng số hành động của Campaign Manager có trọng số. chỉ số Number Có
dfaActionsCrossEnv Tổng số hành động trên nhiều môi trường của Campaign Manager. chỉ số Number Có
dfaRevenueCrossEnv Tổng doanh thu do các giao dịch Campaign Manager trên nhiều môi trường tạo ra. chỉ số Money Có
dfaTransactionsCrossEnv Tổng số giao dịch trên nhiều môi trường trong Campaign Manager. chỉ số Number Có
dfaWeightedActionsCrossEnv Tổng trọng số của các hành động trên nhiều môi trường từ Campaign Manager. chỉ số Number Có
avgCpc Giá mỗi nhấp chuột trung bình. chỉ số Money Có
avgCpm Chi phí trung bình cho mỗi nghìn lượt hiển thị. chỉ số Money Có
avgPos Vị trí trung bình. chỉ số Number Có
clicks Tổng hợp số lượt nhấp. chỉ số Integer Có
cost Tổng chi phí đã thanh toán cho(các) tài khoản công cụ. chỉ số Money Có
ctr Tỷ lệ nhấp trung bình. chỉ số Number Có
impr Tổng số lượt hiển thị. chỉ số Integer Có
adWordsConversions Dữ liệu mà nhà quảng cáo đã thiết lập sẽ được báo cáo trong cột Lượt chuyển đổi trên Google Ads. Khi một hành động chuyển đổi trên Google Ads được tạo, nhà quảng cáo có thể chọn xem có tính các lượt chuyển đổi đó trong cột Báo cáo lượt chuyển đổi hay không. chỉ số Number Có
adWordsConversionValue Giá trị tổng hợp của các lượt chuyển đổi trên Google Ads. chỉ số Number Có
adWordsViewThroughConversions Tổng số lượt chuyển đổi từ lượt xem hết trên Google Ads. chỉ số Integer Có
visits Tổng số lượt truy cập DS. chỉ số Integer Có
date Phân đoạn báo cáo theo ngày; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày của mỗi hàng. phân khúc Date Có
monthStart Phân đoạn báo cáo theo tháng; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong tháng của mỗi hàng. phân khúc Date Có
monthEnd Phân đoạn báo cáo theo tháng; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng trong tháng của mỗi hàng. phân khúc Date Có
quarterStart Phân đoạn báo cáo theo quý; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong quý của mỗi hàng. phân khúc Date Có
quarterEnd Phân đoạn báo cáo theo quý; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng của quý của mỗi hàng. phân khúc Date Có
weekStart Phân đoạn báo cáo theo tuần (Chủ nhật đến thứ Bảy); mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên (Chủ nhật) của mỗi hàng. phân khúc Date Có
weekEnd Phân đoạn báo cáo theo tuần (Chủ nhật đến thứ Bảy); mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng (Thứ Bảy) của mỗi hàng. phân khúc Date Có
yearStart Phân đoạn báo cáo theo năm; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày đầu tiên trong năm của mỗi hàng. phân khúc Date Có
yearEnd Phân đoạn báo cáo theo năm; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, mỗi hàng cho một hàng. Cột này trả về ngày cuối cùng trong năm trên mỗi hàng. phân khúc Date Có
deviceSegment Phân đoạn báo cáo theo thiết bị; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi phân đoạn thiết bị. Cột này trả về phân đoạn thiết bị của mỗi hàng. phân khúc Device segment Có
floodlightGroup Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về tên nhóm Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String Có
floodlightGroupId Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về mã nhóm Floodlight DS của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc ID Có
floodlightGroupTag Phân đoạn báo cáo theo nhóm Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi nhóm Floodlight. Cột này trả về thẻ nhóm Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String Có
floodlightActivity Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về tên hoạt động Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String Có
floodlightActivityId Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về mã hoạt động Floodlight của mỗi hàng DS. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc ID Có
floodlightActivityTag Phân đoạn báo cáo theo hoạt động Floodlight; mỗi hàng và chỉ số tổng hợp của hàng đó được chia thành nhiều hàng, tối đa một hàng cho mỗi hoạt động Floodlight. Cột này trả về thẻ hoạt động Floodlight của mỗi hàng. Xin lưu ý rằng một số chỉ số không có giá trị được phân đoạn bằng Floodlight, chẳng hạn như số lượt nhấp và lượt truy cập. phân khúc String Có