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

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.