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)

必要欄位。第一個回傳回溯期的轉換價值設定。這些與回傳期二和三的回傳期值不同,因為前者包含「精細」精細轉換價值 (數值)。

必須設定這個回傳期的轉換價值。其他視窗則為選用功能,如果您未設定或停用該視窗,其他視窗可能會沿用這項設定。

postbackWindowTwo

object (PostbackWindow)

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

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

如果將這個回傳期的 enable_postback_window_settings 設為 false,則會使用 postbackWindowOne 的值。

postbackWindowThree

object (PostbackWindow)

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

只有在使用者選擇為這個回傳期定義不同的轉換價值時,才需要設定這個欄位。可以在不設定視窗 2 的情況下設定視窗 3。案件視窗 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,則轉換值必須填入,且會用來決定在用戶端裝置上設定轉換價值的時機和方式,並將結構定義匯出至已連結的 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。