Запросы на создание структуры

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

Создание кампаний с максимальной эффективностью

В Google Ads API объекты кампаний с максимальной эффективностью представлены как комбинация нескольких уникальных ресурсов.

Стандартные кампании с максимальной эффективностью

Для показа стандартных кампаний с максимальной эффективностью требуется минимальный набор ресурсов.

• Бюджет кампании
• Кампания
• Объекты кампании (только для кампаний с включенными правилами фирменного оформления)
• Группы объектов
• Объекты в группе
• Объекты

Для кампаний с включенными правилами фирменного оформления операции по созданию ресурсов Campaign и необходимых ресурсов CampaignAsset должны быть включены в один запрос, а ресурсы CampaignAsset должны соответствовать минимальным требованиям и спецификациям.

Важно отметить, что операции по созданию объектов AssetGroup и AssetGroupAsset должны быть включены в один запрос, а ресурсы AssetGroupAsset должны соответствовать всем минимальным требованиям к объектам и спецификациям. Обратите внимание, что для кампаний для розничной торговли действуют другие правила. Запросы на создание объекта AssetGroup без всех необходимых объектов AssetGroupAsset приводят к ошибке. Подробную информацию вы найдете в разделе Недопустимое состояние и недопустимые запросы.

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

• Создайте ресурсы CampaignBudget, Campaign, Asset и CampaignAsset в отдельных запросах, прежде чем создавать ресурсы AssetGroup и AssetGroupAsset. (Для кампаний с включенными правилами фирменного оформления ресурсы Campaign и обязательные ресурсы CampaignAsset должны быть включены в один запрос.)
• Включите все эти ресурсы в один запрос mutate.

Вы можете создать ресурсы CampaignBudget, Campaign, Asset и CampaignAsset в отдельных запросах, но кампания с максимальной эффективностью не будет допущена к показу, пока вы не создадите ресурсы AssetGroup и AssetGroupAsset.

Минимальные требования для показа объявлений из кампании с максимальной эффективностью

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

• Сигналы групп объектов
• Цели конверсий в кампании
• Критерии кампании

Вы можете включить операции по созданию ресурсов AssetGroupSignal в тот же запрос, который создает ресурсы AssetGroup и AssetGroupAsset. Вы также можете создать объекты AssetGroupSignal в отдельном запросе после создания AssetGroup.

Кампания с максимальной эффективностью с дополнительными настройками

Кампании с максимальной эффективностью для розничной торговли

Кампании для розничной торговли уникальны тем, что в них есть два разных способа создания групп объектов, которые позволяют запустить показ объявлений:

• Группы объектов без пользовательских объектов (или только с объектами HTML5 MEDIA_BUNDLE)
• Группы объектов, содержащие все необходимые объекты (рекомендуется)

Если вы решите исключить объекты из групп, Google будет автоматически использовать для создания объявлений объекты из связанного аккаунта Merchant Center. Однако мы рекомендуем добавить объекты, чтобы охватить весь инвентарь. Для показа объявлений из кампаний с максимальной эффективностью для розничной торговли требуется следующий минимальный набор ресурсов:

• CampaignBudget
• Campaign (с заполненным полем ShoppingSetting)
• AssetGroup
• AssetGroupListingGroupFilter

В кампаниях для розничной торговли необходимо заполнить поле Campaign.shopping_setting. Кроме того, все значения атрибута final_urls, указанные в атрибуте AssetGroup, должны соответствовать домену сайта, связанному с идентификатором аккаунта Merchant Center, который указан в атрибуте Campaign.shopping_setting. Наконец, с каждым объектом AssetGroup должно быть связано действительное дерево групп товаров, состоящее из одного или нескольких ресурсов AssetGroupListingGroupFilter. Вам нужно создать хотя бы одно дерево узлов, чтобы учесть все товары в указанном фиде Merchant Center.

Каждый из этих ресурсов можно создать отдельно или в одном запросе. Однако кампания не будет допущена к показу, пока все эти ресурсы не будут созданы правильно.

Минимальные требования для показа кампании с максимальной эффективностью для розничной торговли

В кампаниях с максимальной эффективностью для розничной торговли можно использовать все варианты, доступные для стандартных кампаний с максимальной эффективностью, включая создание сигналов групп объектов, целей конверсий кампании и критериев кампании. Если вы решите добавить собственные объекты (кроме объектов MEDIA_BUNDLE HTML5) в AssetGroup при создании ресурса AssetGroup, ваш запрос должен соответствовать всем минимальным требованиям к объектам (включая объекты, связанные с брендом, на уровне кампании, если включены правила фирменного оформления). Другими словами, либо не добавляйте собственные объекты, либо добавьте все необходимые.

Кампания с максимальной эффективностью для розничной торговли с дополнительными настройками

Недопустимое состояние и недопустимые запросы

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

Неправильный штат

Кампания не допущена к показу из-за своих настроек. Например, вы можете создать отдельный ресурс Campaign с advertising_channel_type PERFORMANCE_MAX. Хотя запрос на создание кампании будет выполнен, она не будет допущена к показу, пока вы не добавите в нее хотя бы один объект AssetGroup. Если запросы выполняются успешно, но кампания или группы объектов неактивны, вы можете использовать CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus и AssetGroupPrimaryStatusReason, чтобы определить причину, как описано в руководстве по устранению неполадок.

Неверный запрос

Запрос, который не может быть выполнен, поскольку он приведет к недопустимому состоянию кампании или ресурса. Например, Google Ads API выдаст ошибку, если вы попытаетесь создать AssetGroup для кампании, не связанной с розничной торговлей (кроме кампаний с максимальной эффективностью для местных услуг), не добавив минимально необходимое количество объектов. Поэтому в одном запросе необходимо указывать и AssetGroup, и связанные с ним ресурсы AssetGroupAsset. Это также означает, что все ресурсы AssetGroupAsset должны соответствовать правильным спецификациям для заданного field_type, чтобы предотвратить сбой всего запроса.

Группировка операций с помощью запросов mutate

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

Пока вы не создадите все необходимые ресурсы, указанные в этом руководстве, кампания не будет допущена к показу. При отправке отдельных запросов используйте фактические названия ресурсов, на которые ссылаются последующие запросы. При отправке массовых запросов mutate, содержащих несколько операций, используйте названия ресурсов, сформированные с помощью временных идентификаторов.

Порядок действий

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

Если вы решите создать ресурсы Asset в том же запросе mutate, который создает ресурс AssetGroup и его ресурсы AssetGroupAsset, все AssetOperations должны предшествовать всем AssetGroupAssetOperations, как показано на диаграмме.

Сервер Google Рекламы объединяет последовательные операции AssetGroupAssetOperations и проверяет, соответствует ли AssetGroup минимальным требованиям к объектам после последней операции в этой группе. Если вы будете чередовать AssetOperations и AssetGroupAssetOperations в запросе, сервер API проверит минимальные требования к объектам после первого AssetGroupAssetOperation и вернет ошибку, не выполняя остальные операции в запросе. В результате ни один из объектов, указанных в запросе, не будет добавлен в ваш аккаунт Google Рекламы. Кроме того, не будут созданы ни AssetGroup, ни связанные с ним ресурсы AssetGroupAsset.

Обновить группы объектов

После создания действительного объекта AssetGroup вы не сможете отправлять последующие запросы, которые приведут к тому, что группа объектов перестанет соответствовать минимальным требованиям. При попытке сделать это будет возникать ошибка. Например, если вы создадите объект AssetGroup с одним объектом MARKETING_IMAGE (минимальное требование), запрос на удаление только этого объекта MARKETING_IMAGE AssetGroupAsset вернет ошибку. Однако в кампаниях с максимальной эффективностью для розничной торговли можно вернуться AssetGroup к использованию объектов, автоматически созданных в Google Merchant Center, удалив все ссылки на собственные объекты AssetGroupAsset в одном запросе.

Для групп объектов в торговых кампаниях с максимальной эффективностью, созданных без связанных пользовательских объектов, последующие запросы на связывание пользовательских объектов (кроме объектов HTML5 MEDIA_BUNDLE) должны обеспечивать установку хотя бы одного final_urls в AssetGroup (сначала заполняя его, если он изначально был опущен) и должны предоставлять все минимально необходимые объекты (включая объекты бренда на уровне кампании, если включены правила фирменного оформления) в одном атомарном запросе. Не связывайте только необязательные объекты объявлений, например YOUTUBE_VIDEO, и не добавляйте объекты объявлений по одному в разных запросах. Если связать только необязательные настраиваемые объекты, группа объектов перейдет в неподдерживаемое состояние, в котором ее нельзя будет изменить в интерфейсе Google Рекламы. Подробнее о том, как связать группы объектов с объектами в кампаниях с максимальной эффективностью для розничной торговли…