REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

資源：SKAdNetworkConversionValueSchema

iOS 串流的 SKAdNetwork 轉換價值結構定義。

JSON 表示法 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
欄位
name

string

ID。結構定義的資源名稱。這只會是 iOS 串流的子項，且 iOS 串流最多只能有一個這類子項。格式：properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

必填。第一個回傳期的轉換價值設定。與回傳視窗 2 和 3 的值不同，這些值包含「精細」的轉換價值 (數值)。

必須為這個回傳期設定轉換價值。其他視窗為選用視窗，如果未設定或停用，可能會沿用這個視窗的設定。
postbackWindowTwo

object (PostbackWindow)

第二個回傳期的轉換價值設定。

只有在需要為這個回傳期定義不同的轉換價值時，才應設定這個欄位。

如果這個回傳期的 enable_postback_window_settings 設為 false，系統會使用 postbackWindowOne 的值。
postbackWindowThree

object (PostbackWindow)

第三個回傳期的轉換價值設定。

只有在使用者選擇為這段回傳期定義不同的轉換價值時，才應設定這個欄位。您可以在不設定視窗 2 的情況下設定視窗 3。如果已設定回溯期 1 和 2，且這個回傳期的 enable_postback_window_settings 設為 false，結構定義會沿用 postbackWindowTwo 的設定。
applyConversionValues

boolean

啟用後，Google Analytics SDK 會使用這個結構定義設定轉換價值，且結構定義會匯出至連結這項資源的所有 Google Ads 帳戶。如果停用，Google Analytics SDK 不會自動設定轉換價值，且結構定義也不會匯出至 Google Ads。

PostbackWindow

SKAdNetwork 轉換回傳回溯期設定。

JSON 表示法 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
欄位
conversionValues[]

object (ConversionValues)

系統會根據重複欄位的順序，決定轉換價值設定的優先順序。索引值越小的項目優先順序越高。系統會選取第一個評估結果為 true 的轉換價值設定。如果 enable_postback_window_settings 設為 true，則至少須有一個項目。最多可輸入 128 個項目。
postbackWindowSettingsEnabled

boolean

如果 enable_postback_window_settings 為 true，則必須填入 conversionValues，系統會使用這些值判斷何時及如何設定用戶端裝置的轉換價值，並將結構定義匯出至已連結的 Google Ads 帳戶。如果為 false，系統不會使用這些設定，但會保留這些設定，以備日後使用。postbackWindowOne 一律必須符合這項條件。

ConversionValues

SKAdNetwork 轉換價值結構定義的回傳期轉換價值設定。

JSON 表示法 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
欄位
displayName

string

SKAdNetwork 轉換價值的顯示名稱。顯示名稱長度上限為 50 個 UTF-16 程式碼單元。
coarseValue

enum (CoarseValue)

必填。粗略轉換價值。

這個值不保證不會重複。
eventMappings[]

object (EventMapping)

必須符合的事件條件，才能達成這個轉換價值。這份清單中的條件會以 AND 運算子連結。如果啟用回傳視窗，則必須至少有 1 個項目，最多 3 個項目。
lockEnabled

boolean

如果為 true，SDK 應鎖定目前回傳期的這個轉換價值。
fineValue

integer

精細轉換價值。這項功能僅適用於第一個回傳視窗。有效值為 [0,63]，包括 0 和 63。必須為回傳期 1 設定，且不得為回傳期 2 和 3 設定。這個值不保證不會重複。

如果第二或第三個回傳期沿用第一個回傳期的設定，這個欄位就不會生效。

CoarseValue

滿足 ConversionValues.event_mappings 條件時，在 updatePostbackConversionValue SDK 呼叫中設定的粗略轉換價值。詳情請參閱 SKAdNetwork.CoarseConversionValue。

列舉
COARSE_VALUE_UNSPECIFIED 未指定粗略值。
COARSE_VALUE_LOW 粗略值偏低。
COARSE_VALUE_MEDIUM 媒體的粗略值。
COARSE_VALUE_HIGH 高粗略值。

EventMapping

事件設定條件，用來比對事件。

JSON 表示法 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
欄位
eventName

string

必填。Google Analytics 事件名稱。這個欄位必須一律設定。顯示名稱長度上限為 40 個 UTF-16 碼元。
minEventCount

string (int64 format)

請至少設定下列四個最小值/最大值之一。系統會將設定的值以 AND 運算符合併，以判斷事件是否符合條件。事件發生的最少次數。如未設定，系統就不會檢查事件數量下限。
maxEventCount

string (int64 format)

事件發生的次數上限。如未設定，系統就不會檢查事件數量上限。
minEventValue

number

活動帶來的最低收益。收益幣別會在房源層級定義。如未設定，系統就不會檢查事件價值是否達到最低門檻。
maxEventValue

number

活動帶來的最高收益。收益幣別會在房源層級定義。如未設定，系統不會檢查事件價值上限。

方法

create

 建立 SKAdNetworkConversionValueSchema。

delete

 刪除目標 SKAdNetworkConversionValueSchema。

get

 查詢單一 SKAdNetworkConversionValueSchema。

list

 列出串流中的 SKAdNetworkConversionValueSchema。

patch

 更新 SKAdNetworkConversionValueSchema。