Vungle campaign configuration

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.

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.

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 served by Vungle. Read more about how Vungle defines clicks and views.	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, Limit the number of site IDs in use. Use the subsite ID parameter to avoid exceeding the site ID limit.
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.

AppsFlyer gets cost details by API. See the ad network cost integration table for full details on the supported dimensions, metrics, and features. Note: Cost data requires an Xpend subscription.

To enable the cost API:

• Follow these integration instructions. 

View your cost API status and the last time AppsFlyer managed to pull matching cost data in either the cost (and ad revenue) integration status dashboard, or in the individual ad network dashboard.

This section is relevant if you are acting as a publisher, displaying ads of the partner to your users. As such, you would certainly like to measure the engagement of your users acquired from different sources, to find the most profitable sources for you.

To enable the ad revenue API:

• Follow these integration instructions. 

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.