REST Resource: accounts.conversionSources

Tài nguyên: ConversionSource

Đại diện cho nguồn chuyển đổi do tài khoản người bán sở hữu. 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. Do Content API tạo khi tạo ConversionSource mới. Định dạng: [a-z]{4}:.+ Bốn ký tự trước dấu hai chấm biểu thị loại nguồn chuyển đổi. Nội dung sau dấu hai chấm biểu thị 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 trên các loại khác nhau. Các tiền tố loại sau đượ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 còn có sẵn để huỷ xoá.
controller

enum (Controller)

Chỉ có đầu ra. Trình kiểm soát nguồn chuyển đổi.
Trường hợp 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 trạng thái 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 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 theo ngày) được dùng cho hoạt độ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 có thể phân loại sự kiện chuyển đổi. Loại "purchase" tiêu chuẩn sẽ được tạo tự động 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 tập hợp mô hình do Google Analytics 4 cung cấp, như mô tả trong: https://support.google.com/analytics/answer/10596866.

Enum
ATTRIBUTION_MODEL_UNSPECIFIED Mô hình chưa được chỉ đị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 theo hướng 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 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ì khách hàng sẽ báo cáo sự kiện này.
report

boolean

Chỉ có đầu ra. Lựa chọn cho biết liệu loại đó 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 của Merchant Center" để gửi sự kiện chuyển đổi từ một cửa hàng trực tuyến bằng cách sử dụng thẻ Google trực tiếp đến tài khoản Merchant Center đã 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 trong 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 trong Merchant Center.
displayName

string

Bắt buộc. Tên hiển thị do người bán chỉ định cho vị trí xuất hiện. Đây là tên xác định nguồn chuyển đổi trong giao diện người dùng Merchant Center. Gồm tối đa 64 ký tự.
currencyCode

string

Bắt buộc. Mã đơn vị tiền tệ gồm ba chữ cái (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 vị trí xuất hiện này sẽ được báo cáo trong Merchant Center.

Tiểu bang

Thể hiện 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 có đầy đủ chức năng.
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 cách sử dụng phương pháp huỷ xoá.
PENDING Quá trình tạo nguồn chuyển đổi đã bắt đầu nhưng chưa hoàn tất.

Trình điều khiển

Thực thể 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ữ nguồn chuyển đổi hiện có.

get

 Tìm nạp một 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 nguồn chuyển đổi đã lưu trữ.