Documentation

appMixable Documentation

Below you'll find an integration overview, guides that will teach you how to use appMixable, and reference documentation for all the moving parts.


In Your Mobile App

Choose from our Unity3D SDK or iOS SDK for quick integration into your iOS and Android applications.

On Our Site

Control the creation and delivery of in-app experiences, and gain insight from remix metrics

In Your System

Use our REST server API to create custom clients or fold remix metrics into your own analytics solution.


Integration Overview

Sign up and download the SDK

If you've used other 3rd-party services before in your mobile apps, then this process should sound familiar:

  • Sign up on the site
  • Create a new appMixable app in the dashboard
  • Note the keys associated with your appMixable app
  • Download the appropriate Software Development Kit (SDK) and copy it into your mobile app project
  • Enter your appMixable app keys into the appropriate area of the SDK
  • Start creating amazing app remixes

Thus, appMixable uses the same premise. Also, because our SDK is complementary, you can add it to any existing Unity3D or Xcode project without conflict or regard to any other SDKs you may favor.

Note: since the appMixable service is in closed beta, registration is currently by invite only.

Request an Invite

Create your first remixable object

Here's where it gets interesting. Within your app, you locate which aspects you want to remix. It may be an object, an image, a UI element, or any combination of these. In Unity3D, conveying this to appMixable is as simple as selecting the element in the Scene or Hierarchy, which appMixable then uses as the basis for customization of your app.

Each remix is assigned a unique token by appMixable, which our SDK can then recognize when present in a deeplink to your app, and in turn, can inform your app about the specific mix that launched it.

Choose the properties of your remix

Although you can start using your remixes of the bat, you also have the option of assigning it additional properties. For example, you may control the permissions available to this remix. Maybe it's just for you for internal A/B testing purposes, or maybe it's the basis for app users to create and share their own remixes.

You may also want to assign certain media elements to it, like a thumbnail. Maybe you'd like this media to be auto-generated from the inputs used to create the remix.

Additionally, you may want to assign a certain remix, say a welcome screen, to be the default, but serve as the basis for creating new remixes of the welcome screen.

Test out your remix

Remixes can be loaded in Editor or in Project, so you can run the loop locally in your development environment. Because the creation of new remix objects also occurs in project, this allows for a tight development iteration loop. You can quickly make changes and then see those changes in project with the actual remix data/assets themselves.

The Editor-based Deeplink Simulator included in our Unity3D SDK will also let you directly load any remixes of interest, just as if the app user had clicked the deeplink before entering the app.

Once you're comfortable with your remixes in Editor, then compile and build for iOS or Android, and test in simulator or on device.

Remix your remix

The great thing about a remix is that it can be ... (wait for it) ... remixed! We call this process:

casting

When casting a new remix, you create a new variation by specifying which parts of the previous remix you'd like to replace.

How you'd like to present this option, either to yourself, a user of your app, a product manager, whoever, is up to you. Ultimately, it's simply a call to our Server API , so the user interface that makes the call could reside in your app ("Choose an image from Photos for a new background"), could be a process in your system ("Get an image from a trending post in Pinterest"), on your website, maybe even tied to an Arduino app out in the physical world.

Internally, you can create new variants yourself directly on the site. However, this is limited to you and your app collaborators. Thus, appMixable also provides hosting ourselves on a separate domain for public remix authoring on the web.

Share your remix

Finally, since each remix has its own unique deeplink URL, distribute those however you see fit. End users may want to share them on their favorite social media channels, via SMS, or email.

Because not all recipients of new remixes may not have yet installed your app, appMixable provides a free short url site at appm.co which guides end users through your app's install flow while retaining the intended remix to load during their trip to the App Store, Google Play, or any enterprise, ad hoc, or OTA install path you may favor.


Need Help?

We're always happy to help out with code or any other questions you might have.

Contact Us