REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Tài nguyên: SKAdNetworkConversionValueSchema

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

Mã nhận dạng. 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 phần tử con như vậy trong một luồng iOS. Định dạng: properties/{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 giá trị cho khoảng thời gian đăng lại thứ hai và thứ ba ở chỗ chúng chứa giá trị lượt chuyển đổi "Fine" (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 khoảng thời gian khác là không bắt buộc và có thể kế thừa chế độ cài đặt của khoảng thời gian này nếu chưa đặt hoặc bị tắt.
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 khoảng thời gian đăng lại này, thì các giá trị từ 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. Bạn có thể định cấu hình khoảng thời gian 3 mà không cần đặt khoảng thời gian 2. Trong trường hợp bạn đặt chế độ cài đặt cho khoảng thời gian 1 và 2, đồng thời đặt enable_postback_window_settings cho khoảng thời gian đăng lại này thành false, thì giản đồ sẽ kế thừa chế độ cài đặt từ 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 mọi tài khoản Google Ads được liên kết với tài sản này. Nếu bị tắt, SDK GA sẽ không tự động đặt giá trị lượt chuyển đổi và giản đồ cũng 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. Các 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 đánh giá thành true sẽ được chọn. Chế độ này phải có ít nhất một mục nếu bạn đặt enable_postback_window_settings thành true. Chế độ này có thể có tối đa 128 mục.
postbackWindowSettingsEnabled

boolean

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

ConversionValues

Chế độ cài đặt giá trị lượt chuyển đổi cho khoảng thời gian đăng lại của 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. Chiều 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 thô.

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

object (EventMapping)

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

boolean

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

integer

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

Nếu bạn sử dụng lại cấu hình cho khoảng thời gian đăng lại đầu tiên cho khoảng thời gian đăng lại thứ hai hoặc thứ ba, thì 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 các điều kiện ConversionValues.event_mappings được đáp ứng. Để biết thêm thông tin, hãy xem SKAdNetwork.CoarseConversionValue.

Enum
COARSE_VALUE_UNSPECIFIED Giá trị thô không được chỉ định.
COARSE_VALUE_LOW Giá trị thô thấp.
COARSE_VALUE_MEDIUM Giá trị thô của phương tiện.
COARSE_VALUE_HIGH Giá trị thô 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 Google Analytics. Bạn phải luôn đặt giá trị này. Chiều 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 4 giá trị tối thiểu/tối đa sau đây. Các giá trị được đặ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 tối thiểu sự kiện xảy ra. Nếu bạn không đặt, thì số lượt sự kiện tối thiểu sẽ không được kiểm tra.
maxEventCount

string (int64 format)

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

number

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

number

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

Phương pháp

create

 Tạo SKAdNetworkConversionValueSchema.

delete

 Xoá SKAdNetworkConversionValueSchema mục tiêu.

get

 Tìm một SKAdNetworkConversionValueSchema.

list

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

patch

 Cập nhật SKAdNetworkConversionValueSchema.