Search Ads 360 Reporting API cũ đã ngừng hoạt động. Giờ đây, bạn có thể tạo báo cáo bằng API Báo cáo Search Ads 360 mới.

Xin lưu ý rằng Search Ads 360 Conversion API không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ.

Trang này được dịch bởi Cloud Translation API.

Loại báo cáo: lượt chuyển đổi

Dữ liệu sự kiện thô về lượt chuyển đổi.

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

Vì các sự kiện xảy ra vào những ngày cụ thể, nên yêu cầu báo cáo này phải chỉ định một timeRange. Bạn có thể chỉ định một trong những thông tin sau:

startDate và endDate.
changedMetricsSinceTimestamp (changedAttributesSinceTimestamp không hợp lệ đối với sự kiện).

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

Gửi nội dung yêu cầu Reports.request() thông thường, nhưng hãy chỉ định "reportType": "conversion".

{
...
  "reportType": "conversion",
  "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, hãy 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. Xin lưu ý rằng bạn không thể lọc một số cột; hãy tham khảo mục "Có thể lọc" trong bảng bên dưới.

`columnName`	Mô tả	Hành vi	Loại	Có thể lọc
`status`	Trạng thái của lượt chuyển đổi: `Active` hoặc `Removed`.	thuộc tính	`Status`	Có
`deviceSegment`	Phân khúc thiết bị được phân bổ lượt chuyển đổi: `Desktop`, `Mobile`, `Tablet` hoặc `Other`.	thuộc tính	`Device segment`	Có
`floodlightGroup`	Tên nhóm Floodlight.	thuộc tính	`String`	Có
`floodlightGroupConversionType`	Loại lượt chuyển đổi do các hoạt động Floodlight trong nhóm này tạo ra: `Action` hoặc `Transaction`.	thuộc tính	`Conversion type`	Có
`floodlightGroupId`	Mã nhóm Floodlight DS.	thuộc tính	`ID`	Có
`floodlightGroupTag`	Thẻ nhóm Floodlight.	thuộc tính	`String`	Có
`floodlightActivity`	Tên hoạt động Floodlight.	thuộc tính	`String`	Có
`floodlightActivityId`	Mã hoạt động DS Floodlight.	thuộc tính	`ID`	Có
`floodlightActivityTag`	Thẻ hoạt động Floodlight.	thuộc tính	`String`	Có
`agency`	Tên công ty quảng cáo.	thuộc tính	`String`	Có
`agencyId`	Mã đại lý DS.	thuộc tính	`ID`	Có
`advertiser`	Tên nhà quảng cáo.	thuộc tính	`String`	Có
`advertiserId`	Mã nhận dạng nhà quảng cáo DS.	thuộc tính	`ID`	Có
`account`	Tên tài khoản công cụ.	thuộc tính	`String`	Có
`accountId`	Mã tài khoản công cụ DS.	thuộc tính	`ID`	Có
`accountEngineId`	Mã của tài khoản trong tài khoản công cụ bên ngoài.	thuộc tính	`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`.	thuộc tính	`Engine type`	Có
`campaign`	Tên chiến dịch.	thuộc tính	`String`	Có
`campaignId`	Mã chiến dịch DS.	thuộc tính	`ID`	Có
`campaignStatus`	Trạng thái của chiến dịch chứa mặt hàng này.	thuộc tính	`Status`	Có
`adGroup`	Tên nhóm quảng cáo.	thuộc tính	`String`	Có
`adGroupId`	Mã nhóm quảng cáo DS.	thuộc tính	`ID`	Có
`adGroupStatus`	Trạng thái của nhóm quảng cáo chứa mục này.	thuộc tính	`Status`	Có
`keywordId`	Mã từ khoá DS. Giá trị 0 cho biết từ khoá không được phân bổ.	thuộc tính	`ID`	Có
`keywordMatchType`	Kiểu khớp từ khoá: `Broad`, `Exact`, `Phrase` hoặc `Content`.	thuộc tính	`Match type`	Có
`keywordText`	Văn bản từ khoá.	thuộc tính	`String`	Có
`productTargetId`	Mã mục tiêu sản phẩm DS.	thuộc tính	`ID`	Có
`productGroupId`	Mã nhận dạng nhóm sản phẩm được liên kết với lượt chuyển đổi này. Chỉ những lượt chuyển đổi từ chiến dịch mua sắm mới có mã nhóm sản phẩm. Không được sử dụng mã nhóm sản phẩm để tham gia.	thuộc tính	`ID`	Có
`ad`	Tên quảng cáo.	thuộc tính	`String`	Có
`adId`	Mã nhận dạng cho quảng cáo DS. Giá trị 0 cho biết quảng cáo không được phân bổ.	thuộc tính	`ID`	Có
`isUnattributedAd`	Cho biết liệu các chỉ số trong hàng này có 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 không chính xác có thể ngăn DS phân bổ chỉ số cho một quảng cáo.	thuộc tính	`Boolean`	Có
`inventoryAccountId`	Mã tài khoản khoảng không quảng cáo DS chứa sản phẩm được liên kết với lượt chuyển đổi. DS tạo mã này khi bạn liên kết một tài khoản kho hàng trong DS.	thuộc tính	`ID`	Có
`productId`	Mã của sản phẩm được liên kết với lượt chuyển đổi này.	thuộc tính	`String`	Có
`productCountry`	Quốc gia (định dạng ISO 3166) đã đăng ký nguồn cấp dữ liệu kho hàng chứa sản phẩm liên kết với lượt chuyển đổi này.	thuộc tính	`String`	Có
`productLanguage`	Ngôn ngữ (ISO 639-1) của sản phẩm liên kết với lượt chuyển đổi này.	thuộc tính	`String`	Có
`productStoreId`	Cửa hàng trong Quảng cáo kho hàng tại địa phương được liên kết với lượt chuyển đổi. Mã này phải khớp với mã cửa hàng được dùng trong nguồn cấp dữ liệu sản phẩm tại cửa hàng địa phương.	thuộc tính	`String`	Có
`productChannel`	Kênh bán hàng của sản phẩm liên kết với lượt chuyển đổi: `Online` hoặc `Local`.	thuộc tính	`Product channel`	Có
`conversionId`	Mã mà Search Ads 360 tạo cho mỗi lượt chuyển đổi.	thuộc tính	`ID`	Có
`advertiserConversionId`	Đối với lượt chuyển đổi ngoại tuyến, đây là mã do nhà quảng cáo cung cấp. Nếu nhà quảng cáo không chỉ định mã nhận dạng như vậy, thì Search Ads 360 sẽ tạo mã nhận dạng. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng cột conversionId hoặc cột floodlightOrderId tuỳ thuộc vào hướng dẫn của nhà quảng cáo về Floodlight.	thuộc tính	`String`	Có
`conversionType`	Loại lượt chuyển đổi: `Action` hoặc `Transaction`.	thuộc tính	`Conversion type`	Có
`conversionRevenue`	Tổng số tiền từ lượt chuyển đổi.	thuộc tính	`Money`	Có
`conversionQuantity`	Số lượng mặt hàng được ghi lại bằng lượt chuyển đổi, do tham số `qty` xác định. Nhà quảng cáo chịu trách nhiệm tự động điền thông số này (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không thì thông số này sẽ mặc định là 1.	thuộc tính	`Number`	Có
`conversionDate`	Ngày xảy ra lượt chuyển đổi (theo múi giờ của mạng Campaign Manager). Ngày này được dùng để tổng hợp chỉ số lượt chuyển đổi. Ví dụ: khi tổng hợp các hành động cho ngày 1 tháng 5, DS sẽ tính tất cả lượt chuyển đổi hành động có `conversionDate` là ngày 1 tháng 5.	thuộc tính	`Date`	Có
`conversionTimestamp`	Dấu thời gian theo giờ UTC khi lượt chuyển đổi xảy ra.	thuộc tính	`Timestamp`	Có
`conversionLastModifiedTimestamp`	Dấu thời gian theo chuẩn UTC của lần sửa đổi gần đây nhất của lượt chuyển đổi.	thuộc tính	`Timestamp`	Có
`conversionAttributionType`	Lượt chuyển đổi được phân bổ cho: `Visit` hoặc `Keyword+Ad`.	thuộc tính	`Conversion attribution type`	Có
`conversionVisitId`	Mã lượt truy cập DS được phân bổ cho lượt chuyển đổi.	thuộc tính	`ID`	Có
`conversionVisitTimestamp`	Dấu thời gian theo giờ UTC của lượt truy cập được phân bổ cho lượt chuyển đổi.	thuộc tính	`Timestamp`	Có
`conversionVisitExternalClickId`	Một chuỗi duy nhất, cho lượt truy cập được phân bổ lượt chuyển đổi, được chuyển đến trang đích dưới dạng tham số URL `gclid`. Chỉ bật cho những nhà quảng cáo đã tích hợp Conversion API hoặc Google Analytics.	thuộc tính	`String`	Có
`conversionSearchTerm`	Cụm từ tìm kiếm đã dẫn đến lượt chuyển đổi.	thuộc tính	`String`	Có
`floodlightOriginalRevenue`	Doanh thu ban đầu, không thay đổi được liên kết với sự kiện Floodlight (theo đơn vị tiền tệ của báo cáo hiện tại), trước khi sửa đổi chỉ thị về đơn vị tiền tệ của Floodlight.	thuộc tính	`Money`	Có
`floodlightEventRequestString`	Chuỗi yêu cầu Floodlight của lượt chuyển đổi.	thuộc tính	`String`	Có
`floodlightReferrer`	Trang web giới thiệu Floodlight của lượt chuyển đổi.	thuộc tính	`String`	Có
`floodlightOrderId`	Mã đơn đặt hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi.	thuộc tính	`String`	Có
`feedItemId`	Mã của hàng mục trong nguồn cấp dữ liệu liên kết với lượt chuyển đổi này.	thuộc tính	`ID`	Có
`feedId`	Mã của bảng nguồn cấp dữ liệu được liên kết với lượt chuyển đổi này.	thuộc tính	`ID`	Có
`feedType`	Loại nguồn cấp dữ liệu liên kết với lượt chuyển đổi này.	thuộc tính	`Feed type`	Có