Campaign Buckets
  • 12 Jul 2022
  • 4 Minutes to read
  • Dark
    Light

Campaign Buckets

  • Dark
    Light

What is Tenjin's Campaign Bucketing Tool?

Tenjin's Campaign Bucketing Tool syncs data from third party attribution providers and ad networks to calculate ROI within its dashboards and DataVault. Customers can use this tool on their own to "clean" their siloed datasets.


Campaign Bucketing Tool Overview

Show more

To illustrate what the Bucketing Tool solves, Tenjin can be configured to receive campaign data from ad networks and third party attribution providers. The campaign data Tenjin receives has properties that make each campaign seem unique, even though they represent the same campaign.

Tying these "different" campaigns together is critical to report on ROI from a specific channel.

Below is an example of how an ad network and attribution provider might see things differently in their reporting. These three campaigns are in fact “identical”, but both ad network and attribution provider see them as separate campaigns.

Campaign reported_installs tracked_installs spend LTV ROI
US - WS 20 $30 -100%
US - WordSearch 10 $100 -100%
WordSearch - US 32 $30

Using the Tenjin Campaign Bucketing tool, Tenjin clients can "sync" both siloed ad network and attribution campaign data sets together as shown in the result below.

After campaign buckets

Campaign reported_installs tracked_installs spend LTV ROI
US - WordSearch 30 32 $130 $30 -70%

This data is now "cleaned" so that everything is tied to a single campaign ID and can be accessed through Tenjin's various APIs and also DataVault.

image.png


Process

Show more
  1. We pull a list of campaigns from ad-network API and create those campaigns automatically on Tenjin.

  2. We receive real-time attribution callbacks from 3rd party attribution providers and create a network as a custom channel. The campaigns under the channel are automatically created for the attribution provider. To know how to set up a real-time callback, please refer to the steps here.

  3. In the CONFIGURE -> Channels page you will see custom channels from 3rd party attribution providers show up as below. This channel name is imported from the 3rd party attribution, so it could be any name you choose on their dashboards. Tenjin will merge those custom channels into the proper channels you initially created on the Tenjin dashboard through the ad network APIs.

    image.png

  4. Once 3rd party attribution channels are merged with Ad Network API channels, you can bucket the campaigns. Go to the DIAGNOSE -> Campaign Buckets page to do that. You'll see a list of campaigns that need to be bucketed for each app and network.

    image.png

    image.png

    In the example above, you can see those campaigns. Click the blue arrow to edit the campaign bucket.

    • 2 Reported campaigns and 1 tracked campaign for Word Search iOS, Facebook
    • 2 Reported campaigns and 1 tracked campaign for Word Search Android, Facebook
    • 4 Reported campaigns and 3 tracked campaigns for Word Search iOS, Pinterest

On the top, you can filter the campaigns by app and channel and select lookback days(from 1 to 30). We show all the tracked and reported installs within the lookback period. This is useful to gauge how similar the attribution and ad network campaigns are.
image.png

In the middle, you can see a list of raw campaigns that need to be bucketed. If the campaign comes from an ad-network's reporting API, we show remote_campaign_id, reported_installs, and spend. If the campaign comes from a 3rd party attribution tool, we show only tracked_installs.

Then, you can check each campaign you want to bucket, and click Unify Campaigns. In the example below, "Word Search iOS - US" campaign has 16 reported_isntalls and 16 tracked_installs, so you can easily see those are the same campaign. You can also type the Unified Campaign Name manually, if you want to change the name that appears on the dashboard.
image.png

Once you bucket the campaigns, you can see the bucketed campaign under Unified Campaigns.

  • You can bucket "unified campaign" and "raw campaigns" together
  • If you want to un-bucket the unified campaigns, click the red trash button on the right side of each unified campaign.

image.png


How long does it take for data to appear after bucketing?

Show more

This depends on the number of campaigns you are currently running. Once all campaigns are bucketed, DataVault will be updated in 3 hours. Dashboard data for the last 45 days will be updated within a day.


Networks which don’t require campaign buckets

Show more

Some networks have a definite campaign structure, so campaign buckets happen automatically. This is a list of networks which don’t require campaign buckets manually.

  • Adjust
    • Facebook
    • Twitter
    • Yahoo
    • Snapchat
    • Apple Search
    • Google UAC
    • Chartboost
  • AppsFlyer
    • Facebook
    • Apple Search
    • Snapchat
  • Kochava
    • Facebook

Tenjin campaign ID

Show more

If you don’t want to handle campaign buckets manually, follow the instructions below. You don't need to do this if you are using the Campaign Buckets tool.

  1. Add channels on Tenjin dashboard. Tenjin will pull a list of campaigns you are currently running with your ad network providers.

  2. For each campaign tracking URL you generate in your attribution service, add that attribution services' custom parameter(list below) to the tracking URL with the value of that campaign’s tenjin_campaign_id.

You can find your campaign’s tenjin_campaign_id in the dashboard under the Campaigns tab for that campaign.

image.png

Here is the list of custom parameters. Some attribution providers have multiple parameters, so you can pick any one of them.

  • Adjust
    • label
  • AppsFlyer
    • af_sub1, af_sub2, af_sub3, af_sub4, af_sub5
  • TUNE
    • publisher_sub1, publisher_sub2, publisher_sub3, publisher_sub4, publisher_sub5
  • Kochava
    • kc_sub
  • Apsalar/Singular
    • ap_sub

For example, if your adjust tracking link is as shown below, and your Tenjin camapign ID for a campaign is djlCLxU69D41CI4WIu4Ghq,

https://app.adjust.com/aaaaaa?campaign={CAMPAIGN_NAME}&adgroup={APP_ID}&creative={AD_NAME}&idfa={IDFA}&country={CC}&gps_adid={IDFA}&device_type={DEVICE_TYPE}&tracker_limit=100000&applovin_click_id={DID}&android_id_lower_sha1={HADID}

Updated tracking url will be:

https://app.adjust.com/aaaaaa?campaign={CAMPAIGN_NAME}&adgroup={APP_ID}&creative={AD_NAME}&idfa={IDFA}&country={CC}&gps_adid={IDFA}&device_type={DEVICE_TYPE}&tracker_limit=100000&applovin_click_id={DID}&android_id_lower_sha1={HADID}&label=djlCLxU69D41CI4WIu4Ghq
  1. Set up real-time callbacks on 3rd party attribution dashboard as described here.


Was this article helpful?

What's Next