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

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

Как работает конвертация

Когда вы вызываете метод SmartCampaignSettingService.GeneratePMaxDraftCampaign, API создает черновик кампании с максимальной эффективностью на основе конфигурации умной кампании.

Сгенерированная черновая кампания с максимальной эффективностью инициализируется со значением status, равным PAUSED (и ее соответствие требованиям к показу отражается в primary_status). Если все конвертеры функций не проходят проверку для умной кампании, запрос завершается с ошибкой SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

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

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

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

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

  customers/customer_id/smartCampaignSettings/campaign_id
  

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

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

• image_enabled (Не поддерживается): необязательный атрибут. Нужно ли генерировать обязательные изображения для кампании с максимальной эффективностью (например, горизонтальные, квадратные и логотипы). Оставьте это поле пустым или укажите значение false. Значение true не реализовано в v25 и возвращает ошибку 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, проверьте и настройте его бюджет, группу объектов и объекты.
3. Включите кампанию с максимальной эффективностью и приостановите исходную. Когда вы будете готовы к показу объявлений, измените статус кампании с максимальной эффективностью с status на ENABLED, а исходной умной кампании – с status на PAUSED, чтобы избежать дублирования.