Aura by ironSource campaign configuration

At a glance: Aura by ironSource, an AppsFlyer integrated partner, is a platform that allows advertisers to connect with users when they set up a new device.

Aura integration in AppsFlyer

To configure the partner integration:

  1. Go to Configuration > Integrated Partners.
  2. In the list of Integrated partners, search for Aura.
  3. Click Aura ironSource to open the configuration page.
  4. Set tabs as needed:
    • [Mandatory] Integration: Configure the integration (connection) between Aura and AppsFlyer.
    • Attribution link: Generate attribution links to be used with ads on Aura.
    • Cost: Aura ironSource automatically sends encrypted CPI cost data on the attribution link for all installs. No extra configuration is needed.
    • Ad revenue is not active for this partner.
    • Permissions: You can configure the aforementioned parameters yourself or, in this tab, give Aura permission to set them and view your data.

The following sections explain how to configure each tab.

Integration

Connect to Aura by activating and setting parameters in the Integration tab.

To configure the integration:
  1. Enable Activate partner.
  2. Under General settings enable/disable View-through attribution:
    • [Default] Enable: Activate to attribute view-through installs to Aura. 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 the following postbacks to Aura:
    • Installs: Postbacks are sent every time a user installs the app. Choose if you want to send postbacks for users attributed to Aura or all users, including organic installs.
    • Rejected installs: With Protect360, postbacks are sent when an install is rejected due to fraud. Only users attributed to Aura are reported.
  4. In-app events settings: To send postbacks, map your in-app event IDs to Aura's in-app IDs. Configure the parameters as follows:
    • Enable In-app events postbacks.
    • Sending option: Select if you want to send Only events attributed to this partner or Events attributed to any partners, including organic installs.
    • Click Add event to add an SDK event to the list. Complete the parameters described in the following table.
Setting 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 Aura.

Choose an event name (from the drop-down list) that most closely matches the event.

Send revenue

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

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

Attribution link generation

The following table defines click and impression attribution links (for use by Aura), as well as the relevance of lookback windows. 
Attribution link type Link activation Lookback window
Click
A lead clicks on an ad served by Aura

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

Aura 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

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

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

Aura 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

Learn more about link structure and parameters.

Typical link parameters

Parameter Parameter name Description
Campaign c Name of the campaign
Ad set af_adset Name of the ad set. Use to differentiate between ad sets within a campaign
Ad name af_ad Name of a specific ad. Use to differentiate between creatives within an ad set
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 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 Aura campaigns.
    Note! AppsFlyer does not save partner links.

Cost

AppsFlyer gets cost details by API.

Geo Media source Campaign Adset Ad Other
Yes - Yes - - -
API dimensions supported

Before you begin:

  • In your Aura dashboard, get your Aura authentication token.
  • Depending on the app platform you need:
    • iOS: The iOS bundle name from the Apple developer console
    • Android: Android package name

To enable Aura 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.

For the full list of partners supporting cost data go here.

Ad revenue

Ad revenue attribution is not available for this partner.

Permissions

You can give Aura 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 Aura.

Note! It is possible to give Aura 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 Aura team members access to one or more of the following:
    • Allow to configure integration:  Permit the partner to set up the integration tab (except in-app event postbacks).
    • Allow to configure in-app event postbacks: Permit the partner to map in-app event postbacks to itself on the integration tab.
    • Allow access to your retention report: Only permit access to the partner's own retention data.
    • Allow access to your aggregate loyal user data: Only permit access to the partner's own loyal user data.
    • Allow access to your aggregate in-app events data: Only permit access to the partner's own in-app events data.
    • Allow access to your aggregate revenue data: Only permit access to the revenue data attributed to the partner.
    • Allow spend ingestion: Permit the partner to upload ad spend data for this app.
    • Allow access to your Protect360 dashboard: Only to the partner's own Protect360 data if the feature is enabled for the advertiser.
Was this article helpful?