Overview

This document provides a detailed overview of integrating AppsFlyer with Netcore Cloud's Customer Engagement platform. By utilizing AppsFlyer's comprehensive data collection and attribution capabilities, Netcore Cloud seeks to enhance its personalized engagement solutions and deliver superior customer experiences.

This integration will enable Netcore CE to receive install source attribution event data directly from AppsFlyer.

📘

Prerequisites

1. Both the AppsFlyer SDK and Netcore SDK must be integrated into the application.
2. This integration supports iOS and Android apps. Follow platform-specific code snippets as needed.

Procedure to get the app_id:

To get the app_id from the AppsFlyer console, follow these steps:

1. Log in to AppsFlyer: Access your AppsFlyer account by logging in to the console.
2. Navigate to the Dashboard:
   1. Once logged in, you'll land on the dashboard.
   2. If you have multiple apps, choose the specific app for which you want the app_id.
3. Locate the app_id:
   1. After selecting the app, you'll be taken to the app's dashboard.
   2. The app_id is usually found in the URL of your browser when you're viewing the app's
      dashboard. It might look something like this:
      https://www.appsflyer.com/dashboard/app/APP_ID/overview.
   3. The APP_ID in the URL is your app_id.
4. Check App Settings:
   1. If the app_id is not clear from the URL, go to the app settings by clicking on the gear icon or the settings option within the app's dashboard.
   2. In the settings page, you should see details about your app, including the app_id.
   3. The app_id is a unique identifier used by AppsFlyer to distinguish between different applications within your account.

Procedure to get the authentication token

To get the Authorization token (API token) in AppsFlyer, follow these steps:

1. Log in to AppsFlyer: Access your AppsFlyer account by logging into the console.
2. Navigate to the Account Settings:
   1. Click on your account name or profile icon in the top right corner.
   2. From the dropdown menu, select 'Account' or 'Account Settings'.
3. Find the API Token:
   1. In the account settings, look for a section labeled 'API Tokens' or 'API Access'.
   2. The API token (Authorization token) for your account will be listed here.
4. Copy the API Token:
   1. You can copy the token directly from the interface for use in API calls or integrations
5. API Tokens for Specific Apps (Optional):
   1. If you're working with multiple apps and need an API token for a specific app, you may need to navigate to that app's specific settings and locate the token there. However, the main API token for your account typically works across all apps within your account.

After obtaining the appI-d and auth token, there are 2 ways that you can set the “X-API-KEY” that will be used as the authentication token while communicating with Netcore.

Method 1

You may go to the command prompt and execute this CURL command. Remember to replace <app_id> and <YOUR_AUTH_TOKEN> as determined from the above steps.

curl --request PUT \
--url https://hq1.appsflyer.com/api/pushapi/v1.0/tokens/app/<app_id> \
--header 'accept: application/json' \
--header 'authorization: Bearer <YOUR_AUTH_TOKEN>' \
--header 'content-type: application/json' \
--data '
{
"token_name": "X-API-KEY",
"token": "qlkh1lJuhS1fN0S629JuAtdnkUvlyq"
}
'

📘

Note

Keep the X-API-KEY as-is because this is the token that belongs to Netcore DEV
system and we expect this to be part of every event received from AppsFlyer.

Method 2:

Go to https://dev.appsflyer.com/hc/reference/put_tokens-app-app-id

2. Fill in the Bearer token.
   3. Under Body Params:
   1. Paste the token as fetched from the CE Panel.
   2. Click on OPTION 2 and type in "X-API-KEY"

You will see the CURL command getting constructed on the right side panel - Click on “Try it”.

Enabling AppsFlyer PUSH API to Netcore

1. Go to Report > API Access Scroll down to the Push API section.
2. Click Add Endpoint.
3. Select an HTTP method: POST
4. Enter the Endpoint URL [Regional End Point] as provided on the panel. If you get the message this URL is not safe, contact AppsFlyer support.
5. Select event type "install"
6. Select the fields to populate the Push API message. Please click on “Select all”.
7. Click Save.

The Push API is now active. Conversion data is sent to the endpoint.