Черновики кампании

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

• Базовая кампания — это обычная кампания в вашем аккаунте, включающая объявления, группы объявлений и другие ресурсы.
• Черновая версия кампании — это виртуальный слой, где изменения накапливаются по мере выполнения операций, но не затрагивают реальные кампании в вашем аккаунте. Как только вы будете удовлетворены состоянием черновой версии кампании, вы можете применить её к реальной кампании несколькими способами.

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

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

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

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

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

   • base_campaign : Название ресурса кампании, на основе которой будет создан этот черновик.
   • name : Название для вашего проекта кампании.

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

3. Наконец, отправьте эту операцию в API Google Ads, используя метод 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"

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

Продвижение или удаление черновика кампании

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

После завершения настройки черновика кампании у вас есть несколько вариантов:

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