Отчет о пользовательских переменных Floodlight

Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании нового API отчетов Search Ads 360 .

Рекламодатели используют пользовательские переменные Floodlight, чтобы сообщать данные о конверсиях, которые соответствуют потребностям их бизнеса, например жанр фильма, который покупает пользователь, название магазина, в котором куплен товар, стоимость доставки и т. д. Данные можно загрузить с помощью тега Floodlight на сайте рекламодателя или с помощью API Search Ads 360 , а вы можете использовать API для загрузки отчетов, содержащих данные.

Узнайте больше о пользовательских переменных Floodlight в Search Ads 360.

Метрика или измерение

При настройке пользовательских переменных Floodlight рекламодатель использует пользовательский интерфейс Search Ads 360, чтобы указать, как каждую переменную можно использовать в отчетах:

  • Метрика . В большинстве отчетов Search Ads 360 объединяет значения переменных, которые определены как метрики.
    Например, рекламодатель использует пользовательскую переменную Floodlight для отслеживания стоимости доставки. Если пользователь Search Ads 360 определяет эту переменную как показатель и вы включаете ее в отчет adGroup , вы увидите общую стоимость доставки, связанную с каждой группой объявлений в области отчета.

    В отчете conversion Search Ads 360 предоставляет необработанные данные об отдельных конверсиях, а не агрегированные данные.

    Примечание. Специальные показатели также могут отображаться в столбцах отчетов Floodlight . В пользовательском интерфейсе Search Ads 360 пользователи добавляют специальные показатели в столбцы отчетов Floodlight, а затем включают столбцы отчетов Floodlight в отчеты. Вы также можете включить эти столбцы Floodlight в запрос отчета, как и любой другой тип сохраненного столбца .

  • Измерение : переменные, определенные как измерения, можно использовать для сегментации большинства отчетов.
    Например, рекламодатель использует специальную переменную Floodlight для отслеживания названий магазинов. После того как пользователь Search Ads 360 определит эту переменную как параметр, вы сможете использовать ее для сегментирования отчета adGroup и просмотра количества покупок в каждом магазине, связанных с рекламой в группе объявлений.

    В отчете conversion Search Ads 360 предоставляет необработанные данные об отдельных конверсиях, а не агрегированные данные. Поэтому, когда вы добавляете специальный параметр в отчет conversion , вы увидите его значение. Продолжая пример из предыдущего абзаца: если вы сегментируете отчет conversion по специальному параметру storeName, вы увидите название магазина, в котором произошла каждая конкретная покупка.

    Примечание. Когда пользователи Search Ads 360 определяют столбец отчетов Floodlight , они могут использовать специальные параметры в качестве фильтра, чтобы в столбце регистрировались только конверсии, в которых зафиксировано определенное значение параметра.

Включение специальных показателей в запрос отчета

Чтобы включить специальные метрики в запрос отчета:

Затем в запрос отчета включите:

  • customMetricName : указывает понятное имя пользовательской метрики.
    Имя специальной метрики чувствительно к регистру.

  • platformSource : всегда устанавливайте значение Floodlight .

Например, если рекламодатель создал специальный показатель с именем ShippingCost , включите в отчет customMetricName ShippingCost: 

{
   "reportScope": {
     "agencyId": "12300000000000456", // Replace with your ID
     "advertiserId": "21700000000011523", // Replace with your ID
   },
   ...
   "columns": [
     {
        "customMetricName": "shippingCost",
        "platformSource": "floodlight"
     }
   ],
   ...
}

Сегментация отчета по специальному параметру

Чтобы сегментировать отчет по специальному параметру:

  • Вам необходимо знать понятное имя, которое было указано при создании пользовательской переменной Floodlight в Менеджере кампаний . Понятное имя также отображается в пользовательском интерфейсе Search Ads 360 при настройке специальных параметров и показателей.

  • Область отчета должна быть указана на конкретного рекламодателя или ниже.

  • В каждом запросе отчета можно указать только один специальный параметр. Но запрос может включать в себя дополнительные неиндивидуальные сегменты .
    Например, вы можете сегментировать отчет по специальному параметру storeName , а также по ненастраиваемым сегментам по кварталам и устройствам. Просто имейте в виду, что количество строк может увеличиваться в геометрической прогрессии с каждым дополнительным сегментом.

Затем в запрос отчета включите:

  • customDimensionName : указывает понятное имя специального измерения.
    Имя специального параметра чувствительно к регистру.

  • platformSource : всегда устанавливайте значение Floodlight .

Например, если рекламодатель создал специальный параметр с именем storeName , включите его в отчет storeName customDimensionName , чтобы сегментировать показатели по названию магазина:

{
   "reportScope": {
     "agencyId": "20700000000000123", // Replace with your IDs
     "advertiserId": "2170000012345" // Replace with your IDs
   },
   "reportType": "campaign",

   "columns": [
     { "columnName": "campaignId" },
     { "columnName": "clicks" },
     { "columnName": "cost" },
     { "columnName": "dfaRevenue"},

     {
        "customDimensionName": "storeName",
        "platformSource": "floodlight"
     }
   ],
   ...
}