Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Xtremepush (Actions) Destination docs. #6528

Merged

Conversation

vii07
Copy link

@vii07 vii07 commented May 10, 2024

Proposed changes

Add the new docs page for Xtremepush (Actions) Destination.

Merge timing

ASAP once approved.

@vii07 vii07 requested a review from a team as a code owner May 10, 2024 13:09
@vii07 vii07 requested review from forstisabella and removed request for a team May 10, 2024 13:09
@forstisabella forstisabella added the new-integration Added a new source or destination label May 10, 2024
Comment on lines 1 to 3
---
title: Xtremepush (Actions) Destination
---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @vii07 - the beta/hidden attributes denote that this integration is in private beta, the ID autogenerates some of the actions content when this integration enters public beta, and the versions note links directly to the classic Xtremepush destination (an example of this is the docs for the Slack (Actions) destination, and the blue note at the top of that page).

Suggested change
---
title: Xtremepush (Actions) Destination
---
---
title: Xtremepush (Actions) Destination
beta: true
hidden: true
id: 661e9787658d112ba31b59a7
versions:
- name: Xtremepush Destination
link: /docs/connections/destinations/catalog/xtremepush/
---

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@forstisabella Thanks for your suggestions and I'll apply all of them soon. But a note for this one is that we want to make our new Xtremepush (Actions) Destination public beta after merging this doc, so I will pass hidden: false instead.

---
{% include content/plan-grid.md name="actions" %}

[Xtremepush](https://xtremepush.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a complete digital engagement platform. Empowering global brands to create personalised, real-time experiences for their customers across mobile, web, email, SMS and social. Xtremepush's clients are increasing revenue through data-driven, contextually-relevant interactions. The software is flexible, reliable and quick to deploy, backed up by a team of expert strategists and technical support.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[Xtremepush](https://xtremepush.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a complete digital engagement platform. Empowering global brands to create personalised, real-time experiences for their customers across mobile, web, email, SMS and social. Xtremepush's clients are increasing revenue through data-driven, contextually-relevant interactions. The software is flexible, reliable and quick to deploy, backed up by a team of expert strategists and technical support.
[Xtremepush](https://xtremepush.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a complete digital engagement platform that empowers global brands to create personalized, real-time experiences for their customers across mobile, web, email, SMS and social. Xtremepush's clients are increasing revenue through data-driven, contextually-relevant interactions. The software is flexible, reliable and quick to deploy, backed up by a team of expert strategists and technical support.

Comment on lines 10 to 11
> success ""
> **Good to know**: This page is about the [Actions-framework](/docs/connections/destinations/actions/) Xtremepush (Actions) Segment destination. There's also a page about the [classic Xtremepush destination](/docs/connections/destinations/catalog/xtremepush/). Both of these destinations receive data from Segment.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> success ""
> **Good to know**: This page is about the [Actions-framework](/docs/connections/destinations/actions/) Xtremepush (Actions) Segment destination. There's also a page about the [classic Xtremepush destination](/docs/connections/destinations/catalog/xtremepush/). Both of these destinations receive data from Segment.

Comment on lines 17 to 19
- **Easier setup**. Users see fewer initial settings which can decrease the time spent configuring the destination.
- **Increased transparency**. Users can see the exact data that is sent to the destination, and when Segment sends it.
- **Improved customization**. Users can determine how the events their sources trigger and map to actions supported by the destination.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Easier setup**. Users see fewer initial settings which can decrease the time spent configuring the destination.
- **Increased transparency**. Users can see the exact data that is sent to the destination, and when Segment sends it.
- **Improved customization**. Users can determine how the events their sources trigger and map to actions supported by the destination.
- **Easier setup**: Users see fewer initial settings which can decrease the time spent configuring the destination.
- **Increased transparency**: Users can see both the exact data that is sent to the destination and the time that Segment sent it.
- **Improved customization**: Users can determine how the events their sources trigger map to actions supported by the Xtremepush (Actions) destination.

Comment on lines 23 to 26
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Xtremepush"
2. Select **Xtremepush (Actions)** and click **Add Destination**
3. Select an existing Source to connect to **Xtremepush (Actions)**.
4. Enter the "API Key" and "API Endpoint" into your Segment Settings UI which you can find from your Xtremepush Project under *Settings > Integrations* as described in the [user guide](https://docs.xtremepush.com/docs/segment){:target="_blank"}.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Xtremepush"
2. Select **Xtremepush (Actions)** and click **Add Destination**
3. Select an existing Source to connect to **Xtremepush (Actions)**.
4. Enter the "API Key" and "API Endpoint" into your Segment Settings UI which you can find from your Xtremepush Project under *Settings > Integrations* as described in the [user guide](https://docs.xtremepush.com/docs/segment){:target="_blank"}.
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”} search for "Xtremepush".
2. Select **Xtremepush (Actions)** and click **Add destination**.
3. Select an existing Source to connect to **Xtremepush (Actions)**, and click **Next**.
4. Enter a name for your Xtremepush (Actions) destination and click **Create destination**.
4. From the Segment destinations settings page, enter the "API Key" and "API Endpoint". You can find these values in your Xtremepush Project under *Settings > Integrations* as described in the [Xtremepush Segment integration user guide](https://docs.xtremepush.com/docs/segment){:target="_blank"}.


When you identify a user, we'll pass that user's information to Xtremepush and will try to update or create a new user based on whether a Profile exists with that `user_id`.

Some special traits will also be used as additional user identifiers:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Some special traits will also be used as additional user identifiers:
Some user traits are also passed as additional user identifiers:

| email | email |
| phone | mobile_number |

For any additional traits you want to save you should create [User Profile Attributes](https://docs.xtremepush.com/docs/attributes-tags){:target="_blank"} in your Xtremepush Project.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For any additional traits you want to save you should create [User Profile Attributes](https://docs.xtremepush.com/docs/attributes-tags){:target="_blank"} in your Xtremepush Project.
For any additional traits you want to save, create [User Profile Attributes](https://docs.xtremepush.com/docs/attributes-tags){:target="_blank"} in your Xtremepush Project.


For any additional traits you want to save you should create [User Profile Attributes](https://docs.xtremepush.com/docs/attributes-tags){:target="_blank"} in your Xtremepush Project.

If a trait does not match a custom Xtremepush User Profile Attribute and is not recognized as a User Identifier it will be ignored.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If a trait does not match a custom Xtremepush User Profile Attribute and is not recognized as a User Identifier it will be ignored.
If a trait does not match a custom Xtremepush User Profile Attribute and is not recognized as a User Identifier, Xtremepush ignores the trait.

})
```

Track calls will be sent to Xtremepush as a `event hits`, so you can use it to [trigger a campaign](https://docs.xtremepush.com/docs/campaign-events){:target="_blank"} for a user.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Track calls will be sent to Xtremepush as a `event hits`, so you can use it to [trigger a campaign](https://docs.xtremepush.com/docs/campaign-events){:target="_blank"} for a user.
Track calls are sent to Xtremepush as a `event hits` and you can use them to [trigger a campaign](https://docs.xtremepush.com/docs/campaign-events){:target="_blank"} for a user.

Event properties can be used as merge tags in the message content. You can also define additional rules on where to trigger the campaign based on event properties value.

## Enabling Push and In-App Notifications
To enable Xtremepush push and in-app notifications you will also need to to install the relevant Xtremepush SDKs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To enable Xtremepush push and in-app notifications you will also need to to install the relevant Xtremepush SDKs.
To enable Xtremepush push and in-app notifications you must also install the relevant Xtremepush SDKs.

@vii07 vii07 requested a review from forstisabella May 13, 2024 09:30
Copy link
Contributor

@tcgilbert tcgilbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

---
title: Xtremepush (Actions) Destination
beta: true
hidden: false
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
hidden: false

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we can remove this attribute if hidden is not set to true, as it's not hidden by default!

@forstisabella forstisabella merged commit cf6e848 into segmentio:develop May 14, 2024
4 checks passed
Copy link
Contributor

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration Added a new source or destination
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants