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 dữ liệu 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à con của CHỈ một luồng iOS và chỉ có thể có tối đa một luồng con như vậy trong 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 các giá trị cho khoảng thời gian đăng lại 2 và 3, ở chỗ các giá trị này chứa giá trị lượt chuyển đổi chi tiết "Chi tiết" (mộ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 không được đặ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 phải 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ị trong giáoWindowOne 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. Được 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 bạn đã đặt chế độ cài đặt cho khoảng thời gian 1 và 2 và enable_postback_window_settings cho khoảng thời gian đăng lại này được đặt thành false, thì giản đồ sẽ kế thừa chế độ cài đặt từ hệ thống đăng lạiHai.
applyConversionValues

boolean

Nếu được bật, SDK GA sẽ đặt các 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 thuộc tính này. Nếu bạn tắt chế độ cài đặt này, SDK GA sẽ không tự động đặt giá trị lượt chuyển đổi và giản đồ này 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 trong 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 nhập có chỉ mục càng thấp thì càng được ưu tiên. Hệ thống sẽ chọn chế độ cài đặt giá trị chuyển đổi đầu tiên có giá trị là true. Tệp 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. Có thể chứa tối đa 128 mục nhập.
postbackWindowSettingsEnabled

boolean

Nếu enable_postback_window_settings là true, thì các giá trị chuyển đổi phải được điền và sẽ được dùng để 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, đồng thời xuất giản đồ sang các tài khoản Google Ads được liên kết. Nếu giá trị là sai, thì các chế độ cài đặt sẽ không được sử dụng, nhưng sẽ đượ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 sendWindowOne.

ConversionValues

Chế độ cài đặt giá trị lượt chuyển đổi cho một 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ên hiển thị tối đa được phép 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 đảm bảo là duy nhất.
eventMappings[]

object (EventMapping)

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

boolean

Nếu đúng, 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ị 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. Các giá trị hợp lệ của nó là [0,63], bao gồm cả hai. Bạn phải đặt khoảng thời gian đăng lại 1 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 đảm bảo là duy nhất.

Nếu cấu hình của khoảng thời gian đăng lại đầu tiên được sử dụng lại 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 đá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 Chưa chỉ định giá trị thô.
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

Các đ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 thuộc tính này. Độ dài tên hiển thị tối đa được phép là 40 đơn vị mã UTF-16.
minEventCount

string (int64 format)

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ị được đặt sẽ được kết hợp với nhau để đủ điều kiện cho một sự kiện. Số lần tối thiểu đã xảy ra sự kiện. Nếu bạn không đặt chính sách này, thì số 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 chính sách này, thì số sự kiện tối đa sẽ không được kiểm tra.
minEventValue

number

Doanh thu tối thiểu được tạo ra từ sự kiện. Đơ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, 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 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, hệ thống sẽ không kiểm tra giá trị sự kiện tối đa.

Phương thức

create

 Tạo một SKAdNetworkValueValueSchema.

delete

 Xoá SKAdNetworkconversionValueSchema mục tiêu.

get

 Tìm một mã lượt chuyển đổi SKAdNetwork duy nhất.

list

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

patch

 Cập nhật một SKAdNetworkValueValueSchema.