- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- イベント
- RevenueRange
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- 試してみる
CustomerSkAdNetworkConversionValueSchema を作成または更新します。
スローされるエラーのリスト: AuthenticationError AuthorizationError FieldError InternalError MutateError
HTTP リクエスト
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
共有セットを変更する顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"operation": {
object ( |
フィールド | |
---|---|
operation |
実行するオペレーション。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。 |
enableWarnings |
省略可。true の場合、警告を返すことができます。警告は、変換オペレーションの実行をブロックすることなくエラー メッセージとエラーコードを返します。 |
レスポンスの本文
customerSkAdNetworkConversionValueSchemas.mut に対するレスポンス メッセージ。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "result": { object ( |
フィールド | |
---|---|
result |
変換のすべての結果。 |
warning |
スキーマ検証の失敗の詳細を示す非ブロックエラー。enableWarnings = true の場合にのみ返されます。 |
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。
CustomerSkAdNetworkConversionValueSchemaOperation
CustomerSkAdNetworkConversionValueSchema の 1 つの更新オペレーションです。
JSON 表現 |
---|
{
"update": {
object ( |
フィールド | |
---|---|
update |
更新オペレーション: スキーマには有効なリソース名が必要です。 |
CustomerSkAdNetworkConversionValueSchema
CustomerSkAdNetworkConversionValueSchema。
JSON 表現 |
---|
{
"resourceName": string,
"schema": {
object ( |
フィールド | |
---|---|
resourceName |
出力専用。スキーマのリソース名。CustomerSkAdNetworkConversionValueSchema リソース名の形式は、customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} です。 |
schema |
出力専用。指定されたリソースのスキーマ。 |
SkAdNetworkConversionValueSchema
CustomerLink 固有の SkAdNetworkConversionValueSchema。
JSON 表現 |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
フィールド | |
---|---|
appId |
必須。出力専用。Apple App Store のアプリ ID。 |
measurementWindowHours |
出力専用。インストール後の期間(時間単位で測定)。この時間が経過すると、App Attribution Partner または広告主が updateConversionValue の呼び出しを停止します。 |
fineGrainedConversionValueMappings[] |
出力専用。詳細なコンバージョン値のマッピング:複数の計測期間をサポートする SkAdNetwork バージョン 4.0 以降では、きめ細かいコンバージョン値のマッピングは最初のポストバックにのみ適用されます。 |
postbackMappings[] |
出力専用。複数の計測期間におけるポストバックのポストバックごとのコンバージョン値のマッピング。SkAdNetwork バージョン 4.0 以降にのみ適用されます。 |
FineGrainedConversionValueMappings
詳細なコンバージョン値のマッピング
JSON 表現 |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
フィールド | |
---|---|
fineGrainedConversionValue |
出力専用。コンバージョン値を細かく確認できます。有効な値の範囲は [0,63] です。 |
conversionValueMapping |
出力専用。詳細なコンバージョン値がマッピングされるコンバージョン イベントです。 |
ConversionValueMapping
1 つのコンバージョン値から 1 つ以上のコンバージョン イベントへのマッピングを表します。
JSON 表現 |
---|
{
"minTimePostInstallHours": string,
"maxTimePostInstallHours": string,
"mappedEvents": [
{
object ( |
フィールド | |
---|---|
minTimePostInstallHours |
出力専用。測定期間中にユーザーが最後にアクティブだった期間(最小)。 |
maxTimePostInstallHours |
出力専用。測定期間中にユーザーが最後にアクティブだった期間の最大値。 |
mappedEvents[] |
出力専用。コンバージョン値は、さまざまな属性を持つ複数のイベントにマッピングされる場合があります。 |
イベント
コンバージョン値がマッピングされる Google コンバージョン イベントを定義します。
JSON 表現 |
---|
{ "mappedEventName": string, "currencyCode": string, // Union field |
フィールド | |
---|---|
mappedEventName |
出力専用。このコンバージョン値で表される Google イベント名。 |
currencyCode |
出力専用。event_revenue でレポートされる通貨。ISO 4217 の 3 文字の通貨コード(「USD」など) |
共用体フィールド revenue_rate 。イベント収益の範囲または特定の値。revenue_rate は次のいずれかになります。 |
|
eventRevenueRange |
出力専用。イベント収益の範囲。 |
eventRevenueValue |
出力専用。特定のイベント収益の値。 |
共用体フィールド event_rate 。イベント カウンタの範囲または特定の値。event_rate は次のいずれかになります。 |
|
eventOccurrenceRange |
出力専用。イベント カウンタの範囲。 |
eventCounter |
出力専用。特定のイベント カウンタ値の場合。 |
RevenueRange
収益値の範囲を定義します。
JSON 表現 |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
フィールド | |
---|---|
minEventRevenue |
出力専用。収益の範囲について、このコンバージョン値が更新される |
maxEventRevenue |
出力専用。収益の範囲について、このコンバージョン値が更新される |
EventOccurrenceRange
イベント カウンタ値の範囲を定義します。
JSON 表現 |
---|
{ "minEventCount": string, "maxEventCount": string } |
フィールド | |
---|---|
minEventCount |
出力専用。イベント カウンタの範囲の場合、定義された範囲の最小値。0 の値は設定されていないものとして扱われます。 |
maxEventCount |
出力専用。イベント カウンタの範囲の場合、定義されている範囲の最大値。0 の値は設定されていないものとして扱われます。 |
PostbackMapping
複数の計測期間における各ポストバックのマッピング。
JSON 表現 |
---|
{ "postbackSequenceIndex": integer, "coarseGrainedConversionValueMappings": { object ( |
フィールド | |
---|---|
postbackSequenceIndex |
出力専用。ポストバックの順序を示す 0 ベースのインデックス。有効な値の範囲は [0,2] です。 |
coarseGrainedConversionValueMappings |
出力専用。すべての大まかなコンバージョン値のコンバージョン値のマッピング。 |
共用体フィールド lock_window_trigger 。計測期間のロックに使用されるイベントまたはコンバージョン値です。lock_window_trigger は次のいずれかになります。 |
|
lockWindowCoarseConversionValue |
出力専用。計測期間のロックをトリガーする大まかなコンバージョン値です。 |
lockWindowFineConversionValue |
出力専用。計測期間のロックをトリガーする詳細なコンバージョン値。 |
lockWindowEvent |
出力専用。計測期間のロックをトリガーするイベント名。 |
CoarseGrainedConversionValueMappings
大まかなコンバージョン値のマッピング。
JSON 表現 |
---|
{ "lowConversionValueMapping": { object ( |
フィールド | |
---|---|
lowConversionValueMapping |
出力専用。大まかなコンバージョン値を「低」にマッピングします。 |
mediumConversionValueMapping |
出力専用。「中程度」の大まかなコンバージョン値のマッピング。 |
highConversionValueMapping |
出力専用。大まかなコンバージョン値を「高」にマッピングします。 |
MutateCustomerSkAdNetworkConversionValueSchemaResult
CustomerSkAdNetworkConversionValueSchema の結果は、変更されます。
JSON 表現 |
---|
{ "resourceName": string, "appId": string } |
フィールド | |
---|---|
resourceName |
変更された顧客のリソース名。 |
appId |
変更された SkanConversionValue のアプリ ID。 |