Отчет о целях кампании и группы объявлений

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

Цели — это критерии показа рекламы на основе местоположения, демографических данных и других характеристик поискового запроса. Например, рекламодатель может настроить таргетинг объявлений кампании на показ только в Нью-Йорке, Бостоне и Чикаго. Или рекламодатель может увеличить ставки для поисковых запросов представителей определенной рекламной аудитории, тем самым увеличивая вероятность того, что реклама появится у этой аудитории.

Некоторые типы целей можно применять только к кампаниям, а другие — только к группам объявлений. Чтобы узнать, какие цели доступны на каждом уровне, обратитесь к документации по отчетам campaignTarget и adGroupTarget .

Вы можете запросить отчеты, показывающие показатели производительности для определенных типов целей. Например, если рекламодатель ориентирует кампанию на географические местоположения, включите столбец locationTargetName в запрос campaignTarget . Когда вы получите сгенерированный отчет, вы сможете увидеть, как кампания работала в каждом целевом местоположении.

Отрицательные цели

Отрицательные цели предотвращают показ объявлений, когда поисковые запросы соответствуют определенным критериям. Как и в случае с целями, некоторые типы минус-целей можно применять только к кампаниям, а другие — только к группам объявлений. Дополнительные сведения см. в разделах negativeCampaignTarget и negativeAdGroupTarget .

Вы можете запросить отчеты, чтобы просмотреть критерии, по которым минус-цели исключают рекламу. Например, если рекламодатель использует отрицательные цели, чтобы предотвратить показ рекламы в определенных географических местоположениях, включите столбец locationTargetName в запрос negativeCampaignTarget . Когда вы получите созданный отчет, вы увидите список мест, исключенных из кампании.

Примеры запросов

Вот примеры запросов для разных типов целей:

Отчет о целевых местоположениях в кампании

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

Пример запроса

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Пример отчета

Ниже приведен пример отчета campaignTarget . В отчете показана производительность для цели географического местоположения с указанием «США», цели близости с указанием «100,0 миль вокруг (37,4220041,-122,0862462)» и еще одной цели географического расположения с указанием почтового индекса США (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

Цели ремаркетинга для всех групп объявлений в аккаунте

Следующий пример асинхронного запроса возвращает количество кликов, показов и другие данные для всех целей ремаркетинга, определенных для групп объявлений в конкретной кампании Google Рекламы.

Пример запроса

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Пример отчета

Ниже приведен пример отчета adGroupTarget . В отчете показано, что три группы объявлений в кампании «Аксессуары» определяют цели ремаркетинга. Также включены показатели эффективности для каждой цели ремаркетинга:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

Цели динамической рекламы для всех групп объявлений в аккаунте

Цель динамической рекламы определяет страницы вашего сайта, которые вы хотите рекламировать с помощью динамических поисковых объявлений. (Цели динамической рекламы доступны только в учетных записях системы Google Рекламы и всегда создаются в определенных группах объявлений.) Google использует свой поисковый индекс, чтобы определить, когда поиск клиента релевантнен каким-либо страницам, соответствующим вашим целям динамической рекламы. Если поиск релевантный, Google отображает динамическое поисковое объявление, которое вы определили в той же группе объявлений, что и целевые.

Следующий пример асинхронного запроса возвращает количество кликов, показов и другие данные для всех целей динамической рекламы, определенных для групп объявлений в системном аккаунте.

Пример запроса

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Пример отчета

Ниже приведен пример отчета adGroupTarget . В отчете показано, что одна группа объявлений в кампании «Магазины Google» определяет цель динамической рекламы. Также включены показатели эффективности для цели:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

Отчет об исключенных целевых местоположениях для кампаний

Следующий пример асинхронного запроса возвращает местоположения, исключенные из кампаний в системном аккаунте (отчеты по исключенным целевым местоположениям доступны только для кампаний Google Рекламы). Отрицательные цели местоположения используют в качестве критериев только цели географического местоположения (они не могут указывать цели близости или радиуса ). Таким образом, отчеты для исключенных целевых местоположений содержат только список географических местоположений, исключенных из кампаний в области отчета.

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

Пример запроса

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Пример отчета

Ниже приведен пример отчета negativeCampaignTarget . В отчете показано, что кампания «Грандиозные открытия – Северо-восток» исключает штат Мэн, а кампания «Грандиозные открытия – Запад» исключает штат Калифорния:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA