Dữ liệu sự kiện thô về các lượt chuyển đổi.
Chỉ có thể trả về báo cáo này bằng một yêu cầu không đồng bộ (nghĩa là thông qua phương thức Reports.request()).
Do các 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 những mục sau:
- startDate và endDate.
- ThayMetricsMetricsTimestamp (ChangeAttributes VìTimestamp không hợp lệ đối với các 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 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 trong bảng dưới đây.
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 phần "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 đoạn thiết bị mà lượt chuyển đổi được phân bổ: 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 chuyển đổi do hoạt động Floodlight tạo trong nhóm này: 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 Floodlight của DS. | thuộc tính | ID |
Có |
floodlightActivityTag |
Thẻ hoạt động Floodlight. | thuộc tính | String |
Có |
agency |
Tên đại lý. | thuộc tính | String |
Có |
agencyId |
ID đại lý DS. | thuộc tính | ID |
Có |
advertiser |
Tên nhà quảng cáo. | thuộc tính | String |
Có |
advertiserId |
ID 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ục 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 |
ID từ khóa DS. Giá trị 0 cho biết từ khoá chưa được phân bổ. | thuộc tính | ID |
Có |
keywordMatchType |
Loại so khớp từ khóa: 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 |
ID mục tiêu sản phẩm DS. | thuộc tính | 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. | thuộc tính | ID |
Có |
ad |
Tên quảng cáo. | thuộc tính | String |
Có |
adId |
ID quảng cáo DS. Giá trị 0 cho biết quảng cáo chưa đượ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ụ: quảng cáo có định dạng không được hỗ trợ hoặc URL máy chủ lượt nhấp không chính xác có thể ngăn DS phân bổ các chỉ số cho quảng cáo. | thuộc tính | Boolean |
Có |
inventoryAccountId |
Mã tài khoản kho hàng 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 tài khoản khoảng không quảng cáo trong DS. | thuộc tính | ID |
Có |
productId |
Mã 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ó |
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. | 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 quan đến lượt chuyển đổi. Mã này phải khớp với mã cửa hàng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn. | thuộc tính | String |
Có |
productChannel |
Kênh bán sản phẩm được liên kết với lượt chuyển đổi: Online hoặc Local. |
thuộc tính | Product channel |
Có |
conversionId |
Mã nhận dạng 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 đó, Search Ads 360 sẽ tạo mã đó. Đối với lượt chuyển đổi trực tuyến, cột này bằng cột conversionId hoặc cột FloodlightOrderId, tuỳ thuộc vào hướng dẫn của Floodlight của nhà quảng cáo. | thuộc tính | String |
Có |
conversionType |
Loại 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 các mục được ghi lại bởi chuyển đổi, như được xác định bởi thông số qty. Nhà quảng cáo chịu 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, nhà quảng cáo sẽ mặc định đặt giá trị là 1. | thuộc tính | Number |
Có |
conversionDate |
Ngày, theo múi giờ trong mạng Campaign Manager, thời điểm xảy ra lượt chuyển đổi. Ngày này được dùng để tổng hợp chỉ số chuyển đổi. Ví dụ: khi tổng hợp các hành động vào 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 UTC khi lượt chuyển đổi xảy ra. | thuộc tính | Timestamp |
Có |
conversionLastModifiedTimestamp |
Dấu thời gian UTC của sửa đổi gần đây nhất của 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 mà lượt chuyển đổi được phân bổ. | thuộc tính | 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ổ. | thuộc tính | Timestamp |
Có |
conversionVisitExternalClickId |
Một chuỗi duy nhất cho lượt truy cập mà lượt chuyển đổi được phân bổ, được chuyển đến trang đích dưới dạng tham số URL gclid. Chỉ được bật cho các nhà quảng cáo tích hợp API chuyển đổi hoặc tích hợp 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 (bằng đơn vị tiền tệ của báo cáo hiện tại), trước khi sửa đổi hướng dẫn về đơn vị tiền tệ 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 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 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 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ó |