REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

リソース: SKAdNetworkConversionValueSchema

iOS ストリームの SKAdNetwork コンバージョンの値スキーマ。

JSON 表現
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
フィールド
name

string

ID。スキーマのリソース名。これは 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

有効にすると、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 つの最小値/最大値のうち、少なくとも 1 つを設定する必要があります。設定された値は、イベントを修飾するために AND 演算されます。イベントが発生した最小回数。設定されていない場合、最小イベント数はチェックされません。

maxEventCount

string (int64 format)

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

minEventValue

number

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

maxEventValue

number

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

メソッド

create

SKAdNetworkConversionValueSchema を作成します。

delete

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

get

単一の SKAdNetworkConversionValueSchema を検索します。

list

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

patch

SKAdNetworkConversionValueSchema を更新します。