REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Ресурс: SKAdNetworkConversionValueSchema

Схема значения преобразования SKAdNetwork для потока iOS.

JSON-представление
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Поля
name

string

Только вывод. Имя ресурса схемы. Это будет дочерний элемент ТОЛЬКО потока iOS, и в потоке iOS может быть не более одного такого дочернего элемента. Формат: свойства/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object ( PostbackWindow )

Необходимый. Настройки ценности конверсии для первого окна постбэка. Они отличаются от значений для второго и третьего окна обратной передачи тем, что содержат «точное» детализированное значение конверсии (числовое значение).

Необходимо установить значения конверсии для этого окна обратной передачи. Остальные окна являются необязательными и могут наследовать настройки этого окна, если они не установлены или отключены.

postbackWindowTwo

object ( PostbackWindow )

Настройки ценности конверсии для второго окна постбэка.

Это поле следует настраивать только в том случае, если необходимо определить разные значения конверсии для этого окна обратной передачи.

Если для этого окна обратной передачи для параметра Enable_postback_window_settings установлено значение false, будут использоваться значения из postbackWindowOne.

postbackWindowThree

object ( PostbackWindow )

Настройки ценности конверсии для третьего окна постбэка.

Это поле следует задавать только в том случае, если пользователь решил определить разные значения конверсии для этого окна обратной передачи. Разрешено настраивать окно 3 без настройки окна 2. Если установлены настройки окон 1 и 2, а для параметра Enable_postback_window_settings для этого окна обратной передачи установлено значение false, схема унаследует настройки из postbackWindowTwo.

applyConversionValues

boolean

Если этот параметр включен, SDK GA будет устанавливать ценность конверсий, используя это определение схемы, и схема будет экспортироваться во все аккаунты Google Рекламы, связанные с этим ресурсом. Если этот параметр отключен, GA SDK не будет автоматически устанавливать значения конверсий, а также схема не будет экспортироваться в рекламу.

ПостбэкОкно

Настройки окна постбэка конверсии SKAdNetwork.

JSON-представление
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Поля
conversionValues[]

object ( ConversionValues )

Порядок повторяющихся полей будет использоваться для определения приоритета настроек ценности конверсии. Записи с более низким индексом имеют более высокий приоритет. Будет выбрана первая настройка ценности конверсии, которая имеет значение true. В нем должна быть хотя бы одна запись, если для параметра Enable_postback_window_settings установлено значение true. Он может иметь максимум 128 записей.

postbackWindowSettingsEnabled

boolean

Если для параметра Enable_postback_window_settings установлено значение true, значение конверсионных значений должно быть заполнено и будет использоваться для определения того, когда и как установить ценность конверсии на клиентском устройстве, а также для экспорта схемы в связанные учетные записи рекламы. Если false, настройки не используются, но сохраняются на случай, если они могут быть использованы в будущем. Это всегда должно быть верно для postbackWindowOne.

Ценности конверсий

Настройки ценности конверсии для окна обратной передачи для схемы ценности конверсии SKAdNetwork.

JSON-представление
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Поля
displayName

string

Отображаемое имя значения преобразования SKAdNetwork. Максимально допустимая длина отображаемого имени — 50 кодовых единиц UTF-16.

coarseValue

enum ( CoarseValue )

Необходимый. Грубо детализированное значение конверсии.

Уникальность этого значения не гарантируется.

eventMappings[]

object ( EventMapping )

Условия события, которые должны быть выполнены для достижения этой ценности конверсии. Условия в этом списке объединены оператором AND. В нем должно быть минимум 1 запись и максимум 3 записи, если окно обратной передачи включено.

lockEnabled

boolean

Если это правда, SDK должен зафиксировать это значение преобразования для текущего окна обратной передачи.

fineValue

integer

Детализированная ценность конверсии. Это применимо только к первому окну обратной передачи. Его допустимые значения — [0,63] включительно. Оно должно быть установлено для окна обратной передачи 1 и не должно быть установлено для окон обратной передачи 2 и 3. Уникальность этого значения не гарантируется.

Если конфигурация первого окна обратной передачи повторно используется для второго или третьего окна обратной передачи, это поле не имеет никакого эффекта.

Грубое значение

Значение грубого преобразования, установленное при вызове SDK updatePostbackConversionValue, когда условия ConversionValues.event_mappings удовлетворены. Дополнительные сведения см. в разделе SKAdNetwork.CoarseConversionValue .

Перечисления
COARSE_VALUE_UNSPECIFIED Грубое значение не указано.
COARSE_VALUE_LOW Грубое значение низкое.
COARSE_VALUE_MEDIUM Грубое значение среды.
COARSE_VALUE_HIGH Грубое значение высокого.

Сопоставление событий

Условия настройки события, соответствующие событию.

JSON-представление
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Поля
eventName

string

Необходимый. Название события GA4. Он должен быть установлен всегда. Максимально допустимая длина отображаемого имени — 40 кодовых единиц UTF-16.

minEventCount

string ( int64 format)

Должно быть установлено хотя бы одно из следующих четырех минимальных/максимальных значений. Набор значений будет объединен с помощью AND для квалификации события. Минимальное количество раз, когда событие произошло. Если не установлено, минимальное количество событий проверяться не будет.

maxEventCount

string ( int64 format)

Максимальное количество раз, когда событие произошло. Если не установлено, максимальное количество событий проверяться не будет.

minEventValue

number

Минимальный доход, полученный в результате мероприятия. Валюта дохода будет определена на уровне ресурса. Если не установлено, минимальное значение события проверяться не будет.

maxEventValue

number

Максимальный доход, полученный благодаря событию. Валюта дохода будет определена на уровне ресурса. Если не установлено, максимальное значение события не будет проверяться.

Методы

create

 Создает SKAdNetworkConversionValueSchema.

delete

 Удаляет целевой SKAdNetworkConversionValueSchema.

get

 Ищет одну SKAdNetworkConversionValueSchema.

list

 Перечисляет SKAdNetworkConversionValueSchema в потоке.

patch

 Обновляет SKAdNetworkConversionValueSchema.
,

Ресурс: SKAdNetworkConversionValueSchema

Схема значения преобразования SKAdNetwork для потока iOS.

JSON-представление
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Поля
name

string

Только вывод. Имя ресурса схемы. Это будет дочерний элемент ТОЛЬКО потока iOS, и в потоке iOS может быть не более одного такого дочернего элемента. Формат: свойства/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object ( PostbackWindow )

Необходимый. Настройки ценности конверсии для первого окна постбэка. Они отличаются от значений для второго и третьего окна обратной передачи тем, что содержат «точное» детализированное значение конверсии (числовое значение).

Необходимо установить значения конверсии для этого окна обратной передачи. Остальные окна являются необязательными и могут наследовать настройки этого окна, если они не установлены или отключены.

postbackWindowTwo

object ( PostbackWindow )

Настройки ценности конверсии для второго окна постбэка.

Это поле следует настраивать только в том случае, если необходимо определить разные значения конверсии для этого окна обратной передачи.

Если для этого окна обратной передачи для параметра Enable_postback_window_settings установлено значение false, будут использоваться значения из postbackWindowOne.

postbackWindowThree

object ( PostbackWindow )

Настройки ценности конверсии для третьего окна постбэка.

Это поле следует задавать только в том случае, если пользователь решил определить разные значения конверсии для этого окна обратной передачи. Разрешено настраивать окно 3 без настройки окна 2. Если установлены настройки окон 1 и 2, а для параметра Enable_postback_window_settings для этого окна обратной передачи установлено значение false, схема унаследует настройки из postbackWindowTwo.

applyConversionValues

boolean

Если этот параметр включен, SDK GA будет устанавливать ценность конверсий, используя это определение схемы, и схема будет экспортироваться во все аккаунты Google Рекламы, связанные с этим ресурсом. Если этот параметр отключен, GA SDK не будет автоматически устанавливать значения конверсий, а также схема не будет экспортироваться в рекламу.

ПостбэкОкно

Настройки окна постбэка конверсии SKAdNetwork.

JSON-представление
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Поля
conversionValues[]

object ( ConversionValues )

Порядок повторяющихся полей будет использоваться для определения приоритета настроек ценности конверсии. Записи с более низким индексом имеют более высокий приоритет. Будет выбрана первая настройка ценности конверсии, которая имеет значение true. В нем должна быть хотя бы одна запись, если для параметра Enable_postback_window_settings установлено значение true. Он может иметь максимум 128 записей.

postbackWindowSettingsEnabled

boolean

Если для параметра Enable_postback_window_settings установлено значение true, значение конверсионных значений должно быть заполнено и будет использоваться для определения того, когда и как установить ценность конверсии на клиентском устройстве и экспортировать схему в связанные учетные записи рекламы. Если false, настройки не используются, но сохраняются на случай, если они могут быть использованы в будущем. Это всегда должно быть верно для postbackWindowOne.

Ценности конверсий

Настройки ценности конверсии для окна обратной передачи для схемы ценности конверсии SKAdNetwork.

JSON-представление
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Поля
displayName

string

Отображаемое имя значения преобразования SKAdNetwork. Максимально допустимая длина отображаемого имени — 50 кодовых единиц UTF-16.

coarseValue

enum ( CoarseValue )

Необходимый. Грубо детализированное значение конверсии.

Уникальность этого значения не гарантируется.

eventMappings[]

object ( EventMapping )

Условия события, которые должны быть выполнены для достижения этой ценности конверсии. Условия в этом списке объединены оператором AND. В нем должно быть минимум 1 запись и максимум 3 записи, если окно обратной передачи включено.

lockEnabled

boolean

Если это правда, SDK должен зафиксировать это значение преобразования для текущего окна обратной передачи.

fineValue

integer

Детализированная ценность конверсии. Это применимо только к первому окну обратной передачи. Его допустимые значения — [0,63] включительно. Оно должно быть установлено для окна обратной передачи 1 и не должно быть установлено для окон обратной передачи 2 и 3. Уникальность этого значения не гарантируется.

Если конфигурация первого окна обратной передачи повторно используется для второго или третьего окна обратной передачи, это поле не имеет никакого эффекта.

Грубое значение

Значение грубого преобразования, установленное при вызове SDK updatePostbackConversionValue, когда условия ConversionValues.event_mappings удовлетворены. Дополнительные сведения см. в разделе SKAdNetwork.CoarseConversionValue .

Перечисления
COARSE_VALUE_UNSPECIFIED Грубое значение не указано.
COARSE_VALUE_LOW Грубое значение низкое.
COARSE_VALUE_MEDIUM Грубое значение среды.
COARSE_VALUE_HIGH Грубое значение высокого.

Сопоставление событий

Условия настройки события, соответствующие событию.

JSON-представление
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Поля
eventName

string

Необходимый. Название события GA4. Он должен быть установлен всегда. Максимально допустимая длина отображаемого имени — 40 кодовых единиц UTF-16.

minEventCount

string ( int64 format)

Должно быть установлено хотя бы одно из следующих четырех минимальных/максимальных значений. Набор значений будет объединен с помощью AND для квалификации события. Минимальное количество раз, когда событие произошло. Если не установлено, минимальное количество событий проверяться не будет.

maxEventCount

string ( int64 format)

Максимальное количество раз, когда событие произошло. Если не установлено, максимальное количество событий проверяться не будет.

minEventValue

number

Минимальный доход, полученный в результате мероприятия. Валюта дохода будет определена на уровне ресурса. Если не установлено, минимальное значение события не будет проверяться.

maxEventValue

number

Максимальный доход, полученный благодаря событию. Валюта дохода будет определена на уровне ресурса. Если не установлено, максимальное значение события проверяться не будет.

Методы

create

 Создает SKAdNetworkConversionValueSchema.

delete

 Удаляет целевой SKAdNetworkConversionValueSchema.

get

 Ищет одну SKAdNetworkConversionValueSchema.

list

 Перечисляет SKAdNetworkConversionValueSchema в потоке.

patch

 Обновляет SKAdNetworkConversionValueSchema.