Epic integration with AppsFlyer

For:
Last update:
At a glance: Integrate your Epic game with AppsFlyer to receive attribution and event data for your Epic campaigns. The Epic integration supports attribution and in-app event recording for Epic games (in other words, attribution and recording on a user's device).

About Epic game attribution

Gams running on Epic can integrate with AppsFlyer via API (both S2S and client-side) to receive attribution data and performance measurements about which sources and campaigns drive app open and in-app events. Marketers rely on these insights to measure and optimize marketing activities.

Example attribution flow

The following is an example flow that highlights the most important steps in a user journey from ad engagement to attribution. It includes the AppsFlyer-recommended cross-platform landing page. Note: While we recommend using the cross-platform landing page, you can also use direct attribution links.

Epic_journey.jpg

  1. Marketing touchpoint: Customers interact with your brand through online or offline marketing touchpoints. These can include, email and newsletters, social media, mobile web, and more.
  2. Game landing page:  A game landing page directs customers to your Epic game page. This step is important for collecting UTM and other URL parameters to attribute customers from the click/install to the original media sources or to your owned media sources.
    The landing page is also useful because it provides links to the various platforms your game supports. For example, you can also have links to your Xbox, Microsoft store, and Steam page on your landing page.
  3. Epic app page: This is your Epic storefront page that hosts your Epic game for customers to download.
  4. Game install: The user installs the game, triggering attribution and the recording of in-app events and sessions.

Integration procedures

The following table lists the tasks required to integrate your Epic game with AppsFlyer.∑

Task Actions Who's involved

App setup

 Marketer

API integration with your app (via S2S or client-side)

There are two methods of integration you can use: S2S and client-side.

For the S2S method:

Integrate the AppsFlyer Epic API into your app with commands to report the following events to AppsFlyer.

  • First opens
  • In-app events
  • Sessions

Note:

  • First app opens must be reported before in-app events and sessions.
  • For the device_ids parameter, select the type custom or epicid.
  • Send events using the API. Tell your developer which events to send.
  • To report owned media engagements, integrate the impression engagement API.

For the client-side method, there are three versions: native C++, Unreal, and Unity.

Note:

If you have an existing user base and therefore want the first session to be considered a session and not an install, the developer can use the method skipFirst=true.

 App developer

Cross-platform landing page setup

Recommended: A cross-platform landing page running the AppsFlyer Smart Script lets you perform web-to-app attribution. It's most recommended when your campaign promotes an app that's also available on other platforms, like Epic and Steam.

Learn about cross-platform landing pages

Learn how to set up a cross-platform landing page

Note:

For Epic, the following parameters are required:

  • platform
    epic
  • app_id
    The app ID of the game page on the Epic store.

    You can find your unique game ID on your Epic developer console. For example,

    https://store.epicgames.com/en-us/p/YOUR-GAME-ID
  • media_source

The following parameters are not required but recommended:

  • campaign
  • ad
  • ad_set
  • storefront_redirect_url
    The full URL of your Epic storefront for your app including your app_id.
    For example, https://store.epicgames.com/en-us/p/12345678/

Marketer (may require developer assistance) 

Link setup

If you don't use a cross-platform landing page, you can create direct attribution links to place behind ads.

Learn how to create direct attribution links

Marketer
Report setup/view data Learn about data availability in dashboards and reports Mareketer/Data engineer 

Removing AppsFlyer data when uninstalling the app

To remove all AppsFlyer SDK data when uninstalling the app, please ask your developer to perform the steps specified here.

Traits and limitations

Trait Remarks

Retargeting

Not currently supported

Cost data

 Cost data must be sent via Ad Spend Ingestion using the upload file by email method.

See also