Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Создает или обновляет CustomerSkAdNetworkConversionValueSchema.

Список выброшенных ошибок: AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Идентификатор клиента, общие наборы которого изменяются.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
Поля
operation

object ( CustomerSkAdNetworkConversionValueSchemaOperation )

Операция, которую необходимо выполнить.

validateOnly

boolean

Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты.

Тело ответа

Ответное сообщение для customerSkAdNetworkConversionValueSchemas.mutate.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
Поля
result

object ( MutateCustomerSkAdNetworkConversionValueSchemaResult )

Все результаты для mutate.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

CustomerSkadNetworkConversionValueSchemaOperation

Одна операция обновления для CustomerSkAdNetworkConversionValueSchema.

JSON-представление
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Поля
update

object ( CustomerSkAdNetworkConversionValueSchema )

Операция обновления: ожидается, что схема будет иметь допустимое имя ресурса.

CustomerSkadNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema.

JSON-представление
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Поля
resourceName

string

Только вывод. Имя ресурса схемы. Имена ресурсов CustomerSkAdNetworkConversionValueSchema имеют вид: клиенты/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}

schema

object ( SkAdNetworkConversionValueSchema )

Только вывод. Схема для указанного ресурса.

SkAdNetworkConversionValueSchema

Специальная схема SkAdNetworkConversionValueSchema для CustomerLink.

JSON-представление
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
Поля
appId

string

Необходимый. Только вывод. Идентификатор приложения Apple App Store.

measurementWindowHours

integer

Только вывод. Временной интервал (измеряется в часах) после установки, после которого партнер по атрибуции приложений или рекламодатель перестает вызывать updateConversionValue .

fineGrainedConversionValueMappings[]

object ( FineGrainedConversionValueMappings )

Только вывод. Детальное сопоставление ценности конверсии.

FineGrainedConversionValueMappings

Сопоставления для детальной оценки ценности конверсии.

JSON-представление
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Поля
fineGrainedConversionValue

integer

Только вывод. Детализированная ценность конверсии. Допустимые значения находятся в инклюзивном диапазоне [0,63].

conversionValueMapping

object ( ConversionValueMapping )

Только вывод. События конверсии, которым соответствует детальная ценность конверсии.

Сопоставление значений конверсии

Представляет сопоставление одной ценности конверсии с одним или несколькими событиями конверсии.

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, например, «USD».

Объединённое поле revenue_rate . Либо диапазон, либо конкретное значение дохода от мероприятий. revenue_rate может быть только одним из следующих:
eventRevenueRange

object ( RevenueRange )

Только вывод. Диапазон доходов от мероприятий.

eventRevenueValue

number

Только вывод. Значение дохода от конкретного мероприятия.

Поле объединения event_rate . Либо диапазон, либо конкретное значение счетчика событий. event_rate может быть только одним из следующих:
eventOccurrenceRange

object ( EventOccurrenceRange )

Только вывод. Диапазон счетчика событий.

eventCounter

string ( int64 format)

Только вывод. Для конкретных значений счетчика событий.

Диапазон доходов

Определяет диапазон значений дохода.

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 изменен.