This preview of pull request 1639 is meant for internal use only.

Moesif API Analytics Destination

Moesif API Analytics quick info

Moesif API Analytics accepts Identify calls. If you reference it in the Integrations object, call it “moesif-api-analytics", or "Moesif API Analytics”.

Moesif API Analytics helps you drive API adoption, usage, and retention. With Moesif, track your customer journey from initial ad click to first API call while identifying at-risk customers struggling to integrate with your APIs.

The Moesif SDKs and API gateway plugins are open-source and support REST, GraphQL, and other APIs.

This destination is maintained by Moesif. For any issues with the destination, contact the Moesif team.

Getting Started

  1. From the Segment web app, click Catalog.
  2. Search for “Moesif” in the Catalog, select it, and choose which of your sources to connect the destination to.
  3. Enter the Moesif “API Key” into the destinations settings in the Segment App. You can find these by going to your Moesif account and navigating to the extensions settings.
  4. Once integrated, Segment data shows up in Moesif in a few seconds.

Tip: You can use Segment’s Replay feature to sync historical events sent through Segment into your Moesif app.

Identify

If you’re not familiar with the Segment Specs, take a look to understand what the Identify method does. An example call would look like:

analytics.identify('userId123', {
      first_name: 'John',
      last_name: 'Doe',
      email: 'john@example.com',
      company: {
          id: '67890',
          plan: 'Free'
      }
});

Segment sends identify() calls to Moesif as user updates which you can see in the Users section in Moesif. If you set traits.company.id on the user, Moesif associates them with a company. The integration maps user fields as follows:

Segment Field Moesif Field
userId user_id
traits metadata
traits.company.id company_id

The integration handles Segment reserved traits like email and firstName. It maps automatically-collected fields like campaign information and IP address.

Track

If you haven’t had a chance to review our spec, take a look tounderstand what the Track method does. An example call would look like:

analytics.track('Login Button Clicked')

Segment sends track() calls to Moesif as user actions which you can see in the Events section in Moesif. The integration maps event fields as follows:

Segment Field Moesif Field
event action_name
properties metadata

Personas

You can send computed traits and audiences generated using Segment Personas to this destination as a user property. To learn more about Personas, contact us for a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Personas sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Personas sets that value to false.

When you first create an audience, Personas sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

API Key

You can find your API key by going to extensions menu within Moesif and selecting Segment

Adding Moesif API Analytics to the integrations object

To add Moesif API Analytics to the integrations JSON object (for example, to filter data from a specific source), use one of the following valid names for this integration:

  • moesif-api-analytics

  • Moesif API Analytics

This page was last modified: 20 Oct 2020



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account