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
    }
  ]
}

Имя свойства	Ценить	Описание	Примечания
conversion[]	list	Запрошенные преобразования.
conversion[]. adGroupId	long	Идентификатор группы объявлений DS.
conversion[]. adId	long	Идентификатор объявления DS.
conversion[]. adUserDataConsent	string	Представляет согласие на предпочтения основных служб платформы (CPS) в настройках. Нет значения по умолчанию. Приемлемые значения: GRANTED: Желаемый статус согласия — предоставить. Прочтите настройки CPS в настройках GTE. ЗАПРЕЩЕНО: Желаемый статус согласия — отклонить; Список CPS пуст.
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	Время последнего изменения преобразования в миллисе UTC.
conversion[]. conversionTimestamp	unsigned long	Время, в которое произошло преобразование, в миллисе UTC.
conversion[]. countMillis	long	Доступно рекламодателям только после обращения в службу поддержки клиентов DoubleClick Search.
conversion[]. criterionId	long	Идентификатор критерия DS (ключевого слова).
conversion[]. currencyCode	string	Код валюты дохода от конвертации. Должен быть в алфавитном (3-символьном) формате ISO 4217.	записываемый
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	Новый идентификатор клиента Поисковой рекламы 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[]. 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.

GetByCustomerId

Получает список конверсий из аккаунта поисковой системы DoubleClick с использованием нового идентификатора клиента Search Ads 360.

вставлять

Вставляет пакет новых конверсий в DoubleClick Search.

обновлять

Обновляет пакет конверсий в DoubleClick Search.

обновлениеДоступность

Обновляет доступность пакета действий Floodlight в DoubleClick Search.