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.