Skip to content

Commit 72a7c96

Browse files
committed
Add template page and push notifications directory
1 parent d9cdb05 commit 72a7c96

File tree

2 files changed

+69
-1
lines changed

2 files changed

+69
-1
lines changed

src/engage/campaigns/push-notifications.md renamed to src/engage/campaigns/push-notifications/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Push Notifications
2+
title: Push Notifications Onboarding
33
plan: engage-premier
44
---
55

src/engage/content/mobile-push.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Mobile Push Template
3+
plan: engage-premier
4+
---
5+
6+
Use Twilio Engage to build push notification templates to include throughout your marketing campaigns.
7+
8+
## Push notification template types
9+
10+
You can choose between two push notification template types:
11+
12+
- **Media**, which contains media and text content
13+
- **Text**, which contains text content
14+
15+
## Build a push notification message template
16+
17+
> info ""
18+
> To build a push notification template in Engage, you must first [configure Engage for push notifications](/docs/engage/campaigns/push-notifications/).
19+
20+
Follow these steps to build an push notification template:
21+
22+
1. Navigate to **Engage > Content** and click **Create template**.
23+
2. Select **Push**, then click **Configure**.
24+
3. Enter a template name and select your template's language.
25+
4. Select your template's content type, then click **Next**.
26+
- For media templates, enter your message's title in the **Title** field, its body in the **Body** field, add the media URL, then add any desired [merge tags](#personalize-with-merge-tags).
27+
- For text templates, enter your message's title in the **Title** field, its body in the **Body** field, then add any desired merge tags.
28+
5. Select a [click behavior](#click-behaviors).
29+
6. Click [Test](#test-your-mobile-push-template) or **Save** to save your template.
30+
31+
32+
### Click behaviors
33+
34+
When you build a push notification template, you can choose between three click behaviors, which determine what happens when a user taps on the mobile push:
35+
36+
| Click behavior | Description |
37+
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38+
| Open app | Opens an app. You can specify a URL with or without merge tags to take the user to a specific screen with your app. If you don't enter a URL, this behavior will take the user to the app's home screen. |
39+
| Open URL | Opens the specified URL. |
40+
| Custom action | Takes any value as text input. Your app determines how to handle the value. For example, you could enter a custom action of `open_settings`, and then instruct your application to open the settings application when a user taps the notification and the notification arrives with `click behavior = open_settings`. |
41+
42+
## Test your mobile push template
43+
44+
> info "Push tokens"
45+
> Push tokens are unique identifiers Segment associates with each profile. For push notifications, you'll need to configure identity resolution settings for the push tokens `ios.push_token` and `android.push_token`. Using the Profile explorer, you can find a profile's push tokens by opening a profile and then selecting the Identities tab. You can only send push notifications to profiles with push tokens enabled.
46+
47+
Follow these steps to test your push notification:
48+
49+
50+
1. Choose a template to test:
51+
- For new templates, select **Test** once you've finished building a template.
52+
- For existing templates, navigate to **Engage > Content > Push**, select the template you want to test, then click **Test**.
53+
2. Choose a messaging service and add a recipient.
54+
- You can add recipients either by either their email address or user ID.
55+
3. Click **Send test push**.
56+
57+
Segment verifies that the the profile you're sending a test to has push tokens enabled, then sends the test. If the test push notification doesn't work as expected, confirm that the profile you're sending to has enabled push tokens.
58+
59+
## Personalize with merge tags
60+
61+
Personalize mobile push content in Engage using profile traits as merge tags in your messages.
62+
63+
To personalize a push notification, click **Add merge tags** in the template builder and select the profile traits to include in your message.
64+
65+
Engage inserts the selected traits inside merge tags based on cursor placement in the message. This allows you to personalize each push notification you send to recipients. You can also use [liquid templating](https://liquidjs.com/tags/if.html){:target="blank"} to create dynamic content in the template editor.
66+
67+
> info ""
68+
> To learn more about profile traits, visit Segment's [Computed Traits](/docs/engage/audiences/computed-traits/) and [SQL Traits](/docs/engage/audiences/sql-traits/) documentation.

0 commit comments

Comments
 (0)