Структурные запросы

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

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

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

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

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

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

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

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

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

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

Хотя вы можете успешно создать ресурсы 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.

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

Минимальные требования для действительной кампании Retail Performance Max

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

Кампания Retail Performance Max с дополнительными опциями

Недействительное состояние против недействительных запросов

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

Недопустимое состояние

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

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

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

Групповые операции с запросами на мутацию

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

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

Порядок операций

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

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

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

Обновление групп активов

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

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