Lesson

Playbook: SDK Integration Testing

The first step in integrating Braze is to perform basic SDK initialization and basic user management, such as logging in identified users.

Key Areas for Testing

Once the basic SDK integration is complete, you able to track session and device data for:

  • Anonymous users on a per-device basis
  • Identified users across multiple devices

When testing the SDK integration, you will want to focus on:

  • Making sure SDK initialization occurs when expected
  • Ensuring data reaches the correct workspaces
  • Correctly applying identifiers to identified users
  • Checking that data allowlisting is properly configured

Key Tools

Testing your SDK integration will rely primarily on the following tools:

  • Dashboard Home Page
  • Braze User Profile page
  • Internal Groups
  • Event User Log

Example: Testing SDK Integration

This video shows how one company, PantsLabyrinth, tested their SDK initialization.

Testing Anonymous Users

Follow these steps to test if anonymous users are being tracked.

First Steps

  1. Make sure you’re using the development version of your app with Braze integrated.
  2. Confirm that you’re viewing the correct workspace in the Braze dashboard.

Quick Check

  1. Check session count in the Braze dashboard’s data overview homepage.
  2. Open a new session on your test device (recall the session timeouts for Android, iOS and Web)
  3. Check the Data Overview page to see if session count has increased.

Deep Dive

  1. Add your anonymous user as an Internal Group test user.
  2. View their profile in the User Profile tool.
  3. Trigger additional sessions with the device and check if sessions are registering in the Data Overview page and on the User Profile.

Testing Identified Users

Follow these steps to test if identified users are being tracked correctly.

Identified to Anonymous

We recommend keeping aside one device without logging in a user as it is easier to continue anonymous user testing on that device. If needed, you can uninstall your app on mobile devices, or clear your cache in a web browser.

First Steps

  1. Make sure you’re using the development version of your app with Braze integrated.
  2. Confirm that you’re viewing the correct workspace in the Braze Dashboard.

Quick Check

  1. Complete your login procedure in your app, for example as User 1.
  2. Check that you’re able to view the user profile in the Braze user profile tool using the expected user ID.

Deep Dive

  1. Log in as the same user, User 1, on a separate device.
  2. Check that you are able to see both devices in the User 1’s Recent Devices section in the Braze user profile page.
  3. Try logging in as a different user, User 2, on both devices.
  4. Check the Braze user profiles to see if User 2 is being tracked now.