Tapstream

Setting up campaigns

Running reports

APIs

Advanced

Tapstream SDKs

Tapstream campaign creation

Tapstream campaigns are differentiated by their campaign links. These URLs give you data on the engagement that each relevant cohort in your marketing channels generate.

Use as many campaign links as you like. Each of your campaigns should have its own, unique link - don't re-use links.

Advanced URL handling

Tapstream campaign URLs have several special features:

  • Onboarding to send users to deep destinations within your app
  • Device-aware redirection to send users on different platforms to different destinations
  • Split testing so you can measure weighted split tests on different destinations
  • Dynamic redirection so you can dynamically redirect inbound clicks based on their query string parameters

See each feature's documentation for more detail.

Campaign walkthrough

There are four types of campaigns:

Ad network campaigns

Use for: Paid user acquisition on an ad network that supports Tapstream

Ad network campaigns automatically send campaign performance information back to the ad network, allowing you to advertise with publishers on a CPI basis without installing the ad network's SDK.

First, navigate to the Campaigns tab, and press Create Campaign. Then, select the campaign type Ad Network.

Fill in the following fields:

  • Ad Network: Choose the ad network that will be running this campaign for you.
  • In-app event: Depending on the ad network, you may be prompted to select one of your in-app events. Choose the in-app event that matches the description in the prompt. For instance, if you're prompted to choose your app's Open event, you might select ios-myapp-open.
  • Ad network-specific fields: Again, depending on the ad network, you may be prompted to complete one or more fields. These fields are usually used for the ad network to identify you, and might include an ad network-specific advertiser ID, an application ID, or a campaign ID. Ask your ad network representative or your Tapstream support contact if you're not sure.
  • Your App's URL: Enter a destination for this campaign link. This should be the advertiser app's App Store or Google Play listing.
  • Campaign name: If you like, you can manually enter a name for this campaign.
  • Campaign URL: This will be the public-facing URL of this campaign. You can customize it if you wish.

Finally, save your campaign by pressing Create Campaign. You'll be taken to a reporting page for your campaign, and presented with a campaign destination URL. Copy the entire campaign destination URL, including its query string, and provide it to your ad network interface or account manager. This is the URL that you must use as your click URL on the campaign you're creating with the ad network.

Cross promotion campaigns

Use for: Cross-promoting between two apps you own that share a Tapstream account

Cross promotion links enable you to track the effectiveness of campaigns that promote one of your apps to the users of another one of your apps.

Use a cross promo campaign link when your campaign meets all of the following conditions:

  • You're showing an ad in an app that you own
  • The ad is promoting another app that you own
  • You use the same Tapstream account for both apps

To set up a cross promotion campaign, navigate to the Campaigns tab, and press Create Campaign. Then, select the campaign type Cross Promotion.

Fill in the following fields.

  • Package Name: Enter the package name of the advertiser app (that is, the app being promoted). The package name should look something like com.mycompany.myapp.
  • Your App's URL: Enter a destination for this campaign link. This should be the advertiser app's App Store or Google Play listing.
  • Campaign name: If you like, you can manually enter a name for this campaign.
  • Campaign URL: This will be the public-facing URL of this campaign. You can customize it if you wish.

Save your cross promo campaign by pressing Create campaign.

You'll now be taken to a reporting page for your campaign. Use the campaign destination URL shown at the top of this page as the destination URL for your cross promotion campaign.

Custom campaigns

Use for: Email campaigns, social promotions, and everything else

Custom campaign links are general-purpose; use them anywhere you want to measure user cohorts.

To create a custom campaign, navigate to the Campaigns tab, and press Create Campaign. Then, select the campaign type Custom.

Fill in the following fields:

  • Your App's URL: Enter a destination for this campaign link. This should be the advertiser app's App Store or Google Play listing.
  • Campaign name: If you like, you can manually enter a name for this campaign.
  • Campaign URL: This will be the public-facing URL of this campaign. You can customize it if you wish.

Once you've saved the campaign, you'll be taken to its report page.

App Invite campaigns

Use for: Rewarding users for sharing your app with their friends

App Invite campaigns allow you to reward your users for sharing your app with their friends.

You'll need to configure your app for App Invites before proceeding.

First, navigate to the Campaigns tab, and press Create Campaign. Then, select the campaign type Word of Mouth.

Fill in the following fields:

Campaign information

  • Your App's URL: Enter a destination for this campaign link. This should be the advertiser app's App Store or Google Play listing.
  • Campaign name: If you like, you can manually enter a name for this campaign.
  • Campaign URL: This will be the public-facing URL of this campaign. You can customize it if you wish.

Targeting

  • Insertion Point: This is the label for a point in your app that you'd like to insert an offer. Refer to the App Invite SDK docs for details.

Note that you can only have one enabled App Invite campaign per insertion point.

  • Bundle: The bundle or package ID that this offer applies to. This is optional - only fill it in if you have other Tapstream-enabled apps that you want to exclude.
  • Rate Limit: The amount of time that must have elapsed between the last time the offer was shown and now (in seconds).
  • Minimum Age: The minimum age, in seconds, that sessions must be in order to be eligible to see this offer.

Reward

  • Reward Identifier (SKU): This is the SKU that will be delivered as a reward, whenever your users become eligible.
  • Minimum Events for Reward: The number of events that a user must have caused in order to be eligible for a reward.

Offer

  • Layout: Just a switcher to help you visualize how the offer will look in both orientations.
  • Text, color, and image elements: These allow you to define the content and appearance of your offer. Use them wisely!

Share Window Content

  • Message to Share: This is the message that App Invites will prepopulate in to the user's sharing cards.

Save the campaign by pressing Create Campaign.

Once you've saved the campaign, you'll be taken to its report page. You don't need to do anything further - this offer will now be served to any users triggering the campaign's Insertion Point in your app.