Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customerId

string

共有セットを変更する顧客の ID。

リクエスト本文

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

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

validateOnly

boolean

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

enableWarnings

boolean

省略可。true の場合、警告を返すことができます。警告は、変換オペレーションの実行をブロックすることなくエラー メッセージとエラーコードを返します。

レスポンスの本文

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

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

変換のすべての結果。

warning

object (Status)

スキーマ検証の失敗の詳細を示す非ブロックエラー。enableWarnings = true の場合にのみ返されます。

承認スコープ

次の 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 リソース名の形式は、customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} です。

schema

object (SkAdNetworkConversionValueSchema)

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

SkAdNetworkConversionValueSchema

CustomerLink 固有の SkAdNetworkConversionValueSchema。

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

string

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

measurementWindowHours

integer

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

fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

出力専用。詳細なコンバージョン値のマッピング:複数の計測期間をサポートする SkAdNetwork バージョン 4.0 以降では、きめ細かいコンバージョン値のマッピングは最初のポストバックにのみ適用されます。

postbackMappings[]

object (PostbackMapping)

出力専用。複数の計測期間におけるポストバックのポストバックごとのコンバージョン値のマッピング。SkAdNetwork バージョン 4.0 以降にのみ適用されます。

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 の値は設定されていないものとして扱われます。

PostbackMapping

複数の計測期間における各ポストバックのマッピング。

JSON 表現
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
フィールド
postbackSequenceIndex

integer

出力専用。ポストバックの順序を示す 0 ベースのインデックス。有効な値の範囲は [0,2] です。

coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

出力専用。すべての大まかなコンバージョン値のコンバージョン値のマッピング。

共用体フィールド lock_window_trigger。計測期間のロックに使用されるイベントまたはコンバージョン値です。lock_window_trigger は次のいずれかになります。
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

出力専用。計測期間のロックをトリガーする大まかなコンバージョン値です。

lockWindowFineConversionValue

integer

出力専用。計測期間のロックをトリガーする詳細なコンバージョン値。

lockWindowEvent

string

出力専用。計測期間のロックをトリガーするイベント名。

CoarseGrainedConversionValueMappings

大まかなコンバージョン値のマッピング。

JSON 表現
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
フィールド
lowConversionValueMapping

object (ConversionValueMapping)

出力専用。大まかなコンバージョン値を「低」にマッピングします。

mediumConversionValueMapping

object (ConversionValueMapping)

出力専用。「中程度」の大まかなコンバージョン値のマッピング。

highConversionValueMapping

object (ConversionValueMapping)

出力専用。大まかなコンバージョン値を「高」にマッピングします。

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema の結果は、変更されます。

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

string

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

appId

string

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