Conversion

Ресурс конверсии содержит методы, которые позволяют пользователям создавать, изменять и извлекать конверсии Floodlight в больших объемах.

Список методов для этого ресурса смотрите в конце этой страницы.

Представления ресурсов

Список преобразований. 

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string,
      "sessionAttributesEncoded": bytes
    }
  ]
}
Имя свойства Ценить Описание Примечания
conversion[] list Запрашиваемые преобразования.
conversion[]. adGroupId long Идентификатор группы объявлений DS.
conversion[]. adId long Идентификатор объявления DS.
conversion[]. adUserDataConsent string Представляет согласие на предпочтения основных служб платформы (CPS) в настройках. Нет значения по умолчанию. Допустимые значения: GRANTED: желаемый статус согласия — предоставить. Прочитайте предпочтения CPS из настроек GTE. DENIED: желаемый статус согласия — отклонить; список CPS пуст.

Допустимые значения:
  • " DENIED "
  • " GRANTED "
  • " UNKNOWN "
conversion[]. advertiserId long Идентификатор рекламодателя DS.
conversion[]. agencyId long Идентификатор агентства DS.
conversion[]. attributionModel string Доступно рекламодателям только после обращения в службу поддержки DoubleClick Search.
conversion[]. campaignId long Идентификатор кампании DS.
conversion[]. channel string Канал сбыта продукта. Допустимые значения:
  • « local »: физический магазин
  • « online »: интернет-магазин
conversion[]. clickId string Идентификатор клика DS для конверсии.
conversion[]. conversionId string Для офлайн-конверсий рекламодатели предоставляют этот идентификатор. Рекламодатели могут указать любой значимый для них идентификатор. Каждая конверсия в запросе должна указывать уникальный идентификатор, а комбинация идентификатора и временной метки должна быть уникальной среди всех конверсий в рамках рекламодателя.
Для онлайн-конверсий DS копирует dsConversionId или floodlightOrderId в это свойство в зависимости от инструкций Floodlight рекламодателя.
conversion[]. conversionModifiedTimestamp unsigned long Время последнего изменения преобразования в миллисекундах по Гринвичу.
conversion[]. conversionTimestamp unsigned long Время, когда произошло преобразование, в миллисекундах по Гринвичу.
conversion[]. countMillis long Доступно рекламодателям только после обращения в службу поддержки DoubleClick Search.
conversion[]. criterionId long Идентификатор критерия DS (ключевое слово).
conversion[]. currencyCode string Код валюты для дохода от конвертации. Должен быть в алфавитном формате ISO 4217 (3 символа). записываемый
conversion[]. customDimension[] list Пользовательские параметры преобразования, которые можно использовать для фильтрации данных в отчете.
conversion[].customDimension[]. name string Имя пользовательского измерения.
conversion[].customDimension[]. value string Значение пользовательского размера.
conversion[]. customMetric[] list Пользовательские метрики для конверсии.
conversion[].customMetric[]. name string Имя пользовательской метрики.
conversion[].customMetric[]. value double Числовое значение пользовательской метрики.
conversion[]. customerId string Новый идентификатор клиента Search Ads 360. Должен быть аккаунтом клиента. Когда это поле установлено, все остальные поля идентификатора должны быть установлены на новые идентификаторы Search Ads 360.
conversion[]. deviceType string Тип устройства, на котором произошло преобразование.

Допустимые значения:
  • " DESKTOP "
  • " HIGH_END_MOBILE "
  • " OTHER_DEVICE "
  • " TABLET "
conversion[]. dsConversionId long Идентификатор, который DoubleClick Search генерирует для каждой конверсии.
conversion[]. engineAccountId long Идентификатор учетной записи движка DS.
conversion[]. floodlightOrderId string Идентификатор заказа Floodlight, предоставленный рекламодателем для конверсии.
conversion[]. inventoryAccountId long Идентификатор, который DS генерирует и использует для уникальной идентификации учетной записи инвентаря, содержащей продукт.
conversion[]. productCountry string Страна, зарегистрированная для фида Merchant Center, содержащего продукт. Используйте код ISO 3166 для указания страны.
conversion[]. productGroupId long Идентификатор группы продуктов DS.
conversion[]. productId string Идентификатор продукта (SKU).
conversion[]. productLanguage string Язык, зарегистрированный для фида Merchant Center, содержащего продукт. Используйте код ISO 639 для указания языка.
conversion[]. quantityMillis long Величина этого преобразования, в миллисекундах. записываемый
conversion[]. revenueMicros long Сумма дохода от этой конверсии TRANSACTION в микро (значение, умноженное на 1000000, без десятичной точки). Например, чтобы указать значение дохода "10", введите "10000000" (10 миллионов) в запросе. записываемый
conversion[]. segmentationId long Числовой идентификатор сегментации (например, идентификатор активности DoubleClick Search Floodlight).
conversion[]. segmentationName string Дружественный идентификатор сегментации (например, название действия DoubleClick Search Floodlight).
conversion[]. segmentationType string Тип сегментации данного преобразования (например, FLOODLIGHT ).

Допустимые значения:
  • " FLOODLIGHT "
conversion[]. sessionAttributesEncoded bytes Атрибуты сеанса для события, представленные в виде строки JSON в кодировке base64. Содержимое должно быть сгенерировано библиотекой, предоставленной Google.
conversion[]. state string Состояние преобразования, то есть ACTIVE или REMOVED . Примечание: состояние DELETED устарело.

Допустимые значения:
  • " ACTIVE "
  • « DELETED »: (Устаревшее)
  • " REMOVED "
 записываемый
conversion[]. storeId string Идентификатор локального магазина, для которого рекламировался продукт. Применимо только когда канал " local ".
conversion[]. type string Тип конверсии, то есть ACTION или TRANSACTION . Конверсия ACTION — это действие пользователя, которое не имеет денежной количественной стоимости, в то время как конверсия TRANSACTION — это действие, которое имеет денежную количественной стоимости. Примерами являются подписки на рассылку ( ACTION ) и покупки в электронной коммерции ( TRANSACTION ).

Допустимые значения:
  • " ACTION "
  • " TRANSACTION "
kind string Определяет это как ресурс ConversionList. Значение: фиксированная строка doubleclicksearch#conversionList .

Методы

получать
Извлекает список конверсий из учетной записи поисковой системы DoubleClick.
получитьПоКлиентИдентификатору
Извлекает список конверсий из учетной записи поисковой системы DoubleClick, используя новый идентификатор клиента Search Ads 360.
вставлять
Вставляет пакет новых конверсий в DoubleClick Search.
обновлять
Обновляет пакет конверсий в DoubleClick Search.
обновлениеДоступность
Обновляет доступность пакета действий Floodlight в DoubleClick Search.