- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- CustomerSkadNetworkConversionValueSchemaOperation
- CustomerSkadNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- Сопоставление значений конверсии
- Событие
- Диапазон доходов
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkadNetworkConversionValueSchemaResult
- Попробуй это!
Создает или обновляет CustomerSkAdNetworkConversionValueSchema.
Список выброшенных ошибок: AuthenticationError AuthorizationError FieldError InternalError MutateError
HTTP-запрос
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Идентификатор клиента, общие наборы которого изменяются. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"operation": {
object ( |
Поля | |
---|---|
operation | Операция, которую необходимо выполнить. |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
enableWarnings | Необязательный. Если true, включает возврат предупреждений. Предупреждения возвращают сообщения об ошибках и коды ошибок, не блокируя выполнение операции изменения. |
Тело ответа
Ответное сообщение для customerSkAdNetworkConversionValueSchemas.mutate.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "result": { object ( |
Поля | |
---|---|
result | Все результаты для mutate. |
warning | Неблокирующие ошибки, которые предоставляют подробную информацию об ошибке проверки схемы. Возвращается только в том случае, если EnableWarnings = true. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
CustomerSkadNetworkConversionValueSchemaOperation
Одна операция обновления для CustomerSkAdNetworkConversionValueSchema.
JSON-представление |
---|
{
"update": {
object ( |
Поля | |
---|---|
update | Операция обновления: ожидается, что схема будет иметь допустимое имя ресурса. |
CustomerSkadNetworkConversionValueSchema
CustomerSkAdNetworkConversionValueSchema.
JSON-представление |
---|
{
"resourceName": string,
"schema": {
object ( |
Поля | |
---|---|
resourceName | Только вывод. Имя ресурса схемы. Имена ресурсов CustomerSkAdNetworkConversionValueSchema имеют вид: клиенты/{customerId}/customerSkAdNetworkConversionValueSchema/{accountLinkId} |
schema | Только вывод. Схема для указанного ресурса. |
SkAdNetworkConversionValueSchema
Специальная схема SkAdNetworkConversionValueSchema для CustomerLink.
JSON-представление |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
Поля | |
---|---|
appId | Необходимый. Только вывод. Идентификатор приложения Apple App Store. |
measurementWindowHours | Только вывод. Временной интервал (измеряется в часах) после установки, после которого партнер по атрибуции приложений или рекламодатель перестает вызывать updateConversionValue . |
fineGrainedConversionValueMappings[] | Только вывод. Детальное сопоставление ценности конверсии. Для версий SkAdNetwork >= 4.0, поддерживающих несколько окон конверсии, детальные сопоставления значений конверсии применимы только к первой обратной передаче. |
postbackMappings[] | Только вывод. Сопоставление значений конверсии для каждой обратной передачи для обратных передач в нескольких окнах конверсий. Применимо только для версий SkAdNetwork >= 4.0. |
FineGrainedConversionValueMappings
Сопоставления для детальной оценки ценности конверсии.
JSON-представление |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
Поля | |
---|---|
fineGrainedConversionValue | Только вывод. Детализированная ценность конверсии. Допустимые значения находятся в инклюзивном диапазоне [0,63]. |
conversionValueMapping | Только вывод. События конверсии, которым соответствует детальная ценность конверсии. |
Сопоставление значений конверсии
Представляет сопоставление одной ценности конверсии с одним или несколькими событиями конверсии.
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, например, «USD». |
Объединённое поле revenue_rate . Либо диапазон, либо конкретное значение дохода от мероприятий. revenue_rate может быть только одним из следующих: | |
eventRevenueRange | Только вывод. Диапазон доходов от мероприятий. |
eventRevenueValue | Только вывод. Значение дохода от конкретного мероприятия. |
Поле объединения event_rate . Либо диапазон, либо конкретное значение счетчика событий. event_rate может быть только одним из следующих: | |
eventOccurrenceRange | Только вывод. Диапазон счетчика событий. |
eventCounter | Только вывод. Для конкретных значений счетчика событий. |
Диапазон доходов
Определяет диапазон значений дохода.
JSON-представление |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
Поля | |
---|---|
minEventRevenue | Только вывод. Для диапазонов доходов — минимальное значение в |
maxEventRevenue | Только вывод. Для диапазонов доходов — максимальное значение в |
EventOccurrenceRange
Определяет диапазон значений счетчика событий.
JSON-представление |
---|
{ "minEventCount": string, "maxEventCount": string } |
Поля | |
---|---|
minEventCount | Только вывод. Для диапазонов счетчиков событий — минимум определенного диапазона. Значение 0 будет считаться неустановленным. |
maxEventCount | Только вывод. Для диапазонов счетчиков событий — максимум определенного диапазона. Значение 0 будет считаться неустановленным. |
ПостбэкМэппинг
Сопоставления для каждого постбэка в нескольких окнах конверсии.
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 изменен. |