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. 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. Do 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 thể hiện 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 thuộc 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. Sau đây là các tiền tố loại được hỗ trợ: – galk: Dành cho nguồn GoogleAnalyticsLink. – mcdn: Dành cho các nguồn Merchant CenterDestination.

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 chỉnh sửa được thông qua API.

expireTime

string (Timestamp format)

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

controller

enum (Controller)

Chỉ có đầu ra. Đơn vị kiểm soát nguồn chuyển đổi.

Trường kết 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 khác nhau. source_data chỉ có thể là một trong những trạng thái sau đây:
merchantCenterDestination

object (MerchantCenterDestination)

Nguồn chuyển đổi của 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. Khoảng thời gian xem lại (tính bằng ngày) được dùng cho mô hình 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)

Bất biến. Danh sách không theo thứ tự. Danh sách các loại chuyển đổi khác nhau có thể được phân loại là một sự kiện chuyển đổi. Một "giao dịch mua" 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 bộ 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 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 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 biểu thị các 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, do khách hàng báo cáo.

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 trong Merchant Center hay không.

MerchantCenterDestination

"Đích đến trong Merchant Center" nguồn dữ liệu có thể được dùng để gửi sự kiện chuyển đổi từ một cửa hàng trực tuyến bằng thẻ Google đến thẳng tài khoản Merchant Center mà bạn đã 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 của 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 của 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à lượt chuyển đổi được gửi đến điểm đế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 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 phương pháp hủy xóa.
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

Thực thể kiểm soát nguồn chuyển đổi.

Enum
CONTROLLER_UNSPECIFIED Giá trị mặc định. Giá trị này chưa đượ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 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ữ.