REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Tài nguyên: SKAdNetworkConvertValueSchema

Giản đồ giá trị lượt chuyển đổi SKAdNetwork của một luồng iOS.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của giản đồ. Đây sẽ là phần tử con của CHỈ một luồng iOS và có thể có tối đa một luồng con như vậy trong một luồng iOS. Định dạng: thuộc tính/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Bắt buộc. Chế độ cài đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại đầu tiên. Các giá trị này khác với các giá trị cho cửa sổ đăng lại 2 và 3 ở chỗ chúng chứa đoạn mã "Chi tiết" giá trị chuyển đổi chi tiết (giá trị số).

Bạn phải đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại này. Các cửa sổ khác là không bắt buộc và có thể kế thừa chế độ cài đặt của cửa sổ này nếu bạn không đặt hoặc tắt chế độ này.
postbackWindowTwo

object (PostbackWindow)

Chế độ cài đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại thứ hai.

Bạn chỉ nên định cấu hình trường này nếu cần xác định các giá trị lượt chuyển đổi khác nhau cho khoảng thời gian đăng lại này.

Nếu bạn đặt enable_postback_window_settings thành false cho cửa sổ đăng lại này, thì các giá trị của postbackWindowOne sẽ được sử dụng.
postbackWindowThree

object (PostbackWindow)

Chế độ cài đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại thứ ba.

Bạn chỉ nên đặt trường này nếu người dùng chọn xác định các giá trị lượt chuyển đổi khác nhau cho khoảng thời gian đăng lại này. Cho phép định cấu hình cửa sổ 3 mà không cần đặt cửa sổ 2. Trong trường hợp cửa sổ 1 và 2 chế độ cài đặt được đặt và enable_postback_window_settings cho cửa sổ đăng lại này được đặt thành false, giản đồ sẽ kế thừa các chế độ cài đặt của postbackWindowTwo.
applyConversionValues

boolean

Nếu được bật, SDK GA sẽ đặt giá trị lượt chuyển đổi bằng cách sử dụng định nghĩa giản đồ này và giản đồ sẽ được xuất sang bất kỳ tài khoản Google Ads nào được liên kết với tài sản này. Nếu bạn tắt chế độ này, SDK GA sẽ không tự động đặt giá trị lượt chuyển đổi và giản đồ sẽ không được xuất sang Google Ads.

PostbackWindow

Chế độ cài đặt cho khoảng thời gian đăng lại lượt chuyển đổi SKAdNetwork.

Biểu diễn dưới dạng JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Trường
conversionValues[]

object (ConversionValues)

Thứ tự của trường lặp lại sẽ được dùng để ưu tiên chế độ cài đặt giá trị lượt chuyển đổi. Những mục được lập chỉ mục thấp hơn sẽ được ưu tiên cao hơn. Chế độ cài đặt giá trị lượt chuyển đổi đầu tiên có giá trị là true sẽ được chọn. Trường này phải có ít nhất một mục nhập nếu enable_postback_window_settings được đặt thành true. Tài sản này có thể có tối đa 128 mục nhập.
postbackWindowSettingsEnabled

boolean

Nếu enable_postback_window_settings là true, thì bạn phải điền giá trị conversionValue và sẽ sử dụng giá trị này để xác định thời điểm và cách thức đặt Giá trị lượt chuyển đổi trên thiết bị khách, cũng như xuất giản đồ sang các tài khoản Google Ads đã liên kết. Nếu đặt là false, thì các chế độ cài đặt đó sẽ không được sử dụng nhưng được giữ lại phòng trường hợp có thể sử dụng trong tương lai. Điều này phải luôn đúng đối với postbackWindowOne.

ConversionValues

Chế độ cài đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại cho giản đồ giá trị lượt chuyển đổi SKAdNetwork.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Trường
displayName

string

Tên hiển thị của giá trị lượt chuyển đổi SKAdNetwork. Độ dài tối đa cho phép của tên hiển thị là 50 đơn vị mã UTF-16.
coarseValue

enum (CoarseValue)

Bắt buộc. Giá trị lượt chuyển đổi chi tiết.

Giá trị này không đảm bảo là duy nhất.
eventMappings[]

object (EventMapping)

Các điều kiện sự kiện phải được đáp ứng để đạt được Giá trị chuyển đổi này. Các điều kiện trong danh sách này được kết hợp bằng toán tử AND. Bài dự thi phải có tối thiểu 1 mục nhập và tối đa 3 mục nhập, nếu cửa sổ đăng lại được bật.
lockEnabled

boolean

Nếu đúng, SDK sẽ khoá giá trị lượt chuyển đổi này trong khoảng thời gian đăng lại hiện tại.
fineValue

integer

Giá trị lượt chuyển đổi chi tiết. Điều này chỉ áp dụng cho khoảng thời gian đăng lại đầu tiên. Giá trị hợp lệ của nó là [0,63], bao gồm cả hai. Nó phải được đặt cho cửa sổ đăng lại 1 và không được đặt cho cửa sổ đăng lại 2 & 3. Giá trị này không đảm bảo là duy nhất.

Nếu cấu hình cho cửa sổ đăng lại đầu tiên được sử dụng lại cho cửa sổ đăng lại thứ hai hoặc thứ ba, trường này sẽ không có hiệu lực.

CoarseValue

Giá trị lượt chuyển đổi thô được đặt trên lệnh gọi SDK updatePostbackConversionValue khi đáp ứng các điều kiện ConversionValues.event_mappings. Để biết thêm thông tin, hãy xem bài viết SKAdNetwork.CoarseConversionValue.

Enum
COARSE_VALUE_UNSPECIFIED Giá trị thô không được chỉ định.
COARSE_VALUE_LOW Giá trị thô là thấp.
COARSE_VALUE_MEDIUM Giá trị thô của phương tiện.
COARSE_VALUE_HIGH Giá trị thô là cao.

EventMapping

Điều kiện cài đặt sự kiện để khớp với một sự kiện.

Biểu diễn dưới dạng JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Trường
eventName

string

Bắt buộc. Tên của sự kiện GA4. Bạn phải luôn đặt giá trị này. Độ dài tối đa cho phép của tên hiển thị là 40 đơn vị mã UTF-16.
minEventCount

string (int64 format)

Bạn phải đặt ít nhất một trong bốn giá trị tối thiểu/tối đa sau đây. Các giá trị đã đặt sẽ được kết hợp với nhau bằng toán tử AND để đủ điều kiện cho một sự kiện. Số lần sự kiện xảy ra tối thiểu. Nếu bạn không đặt chính sách này, thì số lượng sự kiện tối thiểu sẽ không được kiểm tra.
maxEventCount

string (int64 format)

Số lần sự kiện xảy ra tối đa. Nếu bạn không đặt chính sách này, thì số lượng sự kiện tối đa sẽ không được kiểm tra.
minEventValue

number

Doanh thu tối thiểu do sự kiện tạo ra. Đơn vị tiền tệ của doanh thu sẽ được xác định ở cấp tài sản. Nếu bạn không đặt chính sách này, thì hệ thống sẽ không kiểm tra giá trị sự kiện tối thiểu.
maxEventValue

number

Doanh thu tối đa mà sự kiện mang lại. Đơn vị tiền tệ của doanh thu sẽ được xác định ở cấp tài sản. Nếu bạn không đặt chính sách này, thì hệ thống sẽ không kiểm tra giá trị tối đa của sự kiện.

Phương thức

create

 Tạo một SKAdNetwork ConversionValueSchema.

delete

 Xoá SKAdNetwork ConversionValueSchema mục tiêu.

get

 Tìm một SKAdNetworkConversionsValueSchema duy nhất.

list

 Liệt kê SKAdNetworkConvertValueSchema trên một luồng.

patch

 Cập nhật một SKAdNetworkConvertValueSchema.