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 cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Danh sách 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ị	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`	Biểu thị sự đồng ý đối với các lựa chọn ưu tiên về 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. Các giá trị được chấp nhận là: GRANTED: Trạng thái đồng ý mong muốn là cho phép. Đọc lựa chọn ưu tiên về CPS trong phần cài đặt GTE. DENIED: Trạng thái đồng ý bạn muốn dùng là từ chối; Danh sách CPS trống.
`conversion[].advertiserId`	`long`	Mã nhận dạng nhà quảng cáo DS.
`conversion[].agencyId`	`long`	Mã công ty quảng cáo DS.
`conversion[].attributionModel`	`string`	Chỉ dành cho các 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`": một 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 của 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 một 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ã nhận dạng 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 chỉ dẫn Floodlight của nhà quảng cáo.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Thời gian sửa đổi lượt chuyển đổi gần đây nhất, tính theo thời gian bắt đầu của hệ thống (mili giây) 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) UTC.
`conversion[].countMillis`	`long`	Chỉ dành cho các 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`	Mã tiêu chí (từ khóa) DS.
`conversion[].currencyCode`	`string`	Mã đơn vị tiền tệ cho doanh thu của lượt chuyển đổi. Phải theo đị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ể được 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ố tuỳ 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 sẽ đượ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 chấp nhận là: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	ID mà DoubleClick Search tạo cho mỗi 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 do DS tạo và sử dụng để xác định riêng biệt tài khoản kho hàng chứa sản phẩm.
`conversion[].productCountry`	`string`	Quốc gia đăng ký nguồn cấp dữ liệu Merchant Center có 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ữ được đăng ký cho nguồn cấp dữ liệu Merchant Center có 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 phần triệu (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" nhập "10000000" (10 triệu) yêu cầu của bạn.	có thể ghi
`conversion[].segmentationId`	`long`	Giá trị nhận dạng phân đoạn bằng số (ví dụ: mã hoạt động Floodlight 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 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, nghĩa 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 chấp nhận là: "`ACTIVE`" "`DELETED`": (Không dùng nữa) "`REMOVED`"	có thể ghi
`conversion[].storeId`	`string`	Mã của cửa hàng tại địa phương nơi quảng cáo sản phẩm. Chỉ áp dụng khi kênh là "`local`".
`conversion[].type`	`string`	Loại chuyển đổi, nghĩa 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 về tiền, còn lượt chuyển đổi `TRANSACTION` là hành động có giá trị định lượng về tiền. Ví dụ: lượt đăng ký 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 chấp nhận là: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Xác định tài nguyên này là tài nguyên ConversionList. Giá trị: chuỗi cố định `doubleclicksearch#conversionList`.

Phương thức

nhận: Truy xuất danh sách các lượt chuyển đổi từ tài khoản công cụ tìm kiếm DoubleClick.
getByCustomerId: Lấy danh sách các lượt chuyển đổi qua 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.