Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

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

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

HTTP-запрос

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

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

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

Параметры
customerId

string

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

Тело запроса

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

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

object ( CustomerSkAdNetworkConversionValueSchemaOperation )

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

validateOnly

boolean

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

enableWarnings

boolean

Необязательный. Если true, включает возврат предупреждений. Предупреждения возвращают сообщения об ошибках и коды ошибок, не блокируя выполнение операции изменения.

Тело ответа

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

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

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

object ( MutateCustomerSkAdNetworkConversionValueSchemaResult )

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

warning

object ( Status )

Неблокирующие ошибки, которые предоставляют подробную информацию об ошибке проверки схемы. Возвращается только в том случае, если EnableWarnings = true.

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

Требуется следующая область действия 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}/customerSkAdNetworkConversionValueSchema/{accountLinkId}

schema

object ( SkAdNetworkConversionValueSchema )

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

SkAdNetworkConversionValueSchema

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

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

string

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

measurementWindowHours

integer

Только вывод. Временной интервал (измеряется в часах) после установки, после которого партнер по атрибуции приложений или рекламодатель перестает вызывать 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 )

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

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

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

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 будет считаться неустановленным.

ПостбэкМэппинг

Сопоставления для каждого постбэка в нескольких окнах конверсии.

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