# AppLovin Event API Quick Start Guide

{% hint style="warning" %}
The AppLovin Event API destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **AppLovin** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

## Getting Started

This guide enables you to fully enable the AppLovin Event API destination for your site.  For simplicity the event used for demonstration purposes is the generic `Page View` event.  For more complex events see[ our additional documentation](https://documentation.freshpaint.io/readme/setting-up-your-events).  Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow[ this guide](https://documentation.freshpaint.io/readme/guides/quickstart/installing-freshpaint).&#x20;

1. Find/create your Axon **Events Key** for AppLovin
2. Enable the Freshpaint AppLovin destination
   * If in HIPAA mode enable the required fields
3. Confirm and validate events

### Find your Axon Events Key for AppLovin

{% hint style="success" %}
AppLovin uses the Axon Ads Manager. We'll generally refer to them as AppLovin in this guide, but some links will correctly link out to ads.axon.ai or their documentation.
{% endhint %}

1. Log into your [Axon Ads Manager](https://ads.axon.ai/).
2. Select **Events** in the left-hand menu.
3. Copy the ID at the top of the page.&#x20;

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FYQGO6laUw1EOsC5CCxdj%2FScreenshot%202025-11-04%20at%205.04.50%E2%80%AFPM.png?alt=media&#x26;token=4a2b4076-a043-48f4-b78a-c69cfcf70b0a" alt=""><figcaption></figcaption></figure>

### Enable the Freshpaint AppLovin destination

1. Navigate to the [Freshpaint Integrations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **AppLovin** integration.
3. Select **Configure** to paste your **Event Key** from the above step.
4. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find all properties that the Freshpaint AppLovin integration supports here: [applovin-event-api-reference](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/applovin-event-api-early-access/applovin-event-api-reference "mention").
5. Enable AppLovin.

Once you've followed the steps above you can start sending events to the AppLovin Event API.&#x20;

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FJ6D31kqMfaZf6XPSos2y%2Fimage.png?alt=media&#x26;token=aa9119e1-9841-4650-af41-1932c2f9a8b7" alt=""><figcaption></figcaption></figure>

## Confirm and validate events

### Confirm and Validate Events in Freshpaint

1. Navigate to your site and visit a page that should trigger your event
2. Trigger your event (Our demonstration event is a `page_view`).
3. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
4. Select **AppLovin** and verify your event went through.
   * This can take up to 90 seconds.
5. Verify the event is marked as `OK` or resolve missing property issues.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FvSwamRnyKLyun5gZOpPb%2Fimage.png?alt=media&#x26;token=5fc5cd71-3db4-4dd0-a3ae-992d84aa8f48" alt=""><figcaption></figcaption></figure>

### Confirm and Validate Events in AppLovin

When first setting up your AppLovin account, you will be required to send 1 of each required event before you can view the Event Manager.

You can view the list of required parameters for each of these events types[ in their documentation](https://support.axon.ai/en/growth/promoting-your-websites/axon-pixel-integration/events-and-objects).

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2Fd2ULESsEZkMVdRhwh6W6%2Fimage.png?alt=media&#x26;token=0b5877eb-7e2f-4fac-9ba9-7e5f6b032515" alt=""><figcaption></figcaption></figure>

Afterwards, to check whether AppLovin is receiving events:

1. Log into your [Axon Ads Manager](https://ads.axon.ai/).
2. Select **Events** in the left-hand menu.
3. You should see events coming through under the large graph under **Event details** on this page.
   1. Successfully sent events will increment the Count and the "Last seen" time. It's usually within a few seconds. They mention at the top of the page it can be up to 2 hours.
4. See that your event has a status of :green\_circle: <mark style="color:$success;">**All Working**</mark>. Click to spot check events.

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FIPvHXLLkVPwj007FcfOn%2Fimage.png?alt=media&#x26;token=eb06aa28-8401-4466-aa38-4e733a8bf123" alt=""><figcaption></figcaption></figure>
