Проекты кампаний

Проекты кампаний позволяют подготовить набор изменений для исходной кампании. С каждым проектом кампании связаны исходная и экспериментальная кампании.

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

Ключевой термин. Проект кампании – это ресурс, который используется для создания новых проектов на основе исходной кампании и определения связей между исходными кампаниями и проектами. Черновик кампании – это виртуальная кампания, которая действует как обычная, но не может показывать объявления.

Полный пример создания эксперимента можно найти в каталоге примеров кода.

Создать черновик

Чтобы создать CampaignDraft:

1. Создайте объект CampaignDraft со следующими полями:

   • base_campaign – название ресурса кампании, на основе которой будет создан проект.
   • name – название проекта кампании.

2. Затем создайте объект CampaignDraftOperation, в поле create которого будет указан созданный вами объект CampaignDraft.

3. Наконец, отправьте эту операцию в Google Ads API с помощью метода CampaignDraftService.MutateCampaignDrafts. Запрос create является синхронным и сразу возвращает ответ.

Как изменить проект кампании

После создания проекта кампании вы можете получить название его ресурса из поля results объекта MutateCampaignDraftsResponse.

Чтобы изменить черновик, сначала нужно получить название ресурса связанной с ним черновика кампании. Используя название ресурса черновика кампании, вы можете отправить запрос GoogleAdsService.SearchStream, чтобы найти черновик кампании:

SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"

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

Как опубликовать или удалить проект кампании

Ключевое понятие. Асинхронные операции в Google Ads API возвращают так называемую длительную операцию. Длительные операции позволяют удобно проверять, завершена ли операция, без необходимости выполнять полный вызов API.

После того как вы настроите проект кампании, у вас будет несколько вариантов действий:

1. Преобразуйте проект кампании в исходную кампанию, вызвав метод CampaignDraftService.PromoteCampaignDraft. Все изменения, внесенные в проект кампании, будут применены к исходной кампании. Это асинхронная операция.
2. Удалите проект кампании с помощью операции remove в CampaignDraftService.MutateCampaignDrafts, передав название ресурса проекта кампании. Если вы решите не продолжать, проект будет отменен, а все изменения – удалены. Это синхронная операция.