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 может быть не более одного такого дочернего элемента. Формат: properties/{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 Google Analytics будет устанавливать значения конверсий, используя это определение схемы, и схема будет экспортирована во все аккаунты Google Ads, связанные с этим ресурсом. Если эта функция отключена, SDK Google Analytics не будет автоматически устанавливать значения конверсий, и схема также не будет экспортироваться в Google Ads.

PostbackWindow

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

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

object ( ConversionValues )

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

postbackWindowSettingsEnabled

boolean

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

ConversionValues

Настройки значений преобразования для окна обратной отправки данных в соответствии со схемой значений преобразования 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 )

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

lockEnabled

boolean

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

fineValue

integer

Точное значение преобразования. Применимо только к первому окну обратной отправки. Допустимые значения: [0,63] включительно. Необходимо установить для первого окна обратной отправки и не устанавливать для второго и третьего окон. Уникальность этого значения не гарантируется.

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

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

Значение грубого преобразования, устанавливаемое при вызове 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

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

minEventCount

string ( int64 format)

Необходимо задать хотя бы одно из следующих четырех значений min/max. Заданные значения будут объединены оператором И для определения события. Минимальное количество раз, когда произошло событие. Если значение не задано, проверка минимального количества событий не будет производиться.

maxEventCount

string ( int64 format)

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

minEventValue

number

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

maxEventValue

number

The maximum revenue generated due to the event. Revenue currency will be defined at the property level. If not set, maximum event value won't be checked.

Методы

create

Создает схему SKAdNetworkConversionValueSchema.

delete

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

get

Выполняет поиск по единственной схеме SKAdNetworkConversionValueSchema.

list

Выводит список SKAdNetworkConversionValueSchema в потоке.

patch

Обновляет значение параметра SKAdNetworkConversionValueSchema.