Connect an Event Output

Prerequisites

Before you start this activity, you should have already:

• Created an input
• Started to capture some basic data points

Outputs

Outputs are mParticle’s term for the services we forward your data to. Outputs are also referred to as “integrations”. Outputs come in two types: “event”, and “audience”. Audiences are covered in the next part of this guide. This section will show you how to set up an event output.

Example - Connect an Input to Amplitude

mParticle has over a hundred event outputs, and the connection process for each is similar. This tutorial creates a connection to Amplitude as an example. You can follow the same steps with a different output, or create a free Amplitude account to follow along exactly.

Find Amplitude in the Directory

1. Navigate to the Directory in the sidebar. The Directory lists all the integrations offered by mParticle. Select Amplitude.

   

2. From the Amplitude directory page, select Add Amplitude to Setup. And choose Output Event.

   

Complete Configuration Settings

1. Completing the previous step takes us to Setup > Outputs and opens the output configuration dialog for Amplitude. You’ll see that the only credential you need is an API Key.

   This is available from the Amplitude dashboard, on your project’s Settings page.

   

   

2. Give your configuration a name and click Save & Open in Connections.

Create the Connection

Now that you have both an input and an output set up, it’s time to connect them:

1. From Connections > Connect, and select the input you’ve already set up.

   

2. Click Connect Output.

   

3. Select your Amplitude configuration.

   

4. Complete the Connection Settings. These will be different for each output. Refer to the documentation for the specific output for help completing the connection settings. For this example, you can leave the default values as they are. When you’re ready, set the status to Active and click Save.

   

Verify: Check that data is arriving in Amplitude

Once you have enabled the connection, open up the development build of your app again and create a few more events. Each output service will have different ways of displaying the data it receives. For Amplitude, you can create a Real-Time Activity dashboard to check incoming data.

Troubleshoot

If you don’t see your data arriving in the output service, there are a few things you can try.

Start by checking the “Outbound” view of the Live Stream, setting the filters to show messages forwarded to the output you need to troubleshoot:

If there are outgoing messages in the Live Stream

If you see messages in the outbound Live Stream, but none in the output service:

• You may just need to wait. For most event outputs, mParticle forwards information in close to real time. However, there are factors which can slow down processing and the amount of time it takes for data to become visible in an output service’s dashboard can be different for each service.

• Navigate to Activity > System Alerts and see if there are any errors noted against the output you want to troubleshoot. The error type may give you a clue as to what is wrong.

  

• Check all of your Configuration and Connection settings. Make sure that all settings are correct, especially any access credentials, such as Project or App IDs, API Key & Secret, etc.

• It is common for a particular output service to require certain identifiers or other data points to be present to allow data to be forwarded. As an example, the Google Adwords output requires information about a user’s device, including the Device Advertising ID, in order to construct a User Agent Header. If the Device Advertising ID is not present, no data can be sent. Check the docs for the output service and make sure you’re sending all the required information.

If there are no outgoing messages in the Live Stream

If you don’t see any messages in the outbound Live Stream, then mParticle is not attempting to send any data to the output service. Some possible reasons for this include:

• Not all outputs support every platform or accept every event type. The Directory shows a list of available platforms and supported event types for each output. Make sure the data you are trying to send is supported.

  

• mParticle allows you to filter your data for each output. Check the Data Filter to make sure you haven’t turned off the data points you’re trying to send.

  

Next steps

By now you should be successfully forwarding data to at least one event output. Some additional resources you might want to look at include:

• One of the key benefits of mParticle is the power to collect data once and forward it to as many output services as you wish. Browse the Integrations section of our docs to learn more about the different services mParticle can forward your data to.
• Most event outputs work by forwarding data server-side via the output partner’s HTTP API. However, some outputs require extra client-side code to be added to your native app, to allow data to be sent directly from your app to the output service. These integrations are called “embedded kits”. You can read more about them in the iOS and Android documentation.
• Sending web data to an output usually works a little differently from native. If you’re using mParticle on the web, read our guide to Working with Web Data.

Next up, you will learn about the second category of mParticle data by creating an audience.