API Báo cáo Search Ads 360 cũ sẽ ngừng hoạt động và ngừng hoạt động từ ngày 30 tháng 6 năm 2024. Xin lưu ý rằng API Lượt chuyển đổi Search Ads 360 không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ. Mọi hoạt động phát triển báo cáo mới đều phải sử dụng API Báo cáo Search Ads 360 mới.

Kể từ tháng 4 năm 2024, hệ thống sẽ trả về lỗi supportedApiVersion trong khi yêu cầu báo cáo. Xem chi tiết tại đây.

Bạn cũng nên di chuyển mọi hoạt động triển khai Search Ads 360 hiện có sang API mới. Hãy xem Bắt đầu và Hướng dẫn di chuyển API Báo cáo Search Ads 360 mới để biết thêm thông tin.

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

Conversion

Tài nguyên lượt chuyển đổi có các phương thức cho phép người dùng tạo, sửa đổi và truy xuất hàng loạt lượt chuyển đổi Floodlight.

Để biết danh sách các phương thức của tài nguyên này, hãy xem ở cuối trang này.

Biểu thị tài nguyên

Danh sách các lượt chuyển đổi.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
`conversion[]`	`list`	Lượt chuyển đổi đang được yêu cầu.
`conversion[].adGroupId`	`long`	Mã nhóm quảng cáo DS.
`conversion[].adId`	`long`	Mã quảng cáo DS.
`conversion[].adUserDataConsent`	`string`	Thể hiện sự đồng ý đối với các lựa chọn ưu tiên về các dịch vụ nền tảng cốt lõi (CPS) trong phần cài đặt. Không có giá trị mặc định. Giá trị được chấp nhận là: GRANTED: Trạng thái đồng ý mong muốn là đồng ý. Đọc các lựa chọn ưu tiên về CPS trong phần cài đặt GTE. TỪ CHỐI: Trạng thái đồng ý mong muốn là từ chối; danh sách CPS đang trống.
`conversion[].advertiserId`	`long`	Mã nhận dạng nhà quảng cáo DS.
`conversion[].agencyId`	`long`	Mã đại lý DS.
`conversion[].attributionModel`	`string`	Chỉ dành cho nhà quảng cáo sau khi liên hệ với bộ phận hỗ trợ khách hàng của DoubleClick Search.
`conversion[].campaignId`	`long`	Mã chiến dịch DS.
`conversion[].channel`	`string`	Kênh bán hàng cho sản phẩm. Các giá trị được chấp nhận là: "`local`": cửa hàng thực tế "`online`": một cửa hàng trực tuyến
`conversion[].clickId`	`string`	Mã lượt nhấp DS cho lượt chuyển đổi.
`conversion[].conversionId`	`string`	Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo cung cấp mã này. Nhà quảng cáo có thể chỉ định bất kỳ mã nhận dạng nào có ý nghĩa đối với họ. Mỗi lượt chuyển đổi trong yêu cầu phải chỉ định một mã nhận dạng duy nhất, đồng thời, tổ hợp mã và dấu thời gian phải là duy nhất trong số tất cả các lượt chuyển đổi của nhà quảng cáo. Đối với lượt chuyển đổi trực tuyến, DS sẽ sao chép `dsConversionId` hoặc `floodlightOrderId` vào tài sản này tuỳ thuộc vào hướng dẫn về Floodlight của nhà quảng cáo.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Thời gian mà lượt chuyển đổi được sửa đổi lần gần đây nhất, tính theo thời gian bắt đầu của hệ thống (mili giây) theo giờ UTC.
`conversion[].conversionTimestamp`	`unsigned long`	Thời gian diễn ra lượt chuyển đổi, tính theo thời gian bắt đầu của hệ thống (mili giây).
`conversion[].countMillis`	`long`	Chỉ dành cho nhà quảng cáo sau khi liên hệ với bộ phận hỗ trợ khách hàng của DoubleClick Search.
`conversion[].criterionId`	`long`	ID (từ khóa) tiêu chí DS.
`conversion[].currencyCode`	`string`	Mã đơn vị tiền tệ cho doanh thu của lượt chuyển đổi. Phải ở định dạng bảng chữ cái ISO 4217 (3 ký tự).	có thể ghi
`conversion[].customDimension[]`	`list`	Các phương diện tuỳ chỉnh cho lượt chuyển đổi (có thể dùng để lọc dữ liệu trong báo cáo).
`conversion[].customDimension[].name`	`string`	Tên phương diện tuỳ chỉnh.
`conversion[].customDimension[].value`	`string`	Giá trị phương diện tuỳ chỉnh.
`conversion[].customMetric[]`	`list`	Chỉ số tuỳ chỉnh cho lượt chuyển đổi.
`conversion[].customMetric[].name`	`string`	Tên chỉ số tùy chỉnh.
`conversion[].customMetric[].value`	`double`	Giá trị số của chỉ số tùy chỉnh.
`conversion[].customerId`	`string`	Mã khách hàng Search Ads 360 mới. Phải là tài khoản khách hàng. Khi bạn đặt trường này, tất cả các trường mã nhận dạng khác phải được đặt thành mã nhận dạng trong Search Ads 360 mới.
`conversion[].deviceType`	`string`	Loại thiết bị diễn ra lượt chuyển đổi. Các giá trị có thể chấp nhận là: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	Mã nhận dạng mà DoubleClick Search tạo ra cho mỗi lượt chuyển đổi.
`conversion[].engineAccountId`	`long`	Mã tài khoản công cụ DS.
`conversion[].floodlightOrderId`	`string`	Mã đơn hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi.
`conversion[].inventoryAccountId`	`long`	Mã nhận dạng mà DS tạo và sử dụng để xác định riêng tài khoản kho hàng có chứa sản phẩm.
`conversion[].productCountry`	`string`	Quốc gia đã đăng ký nguồn cấp dữ liệu Merchant Center chứa sản phẩm. Sử dụng mã ISO 3166 để chỉ định quốc gia.
`conversion[].productGroupId`	`long`	Mã nhóm sản phẩm DS.
`conversion[].productId`	`string`	Mã sản phẩm (SKU).
`conversion[].productLanguage`	`string`	Ngôn ngữ đăng ký cho nguồn cấp dữ liệu Merchant Center chứa sản phẩm. Sử dụng mã ISO 639 để chỉ định ngôn ngữ.
`conversion[].quantityMillis`	`long`	Số lượng lượt chuyển đổi này, tính bằng mili giây.	có thể ghi
`conversion[].revenueMicros`	`long`	Số tiền doanh thu của lượt chuyển đổi `TRANSACTION` này, tính bằng micrô giây (giá trị nhân với 1000000, không có số thập phân). Ví dụ: để chỉ định giá trị doanh thu là "10", hãy nhập "10000000" (10 triệu) vào yêu cầu của bạn.	có thể ghi
`conversion[].segmentationId`	`long`	Giá trị nhận dạng phân đoạn dạng số (ví dụ: Mã hoạt động Floodlight trong DoubleClick Search).
`conversion[].segmentationName`	`string`	Giá trị nhận dạng phân đoạn thân thiện (ví dụ: tên hoạt động Floodlight trong DoubleClick Search).
`conversion[].segmentationType`	`string`	Loại phân đoạn của lượt chuyển đổi này (ví dụ: `FLOODLIGHT`). Các giá trị được chấp nhận là: "`FLOODLIGHT`"
`conversion[].state`	`string`	Trạng thái của lượt chuyển đổi, tức là `ACTIVE` hoặc `REMOVED`. Lưu ý: trạng thái ĐÃ XÓA không được dùng nữa. Các giá trị có thể chấp nhận là: "`ACTIVE`" "`DELETED`": (Không dùng nữa) "`REMOVED`"	có thể ghi
`conversion[].storeId`	`string`	Mã cửa hàng tại địa phương nơi sản phẩm được quảng cáo. Chỉ áp dụng khi kênh là "`local`".
`conversion[].type`	`string`	Loại chuyển đổi, tức là `ACTION` hoặc `TRANSACTION`. Lượt chuyển đổi `ACTION` là hành động của người dùng không có giá trị định lượng có thể kiếm tiền, còn lượt chuyển đổi `TRANSACTION` là hành động có giá trị có thể định lượng kiếm tiền. Ví dụ: lượt đăng ký tham gia danh sách email (`ACTION`) so với lượt mua hàng thương mại điện tử (`TRANSACTION`). Các giá trị có thể chấp nhận là: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Xác định đây là tài nguyên ConversionList. Giá trị: chuỗi cố định `doubleclicksearch#conversionList`.

Phương thức

nhận: Lấy danh sách lượt chuyển đổi từ tài khoản công cụ DoubleClick Search.
getByCustomerId: Lấy danh sách lượt chuyển đổi từ tài khoản công cụ DoubleClick Search bằng cách sử dụng mã khách hàng Search Ads 360 mới.
chèn: Chèn một loạt các lượt chuyển đổi mới vào DoubleClick Search.
cập nhật: Cập nhật một loạt các lượt chuyển đổi trong DoubleClick Search.
updateAvailability: Cập nhật khả năng sử dụng của một loạt hoạt động Floodlight trong DoubleClick Search.