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 串流下最多只能有一個這樣的子項。Format: 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

啟用後，GA SDK 會使用這個結構定義定義轉換價值，並將結構定義匯出至已連結至這項資源的任何 Google Ads 帳戶。如果停用，GA 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] 之間 (包括 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 事件名稱。必須一律設為「1」。顯示名稱的長度上限為 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。