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 の値とは異なり、「Fine」が含まれています。きめ細かいコンバージョン値(数値)

このポストバック ウィンドウのコンバージョン値を設定する必要があります。他のウィンドウはオプションであり、未設定または無効にすると、このウィンドウの設定が継承されます。

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

有効にすると、GA SDK でこのスキーマ定義を使用してコンバージョン値が設定され、このプロパティにリンクされたすべての Google 広告アカウントにスキーマがエクスポートされます。無効にすると、GA 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 の場合、conversionValues に値を設定する必要があります。この値は、クライアント デバイスでのコンバージョン値の設定のタイミングと方法の決定や、リンクされた 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.この値は一意であるとは限りません。

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)

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

maxEventCount

string (int64 format)

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

minEventValue

number

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

maxEventValue

number

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

メソッド

create

SKAdNetworkConversionValueSchema を作成します。

delete

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

get

1 つの SKAdNetworkConversionValueSchema を検索します。

list

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

patch

SKAdNetworkConversionValueSchema を更新します。