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 các phương thức get và getByCustomerId trong Search Ads 360 Conversion API sẽ ngừng hoạt động trong quý 3 năm 2025. Để tiếp tục truy cập vào dữ liệu lượt chuyển đổi, bạn phải tạo báo cáo bằng tài nguyên lượt chuyển đổi thông qua Search Ads 360 Reporting API mới. Xem thêm thông tin chi tiết tại đây.

Các chức năng còn lại của API lượt chuyển đổi Search Ads 360 sẽ tiếp tục được hỗ trợ.

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.

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

Biểu thị 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,
      "sessionAttributesEncoded": bytes
    }
  ]
}

Tên tài sản	Giá trị	Mô tả	Ghi chú
`conversion[]`	`list`	Các 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ã nhận dạng cho 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à: ĐÃ CẤP: Trạng thái đồng ý mà người dùng mong muốn là đồng ý. Đọc các lựa chọn ưu tiên về CPS từ phần cài đặt GTE. BỊ TỪ CHỐI: Trạng thái đồng ý mà người dùng mong muốn là từ chối; danh sách CPS đang trống. Các giá trị được chấp nhận là: "`DENIED`" "`GRANTED`" "`UNKNOWN`"
`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 của 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 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 sẽ 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 và 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ả 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 của nhà quảng cáo trên Floodlight.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	Thời gian sửa đổi lượt chuyển đổi gần đây nhất, tính theo mili giây theo múi giờ UTC.
`conversion[].conversionTimestamp`	`unsigned long`	Thời gian diễn ra lượt chuyển đổi, tính bằng mili giây theo múi giờ UTC.
`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`	Mã tiêu chí (từ khoá) DS.
`conversion[].currencyCode`	`string`	Mã đơn vị tiền tệ của doanh thu từ lượt chuyển đổi. Phải ở định dạng bảng chữ cái ISO 4217 (3 ký tự).	writable
`conversion[].customDimension[]`	`list`	Phương diện tuỳ chỉnh cho lượt chuyển đổi. Bạn có thể dùng phương diện này để 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ị dạng số của chỉ số tuỳ 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 Search Ads 360 mới.
`conversion[].deviceType`	`string`	Loại thiết bị xảy 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`	Mã mà DoubleClick Search tạo 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 đặt 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 duy nhất tài khoản kho hàng chứa sản phẩm.
`conversion[].productCountry`	`string`	Quốc gia đã đăng ký cho 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ữ được đă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.	writable
`conversion[].revenueMicros`	`long`	Số tiền doanh thu của lượt chuyển đổi `TRANSACTION` này, tính bằng micro (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) trong yêu cầu của bạn.	writable
`conversion[].segmentationId`	`long`	Giá trị nhận dạng phân đoạn dạ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[].sessionAttributesEncoded`	`bytes`	Thuộc tính phiên cho sự kiện, được biểu thị dưới dạng chuỗi JSON được mã hoá base64. Nội dung phải do thư viện do Google cung cấp tạo.
`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 DELETED (ĐÃ XOÁ) không còn được dùng nữa. Các giá trị được chấp nhận là: "`ACTIVE`" "`DELETED`": (Không dùng nữa) "`REMOVED`"	writable
`conversion[].storeId`	`string`	Mã của cửa hàng đị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 lượt chuyển đổi, tức là `ACTION` hoặc `TRANSACTION`. Lượt chuyển đổi `ACTION` là một hành động của người dùng không có giá trị định lượng được bằng tiền, trong khi lượt chuyển đổi `TRANSACTION` là một hành động có giá trị định lượng được bằng 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 đây là tài nguyên ConversionList. Giá trị: chuỗi cố định `doubleclicksearch#conversionList`.

Phương thức

get: Truy xuất danh sách lượt chuyển đổi từ tài khoản công cụ DoubleClick Search.
getByCustomerId: Truy xuất danh sách lượt chuyển đổi từ tài khoản công cụ DoubleClick Search bằng mã khách hàng mới của Search Ads 360.
chèn: Chèn một lô lượt chuyển đổi mới vào DoubleClick Search.
update: Cập nhật một lô lượt chuyển đổi trong DoubleClick Search.
updateAvailability: Cập nhật tình trạng có sẵn của một lô hoạt động Floodlight trong DoubleClick Search.

Conversion Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Biểu thị tài nguyên

Phương thức

Conversion