Как и в случае с отчетами о кампаниях с максимальной эффективностью, используйте GoogleAdsService.SearchStream, чтобы получать метаданные кампаний и групп объектов для устранения распространенных проблем.
Устранение неполадок в кампании
Если кампания с максимальной эффективностью показывает не такие результаты, как вы рассчитывали, возможно, в ней есть проблемы с объявлениями, ставками, параметрами таргетинга, отслеживанием конверсий или настройками. Инструкции по устранению неполадок приведены в следующих руководствах:
- Как исправить настройки кампании с максимальной эффективностью
- Кампания с максимальной эффективностью неактивна или получает мало трафика
- Увеличение расходов в кампаниях с максимальной эффективностью
Кампании с включенными правилами фирменного оформления
Используйте правила фирменного оформления, чтобы контролировать, как ваш бренд представлен в кампаниях с максимальной эффективностью. Чтобы проверить, включены ли правила фирменного оформления для кампании, можно использовать Campaign.brand_guidelines_enabled.
В кампаниях с максимальной эффективностью, в которых для параметра Campaign.brand_guidelines_enabled задано значение true, используются объекты бренда на уровне кампании (BUSINESS_NAME, LOGO и LANDSCAPE_LOGO). В таких кампаниях должны быть заданы
- Ровно один объект типа "
BUSINESS_NAME" - Хотя бы один объект типа "
LOGO".
Если вы не свяжете эти ресурсы CampaignAsset, когда это необходимо, то можете получить ошибку CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED или CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED в зависимости от типа отсутствующего объекта. Эти ошибки могут возникать в кампаниях с включенными правилами фирменного оформления в результате следующих действий:
- Создание нового объекта
Campaignбез указанияBUSINESS_NAMEиLOGOв качестве ресурсовCampaignAssetв одном запросе. - Удаление одного или нескольких ресурсов (
CampaignAsset), в результате которого кампания перестанет соответствовать минимальным требованиям к объектам бренда. - Связывание необходимых пользовательских объектов на уровне группы объектов с кампанией с максимальной эффективностью для розничной торговли без объектов без предоставления всех необходимых ресурсов
CampaignAssetв одном запросе. (Чтобы связать только необязательные настраиваемые объекты, напримерYOUTUBE_VIDEO, необходимо также соблюсти минимальные требования к группе объектов и добавить обязательные ссылки на брендCampaignAsset, чтобы группа объектов не перешла в неподдерживаемое состояние, блокирующее изменения в интерфейсе Google Рекламы.)
Если вы попытаетесь связать объекты бренда на неправильном уровне, также возникнут ошибки. Вот как их исправить:
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL- свяжите объекты бренда с помощью ресурса
CampaignAsset, поскольку для кампании включены правила фирменного оформления.
- свяжите объекты бренда с помощью ресурса
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL- свяжите объекты бренда с помощью ресурса
AssetGroupAsset, поскольку правила фирменного оформления не включены для кампании.
- свяжите объекты бренда с помощью ресурса
Устранение неполадок с группами объектов
Используйте поля asset_group.primary_status и asset_group.primary_status_reasons, чтобы получить статистику эффективности группы объектов.
SELECT
asset_group.resource_name,
asset_group.primary_status,
asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"
Аналогичным образом используйте поля asset_group_asset.primary_status, asset_group_asset.primary_status_details и asset_group_asset.primary_status_reasons, чтобы узнать, показывается ли объект группы, и если нет, то почему.
SELECT
asset_group_asset.resource_name,
asset_group_asset.primary_status,
asset_group_asset.primary_status_reasons,
asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"
Распространенные ошибки в группах объектов
Если запрос на создание AssetGroup или обновление связанных с ним ресурсов AssetGroupAsset не выполняется и возвращается ошибка NOT_ENOUGH_*_ASSET
AssetGroupError (например, AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET), значит ваш AssetGroup не соответствует минимальным требованиям к объектам.
Эта ошибка возникает, если вы создаете стандартную AssetGroup, не добавив обязательные объекты, связываете обязательные пользовательские объекты с AssetGroup для розничной торговли, не добавив все обязательные объекты, или удаляете обязательные объекты, не отменив связь со всеми пользовательскими объектами в одном запросе для розничной торговли. Если вы хотите связать только необязательные настраиваемые объекты, например YOUTUBE_VIDEO, вам все равно нужно добавить все обязательные объекты. В противном случае группа объектов перейдет в неподдерживаемое состояние, и вы не сможете редактировать ее в интерфейсе Google Рекламы.
Например, ошибка AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET означает, что в запросе не указано минимальное количество объектов MARKETING_IMAGE (в данном случае – один). Чтобы устранить эту ошибку, отправьте запрос как массовый запрос mutate с помощью метода GoogleAdsService.Mutate, содержащего asset_group_operation (при создании новой группы объектов) и все необходимые записи asset_group_asset_operation, как показано в разделе Связывание групп объектов с объектами.
В этом примере список операций изменения в запросе mutate должен включать хотя бы один объект AssetGroupAsset с field_type, равным MARKETING_IMAGE. Объект, на который ссылается AssetGroupAsset, также должен соответствовать спецификациям для MARKETING_IMAGE.
Аналогично, если запрос на создание AssetGroup завершается ошибкой AssetGroupError.SHORT_DESCRIPTION_REQUIRED, это означает, что в AssetGroup отсутствует объект TEXT, содержащий не более 60 символов, и field_type DESCRIPTION. Чтобы устранить эту проблему, выполните те же действия, что и в примере NOT_ENOUGH_MARKETING_IMAGE_ASSET. Однако запрос должен содержать хотя бы один объект AssetGroupAsset с типом field_type, равным DESCRIPTION, а длина объекта, на который ссылается AssetGroupAsset, не должна превышать 60 символов.
Список распространенных ошибок и способы их устранения приведены в разделе Распространенные ошибки.
Как найти источник объекта для устранения неполадок
Кампании с максимальной эффективностью уникальны тем, что в них показываются объявления, содержащие объекты, которые загружены рекламодателями и автоматически созданы Google. Рекламодателю может быть полезно знать источник объекта, чтобы устранять неполадки или оценивать эффективность. В этом случае можно использовать поле asset_group_asset.source следующим образом:
SELECT
asset.id,
asset.name,
asset_group.id,
asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID
Ценность конверсий для цели "Привлечение новых клиентов"
Ценность конверсий в отчетах может быть выше, чем при ручной загрузке данных, если вы настроили привлечение новых клиентов в кампаниях с максимальной эффективностью или поисковых кампаниях. Если вы выбрали режим "Ценность новых клиентов" (назначать более высокие ставки), общая ценность всех новых клиентов будет добавлена к ценности конверсии для вашего действия-конверсии. Общая ценность всех новых клиентов доступна только в веб-интерфейсе Google Рекламы.
Если вам нужно рассчитать ценность конверсий без учета общей ценности новых клиентов, используйте следующий псевдокод: Общую ценность всех новых клиентов можно скачать из веб-интерфейса Google Рекламы.
nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
// If the new customer acquisition value is 'Bid higher', then subtract.
if (bidHigher == true) {
nonNewCustomerAcquisitionConversionValueTotal +=
campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
}
// If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
else {
nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
}
}