Сохраненные столбцы

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

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

Получить список сохраненных столбцов

Чтобы просмотреть все сохраненные столбцы, созданные рекламодателем, отправьте запрос SavedColumns.list() . Ответ включает savedColumnName для каждого столбца рекламодателя.

Запросить отчеты по сохраненным столбцам

Чтобы включить сохраненный столбец в запрос отчета, добавьте столбец с атрибутом savedColumnName , равным имени столбца:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

При использовании сохраненных столбцов имейте в виду, что:

  • Сохраненные столбцы определяются на уровне рекламодателя. Если вы включаете в запрос сохраненный столбец, в request.reportScope необходимо указать рекламодателя или более низкую область действия. Следовательно, каждый отчет может включать сохраненные столбцы только для одного рекламодателя.

  • Имена сохраненных столбцов чувствительны к регистру, пробелам и пунктуации. Атрибут savedColumnName должен точно соответствовать имени сохраненного столбца. Если имя сохраненного столбца идентично названию другого столбца в том же запросе, Search Ads 360 потребует указать альтернативный уникальный headerText для одного или обоих столбцов.

  • Сохраненные столбцы можно изменить или удалить в пользовательском интерфейсе управления кампанией Search Ads 360 в любое время; Если запрос, указывающий сохраненные столбцы, завершается неудачей, попробуйте удалить сохраненные столбцы из запроса и отправить его снова.

  • Инкрементные отчеты не могут содержать показатели, которые явно не поддерживаются API (например, столбцы активности Google Analytics). Кроме того, поскольку пользователи Search Ads 360 могут переопределять сохраненные столбцы, добавочные отчеты, содержащие сохраненные столбцы, могут быть неточными.