---
description: >-
  Steps to create an App Push Notification for iOS using Lemnisk Marketing
  Automation Platform.
---

# Create App Push Notification - iOS

### **Create an App Push Notification**

**Step 1: Create an App Push Notification Engagement**

{% tabs %}
{% tab title="Method 1 - Segments" %}
1. Go to Campaigns > Segments
2. Select the Segment Name
3. Click on App Push Notification on the left panel
4. Click on Add Engagement

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FIA5cu5Hca7kaZYiFYzDs%2FApp%20Push%20Segment.gif?alt=media&#x26;token=b016214c-d3d2-4787-b03d-d6e3e1f62bf9" alt=""><figcaption><p>Gif<em>: Add an engagement via Segment flow</em></p></figcaption></figure>
{% endtab %}

{% tab title="Method 2 - Channels" %}
1. Go to Campaigns > Channels
2. Click on App Push Notification on the left panel
3. Click on Add Engagement
4. Select Segment Name from the list
5. Click on Confirm And Proceed To Next Step

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FAdR4NCnJ8LOPGhNkvKYK%2FApp%20Push%20Channel.gif?alt=media&#x26;token=8df253d7-2527-4b9d-88a7-f20dc45c2344" alt=""><figcaption><p>Gif<em>: Add an engagement via Engagement flow</em></p></figcaption></figure>
{% endtab %}
{% endtabs %}

**Step 2: Add General Details**&#x20;

* &#x20;**Engagement Name (mandatory):** Add a unique name to the Engagement. It must range between **6-25 characters**.&#x20;
* **Language (mandatory):** Select a language in which you prefer to write the Engagement.&#x20;
* **Select Device (mandatory):** Select **iOS** from the device list. The preview on the right should show the preview of the Android device.&#x20;
* **Select Notification Style (mandatory):** Choose a notification style of engagement based on device configuration.

For **iOS** we have 2 Notification Styles.

{% tabs %}
{% tab title="Text Only" %}
Use this notification style, in case you want to add only text to your App Push engagement.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FwpSJNOZSRVdOnPFx2E0J%2FiOS%20Image.png?alt=media&#x26;token=b09d23d0-331a-4988-8afd-79398af53d42" alt=""><figcaption><p>Add only text to the engagement</p></figcaption></figure>
{% endtab %}

{% tab title="Text with Rich Media" %}
To make your engagement comprehensible, you can add media to your text using this notification style. Lemnisk provides features to add image, audio or video to your engagement.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FTF1HyMbhNZgLLUvFMwdK%2FiOS%20Rich%20Media.gif?alt=media&#x26;token=c4a26977-337d-44c8-9da5-09a3dc793b21" alt=""><figcaption><p>Add Rich Media with Text</p></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="success" %}
As you enter the data into each section to create an Engagement, the section will turn <mark style="color:red;">red</mark>. Once all the information of the section has been entered, the section will turn <mark style="color:green;">green</mark>. You can complete the sections in any order, but the sections must turn green before you click on Update Engagement.
{% endhint %}

**Step 4: Add Content**&#x20;

* **Title (mandatory):** The title of the Engagement message. It should range between 1-42 characters. The recommended max length is **36 characters**.&#x20;
* **Message (mandatory):** Enter a brief message explaining the purpose of the Engagement. It should contain at least 6 characters. The recommended max length is **36 characters**.
* **Summary:** Give a summary of the Engagement. The recommended max length is **36 characters**.&#x20;
* **Target Page:** Enter the target URL to which the user will be redirected when the app push notification is clicked. You can add an URL or a deep link.&#x20;
* **Select Label (mandatory):** Choose a product label from the list. Click [here](../../getting-started#product-label) to know more about Product Label.

{% hint style="warning" %}
In cases where the recommended size is stated, there is no length constraint for the message. However, it might get trimmed while it is delivered leading to data loss, or might not get delivered at all. Lemnisk suggests you should keep it to the recommended length.
{% endhint %}

* **Use Button:** Check the **Use** button feature to add a button to the app push notification. Buttons are optional. You can add up to **three buttons**.
* **Button Text (mandatory):** Add text to the button.&#x20;
* **Target Page:** You can redirect the user to different platforms when they click the button.&#x20;
* **Select Link Type (mandatory):** The function you want the button to perform.

&#x20;Follow the tab of link type, as per the selected link type:

{% tabs %}
{% tab title="URL" %}
You can redirect the user to the browser.

**Enter URL (mandatory):** Enter the URL of the target page.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FJmFc4YEAhWJn5RxF8tXL%2FAndroid%20URL.gif?alt=media&#x26;token=f152e782-a7fe-4374-894f-383f6c269f94" alt=""><figcaption><p><em>Gif: Add a URL button</em></p></figcaption></figure>
{% endtab %}

{% tab title="Deep Link" %}
You can redirect user to a particular page the application.&#x20;

**Enter URL (mandatory):** Enter the URL for a specific activity within the application.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2F6CrY40AY4UVut7PUWCMu%2FAndroid%20Deep%20Link.gif?alt=media&#x26;token=f8cb75a4-547e-4b6c-b1fe-92a6bc0d297b" alt=""><figcaption><p><em>Gif: Add a Deep Link button</em></p></figcaption></figure>
{% endtab %}

{% tab title="Acknowledgement" %}
An acknowledgment will trigger a new app notification for the user, once h/se clicks the button. You need to include the following content as well.

* **Title (mandatory):** The title of the inline Engagement.
* **Message (mandatory):** Enter a brief message explaining the purpose of the Engagement.
* **Summary:** Give a summary to the Engagement.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FgoJdw6tEwTIwmJ5ESP50%2FAndroid%20Ack.gif?alt=media&#x26;token=3b103599-5e6d-4537-a92c-cb022ddc5560" alt=""><figcaption><p><em>Gif: Add an Acknowledgement button</em></p></figcaption></figure>
{% endtab %}

{% tab title="Dismiss" %}
Users can dismiss the notification when the button is clicked.

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FUD9fUHRtiDU39VQn49b7%2FAndroid%20Dismiss.gif?alt=media&#x26;token=dfd68077-606f-4be3-96cb-0ed0d85090fa" alt=""><figcaption><p><em>Gif: Add  a Dismiss button</em></p></figcaption></figure>
{% endtab %}
{% endtabs %}

&#x20;

**Media Type:** Follow the steps in the tabs as per your selected media.

{% tabs %}
{% tab title="Image" %}
**Upload Image (mandatory):** Upload an image of the following dimensions:

* **Aspect Ratio:** 2:1
* **Max Size:** 10 MB
* **Supported File Formats:** JPG, JPEG, PNG, GIF, WEBP

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FwpSJNOZSRVdOnPFx2E0J%2FiOS%20Image.png?alt=media&#x26;token=b09d23d0-331a-4988-8afd-79398af53d42" alt=""><figcaption><p><em>Upload image to Media Type</em></p></figcaption></figure>
{% endtab %}

{% tab title="Audio" %}
**Audio (mandatory):** Enter the URL of an audio file of the following dimensions:

* The audio file should be hosted on your server or any other public server that can be accessed by Lemnisk. We currently do not support uploading Audio or video files, hence please only enter the URL. Kindly note that the audio files should not be a YouTube/Vimeo link and the file size should not exceed 10 MB.
* **Supported File Formats:** MP3, M4A

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2F6kwTtdrg2i2XO50xGHpE%2FiOS%20Audio.PNG?alt=media&#x26;token=1abdb314-48ad-4205-bb50-61b698d18e48" alt=""><figcaption><p><em>Add Audio URL to Media Type</em></p></figcaption></figure>
{% endtab %}

{% tab title="Video" %}
**Video (mandatory):** Enter the URL of the video of the following dimensions:

* The video file should be hosted on your server or any other public server that can be accessed by Lemnisk. We currently do not support uploading Audio or video files, hence please only enter the URL. Kindly note that the video files should not be a YouTube/Vimeo link and the file size should not exceed 10 MB.
* **Supported File Format:** MP4

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FM4boOeszcZzQ7PqlYF8S%2FiOS%20Video.PNG?alt=media&#x26;token=dcd88649-31a6-4859-bb76-8c1eac697f86" alt=""><figcaption><p><em>Add Video URL to Media Type</em></p></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Consider a scenario where you want to send a personalized notification about term life insurance to users. This notification redirects them to a unique URL on your website representing their user ID. It also shows them their personalized message, such as their premium amount, when it will expire, etc. So, you can send hyper-personalized app push notifications to users, tailored to them.
{% endhint %}

<figure><img src="https://1782533751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FazJDZwzHkmWIbkYOetQH%2Fuploads%2FvDlDCydGiJ3P3E1korIA%2FScenario_iOS.gif?alt=media&#x26;token=69b2988c-df9e-402c-87ad-76746c4052ac" alt=""><figcaption><p><em>Gif: Hyper personalised URL for iOS</em></p></figcaption></figure>

**Step 5: Schedule Settings** \
**- Schedule:** An engagement can be scheduled to be sent at a later time or triggered immediately upon the achievement of the engagement goal. To know more about Engagement Scheduling, click [here](../../getting-started#engagement-scheduling).

**Step 6: Save** \
Click "Save" to save the Engagement.

For a detailed explanation of the steps discussed above, please refer to this video:

{% embed url="https://drive.google.com/file/d/1yABpnyUkQIi4unAIDD9LP7FyCX-6BMCr/view?usp=sharing" %}
Demo: _Creating engagement with App Push (iOS)_
{% endembed %}

{% hint style="danger" %}
Once you have created an Engagement, you can not change the name of the engagement, the selected device, the notification style, or the schedule settings.
{% endhint %}
