Schedule campaign

Manage when your campaign will be sent

👍

If your project uses the legacy campaign interface, some of the options might work differently. To have your project upgraded to the new campaign builder, speak to your Account Manager or contact support.

The Schedule tab allows you to control when you would like your campaign to be sent.

22362236

This tab will look slightly different depending on your campaign trigger and the type of campaign. This is covered in detail in this guide.

Schedule

Send now

Use this option if you have a campaign you want to send just once to a segment of users or to all your users at launch. This is the default selection.

Send later

This option allows sending a message in the future. When you select this option you will be presented with a number of fields to complete:

  • Date: select a calendar date to send the campaign.
  • Time: select hour and minute for your campaign to be sent.
  • Time zone: select the time zone that will be taken into consideration to send the campaign.

Repeat

With this option, you can set up a campaign to send daily or on certain days and is useful when new users enter a segment. A classic example is automating a message to users who haven't opened the app in a certain date range, for instance, in the last 14 days.

Here you have a number of options:

Starts: Set the day, time and time zone for your campaign
Ends: controls when the campaign ends
Repeat on: select the week days when your campaign is sent

  • Days of the week to send on
  • Time to send at
  • Time zone to send by
  • Date to start on
  • Date to end on
22922292

The example shows a repeating campaign that runs daily at 18:00 UTC+1 from the 20th of September of 2022 until the 27th of September of 2022.

Prepare upfront

Check this box if you want to prepare your campaign before sending it. This is useful for larger campaign sends as it pre-calculates the segment that is being used in the campaign, which in turn enables the campaign to be ready to send at the moment the campaign is due to go out.

Send by users' timezone

By default, your notifications will be delivered at the local time zone you have configured when you created your project. However, you can use a different time zone or your users' time zone. If you schedule your campaign by your users' time zone, if for example, 50% of your users are in New York City and 50% are in London and your campaign is scheduled to send at 1 pm, then your notification will be delivered at 1 pm GMT to your London users and at 1pm EST to your NYC users.

🚧

Send by user's timezone

If you configure the campaign to be sent by users' time zone option, only users that have a time zone set against their profiles will receive the campaign.

Offline users

For some campaign types (Android, iOS push and web push), if users are offline when a notification is initially sent it is possible to send the notification when they are back online.

You can set:

  • Retry for: The default configuration for the retry period (4 weeks) is based on Apple and Firebase's defaults, which means that the user will be able to receive the notification when/if they come back online within 4 weeks. A custom time to retry for—such as 1 day, 12 hours, 5 minutes—can be configured.
  • Retry until: A time and date after which the notification expires and will not be sent. This is great for scheduled notifications related to events that run at a specific time. 
  • Do not retry: Not recommended for most cases. See more information below:

👍

Retry period

It's best practice to set a retry time to the longest period that is relevant for the campaign. Even for time-critical content, such as breaking news stories, it's more appropriate to set a 10-minute retry period than setting don't retry.

22122212

This example shows the default option (the system will keep on trying sending the campaign during 4 weeks).

📘

Retry period cannot be altered after send

The retry period cannot be altered after send, as this information is sent to the push gateway at the time the campaign is launched. The setting is used by the push gateway to understand how long it should keep trying to reach offline devices.

Inbox message persistence

When a message is being placed in the inbox, on the Schedule tab you can set how long that message will remain in the inbox. Thus, this option is only available for inbox campaigns.

22562256

You can set:

  • Do not remove: enabled by default. Suitable when your goal is to persist a message in the inbox and have it naturally move down over time.
  • Remove on: a time and date at which the message will be removed from the inbox. This is great for content related to events that run at, or for a specific time for example a limited time offer that runs for a month. 
  • Remove after: you can indicate the time after which you want the message to be removed, such as 7 days, 12 hours, etc. This is the right choice if your message is repeating or triggered and should only last for a certain amount of time, for example, a limited time offer triggered by entering a location.

👍

Once that a campaign has been launched, inbox messages can be manually expired from the inbox feed.

Set up delivery window

For campaigns triggered externally (API triggered, event-triggered or location-triggered campaigns), the Schedule tab can limit the period during which the campaign can be sent. By default, no limits will be set, but it is possible to:

  • Allow or disallow specific days of the week
  • Set up the hours of the days where triggering campaigns is allowed, in a specific timezone
  • Date and time where the campaign starts
  • Date and time where the campaign stops
22502250

In this example, it is only possible to trigger the on-site campaign from Monday to Friday, from 9:00 until 21:59 (UTC).

Third party integrations

Some third-party integrations such as Optimove allow users to set the stop time of the campaign from Xtremepush. See our Optimove guide for more information.