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.