Vungle campaign configuration

At a glance: Vungle, an AppsFlyer integrated partner, has an in-app video advertising platform for performance marketers. In addition to click-based mobile attribution, Vungle offers cost and view-through attribution that can be recorded with AppsFlyer.

Vungle integration in AppsFlyer

To configure the partner integration:

  1. Go to Configuration Integrated Partner.
  2. In the list of integrated partners, search for Vungle. 

  3. Click Vungle to open the configuration page.
  4. Set tabs as needed:
    • [Mandatory] Integration: Configure the integration (connection) between Vungle and AppsFlyer.
    • Attribution link: Generate attribution links to be used with ads on Vungle.
    • Cost is not active for this partner.
    • Ad revenue is not active for this partner.
    • Permissions: Grant permissions to Vungle to view and manage your data in AppsFlyer.
      Note: You can grant permissions without the need to complete the Integration tab.

See a detailed description of the Partner Configuration Window Header.

The following sections explain how to configure each tab.

Integration

Activate partners

Connect to Vungle by activating and setting parameters in the integration tab. Vungle must supply its unique network ID, app_id; this is necessary in order to connect with AppsFlyer.

 Note

Vungle is an ALL-installs network; they want postbacks for all new app installs, from all sources (including organic). To send all install postbacks to Vungle, select Events attributed to any partner.

To configure the integration:

  1. Enable Activate partner. See more information about partner activation.
  2. Under General settings enable/disable View-through attribution:
    • [Default] Enable: Activate to attribute view-through installs to Vungle. The length of the lookback window is configured in the Attribution link tab.
    • Disable: View-through installs from the partner are not attributed.
  3. Default postbacks: AppsFlyer sends postbacks to Vungle after user installs and re-engagements. Use this section to define users who are the source of these postbacks. Under Sending Option,

    • Select Only events attributed to this partner for events attributed to Vungle users.

    • Select Events attributed to any partner or organic to make your entire user available for reporting to Vungle.

  4. In-app events settings: To send postbacks to Vungle, map in-app event IDs to Vungle's. Configure the parameters as follows:
    • Enter the Vungle app_id.
    • Enable In-app events postbacks.
    • Select a Sending Option.
    • Click Add event to add an SDK event to the list. Complete the parameters as described in the following table.
Parameter Name Description
SDK event name

Event name received by AppsFlyer from:

  • SDK integrated in the app
  • Server-to-server events

Tip: If a needed event isn't in the list, perform a non-organic installation on a device, then check again.

Partner event identifier

Unique event name or ID as defined by Vungle.

Get from Vungleevent ID corresponding to your SDK event and insert it in the text field.

Send revenue

[Default] Not enabled: AppsFlyer sends all the in-app parameters to Vungle, except for the revenue parameter (af_revenue).

Enabled: AppsFlyer sends all the in-app parameters including, when available, the revenue amount.

Attribution link

Generate click and impression attribution links to be used by Vungle for campaigns, ad sets, or even single ads. 
  • Parameters let you perform drill-down analyses.
  • Existing parameters can be edited. 
Attribution link type Link activation Lookback window
Click
A lead clicks on an ad served by Vungle

The click-through lookback window is the maximum time from click to install.

Vungle gets an attribution if a lead clicks and installs an app before the lookback window expires.

Parameter name: af_click_lookback
Default value: 7 days
Range: 1-23 hours or 1-30 days

See click lookback window.

Impression A lead views an ad (for at least 1 second) served by Vungle

The view-through lookback window is the maximum time from impression to install.

Vungle gets an attribution if a lead views (impression) an app and then installs before the lookback window expires. This applies if there are no other relevant ad clicks.

Parameter name: af_viewthrough_lookback
Default value: 1 day
Range: 1-23 hours or 1-7 days

See view-through attribution.

Learn more about link structure and parameters.

Typical link parameters:

Parameter Name Description
Campaign c

Name of the campaign.

Add it to compare between campaigns running with Vungle.

Ad set af_adset

Name of the ad set.

Use to differentiate between ad sets within Vungle campaigns.

Ad name af_ad

Name of the specific ad.

Use to differentiate between ad set creatives found within Vungle campaigns.

Site ID

Sub Site ID

af_siteid
af_sub_siteid

Publisher ID used to attribute installs to specific publishers.

Recommended practice! If there are many publishers,

Subscriber parameters af_sub1 up to af_sub5

Use to insert values:

  • Parameters are parsed and included in the raw data report.
  • Use them to perform data aggregation or filtering.

To generate the attribution links:

  1. Select a name from the Parameter name drop-down list, then set the parameter value.
  2. To add more parameters, click Add parameter and repeat the previous step.
  3. Set the duration of the click-through lookback window.
  4. Set the duration of the view-through lookback window.
  5. Copy the click and impression attribution links to use in your Vungle campaigns. 
    Note: AppsFlyer does not save partner links.

Cost

AppsFlyer gets cost details by API.

Geo Media source Campaign Adset Ad Site ID
Yes - Yes - Yes Yes
API dimensions supported

Before you begin:

  • In your Vungle dashboard get your API credentials. You need:
    • Reporting API key
    • Reporting API ID

To enable the cost API:

  1. In the Cost tab, enable Get Cost Data.
  2. Complete the credential fields.
  3. Click Save Cost.
  4. Click Test Connection 
    • The message API connection verified displays.
    •  The API is active. AppsFlyer collects data from the partner 6 times a day, on average once every four hours. 

Ad revenue

This section is only relevant for publishers who display Vungle ads to users. It is important to measure the engagement of users acquired from different sources to find the most profitable sources.

  1. Go to the Ad Revenue tab.
  2. Enable Get Dd Revenue Data.
  3. Enter the Vungle App ID.
  4. Enter the Secret Key.
    • This is an API key used to pull in-app advertising revenue data from Vungle.
    • See Vungle's info about retrieving the API key.
  5. Select an Event Source.
    • An existing in-app event associated with the ad revenue action.
  6. Select an Ad Revenue Event.
    • Field is auto-populated with the ad revenue event.
    • Shows calculated revenue.
  7. Click Save Ad Revenue.
  8. Click Test connection
  9. Do one of the following:
    1. If the message API connection verified displays, you have successfully completed the procedure. AppsFlyer collects the data from the partner once a day.
    2. If any other message displays, take corrective action in accordance with the status message.

Learn more about ad revenue/monetization tracking.

Permissions

You can give Vungle permission to view information or configure changes in the integration. The type of permission varies according to the business relationship (ad network/ad agency) you have with Vungle .

Note: It is possible to give Vungle permissions even if there is no active integration with them.

Ad network permissions

To enable ad-network permissions:

  1. Enable Ad network permissions
  2. Give Vungle team members access to one or more of the following: 
Allow to configure integration Set up the integration tab (except in-app event postbacks).
Allow to configure in-app event postbacks Set up in-app event postbacks that are mapped to integration tab.
Allow access to your retention report Partner's retention data
Allow access to your aggregate loyal users data Partner's loyal-user data
Allow access to your aggregate in-app events data  Partner's in-app events data
Allow access to your aggregate revenue data Revenue data attributed to the partner.
Allow spend ingestion  
Allow access to your Protect360 dashboard [If enabled] Partner's Protect360 data

Learn more about giving ad network permissions.

Agency permissions

You can allow Vungle to configure your app as an agency. 

To enable agency permissions:

  1. Enable Agency permissions
  2. Give Vungle agency access to one or more of the following:
Allow access to your Protect360 dashboard [If enabled for your account] Agency's Protect360 data
Allow access to your retention and cohort reports  Agency's retention and cohort data

Allow access to aggregate organic data

Agency's aggregate organic data
Allow to configure in-app event postbacks Set up in-app event postbacks that are mapped to the integration tab.

Learn more about granting agency permissions

Was this article helpful?