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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кампании с максимальной эффективностью состоят из нескольких ресурсов, и у вас есть возможность создавать эти отдельные ресурсы в уникальных запросах или в одном запросе на массовое изменение . Однако 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 будут успешными только в том случае, если запрос соответствует всем требованиям к активам. Другими словами, вы не можете добавлять активы в эти группы активов постепенно.