---
title: "POST /v23/customers/{customersId}/customerSkAdNetworkConversionValueSchemas:mutate"
method: POST
path: "/v23/customers/{customersId}/customerSkAdNetworkConversionValueSchemas:mutate"
tags: ["customers"]
---

# POST /v23/customers/{customersId}/customerSkAdNetworkConversionValueSchemas:mutate

`POST /v23/customers/{customersId}/customerSkAdNetworkConversionValueSchemas:mutate`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{customersId}/customerSkAdNetworkConversionValueSchemas:mutate`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/doubleclicksearch`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch`
- TypeScript: <https://skmtc.dev/google/apis/searchads360/docs/v23/customers/:customersId/customerSkAdNetworkConversionValueSchemas:mutate/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates or updates the CustomerSkAdNetworkConversionValueSchema. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [FieldError]() [InternalError]() [MutateError]()

## Path parameters

- `customersId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateCustomerSkAdNetworkConversionValueSchemaRequest: Request message for CustomerSkAdNetworkConversionValueSchemaService.MutateCustomerSkAdNetworkConversionValueSchema.
  - `enableWarnings` boolean: Optional. If true, enables returning warnings. Warnings return error messages and error codes without blocking the execution of the mutate operation.
  - `operation` GoogleAdsSearchads360V23ServicesCustomerSkAdNetworkConversionValueSchemaOperation: A single update operation for a CustomerSkAdNetworkConversionValueSchema.
    - `update` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchema: A CustomerSkAdNetworkConversionValueSchema.
      - `resourceName` string: Output only. The resource name of the schema. CustomerSkAdNetworkConversionValueSchema resource names have the form: customers/{customer_id}/customerSkAdNetworkConversionValueSchemas/{account_link_id}
      - `schema` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchema: The CustomerLink specific SkAdNetworkConversionValueSchema.
        - `appId` string: Required. Output only. Apple App Store app ID.
        - `fineGrainedConversionValueMappings` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaFineGrainedConversionValueMappings[]: Output only. Fine grained conversion value mappings.
          - `conversionValueMapping` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaConversionValueMapping: Represents mapping from one conversion value to one or more conversion events.
            - `mappedEvents` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaEvent[]: Output only. The conversion value may be mapped to multiple events with various attributes.
              - …
            - `maxTimePostInstallHours` string, int64: Output only. The maximum of the time range in which a user was last active during the measurement window.
            - `minTimePostInstallHours` string, int64: Output only. The minimum of the time range in which a user was last active during the measurement window.
          - `fineGrainedConversionValue` integer: Output only. Fine grained conversion value. Valid values are in the inclusive range [0,63].
        - `measurementWindowHours` integer: Output only. A time window (measured in hours) post-install, after which the App Attribution Partner or advertiser stops calling [updateConversionValue] (https://developer.apple.com/documentation/storekit/skadnetwork/3566697-updateconversionvalue).
        - `postbackMappings` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaPostbackMapping[]: Output only. Per-postback conversion value mappings for postbacks in multiple conversion windows. Only applicable for SkAdNetwork versions >= 4.0.
          - `coarseGrainedConversionValueMappings` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaCoarseGrainedConversionValueMappings: Mappings for coarse grained conversion values.
            - `highConversionValueMapping` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaConversionValueMapping: Represents mapping from one conversion value to one or more conversion events.
              - …
            - `lowConversionValueMapping` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaConversionValueMapping: Represents mapping from one conversion value to one or more conversion events.
              - …
            - `mediumConversionValueMapping` GoogleAdsSearchads360V23ResourcesCustomerSkAdNetworkConversionValueSchemaSkAdNetworkConversionValueSchemaConversionValueMapping: Represents mapping from one conversion value to one or more conversion events.
              - …
          - `lockWindowCoarseConversionValue` 'UNSPECIFIED' | 'UNKNOWN' | 'UNAVAILABLE' | 'LOW' | 'MEDIUM' | 'HIGH' | 'NONE': Output only. Coarse grained conversion value that triggers conversion window lock.
          - `lockWindowEvent` string: Output only. Event name that triggers conversion window lock.
          - `lockWindowFineConversionValue` integer: Output only. Fine grained conversion value that triggers conversion window lock.
          - `postbackSequenceIndex` integer: Output only. 0-based index that indicates the order of postback. Valid values are in the inclusive range [0,2].
  - `validateOnly` boolean: If true, the request is validated but not executed. Only errors are returned, not results.

## Response `200`

Successful response

- GoogleAdsSearchads360V23ServicesMutateCustomerSkAdNetworkConversionValueSchemaResponse: Response message for MutateCustomerSkAdNetworkConversionValueSchema.
  - `result` GoogleAdsSearchads360V23ServicesMutateCustomerSkAdNetworkConversionValueSchemaResult: The result for the CustomerSkAdNetworkConversionValueSchema mutate.
    - `appId` string: App ID of the SkanConversionValue modified.
    - `resourceName` string: Resource name of the customer that was modified.
  - `warning` GoogleRpcStatus: The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
    - `code` integer: The status code, which should be an enum value of google.rpc.Code.
    - `details` object[]: A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `message` string: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.

---

[API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)