REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

資源：SKAdNetworkConversionValueSchema

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

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

string

僅供輸出。結構定義的資源名稱。這會僅是 iOS 串流的子項，iOS 串流中最多只能有一個兒童。格式：properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

必要欄位。第一個回傳期的轉換價值設定。這些值與回傳期 2 和 3 的值不同，因為其中包含「精細」的轉換價值 (數值)。

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

object (PostbackWindow)

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

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

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

object (PostbackWindow)

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

只有在使用者選擇為這個回傳期定義不同的轉換價值時，才需要設定這個欄位。可以設定視窗 3 而不設定視窗 2。如果調整回溯期 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，此屬性一律須設為 true。

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] (含頭尾)。必須為回傳期 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

必要欄位。GA4 事件的名稱。請務必設定。顯示名稱的長度上限為 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。