REST Resource: accounts.conversionSources

Tài nguyên: ConversionSource

Biểu thị một nguồn chuyển đổi thuộc quyền sở hữu của Tài khoản người bán. Một tài khoản người bán có thể có tối đa 200 nguồn chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Được Content API tạo khi tạo một ConversionSource mới. Định dạng: [a-z]{4}:.+ Bốn ký tự trước dấu hai chấm đại diện cho loại nguồn chuyển đổi. Nội dung sau dấu hai chấm thể hiện mã nhận dạng của nguồn chuyển đổi trong loại đó. Mã của hai nguồn chuyển đổi khác nhau có thể giống nhau giữa các loại. Các tiền tố loại sau đây được hỗ trợ: – galk: Đối với các nguồn GoogleAnalyticsLink. – mcdn: Đối với các nguồn MerchantCenterDestination.
state

enum (State)

Chỉ có đầu ra. Trạng thái hiện tại của nguồn chuyển đổi này. Không thể chỉnh sửa thông qua API.
expireTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm nguồn chuyển đổi đã lưu trữ bị xoá vĩnh viễn và không thể huỷ xoá được nữa.
controller

enum (Controller)

Chỉ có đầu ra. Trình điều khiển của nguồn chuyển đổi.
Trường hợp hợp nhất source_data. Bắt buộc. Dữ liệu nguồn chuyển đổi dành riêng cho từng loại nguồn. source_data chỉ có thể là một trong những giá trị sau:
merchantCenterDestination

object (MerchantCenterDestination)

Nguồn chuyển đổi thuộc loại "Đích đến của thẻ Merchant Center".

AttributionSettings

Biểu thị chế độ cài đặt mô hình phân bổ cho các nguồn chuyển đổi nhận dữ liệu phân bổ trước.

Biểu diễn dưới dạng JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Trường
attributionLookbackWindowDays

integer

Bắt buộc. Giai đoạn xem lại (tính bằng ngày) dùng để phân bổ trong nguồn này. Các giá trị được hỗ trợ là 7, 30, 40.
attributionModel

enum (AttributionModel)

Bắt buộc. Mô hình phân bổ.
conversionType[]

object (ConversionType)

Không thể thay đổi. Danh sách không theo thứ tự. Danh sách các loại chuyển đổi mà một sự kiện chuyển đổi có thể được phân loại. Loại "giao dịch mua" chuẩn sẽ tự động được tạo nếu danh sách này trống tại thời điểm tạo.

AttributionModel

Mô hình phân bổ được sử dụng cho nguồn này. Chúng tôi hỗ trợ cùng một bộ mô hình do Google Analytics 4 cung cấp, như mô tả trong bài viết: https://support.google.com/analytics/answer/10596866.

Enum
ATTRIBUTION_MODEL_UNSPECIFIED Mô hình không xác định.
CROSS_CHANNEL_LAST_CLICK Mô hình Lượt nhấp cuối cùng trên nhiều kênh.
ADS_PREFERRED_LAST_CLICK Mô hình Ưu tiên lượt nhấp cuối cùng trên Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Mô hình Dữ liệu trên nhiều kênh.
CROSS_CHANNEL_FIRST_CLICK Mô hình Lượt nhấp đầu tiên trên nhiều kênh.
CROSS_CHANNEL_LINEAR Mô hình Tuyến tính trên nhiều kênh.
CROSS_CHANNEL_POSITION_BASED Mô hình Dựa trên vị trí trên nhiều kênh.
CROSS_CHANNEL_TIME_DECAY Mô hình Mức giảm dựa trên thời gian trên nhiều kênh.

ConversionType

Thông báo thể hiện một loại sự kiện chuyển đổi

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "report": boolean
}
Trường
name

string

Chỉ có đầu ra. Tên sự kiện chuyển đổi, vì ứng dụng sẽ báo cáo tên này.
report

boolean

Chỉ có đầu ra. Lựa chọn cho biết liệu loại này có được đưa vào báo cáo Merchant Center hay không.

MerchantCenterDestination

Bạn có thể sử dụng nguồn "Đích đến Merchant Center" để gửi trực tiếp các sự kiện chuyển đổi từ một cửa hàng trực tuyến bằng thẻ Google đến tài khoản Merchant Center nơi tạo nguồn.

Biểu diễn dưới dạng JSON 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Trường
destination

string

Chỉ có đầu ra. Mã đích đến Merchant Center.
attributionSettings

object (AttributionSettings)

Bắt buộc. Chế độ cài đặt mô hình phân bổ đang được sử dụng cho Đích đến Merchant Center.
displayName

string

Bắt buộc. Tên hiển thị do người bán chỉ định cho đích đến. Đây là tên giúp xác định nguồn chuyển đổi trong giao diện người dùng Merchant Center. Giới hạn ở 64 ký tự.
currencyCode

string

Bắt buộc. Mã tiền tệ gồm 3 chữ cái (theo tiêu chuẩn ISO 4217). Mã đơn vị tiền tệ xác định đơn vị tiền tệ mà các lượt chuyển đổi được gửi đến đích đến này sẽ được báo cáo trong Merchant Center.

Tiểu bang

Biểu thị trạng thái của nguồn chuyển đổi.

Enum
STATE_UNSPECIFIED Nguồn chuyển đổi có trạng thái chưa xác định.
ACTIVE Nguồn chuyển đổi hoạt động đầy đủ.
ARCHIVED Nguồn chuyển đổi đã được lưu trữ trong 30 ngày qua và hiện không hoạt động. Có thể khôi phục bằng phương thức huỷ xoá.
PENDING Quá trình tạo nguồn chuyển đổi đã bắt đầu nhưng chưa hoàn tất.

Bộ điều khiển

Pháp nhân kiểm soát nguồn chuyển đổi.

Enum
CONTROLLER_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
MERCHANT Do Người bán sở hữu Nguồn chuyển đổi kiểm soát.
YOUTUBE_AFFILIATES Do chương trình Liên kết của YouTube kiểm soát.

Phương thức

create

 Tạo nguồn chuyển đổi mới.

delete

 Lưu trữ một nguồn chuyển đổi hiện có.

get

 Tìm nạp nguồn chuyển đổi.

list

 Truy xuất danh sách các nguồn chuyển đổi mà phương thức gọi có quyền truy cập.

patch

 Cập nhật thông tin của một nguồn chuyển đổi hiện có.

undelete

 Bật lại một nguồn chuyển đổi đã lưu trữ.