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

В версии 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, чтобы избежать дублирования показов.
Назад
Обзор
Далее
Получить предложения