Dữ liệu sự kiện chưa qua xử lý về lượt chuyển đổi.
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()).
Bởi vì sự kiện xảy ra vào các ngày cụ thể, nên yêu cầu cho báo cáo này phải chỉ định timeRange. Bạn có thể chỉ định một trong các thông tin sau:
- startDate và endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp không hợp lệ cho sự kiện).
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": "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,
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.
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 . |
phân bổ | Status |
Có |
deviceSegment |
Phân khúc thiết bị mà lượt chuyển đổi được phân bổ cho: Desktop , Mobile , Tablet hoặc Other . |
phân bổ | Device segment |
Có |
floodlightGroup |
Tên nhóm Floodlight. | phân bổ | String |
Có |
floodlightGroupConversionType |
Loại lượt chuyển đổi do hoạt động Floodlight tạo ra trong nhóm này: Action hoặc Transaction . |
phân bổ | Conversion type |
Có |
floodlightGroupId |
Mã nhóm Floodlight DS. | phân bổ | ID |
Có |
floodlightGroupTag |
Thẻ nhóm Floodlight. | phân bổ | String |
Có |
floodlightActivity |
Tên hoạt động Floodlight. | phân bổ | String |
Có |
floodlightActivityId |
Mã hoạt động Floodlight DS. | phân bổ | ID |
Có |
floodlightActivityTag |
Thẻ hoạt động Floodlight. | phân bổ | String |
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ó |
keywordId |
Mã từ khoá DS. Giá trị 0 cho biết từ khoá không được phân bổ. | phân bổ | ID |
Có |
keywordMatchType |
Loại đối sánh từ khóa: Broad , Exact , Phrase hoặc Content . |
phân bổ | Match type |
Có |
keywordText |
Văn bản từ khoá. | phân bổ | String |
Có |
productTargetId |
Mã mục tiêu sản phẩm DS. | phân bổ | ID |
Có |
productGroupId |
Mã 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. Bạn không được dùng mã nhóm sản phẩm để tham gia. | phân bổ | ID |
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ó |
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ó |
inventoryAccountId |
Mã tài khoản khoảng không quảng cáo DS chứa sản phẩm 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. | phân bổ | ID |
Có |
productId |
Mã của sản phẩm liên kết với lượt chuyển đổi này. | phân bổ | String |
Có |
productCountry |
Quốc gia (định dạng ISO 3166) đã đăng ký nguồn cấp dữ liệu kho hàng có chứa sản phẩm liên kết với lượt chuyển đổi này. | phân bổ | 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. | phân bổ | 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. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn. | phân bổ | String |
Có |
productChannel |
Kênh bán hàng của sản phẩm được liên kết với lượt chuyển đổi: Online hoặc Local . |
phân bổ | Product channel |
Có |
conversionId |
Mã nhận dạng mà Search Ads 360 tạo ra cho mỗi lượt chuyển đổi. | phân bổ | 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ột mã nhận dạng như vậy, thì Search Ads 360 sẽ tạo một mã. Đố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 chỉ dẫn của nhà quảng cáo trong Floodlight. | phân bổ | String |
Có |
conversionType |
Loại chuyển đổi: Action hoặc Transaction . |
phân bổ | Conversion type |
Có |
conversionRevenue |
Tổng số tiền từ lượt chuyển đổi. | phân bổ | Money |
Có |
conversionQuantity |
Số lượng mặt hàng mà lượt chuyển đổi ghi lại, do tham số qty xác định. Nhà quảng cáo có trách nhiệm tự động điền thông số (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không, giá trị mặc định sẽ là 1. | phân bổ | Number |
Có |
conversionDate |
Ngày (theo múi giờ của mạng Campaign Manager) khi diễn ra lượt chuyển đổi. Ngày này được dùng để tổng hợp các chỉ số về lượt chuyển đổi. Ví dụ: khi DS tổng hợp các hành động vào ngày 1 tháng 5, hệ thống này sẽ tính tất cả các lượt chuyển đổi hành động có conversionDate là ngày 1 tháng 5. |
phân bổ | Date |
Có |
conversionTimestamp |
Dấu thời gian UTC khi lượt chuyển đổi xảy ra. | phân bổ | Timestamp |
Có |
conversionLastModifiedTimestamp |
Dấu thời gian UTC của lần sửa đổi gần đây nhất của lượt chuyển đổi. | phân bổ | Timestamp |
Có |
conversionAttributionType |
Đối tượng đóng góp của lượt chuyển đổi: Visit hoặc Keyword+Ad . |
phân bổ | Conversion attribution type |
Có |
conversionVisitId |
Mã lượt truy cập DS mà lượt chuyển đổi được phân bổ. | phân bổ | ID |
Có |
conversionVisitTimestamp |
Dấu thời gian UTC của lượt truy cập mà lượt chuyển đổi được phân bổ. | phân bổ | Timestamp |
Có |
conversionVisitExternalClickId |
Một chuỗi riêng biệt dành cho lượt truy cập mà lượt chuyển đổi được phân bổ, được truyền đến trang đích dưới dạng tham số URL gclid. Chỉ bật cho những nhà quảng cáo có tích hợp API chuyển đổi hoặc Google Analytics. | phân bổ | String |
Có |
conversionSearchTerm |
Cụm từ tìm kiếm đã dẫn đến lượt chuyển đổi. | phân bổ | 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 chỉ định về đơn vị tiền tệ của Floodlight sửa đổi. | phân bổ | Money |
Có |
floodlightEventRequestString |
Chuỗi yêu cầu Floodlight của lượt chuyển đổi. | phân bổ | String |
Có |
floodlightReferrer |
Trang web liên kết giới thiệu Floodlight của lượt chuyển đổi. | phân bổ | String |
Có |
floodlightOrderId |
Mã đơn hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi. | phân bổ | 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. | phân bổ | ID |
Có |
feedId |
Mã của bảng nguồn cấp dữ liệu liên kết với lượt chuyển đổi này. | phân bổ | ID |
Có |
feedType |
Loại nguồn cấp dữ liệu được liên kết với lượt chuyển đổi này. | phân bổ | Feed type |
Có |