Часто задаваемые вопросы об отчетах

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

Каков должен быть объем моего отчета?

Для большинства отчетов мы рекомендуем указать в Reports.reportScope конкретную учетную запись системы или рекламодателя. Для очень больших отчетов, таких как отчеты по ключевым словам, отчеты о конверсиях или мелко сегментированные отчеты, мы рекомендуем ограничить область действия определенным аккаунтом системы. API может возвращать ошибки для отчетов, содержащих более 10 миллионов строк.

Почему я получаю сообщение об ошибке «Запрещено (403)»?

Скорее всего, вам необходимо получить обновленный токен OAuth .

Как найти идентификаторы агентств и рекламодателей?

Если у вас еще нет идентификаторов агентств и рекламодателей, на просмотр которых у вас есть разрешение, запросите отчет advertiser с помощью столбцов agencyId и advertiserId , но не указывайте reportScope . Поисковая реклама 360 вернет список всех идентификаторов агентств и рекламодателей, на просмотр которых у вашего аккаунта Google есть разрешение.

Вот пример запроса:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

Насколько свежи данные отчетности?

Некоторые показатели более свежие, чем другие. Подробнее см., насколько актуальны данные отчетов в Search Ads 360?

Чтобы убедиться, что ваши отчеты содержат все доступные показатели, мы рекомендуем подождать около 4 часов после полуночи (часовой пояс учетной записи системы), прежде чем запрашивать отчеты о вчерашних показателях; для получения отчета conversion мы рекомендуем подождать 12 часов после полуночи (часовой пояс рекламодателя Менеджера кампании). Если вы используете API для загрузки данных о конверсиях, ознакомьтесь с информацией о доступности загруженных данных в разделе Insert.operation .

Даже через несколько дней показатель может измениться из-за спам-фильтров или офлайн-конверсий, загружаемых через API. Чтобы постепенно загрузить эти изменения, запросите отчеты о данных, которые изменились с момента последней загрузки. Если вы загружаете дополнительные изменения, мы рекомендуем время от времени запрашивать полный отчет. Например, вы можете загружать дополнительные изменения каждые несколько дней, а затем запрашивать полный отчет раз в месяц.

Когда изменения атрибутов появятся в отчетах?

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

Мы рекомендуем возвращать только те данные, которые изменились , чтобы определить, какие сущности имеют изменения атрибутов.

Что такое объявления и ключевые слова без атрибуции?

Иногда Search Ads 360 не может привязать показатели к конкретному объявлению. Например, объявление неподдерживаемого формата или URL-адрес сервера кликов с ошибкой могут помешать Search Ads 360 присвоить метрики объявлению. Для каждой группы объявлений Search Ads 360 сообщает, что все показатели без атрибуции относятся к «объявлению без атрибуции». Чтобы запросить эти метрики в отчете, установите для includeRemovedEntities значение true . Чтобы было проще увидеть, какие объявления не имеют атрибуции, включите в запрос столбец isUnattributedAd .

Точно так же иногда Search Ads 360 не может привязать показатели к определенному ключевому слову. Это происходит при возникновении расхождений в отчетности. В таких случаях столбец keywordId для ключевых слов без атрибутов устанавливается в 0.

Включают ли отчеты масштабированные конверсии?

В некоторых случаях конверсии трудно измерить, например, когда файлы cookie веб-сайта, в которых хранится информация о кликах по вашим объявлениям, недоступны из-за таких факторов, как настройки браузера. В таких случаях Floodlight использует масштабирование для учета данных о конверсиях, которые невозможно измерить напрямую. То есть Floodlight применяет машинное обучение к историческим данным для моделирования количества конверсий и суммы дохода от конверсий, который невозможно измерить. Затем Floodlight может добавить полученную оценку к своим показателям конверсий, чтобы получить более полную картину того, как ваша реклама способствует конверсиям.

Floodlight всегда применяет масштабирование к следующим столбцам отчетов:

Отчет conversion не включает масштабированные конверсии. Здесь показаны только те конверсии, которые были измерены напрямую. Ожидается, что количество конверсий и сумма дохода в отчете conversion не будут совпадать с конверсиями и доходом, указанными в столбцах, перечисленных выше.

Почему необработанные конверсии не суммируются с совокупным показателем X ?

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

Что делать, если здесь нет ответа на мой вопрос?

Если возникла проблема, которую вы не можете решить после прочтения ресурсов на этом сайте, обратитесь в службу поддержки и подготовьте следующую информацию:

  • Идентификатор агентства Search Ads 360 и идентификатор рекламодателя, к которому вы пытаетесь получить доступ.

  • Номер проекта из консоли Google API

  • Имя пользователя учетной записи Google, которую вы используете для доступа к API.
    Это аккаунт, которому предоставлено разрешение на доступ к Search Ads 360 ; это тот же аккаунт, который вы используете для настройки авторизации .

  • Фрагмент кода вашего запроса

  • JSON-ответ
    Если ответ представляет собой ошибку, обязательно укажите сообщение об ошибке, а не только цифровой код ошибки.