App Center Source

Ingest your event data from App Center into RudderStack.

  •   2 minute read  

App Center is Microsoft’s cross-platform build automation and management platform. It lets you automate your builds, test your apps in the cloud, and monitor their real-time usage with the help of crash data and analytics.

You can send your App Center events by adding a webhook that points to RudderStack. These events include activities related to build success or failure, new app version releases, or app crashes. You can also configure what events to send per your requirement on their dashboard.

This guide will help you set up App Center as a source in RudderStack.

Get started

  1. Go to your RudderStack dashboard and click Add Source. From the list of Event Streams sources, select App Center.
  2. Assign a name to your source and click Continue.
  3. Your App Center source is now configured. Note the source write keyThe write key (or source write key) is a unique identifier for your source. RudderStack uses this key to send events from a source to the specified destination. required to configure the webhook URL.
  4. In your App Center account, select the application to configure. Navigate to the Webhooks section under Settings from the sidebar, and then create a new webhook:
App Center source configuration
  1. In the URL text box, add the Endpoint URL pointing to RudderStack in the following format:
<DATA_PLANE_URL>/v1/webhook?writeKey=<WRITE_KEY>

A sample URL is as shown:

https://hosted.rudderlabs.com/v1/webhook?writeKey=1bCenqHh8ETX8s5Crjh22J
warning

Make sure to:

  • Replace <DATA_PLANE_URL> with the data plane URL associated with your RudderStack workspace.
  • Add the source write key obtained in Step 3 as a query parameter to the URL. This is required to prevent the webhook from failing.
  • Validate the endpoint before proceeding.
Endpoint configuration
  1. Save the endpoint.

Event transformation

The App Center events are ingested into a RudderStack track call with the designated name and properties as the entire event received from App Center. For example, the app_name set by App Center is set as context.app.name.

The following table highlights the mapping of various App Center events from App to RudderStack’s track calls:

App Center EventRudderStack Track Event Name
On Success of a BuildBuild Succeeded
On Failure of a BuildBuild Failed
On Release of a new versionReleased Version <X.YY>
On an App CrashApp Crashed

Also, RudderStack populates the following properties from the App Center event payload to the RudderStack event:

App Center PropertyRudderStack Property
app_name, app_display_namecontext.app.name
build_idcontext.app.build
os, platformcontext.device.type, context.os.name
start_timeoriginalTimeStamp
sent_atsentAt
short_version, app_versioncontext.app.version
bundle_identifiercontext.app.namespace

Questions? Contact us by email or on Slack