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 ストリームの下には最大で 1 つの子を配置できます。形式: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

必須。最初のポストバック ウィンドウのコンバージョン値の設定。ポストバック ウィンドウ 2 と 3 の値とは異なり、「きめ細かい」コンバージョン値(数値)が含まれます。

このポストバック ウィンドウのコンバージョン値を設定してください。他のウィンドウはオプションです。未設定または無効にした場合は、このウィンドウの設定が継承されます。

postbackWindowTwo

object (PostbackWindow)

2 番目のポストバック ウィンドウのコンバージョン値の設定。

このフィールドは、ポストバック ウィンドウごとに異なるコンバージョン値を定義する必要がある場合にのみ設定する必要があります。

このポストバック ウィンドウの enable_postback_window_settings が false に設定されている場合は、postbackWindowOne の値が使用されます。

postbackWindowThree

object (PostbackWindow)

3 番目のポストバック ウィンドウのコンバージョン値の設定。

このフィールドは、ユーザーがこのポストバック ウィンドウに異なるコンバージョン値を定義することを選択した場合にのみ設定する必要があります。ウィンドウ 2 を設定せずにウィンドウ 3 を構成できます。ウィンドウ 1 と 2 が設定され、このポストバック ウィンドウの enable_postback_window_settings が false に設定されている場合、スキーマは postbackWindowTwo の設定を継承します。

applyConversionValues

boolean

有効にすると、Google アナリティクス SDK でこのスキーマ定義を使用してコンバージョン値が設定され、このプロパティにリンクされているすべての Google 広告アカウントにスキーマがエクスポートされます。無効にすると、Google アナリティクス SDK でコンバージョン値が自動的に設定されず、スキーマも Google 広告にエクスポートされません。

PostbackWindow

SKAdNetwork のコンバージョン ポストバック ウィンドウの設定。

JSON 表現
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
フィールド
conversionValues[]

object (ConversionValues)

繰り返しフィールドの順序に基づいて、コンバージョン値の設定が優先されます。インデックスが小さいエントリほど優先度が高くなります。true と評価された最初のコンバージョン値の設定が選択されます。enable_postback_window_settings が true に設定されている場合は、少なくとも 1 つのエントリが必要です。最大 128 個のエントリを含めることができます。

postbackWindowSettingsEnabled

boolean

enable_postback_window_settings が true の場合、conversionValue は必須です。これは、クライアント デバイスでコンバージョン値を設定するタイミングと方法を決定し、リンクされた Google 広告アカウントにスキーマをエクスポートするために使用されます。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 に設定することはできません。この値は一意であるとは限りません。

最初のポストバック ウィンドウの設定を 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 イベントの名前。常に設定する必要があります。表示名の最大長は UTF-16 コード単位 40 です。

minEventCount

string (int64 format)

次の 4 つの最小値/最大値のうち少なくとも 1 つを設定する必要があります。設定した値は、AND で結合されてイベントが評価されます。イベントが発生した最小回数。設定しない場合、最小イベント数は確認されません。

maxEventCount

string (int64 format)

イベントが発生した最大回数。設定しない場合、最大イベント数はチェックされません。

minEventValue

number

イベントによって発生した最小収益。収益の通貨はプロパティ単位で定義されます。設定しない場合、最小イベント値は確認されません。

maxEventValue

number

イベントによって発生した最大収益。収益の通貨はプロパティ単位で定義されます。設定しない場合、最大イベント値は確認されません。

Methods

create

SKAdNetworkConversionValueSchema を作成します。

delete

ターゲットの SKAdNetworkConversionValueSchema を削除します。

get

1 つの SKAdNetworkConversionValueSchema を検索します。

list

ストリームの SKAdNetworkConversionValueSchema を一覧表示します。

patch

SKAdNetworkConversionValueSchema を更新します。