Conducting advertising campaigns

Creation and review

  1. Form an input data structure and set campaign parameters.

    In the StartDate parameter, you may specify a future date. Impressions start automatically when this date takes effect, provided the moderator has approved the ad and funds have been transferred to the campaign balance.

  2. Call the CreateOrUpdateCampaign method and input the prepared structure.

    The method returns the ID of the new campaign. With this ID, use the GetCampaignsParams method to get campaign parameters.

    A new campaign has the “Draft” status (the StatusModerate parameter has the value “New”). The status changes after moderation.

  3. Use the CreateOrUpdateBanners method to create ads (banners).
  4. Use the ModerateBanners method to submit ads for moderation.

    If the moderator approved at least one ad, the campaign parameter StatusModerate takes the value “Yes”. After this, funds can be transferred to the campaign balance.

  5. There are two ways to make deposits to the campaign balance:
    • Use the CreateInvoice method to generate an invoice for bank transfer.
    • Use the PayCampaigns method to make payments using credit or overdraft.

After moderator approval and payment, the campaign is activated automatically (the StatusShow and IsActive parameters take the value “Yes”) and ad impressions begin.

Stopping and restarting

  1. To stop displaying a particular ad, call the StopBanners method.

    The StatusShow ad parameter takes the value “No”. Impressions may continue for some time. The IsActive parameter indicates when impressions have actually stopped.

  2. To stop displaying all the ads in a campaign, call the StopCampaign method.

    The StatusShow campaign parameter takes the value “No” (the ad parameters of the same name do not change). The IsActive parameter indicates when impressions have actually stopped.

  3. To start displaying an ad again, call the ResumeBanners method.
  4. To restart a campaign, call the ResumeCampaign method.
  5. To stop and restart displays for separate keywords, call the Keyword (Live) method.

Archiving and unarchiving

Campaigns and ads can be moved to the archive, after they have been stopped. If they are needed again in the future, they can be extracted from the archive.

Attention. A campaign can be archived no sooner than one hour after the last impression.
  1. To archive a campaign, stop it and call the ArchiveCampaign method.

    It may take several minutes to move it to the archive. During this time, the StatusArchive parameter has the value “Pending”, and when the transfer is complete, the value is “Yes”.

  2. To unarchive a campaign, call the UnArchiveCampaign method.

    It may take several minutes to extract it from the archive. During this time, the StatusArchive parameter has the value “Pending”. When the parameter takes the “No” value, the campaign can be launched using the ResumeCampaign method.

You can perform similar actions on ads using the ArchiveBanners and UnArchiveBanners methods.