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

В версии v25 и более поздних для преобразования умной кампании в кампанию с максимальной эффективностью можно использовать метод SmartCampaignSettingService.GeneratePMaxDraftCampaign. Этот метод недоступен в v24 и более ранних версиях.

Как работает преобразование

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

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

• Для параметра status задано значение PAUSED.
• Доступность для показа отражена в столбце primary_status.
• По умолчанию для contains_eu_political_advertising задается значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING (если оно не указано в умной кампании). Если в вашей кампании есть политическая реклама для ЕС, проверьте и обновите это поле.

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

Черновики объектов

В новой кампании есть группа изображений-плейсхолдеров, которые нужно заменить, прежде чем кампания будет включена. Если поле image_enabled поддерживается и в запросе для него задано значение true, API автоматически создает изображения вместо того, чтобы использовать изображения-заполнители. Вы можете проверить новые объекты в поле assets ответа и заменить их, выполнив следующие действия:

1. Ознакомьтесь с руководством по требованиям к объектам.
2. Загрузите новые изображения, следуя примеру Загрузка объекта изображения.
3. Свяжите новые объекты с группой объектов черновика кампании, а затем удалите ссылки AssetGroupAsset для изображений-плейсхолдеров (в том же атомарном запросе mutate или после связывания новых объектов, чтобы соблюдались минимальные требования к объектам), следуя инструкциям по связыванию групп объектов с объектами.

Параметры запроса

Сообщение GeneratePMaxDraftCampaignRequest принимает следующие поля:

• resource_name (обязательный) – название ресурса SmartCampaignSetting, который нужно воссоздать для умной кампании, которую вы хотите преобразовать. Формат:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (необязательный параметр). Если задано значение true, запрос проверяется, но не выполняется. В ответе в поле validated_info возвращаются только ошибки и предупреждения, возникшие при проверке, а также возможные проблемы с конверсиями. Черновики объектов не создаются.

• gbp_enabled (не поддерживается): необязательный. Нужно ли преобразовывать адрес профиля компании в Google, связанный с кампанией с максимальной эффективностью. Оставьте это поле пустым или укажите значение false. Значение true не поддерживается и приведет к ошибке SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (не поддерживается): необязательный. Нужно ли генерировать обязательные изображения для кампании с максимальной эффективностью (например, горизонтальные, квадратные и логотипы). Оставьте это поле пустым или укажите значение false. Значение true не поддерживается и приведет к ошибке SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Сведения об ответе

Сообщение GeneratePMaxDraftCampaignResponse возвращает названия ресурсов созданной черновой кампании с максимальной эффективностью и связанных с ней объектов:

• pmax_campaign – название ресурса Campaign созданной черновой кампании с максимальной эффективностью.
• campaign_budget – название ресурса CampaignBudget, связанного с созданной кампанией с максимальной эффективностью.
• asset_group – название ресурса AssetGroup, связанного со сгенерированной кампанией с максимальной эффективностью.
• assets – список названий ресурсов Asset, связанных с созданной кампанией с максимальной эффективностью.
• validated_info – информация о проверке или возможных проблемах с конверсиями, полученная в результате проверки конверсий (заполняется, когда для параметра validate_only задано значение true, а также вместе с именами созданных ресурсов объектов, когда для параметра validate_only задано значение false).

Рекомендуемый рабочий процесс

Чтобы преобразовать умную кампанию, выполните следующие действия:

1. Создайте проект кампании. Вызовите SmartCampaignSettingService.GeneratePMaxDraftCampaign, задав только обязательное поле resource_name (оставьте поля gbp_enabled и image_enabled незаполненными или задайте для них значение false). Сохраните возвращенные названия ресурсов pmax_campaign, campaign_budget, asset_group и assets.
2. Проверьте и настройте кампанию. Поскольку черновик кампании с максимальной эффективностью создается с помощью status = PAUSED и creation_status = INCOMPLETE, проверьте и настройте его бюджет, группу объектов и объекты.
3. Включите кампанию и приостановите исходную. Когда вы будете готовы к показу объявлений, измените значение поля status кампании с максимальной эффективностью на ENABLED, а затем измените значение поля status исходной умной кампании на PAUSED, чтобы избежать повторного показа.