Tapstream campaign creation

Tapstream campaigns are defined by their campaign links (occasionally called 'shortlinks', 'tracking URLs' or 'click URLs'). These URLs give you data on the number of clicks, conversions, revenue, and in-app events that each of your marketing channels generate.

Visitors passing through campaign links are redirected to a destination you choose (usually the App Store). Then, when that visitor starts using your app, Tapstream identifies the app user as the same visitor who passed through the campaign link. Now, you know exactly how that user found you.

Campaign links are used for tracking the performance of ad networks, email campaigns, and social media posts - anywhere that you can provide a link for users to click on.

Use as many campaign links as you like. Each of your ad campaigns should have its own, unique link - don't re-use links. You can have more than one campaign link per ad network or channel, and you should use a new campaign link whenever you change anything and for every new campaign.

There are four types of campaigns:

Read on for an explanation of each campaign type.

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.

You do not need to perform any additional tasks, like setting up postbacks or tracking - this is all done for you automatically when you create the ad network campaign.

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 track user acquisition.

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. From here, grab the campaign destination URL, and place it wherever you want to track user acquisition. That's it!

Word of Mouth campaigns

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

Word of Mouth campaigns allow you to reward your users for sharing your app with their friends.

You'll need to configure your app for Word of Mouth 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 Word of Mouth SDK docs for details.

Note that you can only have one enabled Word of Mouth 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 Installs for Reward: The number of installs 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 Word of Mouth 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.

Advanced URL handling

Tapstream campaign URLs have several special features:

  • Deferred deep links to send users to deep destinations within your app, whether they already have it or not
  • 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.