Отчеты

Как и в случае с другими типами объявлений, вы можете использовать GoogleAdsService.SearchStream для получения данных о статусе продукта и эффективности для товаров в разделе «Покупки».

Кампании, поддерживающие продукты, имеют следующие специальные отчеты:

• Просмотр эффективности покупок
• Просмотр группы продуктов
• Группа активов Группа продуктов Просмотр
• Продукт для покупок

Примечание: Как «Представление эффективности покупок», так и «Продукт покупок» могут возвращать метрики на уровне товара. «Представление эффективности покупок» предоставляет «историческое» состояние товара, по которому показывалась реклама, тогда как «Продукт покупок» отображает текущее состояние товара независимо от того, показывалась ли по нему реклама. Рекомендуется использовать «Продукт покупок» в первую очередь для оценки «состояния» товара и любых проблем, препятствующих его использованию в кампании.

Просмотр эффективности покупок

Представление «Эффективность покупок» предоставляет агрегированную историческую статистику отчетов для продуктов по таким атрибутам, как product_item_id .

Представление «Эффективность покупок» фиксирует состояние товара на момент регистрации соответствующих метрик. Это включает такие сегменты, как product_title , которые могли измениться с момента регистрации метрики.

Вот пример запроса, который извлекает показы, клики, стоимость, конверсии и все конверсии для продуктов по product_item_id с кликами за последние 30 дней (сортировка по убыванию по всем конверсиям, затем конверсиям, затем кликам, затем стоимости, затем показам):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Просмотр группы продуктов

Представление «Группа продуктов» предоставляет агрегированную статистику отчётности по группам товаров (в пользовательском интерфейсе они называются группами продуктов ). Примеры представления «Группа активов» см. в руководстве по отчётности Performance Max.

Вот пример запроса, который извлекает показы, клики, конверсии и все конверсии для групп списков покупок по кампаниям с показами за последние 30 дней (сортировка по убыванию по всем конверсиям, затем конверсиям, затем кликам, затем показам):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Продукт для покупок

Отчёт «Товары для покупок» содержит атрибуты и статистику по товарам, которые есть в аккаунтах Google Merchant Center, связанных с аккаунтом Google Ads. Этот отчёт можно использовать для анализа статистики на уровне клиента, кампании и группы объявлений.

Вот пример запроса, который извлекает показы, клики, конверсии и все конверсии за последние 30 дней (сортированные по убыванию по всем конверсиям, затем конверсиям, затем кликам, затем показам) для всех товаров в Покупках из всех связанных аккаунтов Google Merchant Center:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Более подробную информацию о запросах см. в руководстве по отчетности .

Соображения производительности

Отчёт по товарам в разделе «Покупки» может возвращать значительный объём данных, если учётная запись связана с большим количеством товаров. Следующие рекомендации помогут повысить производительность запросов GAQL:

• Запросы на уровне кампании и группы объявлений обычно выполняются быстрее, чем запросы на уровне аккаунта, поскольку они, скорее всего, содержат меньше продуктов и требуют доступа к меньшему количеству данных.
• Чем больше полей и метрик в предложении SELECT , тем медленнее ответ. Мы рекомендуем выбирать только те поля и метрики, которые вам нужны в запросе.
• Учтите, что для товаров с одной или несколькими проблемами будет возвращено больше данных. Вы можете отфильтровать данные по shopping_product.status в поле WHERE чтобы понять, какие товары с большей вероятностью будут возвращать проблемы, приведшие к соответствующему статусу.

Примеры использования отчета о покупках

Отчёт «Товары для покупок» обеспечивает гибкий доступ к информации о товарах для кампаний, использующих фиды товаров. Он может предоставить вам сведения о статусе товаров в аккаунтах Google Merchant Center, а также специфичную для рекламы информацию, такую как показатели эффективности и проблемы, препятствующие показу рекламы товаров.

В этом разделе рассматриваются некоторые типичные варианты использования, аналогичные тем, которые возможны в представлении « Продукты » в пользовательском интерфейсе Google Ads.

Поле «issues» для товара Shopping Product аналогично полю productstatuses в Content API for Shopping, но с добавлением проблем, специфичных для Google Ads. Чтобы узнать, нужно ли решать проблему в Google Merchant Center или Google Ads, сначала проверьте поле shopping_product.issues.documentation в ответе, которое включает в себя статью справочного центра.

Статусы продукта (уровень аккаунта)

Указав отчет без фильтров для кампании или группы объявлений, вы получите все продукты на уровне аккаунта.

Поддерживает метрики, статусы и проблемы всех кампаний в аккаунте следующих типов:

• Покупки
• Максимальная производительность

Этот запрос позволяет увидеть статус продукта, например NOT_ELIGIBLE , и список проблем, специфичных для продукта, которые привели к данному статусу:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

Статусы продукта (уровень кампании)

Указание отчета с ресурсом кампании как части предложения WHERE вернет все продукты, включенные в выбранную кампанию.

Поддерживаются следующие типы кампаний, которые могут использовать фиды продуктов:

• Покупки
• Максимальная производительность
• Генерация спроса
• Видео

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

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

Статусы продукта (уровень группы объявлений)

Указав в отчёте как ресурс группы объявлений, так и ресурс кампании в предложении WHERE, вы получите все продукты, включённые в выбранную кампанию. Метрики, статус и проблемы продукта будут отражать, включен ли он в выбранную группу объявлений или исключён.

Этот запрос позволяет увидеть статус товара по отношению к данной группе объявлений. Он позволяет убедиться, что фильтры группы товаров (на уровне группы объявлений) применяются правильно, а также проверить статус каждого товара:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

Примечание: В предложении WHERE необходимо указать как кампанию, так и группу объявлений. Отсутствие одного из них приведёт к одной из следующих ошибок: MISSING_CAMPAIGN_FILTER и MISSING_AD_GROUP_FILTER .

Показатели продукта, отфильтрованные по дате (уровень аккаунта)

Указав отчет с датой или диапазоном дат в предложении WHERE, можно получить метрики для всех продуктов на уровне учетной записи, которые (независимо от того, являются ли метрики ненулевыми) относятся к указанному периоду времени.

Вы не можете выбрать segments.date , это приведет к ошибке UNSUPPORTED_DATE_SEGMENTATION .

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

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

Эффективность продукта с использованием данных корзины

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

• ad_group
• ad_group_ad
• campaign
• customer (агрегировано по всем кампаниям)
• product_group_view
• shopping_performance_view

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

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

Примечание: метрики данных корзины недоступны до тех пор, пока не будут зарегистрированы конверсии для связанных товаров. Выполнение запросов к shopping_performance_view может занять больше времени для аккаунтов с большим количеством товаров, даже с применением фильтров.

В следующем примере показано, как метрики данных корзины можно использовать для анализа эффективности на уровне продукта в торговых кампаниях за последние 30 дней.

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Эффективность кампании с использованием данных корзины

Показатели данных корзины можно использовать на уровне кампании и комбинировать с другими показателями эффективности, такими как показы, клики и стоимость.

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC