Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

CustomerSkAdNetworkConversionValueSchema を作成または更新します。

スローされるエラーのリスト: AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP リクエスト

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

共有セットが変更される顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
フィールド
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

実行するオペレーション。

validateOnly

boolean

true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。

レスポンスの本文

customerSkAdNetworkConversionValueSchemas.mut に対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
フィールド
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

ミューテーションのすべての結果。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/adwords

詳細については、OAuth 2.0 の概要をご覧ください。

CustomerSkAdNetworkConversionValueSchemaOperation

CustomerSkAdNetworkConversionValueSchema の 1 回の更新操作。

JSON 表現
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
フィールド
update

object (CustomerSkAdNetworkConversionValueSchema)

更新オペレーション: スキーマには有効なリソース名が必要です。

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema。

JSON 表現
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
フィールド
resourceName

string

出力のみ。スキーマのリソース名。CustomerSkAdNetworkConversionValueSchema リソース名の形式は customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} です。

schema

object (SkAdNetworkConversionValueSchema)

出力のみ。指定されたリソースのスキーマ。

SkAdNetworkConversionValueSchema

CustomerLink 固有の SkAdNetworkConversionValueSchema。

JSON 表現
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
フィールド
appId

string

必須。出力のみ。Apple App Store のアプリ ID。

measurementWindowHours

integer

出力のみ。インストール後の期間(時間単位で測定)。この期間が過ぎると、App Attribution Partner または広告主は updateConversionValue の呼び出しを停止します。

fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

出力のみ。きめ細かなコンバージョン値のマッピング。

FineGrainedConversionValueMappings

詳細なコンバージョン値のマッピング。

JSON 表現
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
フィールド
fineGrainedConversionValue

integer

出力のみ。詳細なコンバージョン値。有効な値の範囲は [0 ~ 63] です。

conversionValueMapping

object (ConversionValueMapping)

出力のみ。詳細なコンバージョン値がマッピングされるコンバージョン イベントです。

ConversionValueMapping

1 つのコンバージョン値から 1 つ以上のコンバージョン イベントへのマッピングを表します。

JSON 表現
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
フィールド
minTimePostInstallHours

string (int64 format)

出力のみ。測定時間枠の中でユーザーが最後にアクティブだった期間の最小。

maxTimePostInstallHours

string (int64 format)

出力のみ。測定時間枠の中で、ユーザーが最後にアクティブだった時間範囲の最大値。

mappedEvents[]

object (Event)

出力のみ。コンバージョン値は、さまざまな属性を持つ複数のイベントにマッピングできます。

イベント

コンバージョン値がマッピングされている Google コンバージョン イベントを定義します。

JSON 表現
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
フィールド
mappedEventName

string

出力のみ。このコンバージョン値によって表される Google イベント名。

currencyCode

string

出力のみ。event_revenue についてレポートされる通貨。ISO 4217 の 3 文字の通貨コード(「USD」など)

共用体フィールド revenue_rate。イベント収益の範囲または特定の値。revenue_rate は次のいずれかになります。
eventRevenueRange

object (RevenueRange)

出力のみ。イベント収益の範囲。

eventRevenueValue

number

出力のみ。特定のイベントの収益値。

共用体フィールド event_rate。イベント カウンタの範囲または特定の値。event_rate は次のいずれかになります。
eventOccurrenceRange

object (EventOccurrenceRange)

出力のみ。イベント カウンタの範囲。

eventCounter

string (int64 format)

出力のみ。特定のイベント カウンタ値の場合。

RevenueRange

収益値の範囲を定義します。

JSON 表現
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
フィールド
minEventRevenue

number

出力のみ。収益の範囲について、このコンバージョン値が更新される currencyCode の最小値。0 は未設定として扱われます。

maxEventRevenue

number

出力のみ。収益の範囲について、このコンバージョン値が更新される currencyCode の最大値。0 は未設定として扱われます。

EventOccurrenceRange

イベント カウンタ値の範囲を定義します。

JSON 表現
{
  "minEventCount": string,
  "maxEventCount": string
}
フィールド
minEventCount

string (int64 format)

出力のみ。イベント カウンタの範囲の場合、定義されている範囲の最小値。0 は未設定として扱われます。

maxEventCount

string (int64 format)

出力のみ。イベント カウンタの範囲の場合、定義されている範囲の最大値。0 は未設定として扱われます。

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema の結果は変わります。

JSON 表現
{
  "resourceName": string,
  "appId": string
}
フィールド
resourceName

string

変更されたお客様のリソース名。

appId

string

変更された SkanConversionValue のアプリ ID。