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 つだけです。Format: 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

有効にすると、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 には設定しないでください。この値が固有であることは保証されていません。

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

minEventCount

string (int64 format)

次の 4 つの最小値/最大値のいずれかを設定する必要があります。設定した値は AND 演算で結合され、イベントの条件として使用されます。イベントが発生した最小回数。設定しない場合、最小イベント数はチェックされません。

maxEventCount

string (int64 format)

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

minEventValue

number

イベントによって得られる最小収益額。収益の通貨は宿泊施設レベルで定義されます。設定されていない場合、最小イベント値はチェックされません。

maxEventValue

number

イベントによって発生した最大収益。収益の通貨は宿泊施設レベルで定義されます。設定しない場合、最大イベント値はチェックされません。

メソッド

create

SKAdNetworkConversionValueSchema を作成します。

delete

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

get

単一の SKAdNetworkConversionValueSchema を検索します。

list

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

patch

SKAdNetworkConversionValueSchema を更新します。