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

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à tối đa có thể có một phần tử con như vậy trong một luồng iOS. Format: 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ị của khoảng thời gian đăng lại 2 và 3 ở chỗ chúng chứa giá trị chuyển đổi chi tiết "Chi tiết" (một giá trị dạng 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 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 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 cửa sổ 1 và 2 và đặt enable_postback_window_settings cho cửa sổ đă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 bạn 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à xuất giản đồ 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ạn tắt tính năng này, 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 các 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 có giá trị đánh giá là đúng sẽ được chọn. Thuộc tính này phải có ít nhất một mục nhập nếu bạn đặt enable_postback_window_settings thành true. Tệp 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 conversionValues và giá trị này 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ị khách cũng như xuất giản đồ sang các tài khoản Google Ads được liên kết. Nếu giá trị là false, các 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. Đ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. Chiều dài tối đa của tên hiển thị được phép là 50 đơn vị mã UTF-16.
coarseValue

enum (CoarseValue)

Bắt buộc. Giá trị lượt chuyển đổi ở mức thô.

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

object (EventMapping)

Các điều kiện sự kiện phải đá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. Trường này phải có ít nhất 1 mục nhập và tối đa 3 mục nhập, nếu bạn bật khoảng thời gian đăng lại.
lockEnabled

boolean

Nếu đúng, SDK sẽ khoá vào 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. Đ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 thuộc tính này 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 cấu hình cho 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 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 Chưa chỉ định giá trị thô.
COARSE_VALUE_LOW Giá trị thô là thấp.
COARSE_VALUE_MEDIUM Giá trị thô của trung bình.
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 Google Analytics. Bạn phải luôn đặt giá trị này. Chiều dài tối đa của tên hiển thị được phép 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. Các giá trị được đặt sẽ được nối với nhau để xác định 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 giá trị này, thì hệ thống sẽ không kiểm tra số lượng sự kiện tối thiểu.
maxEventCount

string (int64 format)

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

number

Doanh thu tối thiểu được tạo ra nhờ sự kiện. Đơn vị tiền tệ của doanh thu sẽ được xác định ở cấp cơ sở lưu trú. Nếu bạn không đặt giá trị 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 được tạo ra nhờ sự kiện. Đơn vị tiền tệ của doanh thu sẽ được xác định ở cấp cơ sở lưu trú. Nếu bạn không đặt giá trị này, giá trị sự kiện tối đa sẽ không được kiểm tra.

Phương thức

create

 Tạo SKAdNetworkConversionValueSchema.

delete

 Xoá mục tiêu SKAdNetworkConversionValueSchema.

get

 Truy vấn một SKAdNetworkConversionValueSchema.

list

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

patch

 Cập nhật SKAdNetworkConversionValueSchema.