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

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

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

В 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.

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

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

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

• Группы объектов, в которых нет объектов
• Группы объектов, содержащие ВСЕ необходимые объекты (предпочтительно)

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

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

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

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

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

В кампаниях для розничной торговли можно использовать все варианты, доступные для стандартных кампаний с максимальной эффективностью, в том числе создавать сигналы групп объектов, цели конверсий и критерии кампаний. Если вы решите добавить объекты объявлений в AssetGroup при создании ресурса 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 (минимальное требование), то любые запросы на удаление AssetGroupAsset, связанного с этим MARKETING_IMAGE, будут возвращать ошибку.

Это особенно важно для групп объектов в кампаниях для розничной торговли, созданных без связанных объектов. Последующие запросы на добавление объектов объявлений в AssetGroup путем создания ресурсов AssetGroupAsset будут выполнены только в том случае, если запрос соответствует всем требованиям к объектам объявлений. Другими словами, вы не можете добавлять объекты в эти группы объектов постепенно.