Create a Push Message Campaign

You can create a new push message campaign by clicking the + Create Campaign button located in the upper right corner of the Push Message menu in the Dashboard.

Create a push message campaign

1

Enter Campaign Information

Campaign information

• Name: Required. Enter the name of the campaign you want to run.

• Description: Optional. A description helps other team members understand what the campaign is about.

2

Campaign Settings

Once a campaign is created, you can view the campaign key, title, description, and status.

• Campaign Key: A unique value that distinguishes the campaign. It can be used to extract users who were exposed to a specific campaign.

• Campaign Title / Description: You can edit the title and description.

• Campaign Status: When you first create a campaign, it is in the 'Draft' state. You can start the campaign after writing and saving the detailed campaign content. To edit campaign content, click the Edit button to change the status back to 'Draft'.

2-1. Platform Selection

You can set the platform environment to which messages will be sent.

Firebase and APN integration settings are required to use push messages.

Platform and message settings

2-2. Write Message

• Content

  • Title: Maximum 30 characters

  • Body: Maximum 30 characters

• The entered content is displayed as a preview on the right side of the screen.

• For Promotional Messages, you must review and comply with the Korea Internet & Security Agency's App Push Advertising Guidelines.

  • Insert the "(Ad)" text in the title or body to clearly indicate it is an advertisement.

  • Clearly state the method of opting out and withdrawing consent. E.g., (Opt-out: Settings > Turn off notifications)

Personalized Message

A personalized message is a message delivered in a customized way based on the user's name, behavior, interests, etc. This increases user engagement and conversion rates, reduces unnecessary messages to improve user satisfaction, and is an effective communication strategy that contributes to retention improvement and revenue growth.

When entering text and links, click the {...} button on the right side of the text box to write a personalized message.

Personalized message detailed settings

In the popup, you can select Event Properties and User Properties, and set a fallback text to display if no value is available for each property. For example, if you select the property value "name", the user's name "John Doe" will be displayed, and if no name is available, the fallback text you entered, such as "Member", will appear.

Confirm and preview personalized message

Review the personalized text set in the popup, and enter values in the User Message Preview below. You can immediately see the push message as it will actually appear on the device screen on the right.

2-3. Image

You can add an image to the push message to deliver more information to the user.

There may be slight differences depending on the presence of an image, the user device's notification status and display settings, and device size. Please refer to the image guidelines before uploading.

• File format: PNG, JPG, JPEG

• File size: 500KB

	Recommended Ratio	Minimum Size (px)	Maximum Size (px)
Android Icon	1:1	48 x 48	256 x 256
Android Image	2:1	512 x 256	2048 x 1024
iOS Image	1:1	400 x 400	1038 x 1038
iOS Image	2:1	400 x 200	1038 x 519

2-4. Notification Channel (Optional)

Using Hackle Push Messages, you can receive push notifications on a pre-declared channel within the Android app. If a push is received with a channel ID that does not exist in the app, the push will be received on the default channel provided by Hackle.

For more information about notification channels, please refer to the Android guide.

3

Set Target

After writing the message, set the send target.

Set target

• All Users

• Cohort

  • You can target the campaign by specifying a cohort. Set up the desired cohort using various events/properties.

Detailed Conditions

You can configure detailed message sending settings based on the marketing subscription consent status of the send target.

4

Campaign Review

You can check the summary information of the written campaign.

In addition to the message content, you can preview the number of users in the cohort set as the target. The meaning of the 'User Count' and 'Send Count' fields in the estimated information section is as follows:

• User Count: The number of users who satisfy the configured target conditions

  • Example (based on the image below): Number of users whose mkt_push_agree property value is true (based on device Id)

• Send Count: Among users who satisfy the 'User Count' condition, the number estimated to be able to receive push messages because they have a push token (Push Token) value

Test Send

You can preview the configured message on the right side of the screen. If you want to receive a preview push message on an actual device, click the Test Send button.

Test send

In the test send popup, select the platform and enter the push token value of the device you want to receive the message on.

Enter push token

After entering the token value and clicking the send button, the push message is sent to the device corresponding to that token value, as shown below. Check not only the message content but also the action that occurs when you click. Test messages are sent regardless of the campaign's period and status.

Test push message sent

When all preparations are complete, click the Send Settings button in the upper right corner of the screen to configure message sending.

If you have applied personalization variables, you can set up the 'User Message Preview' before the test send to test the message with the personalization variables applied.