With your integration setup complete a generated and approved Jacquard experiment in hand, you're ready to set up a mobile push message in Airship.

The integration works with Airship message campaigns for both iOS and Android. Each of the following steps are required for each message you send with the Airship Jacquard integration.

Mobile push message configuration

1. Create an Airship message campaign

Choose Message from the campaign creation menu.

2. Add an Audience and select your channel(s)

Configure your Audience tab as you normally do. At a minimum, the integration requires you select an audience and channel for it to work properly.

3. Select your message type

In the Content tab, choose Push Notification and then click Add content.

4. Add and configure your Jacquard code snippets

Jacquard can optimise the Push Notification text language (referred to hereafter as Body) and the Title language.

Some people choose to optimise only one while others use both. We'll provide code snippets here for both use cases, so do ensure you're choosing the correct one for your Jacquard project.

Single field optimisation

If optimising a single field (Title or Body) with Jacquard, paste the following code snippet into the corresponding field in the Airship Content tab.

{{#feed "jacquard" phrasee_campaign_id="experiment_id"}}{{variant_text}}{{/feed}}

Replace the experiment_id placeholder with the actual experiment ID from your Jacquard experiment, leaving the quotation marks intact. You can locate this ID in the panel on the right side of your screen in the Jacquard platform under the Experiment info heading. Read this article for further assistance finding your experiment ID.

Your completed code snippet should look something like this in Airship:

Title and Body optimisation

If optimising both Title and Body with Jacquard, paste the following code snippets into the corresponding fields in the Airship Content tab.

Push Notification text (Body)

{{#feed "jacquard" phrasee_campaign_id="experiment_id" as |result|}}{{#each ($split result.variant_text "〽️" 2) as |TitleBody|}}{{#if @last }}{{TitleBody}}{{/if}}{{/each}}{{/feed}}

Title

{{#feed "realtimeqa" phrasee_campaign_id="experiment_id" as |result|}}{{#each ($split result.variant_text "〽️" 2) as |TitleBody|}}{{#if @first }}{{TitleBody}}{{/if}}{{/each}}{{/feed}}

Replace the experiment_id placeholders with the actual experiment ID from your Jacquard experiment, leaving the quotation marks intact. You can locate this ID in the panel on the right side of your screen in the Jacquard platform under the Experiment info heading. Read this article for further assistance finding your experiment ID.

Your completed code snippets should look something like this in Airship:

5. Finish your Content setup as you normally do

Complete your message setup as per your normal process. Please ensure you do not alter the code snippets from the previous step as you complete your setup.

6. Activate your experiment in Jacquard

Return to the Jacquard platform. Activate your experiment using the Dynamic Optimisation menu in the panel on the right side of the screen.

Set parameters in this area as discussed with your Jacquard Customer Success representative. For further guidance on how to activate an experiment, visit our Dynamic Optimisation Experiment Configuration article.

7. Test your experiment in Airship before deploying

As with any digital campaign, you'll likely want to run an internal test before deploying to your audience. The Airship data feed unfortunately will not process properly in the in-platform Preview view.

You'll need to send an actual test message to an internal test list to verify everything is working correctly. We recommend doing this for each new experiment you run.

With your experiment thoroughly tested, you're ready to deploy if you're running a triggered experiment. Set your message live in Airship following your normal process.

But if you're running a broadcast experiment, there is one additional step to take before scheduling your message.

8. Add a Delivery Throttle (broadcast only)

In the Delivery tab, scroll down until you find the Options section. Toggle the Throttle Delivery option to the on position.

You'll now need to enter your messages per second rate into the available box.

Calculating your messages per second rate

The rate at which you throttle your message will depend on your audience size for this particular deployment and the number of hours Jacquard's Data Science team recommended for your experimentation window.

You'll need to calculate the messages per second rate based on the message list size and the testing window provided by the Jacquard Data Science team.

In our example below, we show how we've arrived at our messages per second rate for a list of 1 million subscribers with a six-hour testing window.

As an example, let's say we have an audience of 1 million subscribers. In order to determine what rate we should choose, we can take our six hours and multiply it by 60 minutes to determine how many minutes are in six hours.

6 x 60 = 360

Then, we can multiply our product by 60 again to find the number of seconds in six hours.

360 x 60 = 21,600

Now, we can divide our audience of 1 million by that number.

5,000,000 / 21,600 = 231.48148

We would then round down to the nearest whole number. Making our messages per second rate 231.

With your calculated rate in hand, enter the number into the available text box in Airship.

You are now ready to deploy your message as you normally do.

Article path

Previous Article
< Known Issues

Page last reviewed: 23 September 2024