Skip to main content

How to integrate with Appsflyer

  • Updated

Welcome to our guide on integrating Appsflyer to NewsBreak! Follow these simple steps to successfully track and exchange information between servers. 

 

1. Head to AppsFlyer and search the package name in the [APP ID] field and enter the subpage.

 

2. Go to [Configuration] > Integrated Partners. Search “NewsBreak” as the integrated partner and click enter.

3. Select [Permissions] and turn on:

  • Ad network permissions

  • Configure in-app event postbacks

  • Access retention report

  • Access aggregate revenue data

  • Access aggregate in-app events data

 

4. To create NewsBreak links, select [Integrated Partners] > "NewsBreak" > and slide the [Activate partner] toggle to ON under the Integration tab.

 

5. Now, click "Attribution Link" and grab the [Click-through attribution link] and [View-through Attribution link]. 

Both links need to be enabled in the NewsBreak offer for tracking purposes.

 

💡If a Postback fails, how can you verify whether the MMP received the click and install for a specific device ID? --> Go to [Raw Data Export] to check the log.

 

 

Advanced Privacy Settings for iOS Offers

By default, AppsFlyer will not provide device-level attribution data for devices operating on iOS 14.5+. If access to IDFA is not granted, the data learning process of NewsBreak’s algorithm and the performance of its ad campaigns will be severely impacted. To protect your UA performance, please authorize NewsBreak access to IDFA as follows:

 

6. Select [Integration] and toggle OFF the [Advanced Privacy] for NewsBreak.

 

 

7. Enable view-through attribution by heading to "Configuration" on the left-hand side of your screen.

  • Then, click [Integrated Partners] and toggle ON the [Enable view-through attribution] for NewsBreak.

  • Make sure to click "save integration" after you have finished the setup.

💡Only after the view-through attribution is enabled will the view-through installs be sent to NewsBreak.

8. Go to the [App Settings] on the left side of your dashboard and turn the toggle ON for "Enable view-through attribution via probabilistic modeling."

 

9. Set Up Default and In App Event Postbacks:

  • For default Postbacks, select All media sources, including organic from the drop-down menu for each event. This option lets you share with NewsBreak all postback data, which includes NewsBreak-attributed, unattributed, and organic data.

💡Important: Unattributed postbacks don't include any of your media source information.

 

 

10. Be sure to toggle on In-app event postbacks. You must select an option for In-app event window to specify for how long in-app event postbacks are sent to NewsBreak following install, reattribution or re-engagement.

For In-app event windows, we recommend choosing "Lifetime" to ensure that in-app event postbacks are always sent to NewsBreak for optimizing your campaigns. 

 

 

11. Select "Add manually" to send the relevant events, and choose "All media sources, including organic for users from, including Value & revenue."

*Important: It is highly recommended to send more data on in-app events, which can help our algorithm model accurate more data by assessing user value through users' in-app behavior. Recommended events to postback are af_app_opened,  af_purchase,  af_ad_revenue or purchase related events, or game level, etc..

Below is an example of the mapping between [Original Event Name] and [NewsBreak Standard Event Name]. 

Original Event Meaning AppsFlyer Standard Event Name NewsBreak Standard Event Name
A user views an advertisement displayed in your app af_ad_revenue app_in_app_ad_impr
In-app purchase of the app af_purchase app_purchase
User opens the app af_app_opened app_launch_app
Other key action events Custom events on AppsFlyer

NewsBreak's other events

 

 

12. Head back to NewsBreak's Ad Manager > go to Event Management > App Events.

13. Now please input the corresponding product's store url, conversion event, click tracking url, impression tracking url, click ‘Save’, and complete the setup.

All done! Here is an overview of our app event names and what they entail: 

 

NewsBreak Standard Event Name Description
app_in_app_ad_impr A user views an advertisement displayed in your app.
app_purchase A user finishes the payment process in your app.
app_launch_app A user opens your app.
app_checkout A user is ready to check out an order in your app.
app_add_to_cart A user adds an item to a shopping cart in your app.
app_add_to_wishlist A user adds an item to their favorites or wishlist in your app.
app_add_payment_info A user adds their payment information, such as their address or phone number, in your app.
app_view_content A user views important content, such as a product description, in your app.
app_start_trial A user starts a trial of the services you provide in your app.
app_spend_credits A user spends credits, such as in-app currency, in your app.
app_achieve_level A user reaches a certain level that you have defined in your game.
app_create_group A user creates a group or team in your game.
app_create_role A user creates a role or character in your game.
app_join_group A user joins a group or team in your game.
app_unlock_achievement A user unlocks a certain achievement that you have defined in your app.
app_in_app_ad_click A user clicks on an advertisement displayed in your app.
app_loan_disbursal A user successfully receives a loan in your app.
app_loan_application A user applies for a loan in your app.
app_registration A user registers in your app.
app_loan_credit A user receives approval for a loan in your app.
app_subscribe A user subscribes to a channel or service in your app.
app_complete_tutorial A user completes a tutorial in your app.
app_rate A user rates something in your app. For example, reviewing a restaurant.
app_login A user logs into your app.
app_generate_lead

A user leaves valuable contact information, such as a phone number or email, in your app.

 
app_search A user searches for information, such as the name of a product, in your app.

 



Related articles