January 13, 2020

WebPush сampaigns

This article describes how to create a web push campaign using advanced options.

Things to know before starting

  • Recipient presence in the Contact List with active push notification permission is required for delivery.
  • Target contact counts are calculated based only on users who have opted in to receive notifications.
  • Clear and concise campaign names are recommended to simplify future searches.
  • The selection of available channels depends on the current tariff plan.
  • The default contact list is automatically pre-selected during campaign creation.
  • Selecting the same segment for both delivery and exclusion results in a "Failed" status, and the campaign will not be sent.
  • Campaigns with "Running" or "Done" statuses cannot be stopped or edited.
  • Copied campaigns are automatically saved with a "Draft" status.
  • Advanced settings contain sending details specific to the selected contact list.
  • Scheduled and recurring launches support delivery according to the recipient's time zone via the {{contactTimezone}} variable; otherwise, the account's time zone is used.
  • Scheduling campaigns at least 24 hours in advance is strongly advised to ensure delivery across all time zones.
  • A maximum of 3 tags can be added per campaign.

Step-by-step instructions:

  • Navigate to the "Outbound" section.

  • Click the "Campaigns" button.

  • Click the "Create" button.

  • Specify campaign title and select target contact list.

  • Select the segment if necessary. Campaigns are sent only to contacts that match the segment rules.

  • Use "Add filter" to create one-time segments for a specific campaign. These conditions are not saved in the general segment list. Filtering rules can be modified via the "Edit" button or removed using the "Bin" icon.

  • Exclude specific segments to prevent delivery to certain contact groups. One-time exclusion filters can also be applied here.

  • Select the Web Push channel and the preferred template from the dropdown menus.

  • Use the preview feature to check how the template renders on Windows and macOS in Chrome and Firefox.

  • Select the TTL (Time to Live) and the Web Push type (Both, Only Desktop, or Only Mobile).

  • Open "Advanced settings" to manage tags and improve the organization of analytics reports.

  • Proceed by clicking the "Next step" button, then select the campaign launch type.

  • Review the detailed campaign summary in the table on the right before the final launch.

  • Click the “Launch campaign” button.

Advanced settings

This section describes advanced settings that can be modified for a specific campaign. These changes apply only to the specific campaign.

  • Advanced settings list
    Icon caret
    • Tags

Launch Type

Manual - campaigns are created with a "Ready" status and require manual activation from the management page to begin sending.

Now - the campaign is sent immediately when you click the “Launch Campaign” button. It is assigned a “Running” status as the delivery process starts instantly.

Scheduled - campaigns are delayed and created with a “Waiting” status, triggering at a predefined date and time. This launch type supports delivery based on the recipient’s local time zone.

Recurring - this type enables automated campaign repetition through advanced scheduling. Campaigns start in a “Waiting” status, switch to “Running” during delivery, and return to “Waiting” for the next cycle until all conditions are met. This type also supports delivery based on the recipient’s local time zone.

  • Configuration parameters
    Icon caret
    • Start & Frequency: campaigns trigger at a specified date and time with options to repeat daily, weekly, or monthly (including first/last day or specific dates).
    • Monthly Scheduling Note: If the selected dates (29th–31st) do not exist in a given month, the delivery for that period will be skipped.
    • Termination Rules: campaigns can be set to repeat indefinitely, stop on a specific date, or end after a fixed number of occurrences.
  • Details
    Icon caret
    • Channel - type of the campaign channel.
    • Campaign name - campaign title.
    • Template - name of the template (click to redirect to editor).
    • TTL (Time to Live) - the duration for which the push service will attempt to deliver the notification before discarding it.
    • Tags - list of assigned campaign tags.
    • Contact list - name of the target contact list.
    • Segments (Send to/Exclude) - filters used to target or exclude specific contact groups.
    • Target contacts count - total number of recipients (includes a "refresh" button for recalculation).
    • Time zone - account time zone or recipient’s local time if enabled in settings.
    • Launch time - summary of start date/time, launch type, repeat frequency, and end date.