Previewing Experiments

View your Experiments before they go live

If building experiments is like getting dressed in the morning, previewing them is like checking yourself out in the mirror.

If you're at this point in the documentation, you should have already created your first experiment, whether it's code-based or visual. If you haven't, you've probably gone too far and should look a few steps back.

Previewing isn't just about seeing your visual changes or new features on a device before sending them out. Previewing is also about testing your goals and understanding how Taplytics is going to distribute your experiment to your users.

You'll want to know that everything will be tracked and distributed accurately if you've taken the time to set up your goals and a target segment. We have thought long and hard about this and we think we have a pretty good system for previewing all aspects of your experiment.

The sub-sections of this documentation article are:

  1. Preview Your App Edits

  2. Test Your Goals

  3. Test Your Distribution
  4. Distribution Percentages

Preview Your App Edits


Let's not take this time to re-hash how to see real-time changes occurring on your device. That's been covered in our articles in App Linking and creating Visual Experiments. Previewing your app edits is all about getting other people on your team, who may not have access to Taplytics, to check out your experiments and make sure they look and behave the way you expect.

The first step to achieving team-based QA is to make sure all of the people who will preview your tests have their devices connected to Taplytics. Again, to get this set up properly, visit the documentation article on App Linking. This will provide a step-by-step guide to get your team's devices connected to your account.

Once the right people have their devices connected, all you have to do is tell them to open the app and shake their phone to see your experiment.

That's right, get them to shake their phones.

Obviously, caution them about the dangers of vigorous device shaking as it's probably still too soon for some of us to discuss what happened with the Wii-motes.


Once your QA team has shaken their phones (provided that their phone has been connected and accepted as a connected device for Taplytics), the Taplytics menu will display.

The Taplytics Menu


The Taplytics Menu provides anyone with access to it with the ability to view all of your draft and active experiments on any device, regardless of whether the app is loaded on a physical device or a virtual XCode simulator.


To preview an experiment, all a team member has to do is tap the “Show Experiment” option in the Taplytics menu and they will be brought to a list of draft and active experiments. Once they pick the desired experiment, they can preview any of the variations that you have created.


The great thing here is that this means that your QA is done on actual devices. Any of your variations are displayed exactly as your users would see them in the wild. Totally awesome.

Test Your Goals


Once your team views the desired experiment or variation, test out the goals you set up and make sure everything is tracked correctly. To do this, push your experiment live just for people with an internal build of your app and track the data coming into your experiment's results page. This also works for testing distribution. Testing your goals internally can provide you with a sense of what the real data will look like.

If you're a developer and you want to make sure that the code goals that you instrumented are firing properly and you don't want to wait for these charts to populate, look no further than our "User Insights" platform. Our "User Insights" show you everything that a user does in your app and shows you when an experiment is run and when a code goal or event is triggered. To test that your code events are working in under a minute, open the app, shake your device, run the appropriate experiment, and fire those events. Once you refresh the "User Insights" page, you will see your device at the top. When you go into the detailed view, you will see everything you did in that session, including which events occurred and the values that were passed to your results. Pretty awesome, eh?

Test Your Distribution


So your experiment is looking gorgeous, your goals are firing like champs, and now you want to make sure the right people get your experiment.

If you really want to make sure that distribution is working as you'd expect, set the app version in target segmentation to an internal build and hit "Run Experiment".

Your team doesn't need to go to the shake menu; they just need to re-open the app after you've hit run. You can check the "User Insights" view and you'll be able to see who on your team is running which version of your app, and which user attributes received the experiment.

Distribution Percentages


Given that your internal testing team is probably relatively small (under 100 people), if you set your distribution at 50-50, you will not see exactly half of your team get each variation. The distribution is probability-based, folks.

If you have 10 people testing the new experiment even with 50-50, you could get all ten of them seeing the same variation. The best way to test distribution is to set 100% distribution to one variation before hitting the “let's run” button. This way, all devices are sent one variation and you'll know it's working. If it's not, you'll know that the first place you should check is the "DelayLoad" feature in our SDK to make sure Taplytics is giving your experiments the appropriate amount of time to load properly.

Wrapping it Up


We covered a lot in this section. Let's do a quick summary.

To preview your experiments, the tools you'll want to use most are the "Shake Menu" and "User Insights". With these two tools, you can find out everything about how your experiment functions before you send it out into the wild. Beyond that, if you have any questions, you know where you can find us: support@taplytics.com