Skip to content
Pushwoosh Logo Product Documentation

Amplitude integration

Amplitude, a robust product analytics platform, empowers businesses to understand user behavior in real-time, track in-product interactions, and gain valuable insights into user engagement, retention, and revenue.

Integrating Amplitude with Pushwoosh allows you to personalize Pushwoosh campaigns with Amplitude data, trigger automated campaigns based on user actions, analyze performance for continuous improvement, and ultimately drive enhanced engagement, reduced churn, and increased revenue.

Integration overview

Integration type

Destination: Data is sent from Amplitude to Pushwoosh.

Prerequisites

To set up the Event Streaming and Cohort Sync integration from Amplitude to Pushwoosh, ensure the following prerequisites are met:

  • You need an active Pushwoosh account.
  • Generate an API Access Token in Pushwoosh to send data.
  • Locate your Pushwoosh App Code before configuring the integration.
  • This integration is only available to Amplitude customers with paid plans.
  • You must have a paid Pushwoosh plan to use this integration.
  • Pushwoosh only accepts email addresses as the identifier. This means the User_ID or user property you select in Amplitude must contain an email address.

Glossary (mapping entity names if they are different)

Cohorts in Amplitude = Segments in Pushwoosh

Synchronized entities

  • Events
  • Tags
  • Segments

How does the integration work?

The Amplitude Integration with Pushwoosh operates by syncing data between the two platforms to enhance user engagement and segmentation. Here’s a detailed breakdown of how it works:

Data Transmission

  • Events: Amplitude sends event data to Pushwoosh. Each event contains a user ID (external_id), an application code (app_id), a timestamp (created_at), and additional attributes (attributes).

  • Tags: Pushwoosh receives tags that are associated with user profiles. These tags are sent with a user ID (external_id), an application code (app_id), and tag properties (properties).

  • Segments: Segments are imported similarly to how Pushwoosh handles CSV imports. Users are added to or removed from segments via requests.

Data Flow

  • Events and Tags: Data is sent from Amplitude to Pushwoosh based on user interactions or attributes tracked in Amplitude. Events and tags are created or updated in Pushwoosh according to the configuration and mappings set up in Amplitude.

  • Segments: Segments are created in Pushwoosh when Amplitude makes a request. Pushwoosh generates a unique identifier for each segment, which Amplitude uses to manipulate the segment by adding or removing users.

Requests

Requests are sent to specific endpoints in Pushwoosh to handle events, user attributes, and segment updates. Each request requires authentication and has specific headers and payload formats.

Use cases

Event tracking

Track user actions and interactions from Amplitude and send these events to Pushwoosh to trigger notifications or updates.

User tagging

Assign tags to users based on their behavior or attributes in Amplitude. These tags can be used in Pushwoosh for targeted messaging or segmentation.

Segment management

Create and manage user segments in Pushwoosh based on the data and segments configured in Amplitude. This helps in targeting specific groups of users with personalized messages.

Automated user management

Automatically add or remove users from segments based on their actions or attributes in Amplitude, ensuring up-to-date segmentation in Pushwoosh.

Setting up the integration

Cohort sync

Pushwoosh setup

  1. In Pushwoosh, navigate to Settings > Integrations.

  2. Click Add Integration, then find and add Amplitude.

  3. Copy the Pushwoosh API Key and App Code to your clipboard.

Amplitude setup

To configure Amplitude for integration, follow these steps:

  1. In your Amplitude Data, go to the Catalog and select Destinations.
  2. Under the Cohort section, locate and click Pushwoosh.
Choosing Pushwoosh from destinations
  1. Click Add another destination.
Adding another destination
  1. Provide a name and paste the API key you copied from Pushwoosh.
Adding Pushwoosh APi access token and application code
  1. Map the Amplitude User ID field to the Pushwoosh User ID field.
  2. Save your settings when you’re done.

Sending a cohort

To synchronize your first cohort, complete the following steps:

  1. In Amplitude, open the cohort you wish to synchronize, then click on Sync.
Sending a cohort
  1. Choose Pushwoosh and select the account you want to synchronize with. Then, click Next.
  1. Decide on the synchronization cadence and save your configurations.

Event streaming

Pushwoosh setup

  1. Get your Pushwoosh API Key

  2. Locate the App Code in your Pushwoosh account.

Amplitude setup

  1. In Amplitude, go to Data Destinations and find Pushwoosh - Event Stream.
  1. Enter a sync name and then click Create Sync.
  1. Change the Status from Disabled to Enabled and paste your Pushwoosh API Access Token and App Code.
  1. From the left dropdown, select the Amplitude user property that corresponds to your Pushwoosh UserID.
  2. (Optional) Enable the Create & Update users toggle if you want to send users and their properties in real-time whenever Amplitude creates or updates a user property.
  1. Enable Send Events (“Events are sent to Pushwoosh”) if you want to stream events to Pushwoosh. This will automatically forward events to Pushwoosh as they are ingested in Amplitude. Events aren’t sent on a schedule or on demand using this integration.
  1. Then, choose which events you want to send in the Select and Filter Events section. Only select the events you need in Pushwoosh; transformed events are not supported.
  2. Once done, enable the destination and click Save.

How do you know that the integration is working?

To verify that the Amplitude and Pushwoosh integration is functioning correctly, you can use the following methods:

Monitor Pushwoosh dashboard

  • Events and Tags: Check the Pushwoosh dashboard to see if the events and tags sent from Amplitude appear as expected. Look for recent activities or updates related to your events and tags.
  • Segments: Verify that segments are being created, updated, or modified based on the data from Amplitude. Ensure that user counts and segment memberships reflect expected changes.

Check API responses

  • Successful responses: Ensure that you receive 200 OK responses from the Pushwoosh API endpoints. Although there may not always be a response body, the 200 OK status indicates that the request was successfully received.
  • Error responses: Review any error responses or status codes other than 200 OK for clues if something is not working. Common errors might include 400 Bad Request, 401 Unauthorized, or 500 Internal Server Error.

Log requests and responses

  • Request logs: Maintain logs of outgoing requests from Amplitude and incoming responses from Pushwoosh. Check these logs to ensure that requests are formatted correctly and responses are as expected.
  • Error logging: Implement error logging to capture any issues during data transfer or integration processes.

Test with sample data

  • Send test Events/Tags: Create and send test events and tags from Amplitude to Pushwoosh. Verify that these test entries appear correctly in Pushwoosh and trigger expected behaviors.
  • Simulate user actions: Perform actions in Amplitude that should trigger specific events or updates in Pushwoosh. Check if these actions result in the expected changes in Pushwoosh.

Use monitoring tools

  • Integration monitoring: Utilize monitoring tools or services that can track the health and performance of the integration. These tools can alert you to issues or failures in real-time.
  • Analytics and reporting: Use analytics features in both Amplitude and Pushwoosh to review data flow and integration performance.

Review integration documentation

  • Configuration review: Double-check the integration configuration in both Amplitude and Pushwoosh to ensure all settings and mappings are correctly applied.
  • Documentation updates: Stay updated with any changes or updates in the integration documentation that might affect functionality.

Contact support

If you encounter persistent issues or inconsistencies, reach out to the support teams of Amplitude or Pushwoosh for assistance. Provide them with details of the integration setup and any error logs for faster resolution.

Troubleshooting

Integration issues

  • Event not appearing in Pushwoosh: Ensure the event is correctly mapped, and verify that the Pushwoosh application code and API token are properly configured.

  • Tags not syncing: Confirm that the tags are formatted correctly and that all necessary authentication details are included in the request.

Segment problems

  • Segment not created: Check that the request to create the segment is correctly formatted and that the Pushwoosh API token is valid.

  • Users not added/removed: Verify that the user IDs are correctly specified and that the segment ID is valid. Ensure the request payload is properly formatted.

Response issues

  • No response body: If you receive a 200 OK response but no response body, verify that the request was properly formatted and that the data was sent correctly.

FAQ

What should I do if I receive a 400 Bad Request error?

Review the request payload for formatting errors or missing fields. Ensure all required fields are included and correctly formatted.

How can I verify if the integration is working?

Check the Pushwoosh dashboard for incoming events, tags, and segment updates. You can also monitor logs or responses from API endpoints for successful data transfers.

Can I customize the events or tags sent to Pushwoosh?

Yes, you can customize events and tags within the Amplitude configuration. Make sure that the data adheres to the expected Pushwoosh format.

How often is the data synced between Amplitude and Pushwoosh?

Data syncs in real-time or near-real-time based on requests made from Amplitude. Ensure your configuration supports the desired update frequency.

Where can I find more information or support for this integration?

Refer to the official documentation from Amplitude and Pushwoosh. For further assistance, contact the respective support teams.