You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/moengage/index.md
+30-27Lines changed: 30 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ title: MoEngage Destination
4
4
5
5
## Getting Started
6
6
7
-
Once you add the Segment-Moengage library to your app, you can enable MoEngage from the Segment App. These new settings can take up to an hour to propagate to your existing users. For new users, it'll be instantaneous!
7
+
Once you add the Segment-MoEngage library to your app, you can enable MoEngage from the Segment App. These new settings can take up to an hour to propagate to your existing users. For new users, it'll be instantaneous!
8
8
9
9
The Segment-MoEngage Integration is a bundled integration, meaning it requires that you add a client-side integration to your app.
10
10
@@ -29,7 +29,7 @@ users it’ll be instantaneous! Segment-MoEngage Integration is a bundled integr
29
29
30
30
To get started with MoEngage on iOS, first integrate your app with the [MoEngage-Segment-iOS](https://github.com/moengage/MoEngage-Segment-iOS) library. You can integrate MoEngage and Segment with [CocoaPods](http://cocoapods.org).
31
31
32
-
*Initialise pod with pod init command, this will create a podfile for your project.
32
+
*Initialize pod with pod init command, this will create a podfile for your project.
33
33
* Update your podfile by adding pod '**Segment-MoEngage**' as shown below:
34
34
35
35
```ruby
@@ -108,9 +108,9 @@ To differentiate between those, use one of the method below:
108
108
109
109
Read more on [install/update differentiation](https://docs.moengage.com/docs/installupdate-differentiation).
110
110
111
-
### Setting Data Center
111
+
### Set the data center
112
112
113
-
By default, the data center inSDK is set to `DATA_CENTER_01`, make sure to set the correct DataCenter depending on your account using this [doc](https://docs.moengage.com/docs/data-redirection). Its important to set the correct DataCenterwhile integration, ifnot set correctly will result inMoEngageSDKfeaturesnotworking.
113
+
By default, the data center setting inthe SDK is set to `DATA_CENTER_01`. Follow the steps in the [MoEngage-DataRedirection](https://docs.moengage.com/docs/data-redirection)to update the data center value. Ifnot set correctly, several features of the MoEngageSDKwillnotfunction.
114
114
115
115
### Using features provided in the MoEngage SDK
116
116
@@ -121,7 +121,7 @@ Push Notifications are a great way to keep your users engaged and informed about
121
121
122
122
**Segment Push Implementation:**
123
123
124
-
1. Follow the directions to register for push notifications [using Segment SDK](/docs/connections/sources/catalog/libraries/mobile/ios/#how-do-i-use-push-notifications).
124
+
1. Follow the directions to register for push notifications [with the Segment SDK](/docs/connections/sources/catalog/libraries/mobile/ios/#how-do-i-use-push-notifications).
125
125
126
126
2. In your application’s application:didReceiveRemoteNotification: method, add the following:
127
127
```objc
@@ -142,13 +142,12 @@ Push Notifications are a great way to keep your users engaged and informed about
142
142
For information about the MoEngage push implementation, see [**Push Notifications**](https://docs.moengage.com/docs/push-notifications) in the MoEngage documentation.
143
143
144
144
145
-
#### In-App Messaging
146
-
In-App Messaging are custom views which you can send to a segment of users to show custom messages or give new offers or take to some specific pages. Follow the link to know more about inApp Messaging and how to use it in your application:
In-App Messages are custom views which you can send to a set of users to show custom messages, give new offers, or direct to a specific page. For more information about In-app messaging, see [MoEngage - In-App NATIV](https://docs.moengage.com/docs/in-app-nativ)
148
147
149
148
150
149
#### Cards
151
-
Create targeted or automated App Inbox/NewsFeed messages that can be grouped into various categories, and target your users with different updates or offers that can stay in the Inbox/Feed over a designated period of time. Follow the link to know more about [Cards](https://docs.moengage.com/docs/ios-cards).
150
+
Create targeted or automated App Inbox/NewsFeed messages that can be grouped into various categories, and target your users with different updates or offers that can stay in the Inbox/Feed over a designated period of time. For more information about cards, see [MoEngage - Cards](https://docs.moengage.com/docs/ios-cards).
152
151
153
152
154
153
#### Compliance
@@ -205,21 +204,22 @@ Analytics analytics = new Analytics.Builder(this, "write_key")
205
204
```
206
205
207
206
208
-
### Initialise the MoEngage SDK
207
+
### Initialize the MoEngage SDK
209
208
210
-
Get APP ID from the Settings Page `Dashboard --> Settings --> App --> General` and initialise the MoEngage SDK in the onCreate method of the `Application` class
209
+
Copy the APP ID from the Settings Page `Dashboard --> Settings --> App --> General` and initialize the MoEngage SDK in the onCreate method of the `Application` class
211
210
212
-
**Note:** It is recommended that you initialise the SDK on the main thread inside `onCreate()` and not create a worker thread and initialise the SDK on that thread.
211
+
> info ""
212
+
> **Note:** MoEngage recommend that you initialize the SDK on the main thread inside `onCreate()` and not create a worker thread and initialize the SDK on that thread.
213
213
214
214
```java
215
215
// this is the instance of the application class and "XXXXXXXXXXX" is the APP ID from the dashboard.
216
216
MoEngage moEngage = new MoEngage.Builder(this, "XXXXXXXXXXX")
217
217
.enableSegmentIntegration()
218
218
.build();
219
-
MoEngage.initialise(moEngage);
219
+
MoEngage.initialize(moEngage);
220
220
```
221
221
222
-
### Install/Update Differentiation
222
+
### Install or update differentiation
223
223
This is required for migrations to the MoEngage Platform so the SDK can determine whether the user is a new user on your app, or an existing user who updated to the latest version.
224
224
225
225
If the user was already using your application and has just updated to a new version which has the MoEngage SDK, below is an example call:
Copy the Server Key from the FCM console and add it to the MoEngage Dashboard(Not sure where to find the Server Key refer to [Getting FCM Server Key](https://docs.moengage.com/docs/getting-fcmgcm-server-key). To upload it, go to the Settings Page `Dashboard --> Settings --> Channel --> Push --> Mobile Push --> Android` and add the Server Key and package name.
239
+
Copy the Server Key from the FCM console and add it to the MoEngage Dashboard. For more information about retrieving the Server Key, see [MoEngage - Getting FCM Server Key](https://docs.moengage.com/docs/getting-fcmgcm-server-key). To upload it, go to the Settings Page `Dashboard --> Settings --> Channel --> Push --> Mobile Push --> Android` and add the Server Key and package name.
240
240
**Please make sure you add the keys both in Test and Live environment.**
241
241
242
242
#### Add meta information for push notification
243
243
244
-
To show push notifications some metadata regarding the notification is required where the small icon and large icon drawables being the mandatory ones.
245
-
Refer to the [NotificationConfig](https://moengage.github.io/android-api-reference/core/core/com.moengage.core.config/-notification-config/index.html) API reference for all the possible options.
244
+
To display push notifications, some metadata regarding the notification is required. For example, the small icon and large icon drawables are mandatory.
245
+
246
+
Refer to the [MoEngage - NotificationConfig](https://moengage.github.io/android-api-reference/core/core/com.moengage.core.config/-notification-config/index.html) API reference for all the possible options.
246
247
247
248
Use the `configureNotificationMetaData()` to pass on the configuration to the SDK.
The Application would need to pass the Push Token received from FCM to the MoEngage SDK for the MoEngage platform to send out push notifications to the device.
284
+
The Application must pass the Push Token received from FCM to the MoEngage SDK for the MoEngage platform to send out push notifications to the device.
284
285
Use the below API to pass the push token to the MoEngage SDK.
285
286
286
287
```java
@@ -314,13 +315,15 @@ Add the below code in your manifest file.
314
315
</service>
315
316
```
316
317
317
-
When MoEngage SDK handles push registration it optionally provides a callback to the Application whenever a new token is registered or the token is refreshed.
318
+
When the MoEngage SDK handles push registration, it optionally provides a callback to the Application whenever a new token is registered or the token is refreshed.
319
+
318
320
An application can get this callback by implementing `FirebaseEventListener` and registering for a callback in the Application class `onCreate()` using `MoEFireBaseHelper.getInstance().addEventListener()`
319
-
Refer to the [API reference](https://moengage.github.io/android-api-reference/moe-push-firebase/moe-push-firebase/com.moengage.firebase.listener/-firebase-event-listener/index.html) for more details on the listener.
321
+
322
+
Refer to the [MoEngage - API reference](https://moengage.github.io/android-api-reference/moe-push-firebase/moe-push-firebase/com.moengage.firebase.listener/-firebase-event-listener/index.html) for more details on the listener.
Add the following snippet and replace `[PARENT_ACTIVITY_NAME]` with the name of the parent
326
329
activity; `[ACTIVITY_NAME]` with the activity name which should be the parent of the Rich Landing Page
@@ -421,7 +424,7 @@ If you already have these files,
421
424
Use [Identify](/docs/sources/website/analytics.js/#identify) to track user specific attributes. This is equal to [tracking user attributes](https://docs.moengage.com/docs/tracking-web-user-attributes) on MoEngage. MoEngage supports traits supported by Segment as well as custom traits.
422
425
423
426
### Track
424
-
Use [track](/docs/sources/website/analytics.js/#track) to track events and user behaviour in your app. This will send the event to MoEngage with the associated properties. Tracking events is essential and will help you create segments for engaging users.
427
+
Use [track](/docs/sources/website/analytics.js/#track) to track events and user behavior in your app. This will send the event to MoEngage with the associated properties. Tracking events is essential and will help you create segments for engaging users.
425
428
426
429
### Reset
427
430
If your website supports the ability for a user to logout and login with a new identity, then you’ll need to call [reset](/docs/sources/website/analytics.js/#reset-logout) method in `analytics.js`.
0 commit comments