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

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

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

В 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 Рекламы. Подробнее о том, как связать группы объектов с объектами в кампаниях с максимальной эффективностью для розничной торговли…

Назад
Отчеты о критериях кампаний
Далее
Пакетная обработка