Ведение рекламных кампаний

Создание и модерация

  1. Сформируйте структуру входных данных и задайте параметры кампании.

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

  2. Вызовите метод CreateOrUpdateCampaign и подайте на вход сформированную структуру.

    Метод возвращает идентификатор новой кампании. По нему можно получать параметры кампании с помощью метода GetCampaignsParams.

    Новая кампания имеет статус «Черновик» (параметр StatusModerate имеет значение «New»). Статус меняется после проверки модератором.

  3. Создайте объявления с помощью метода CreateOrUpdateBanners.
  4. Отправьте объявления на проверку с помощью метода ModerateBanners.

    Если модератор одобрил хотя бы одно объявление, параметр кампании StatusModerate принимает значение «Yes». После этого можно вносить средства на баланс кампании.

  5. Пополните баланс кампании одним из способов:
    • для безналичного перевода сформируй счет-фактуру методом CreateInvoice;
    • для оплаты за счет кредита или овердрафта используйте метод PayCampaigns.

После одобрения модератором и оплаты, кампания автоматически активизируется (параметры StatusShow и IsActive принимают значение «Yes») и начинаются показы объявлений.

Остановка и возобновление

  1. Чтобы остановить показ конкретных объявлений, вызовите метод StopBanners.

    Параметр объявлений StatusShow принимает значение «No». Показы могут продолжаться еще некоторое время. О фактическом прекращении показов сообщает параметр IsActive.

  2. Чтобы остановить показ всех объявлений кампании, вызовите метод StopCampaign.

    Параметр кампании StatusShow принимает значение «No» (одноименные параметры объявлений не меняются). О фактическом прекращении показов сообщает параметр IsActive.

  3. Чтобы возобновить показ объявлений, вызовите метод ResumeBanners.
  4. Чтобы возобновить кампанию, вызовите метод ResumeCampaign.
  5. Чтобы остановить или возобновить показы по отдельным ключевым фразам, вызовите метод Keyword (Live).

Архивирование и разархивирование

Кампании и объявления можно переносить в архив, предварительно остановив. Если в будущем они понадобятся, их можно извлечь из архива.

Внимание. Поместить кампанию в архив можно не ранее чем через час после последнего показа.
  1. Чтобы архивировать кампанию, остановите ее вызовите метод ArchiveCampaign.

    Перенос в архив может занимать до нескольких минут. В это время параметр StatusArchive имеет значение «Pending», а по окончанию переноса — «Yes».

  2. Чтобы разархивировать кампанию, вызовите метод UnArchiveCampaign.

    Извлечение из архива может занимать до нескольких минут. В это время параметр StatusArchive имеет значение «Pending». Когда параметр принимает значение «No», кампанию можно запускать методом ResumeCampaign.

Аналогичные действия можно выполнять над объявлениями с помощью методов ArchiveBanners и UnArchiveBanners.