資源:SKAdNetworkConversionValueSchema
iOS 串流的 SKAdNetwork 轉換價值結構定義。
JSON 表示法 |
---|
{ "name": string, "postbackWindowOne": { object ( |
欄位 | |
---|---|
name |
僅供輸出。結構定義的資源名稱。這會僅是 iOS 串流的子項,iOS 串流中最多只能有一個兒童。格式:properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema |
postbackWindowOne |
必要欄位。第一個回傳期的轉換價值設定。這些值與回傳期 2 和 3 的值不同,因為其中包含「精細」的轉換價值 (數值)。 必須設定這個回傳期的轉換價值。其他視窗則為選用視窗,如果不設定或停用,可能會沿用這個視窗設定。 |
postbackWindowTwo |
第二個回傳期的轉換價值設定。 只有在需要為這個回傳期定義不同的轉換價值時,才應設定這個欄位。 如果這個回傳期的 enable_postback_window_settings 設為 false,系統將使用 postbackWindowOne 中的值。 |
postbackWindowThree |
第三個回傳期的轉換價值設定。 只有在使用者選擇為這個回傳期定義不同的轉換價值時,才需要設定這個欄位。可以設定視窗 3 而不設定視窗 2。如果調整回溯期 1 和 2 的設定,並將這個回傳期的 enable_postback_window_settings 設為 false,結構定義將沿用 postbackWindowTwo 的設定。 |
applyConversionValues |
啟用後,Google Analytics (分析) SDK 會使用這個結構定義來設定轉換價值,並將結構定義匯出至與這項資源連結的所有 Google Ads 帳戶。如果停用,Google Analytics (分析) SDK 就不會自動設定轉換價值,結構定義也不會匯出至 Google Ads。 |
PostbackWindow
SKAdNetwork 轉換回傳回溯期設定。
JSON 表示法 |
---|
{
"conversionValues": [
{
object ( |
欄位 | |
---|---|
conversionValues[] |
系統會根據重複欄位的順序決定轉換價值設定的優先順序。已建立索引的項目優先順序較高。系統會選取評估結果為 true 的第一個轉換價值設定。如果 enable_postback_window_settings 設為 true,至少必須有一個項目。最多可以有 128 個項目。 |
postbackWindowSettingsEnabled |
如果 enable_postback_window_settings 設為 true,您必須填入 conversionValues 來決定在用戶端裝置上設定轉換價值的時機和方式,以及將架構匯出到已連結的 Google Ads 帳戶的時機和方式。如果設為 False,系統不會使用這些設定,但日後可能會繼續使用。如為 postbackWindowOne,此屬性一律須設為 true。 |
ConversionValues
SKAdNetwork 轉換價值結構定義的回傳期轉換價值設定。
JSON 表示法 |
---|
{ "displayName": string, "coarseValue": enum ( |
欄位 | |
---|---|
displayName |
SKAdNetwork 轉換價值的顯示名稱。顯示名稱的長度上限為 50 個 UTF-16 代碼單位。 |
coarseValue |
必要欄位。概略的轉換價值。 這個值不保證不會重複。 |
eventMappings[] |
要達成此轉換價值的事件條件。這份清單中的條件會以「AND」結合起來。如果啟用了回傳期,最少必須包含 1 個項目,最多 3 個項目。 |
lockEnabled |
如果為 true,SDK 應在目前的回傳期內鎖定這個轉換價值。 |
fineValue |
精細的轉換價值。這僅適用於第一個回傳期。有效值為 [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 |
必要欄位。GA4 事件的名稱。請務必設定。顯示名稱的長度上限為 40 個 UTF-16 代碼單位。 |
minEventCount |
必須設定下列四個最小值/最大值中的其中一個。系統會將設定的值以 AND 結合在一起,以便評估事件。事件發生次數下限。如果未設定,系統就不會檢查事件計數下限。 |
maxEventCount |
事件發生次數的最大值。如未設定,系統就不會檢查事件數量上限。 |
minEventValue |
因為事件產生的最低收益。系統會在資源層級定義收益幣別。如果未設定,系統就不會檢查最低事件價值。 |
maxEventValue |
透過事件產生的最高收益。系統會在資源層級定義收益幣別。如果未設定,系統就不會檢查事件價值上限。 |
方法 |
|
---|---|
|
建立 SKAdNetworkConversionValueSchema。 |
|
刪除目標 SKAdNetworkConversionValueSchema。 |
|
查詢單一 SKAdNetworkConversionValueSchema。 |
|
列出串流的 SKAdNetworkConversionValueSchema。 |
|
更新 SKAdNetworkConversionValueSchema。 |