Автоматические объекты

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

Создание и обновление

После включения этой функции Google Реклама создает автоматические объекты следующим образом:

1. Объекты созданы.
2. Чтобы связать объект с кампанией, группой объявлений или клиентом, создаются объекты CampaignAsset, AdGroupAsset или CustomerAsset соответственно.

Вы не можете создавать или обновлять автоматические объекты с помощью Google Ads API, а также создавать для них CampaignAsset, AdGroupAsset или CustomerAsset.

Вы можете приостановить или удалить объекты CampaignAsset, AdGroupAsset или CustomerAsset, которые связывают автоматический объект с соответствующим ресурсом.

Как приостановить или удалить связь

Приостановка связи временно отключает показ объекта в соответствующем объекте. После этого Google Реклама не будет автоматически включать или показывать соответствующий объект для этого ресурса, пока вы не включите его снова в веб-интерфейсе или через API. Чтобы навсегда отключить связь между объектом и ресурсом, удалите ее.

В Google Рекламе действует ограничение на количество автоматических объектов определенного типа, которые можно связать с определенным объектом, например на количество автоматических дополнительных ссылок в кампании. Приостановленные связи учитываются в этом ограничении, а удаленные – нет. Автоматические объекты объявления не учитываются в ограничениях на количество объектов объявления, добавленных вручную.

Как получить автоматические объекты

Чтобы получить данные об автоматических объектах, отфильтруйте их по значению AssetSource = AUTOMATICALLY_CREATED. Для объектов, которые можно связать с объявлениями, проверьте source. Список типов объектов, которые можно связать с объявлениями, приведен в статье AssetType.

Ниже приведен пример запроса для объектов в объявлении.

SELECT
  ad_group.name,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.source
FROM ad_group_ad_asset_view
WHERE ad_group_ad_asset_view.source = 'AUTOMATICALLY_CREATED'

Для объектов других типов отправьте запрос непосредственно к ресурсу Asset:

SELECT
  asset.id,
  asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'

Отчеты

Статистику эффективности объектов можно запросить из отчета asset_field_type_view. В этом отчете содержатся агрегированные данные как по автоматическим, так и по добавленным вручную объектам.

Статистику эффективности отдельных объектов можно получить из отчетов campaign_asset, customer_asset и ad_group_asset.