App Center

Step-by-step guide to ingest your event data from App Center into RudderStack.

App Center is Microsoft's cross-platform build automation and management platform that lets you manage your app's lifecycle seamlessly. With App Center, you can automate your builds, test your apps in the cloud effectively, and monitor their real-time usage with the help of crash data and analytics.

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

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

Getting started

Follow these steps to set up your App Center source in the RudderStack dashboard:

• Go to your RudderStack dashboard and click on Add Source. From the list of Event Stream sources, select App Center, as shown:

• Assign a name to your source and click on Next.

• Your App Center source is now configured. Note the source Write key - this will be required to configure the webhook URL in the following steps.

• Then, head over to your App Center account and select the application you want to configure. Here, navigate to the Webhooks section under Settings from the sidebar, and then create a new webhook, as shown:

• In the URL text box, add a URL pointing to RudderStack in the following format:

<DATA_PLANE_URL>/v1/webhook?writeKey=<WRITE_KEY>

For more information on the data plane URL, refer to this section.

Make sure you add the source write key as a query parameter to the URL. This is required to prevent the webhook from failing for the lack of a valid write key.

A sample URL is as shown:

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

We highly recommend validating the endpoint using the Send Test button.

• Finally, 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 Event	RudderStack Track Event Name
On Success of a Build	Build Succeeded
On Failure of a Build	Build Failed
On Release of a new version	Released Version <X.YY>
On an App Crash	App Crashed

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

App Center Property	RudderStack Property
app_name, app_display_name	context.app.name
build_id	context.app.build
os, platform	context.device.type, context.os.name
start_time	originalTimeStamp
sent_at	sentAt
short_version, app_version	context.app.version
bundle_identifier	context.app.namespace

Contact us

For queries on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.