> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude

Airbridge supports integration with Amplitude. With the integration, event data is sent to Amplitude, allowing you to leverage the data from Airbridge for more in-depth product analysis with Amplitude.

<Info>
  **Note**

  Once the integration is complete, the attribution data collected by Airbridge is sent to Amplitude’s US server. If you want the data to be sent the EU server, contact your CSM.
</Info>

## Integration Methods: V1 and V2

<Danger>
  **Attention**

  To implement the integration with Amplitude, choose one integration method between V1 and V2 methods. When using both methods, event duplication may occur.
</Danger>

Airbridge supports 2 different methods for integrating with Amplitude. Select one of the V1 or V2 integration methods. Refer to the table below for details of the V1 and V2 methods.

|                                   | V1                                                                                                                                                        | V2                                                                                                                                                    |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| API                               | Attribution API                                                                                                                                           | HTTP V2 API                                                                                                                                           |
| Pre-setup                         | [Add code snippets](/en/guides/amplitude#add-codes-into-the-amplitude-sdk) into the Amplitude SDK to collect Ad ID (GAID for Android, IDFA for iOS, IDFV) | [Add code snippets](/en/guides/amplitude#add-codes-into-the-airbridge-sdk) into the Airbridge SDK to get Amplitude Device ID                          |
| Events that can be sent           | [Target Events](/en/guides/airbridge-attribution-model#target-events)                                                                                     | All events (Target Events and [In-app Events](/en/guides/airbridge-event-types))<br />- Standard Events<br />- Custom Events collected more than once |
| Event properties that can be sent | 12 event properties that are preset                                                                                                                       | Event properties you select from the 124 properties                                                                                                   |
| User matching method              | Ad ID is used. In case of failure, the Ad ID is discarded after 72 hours.                                                                                 | Identifiers are used in given priority. In case of failure, the user is logged as a new user.                                                         |

## **Implementing Integration Through the V1 Method**

The V1 method works through the attribution API provided by Amplitude. Airbridge starts sending the Target Event data collected after the integration implementation is complete with Amplitude. The event properties sent to Amplitude are logged as user properties in Amplitude.

Event properties other than the ones of Target Events cannot be sent to Amplitude using the V1 integration method. Implement the V2 integration method to send in-app events and their event properties to Amplitude.

### Pre-setup for integration

The following steps must be completed to implement the integration through the V1 method.

<AccordionGroup>
  <Accordion title="Add code snippets into the Amplitude SDK">
    Refer to the articles from Amplitude's developer guide below and add the required code snippets to the Amplitude SDK.

    * [For Android SDK](https://www.docs.developers.amplitude.com/data/sdks/android-kotlin/#advertiser-id)
    * [For iOS SDK](https://www.docs.developers.amplitude.com/data/sdks/ios/#advertiser-id)

    If the code snippets are not added to the Amplitude SDK before configuring the integration settings in the Airbridge dashboard, the integration won’t be complete.
  </Accordion>

  <Accordion title="Check the Amplitude account user role">
    Check the Amplitude account's user role in the **\[Settings]>\[Personal settings]>\[Profile]** menu in the Amplitude dashboard. You must have the Admin or Manager role to access the API Key in the Amplitude dashboard.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-profile-personal-settings.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=19df63052d297f0ca907bebf88c71937" alt="01 kr amplitude v2" width="1500" height="727" data-path="asset/image/amplitude-profile-personal-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="Find the API Key in the Amplitude dashboard">
    Navigate to **\[Settings]>\[Organization settings]>\[Projects]** and select the project to import the Airbridge data. In the **\[General]** tab, click **Show** to view the API Key.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-project-api-key-legacy.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=7ddf57df69ab54eb8bddf9b2e2985105" alt="01-en-amplitude" width="886" height="498" data-path="asset/image/amplitude-project-api-key-legacy.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

### Providing the API Key to Airbridge

1. Navigate to **\[Integrations]>\[Third-party Integration]** and select **Amplitude V1**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-v2-integration-card-configured.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=1d7a9be7e0a61f111838898716871dbe" alt="02-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-v2-integration-card-configured.png" />
</Frame>

2. Enter the API Key copied from the Amplitude dashboard.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-v1-api-key-entry.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=1286fa7a4819971a2a9926b2a3aaa693" alt="04-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-v1-api-key-entry.png" />
</Frame>

3. Switch on the **Send User Properties** toggle. The properties of the Target Events will be sent to Amplitude, and the user property names will be prefixed with \[Airbridge] in Amplitude.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-send-user-properties-toggle.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=c290ef14e37c256833d721a8cf34d61b" alt="05-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-send-user-properties-toggle.png" />
</Frame>

## Implementing Integration Through the V2 Method

The V2 method works through the attribution HTTP V2 API provided by Amplitude. Airbridge starts sending the Target Event and in-app event data collected after the integration implementation is complete with Amplitude. The event properties sent to Amplitude are logged as user properties in Amplitude.

The V2 method allows sending more event data to Amplitude than the V1 method. Before implementing the integration through the V2 method, check whether the event data you want to send from Airbridge to Amplitude is already being collected through the Amplitude SDK. Note that event duplication may occur if the event data sent from Airbridge to Amplitude is also collected through the Amplitude API.

### Pre-setup for integration

The following steps must be completed to implement the integration through the V2 method.

<AccordionGroup>
  <Accordion title="Add code snippets to the Airbridge SDK">
    Before enabling the integration with Mixpanel in the Airbridge dashboard, the SDK setup must be completed. Refer to the developer guide below.

    * [Developer guide for Amplitude V2 integration](/en/developers/amplitude-v2)

    If the SDK setup is not completed, Airbridge cannot be successfully connected to Amplitude even if the integration is enabled in the Airbridge dashboard.
  </Accordion>

  <Accordion title="Check the Amplitude account user role">
    Check the Amplitude account's user role in the **\[Settings]>\[Personal settings]>\[Profile]** menu in the Amplitude dashboard. You must have the Admin or Manager role to access the API Key in the Amplitude dashboard.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-profile-personal-settings.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=19df63052d297f0ca907bebf88c71937" alt="01 kr amplitude v2" width="1500" height="727" data-path="asset/image/amplitude-profile-personal-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="Find the API Key in the Amplitude dashboard">
    Navigate to **\[Settings]>\[Organization settings]>\[Projects]** and select the project to import the Airbridge data. In the **\[General]** tab, click **Show** to view the API Key.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-project-api-key-legacy.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=7ddf57df69ab54eb8bddf9b2e2985105" alt="01-en-amplitude" width="886" height="498" data-path="asset/image/amplitude-project-api-key-legacy.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

### Adding connections

<Danger>
  **Attention**

  Make sure the required code snippets are added to the Airbridge SDK before providing the API Key to the Airbridge dashboard. Otherwise, the integration's implementation will not be complete.

  Refer to the following article from the developer guide and share it with your developer.

  * [Amplitude V2 Integration](/en/developers/amplitude-v2)
</Danger>

1. Navigate to **\[Integration]>\[Third-party Integration]** and select **Amplitude V2**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-v2-integration-card-configured.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=1d7a9be7e0a61f111838898716871dbe" alt="02-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-v2-integration-card-configured.png" />
</Frame>

2. Click **Add Connection.**

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-list.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=3be3a19d7300fde7ee32627a3ab274d8" alt="08-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-list.png" />
</Frame>

<Note>
  **Connections**

  You can add multiple connections to send events to Amplitude. However, only a single connection can be enabled at a time. For example, if you want to switch to a new connection, you need to disable the current connection and enable the new connection to send data to Amplitude.
</Note>

3. Enter the API Key copied from the Amplitude dashboard. If you have registered API keys with Airbridge before, you can also select from the list of already registered API keys.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-information-form.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=4d52b6216f4543f190513c5ebe146aa4" alt="09-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-information-form.png" />
</Frame>

4. Select the events you want to send to Amplitude. All events are selected by default. Click **Select All** or **Clear All** to select or clear all events. [Standard Events](/en/guides/airbridge-event-types#standard-events) are available for selection by default, whereas [Custom Events](/en/guides/airbridge-event-types#custom-events) are available only when Airbridge has collected the event at least once.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-event-selection.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=6beaf4ec42b61f4334d3f4a42070cdda" alt="10-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-event-selection.png" />
</Frame>

5. Select the event properties you want to send to Amplitude. Click **Select All** or **Clear All** to select or clear all events. The following event properties are sent to Amplitude by default and cannot be deselected.
   * Event Category, Event Timestamp, Device ID, Platform, User ID

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-property-selection.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=d2ababc8ebe131501ed37be0e64472ec" alt="11-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-property-selection.png" />
</Frame>

Refer to the information below for event properties that can also be used as user properties in Amplitude when imported.

<Accordion title="Airbridge event properties that can be used as user properties in Amplitude">
  By default, the event properties sent from Airbridge are imported as event properties in Amplitude. There are some event properties, however, that are imported as event properties and also as user properties. In Amplitude, you can use the user properties for data analysis on the user level. The [user composition chart](https://help.amplitude.com/hc/en-us/articles/231258248-The-User-Composition-chart-View-your-users-by-the-properties-they-have-in-common), for example, can only be configured using user properties.

  <Frame>
    <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-user-property-composition-chart.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=36ca25922916e78e3eecc71d794d2e9a" alt="04 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-user-property-composition-chart.png" />
  </Frame>

  The following Airbridge event properties are imported to Amplitude as event properties and user properties.

  <Info>
    **Note**

    When no data is collected, `-` is sent to Amplitude as the touchpoint-related properties. For the connections that fall into the following conditions, however, null values are sent as the touchpoint-related properties.

    * Connections created before 2024-02-29
    * Connections not activated or not edited after 2024-02-29
  </Info>

  **Touchpoint-related properties**

  The table below lists the user-related properties. When no data is collected for these properties, `-` is sent to Amplitude.

  | <span style={{ display: 'inline-block', minWidth: '120px' }}>Property</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>Description</span>                 |
  | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
  | Channel                                                                      | Channel that generated touchpoints and conversions                                              |
  | Campaign                                                                     | Campaign that generated touchpoints and conversions                                             |
  | Ad Group                                                                     | Ad Group that generated touchpoints and conversions                                             |
  | Ad Creative                                                                  | Ad Creative that generated touchpoints and conversions                                          |
  | Content                                                                      | Content that generated touchpoints and conversions                                              |
  | Term                                                                         | Term that generated touchpoints and conversions, and also refers to ad search keyword           |
  | Sub Publisher                                                                | Sub publisher that generated touchpoints and conversions                                        |
  | Sub Publisher 1                                                              | Level 1 publisher below Sub Publisher that generated touchpoints and conversions                |
  | Sub Publisher 2                                                              | Level 2 publisher below Sub Publisher that generated touchpoints and conversions                |
  | Sub Publisher 3                                                              | Level 3 publisher below Sub Publisher that generated touchpoints and conversions                |
  | Campaign ID                                                                  | Unique ID for a campaign parameter value that was generated from SAN(Self-attribution Network)  |
  | Ad Group ID                                                                  | Unique ID for Ad Group parameter value that was generated from SAN(Self-attribution Network)    |
  | Ad Creative ID                                                               | Unique ID for Ad Creative parameter value that was generated from SAN(Self-attribution Network) |

  <Note>
    **Channels that did not attribute to the conversion**

    The `Channel` event property data is logged as “Unattributed” when the channel didn’t attribute to the conversion, which is an event occurrence, and in this case, “Unattributed” is sent to Amplitude as the `Channel` event property.

    `-` is sent as the `Channel` event property when no data has been collected.
  </Note>

  ###### User-related properties

  The table below lists the user-related properties. When no data is collected for these properties, a null value is sent to Amplitude.

  | <span style={{ display: 'inline-block', minWidth: '120px' }}>Property</span> | <span style={{ display: 'inline-block', minWidth: '240px' }}>Description</span> |
  | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
  | User ID                                                                      | User ID of the user who generated a touchpoint and conversion                   |
  | Hashed User ID                                                               | Hashed User ID of the user who generated a touchpoint and conversion            |
  | User Email                                                                   | User Email of the user who generated a touchpoint and conversion                |
  | Hashed User Email                                                            | Hashed User Email of the user who generated a touchpoint and conversion         |
  | User Phone                                                                   | Contact of the user who generated a touchpoint and conversion                   |
  | Hashed User Phone                                                            | Hashed contact of the user who generated a touchpoint and conversion            |
  | Custom User Properties                                                       | Custom property                                                                 |
</Accordion>

6. Set the delivery rules for sending event names and install attribution data to Amplitude.

<AccordionGroup>
  <Accordion title="Event Name Settings">
    Choose the name format for the events and properties that Airbridge sends.

    * No \[Airbridge] prefix: Event names and property names appear exactly as they appear in Airbridge. This is the default setting.
    * Add \[Airbridge] prefix to event names and property names: Event names and property names appear with \[Airbridge] prefix added at the beginning.
  </Accordion>

  <Accordion title="Sending Install Attribution Data">
    You can decide whether to send the attribution data of Install to Amplitude every time the attribution data of the most recent event is sent to Amplitude as user property. Note that the attribution data is the touchpoint property data of Target Events.

    #### When the toggle is switched off

    Airbridge only sends the attribution data of the most recent Target Event to Amplitude as user property. As a result, the attribution data of the most recent Target Event is available as a user property in Amplitude, allowing you to determine which campaign the user most recently engaged with before opening your app.

    Refer to the table below that illustrates the data delivery for a user who performed 5 Target Events.

    |                                                     | 1st Target Event | 2nd Target Event | 3rd Target Event  | 4th Target Event | 5th Target Event |
    | --------------------------------------------------- | ---------------- | ---------------- | ----------------- | ---------------- | ---------------- |
    | Event performed by the user                         | Install          | Deeplink Open    | Deeplink Pageview | Reinstall        | Deeplink Open    |
    | Attribution data sent to Amplitude as User Property | Install          | Deeplink Open    | Deeplink Pageview | Reinstall        | Deeplink Open    |

    #### When the toggle is switched on

    Every time Airbridge sends the attribution data of the most recent Target Event to Amplitude as a user property, it also sends the attribution data of the Install event. As a result, the attribution data of the most recent Target Event and the Install event is available as separate user properties in Amplitude. This allows you to determine which campaign the user most recently engaged with before recently opening your app and which campaign the user engaged with before installing the app. The attribution data of Installs is displayed in Amplitude as user properties with `install_` as a prefix.

    Note that when a Reinstall occurs, the attribution data of the Reinstall will be sent instead of the attribution data of the first Install. Refer to the table below that illustrates the data delivery for a user who performed 5 Target Events.

    |                                                                    | 1st Target Event | 2nd Target Event | 3rd Target Event  | 4th Target Event | 5th Target Event |
    | ------------------------------------------------------------------ | ---------------- | ---------------- | ----------------- | ---------------- | ---------------- |
    | Event performed by the user                                        | Install          | Deeplink Open    | Deeplink Pageview | Reinstall        | Deeplink Open    |
    | Attribution data sent as user property                             | Install          | Deeplink Open    | Deeplink Pageview | Reinstall        | Deeplink Open    |
    | Attribution data sent as user property with `install_` as a prefix | Install          | Install          | Install           | Reinstall        | Reinstall        |
  </Accordion>
</AccordionGroup>

7. Configuring the **Additional Delivery Rules** is optional. You can create a connection without adding any delivery rules.

If there are events and properties you don't want to send, click **Add Rule**, enter a unique rule name, and configure the rule conditions.

You can add multiple conditions to a delivery rule. For example, if the delivery rule has been configured like in the image below, the **Install (App)** events are not sent to Amplitude if the `Channel` property is `example_channel`, and the `Campaign` property is not `example_campaign`.

However, you need to add a new rule to configure different conditions for a single event or property.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-delivery-rule-conditions.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=c2c5de6beed92210f57dd92b80bdf2f6" alt="13-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-delivery-rule-conditions.png" />
</Frame>

8. Click **Add Connection** when you are done. Note that the events that are used for configuring the delivery rules cannot be unchecked from the events selector in the **\[Select Events]** step. You must first delete the relevant delivery rule if you don’t want to send certain events.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-add-connection-delivery-rules.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=72afb7e530b1122ba08bee7058e2675a" alt="14-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-add-connection-delivery-rules.png" />
</Frame>

9. The default status for a new connection is `Inactive` with the status toggle being switched off. Switch on the status toggle to activate the connection.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-status-toggle.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=10fe888b4b82dec813237989d5b3ac34" alt="15-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-status-toggle.png" />
</Frame>

You can also activate an inactive connection by clicking on it and clicking **Activate**. When activated, the configured events and properties are sent to Amplitude.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-activate-button.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=bf1b9820512d3bbab94b95e03e7616ad" alt="16-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-activate-button.png" />
</Frame>

### Supported features

#### Edit connection settings

Click the connection to edit its connection settings, regardless of whether it is active or not. You can edit the event schema, delivery rules, and connection info. Be cautious when editing the connection settings of an active connection, as unintended events and event properties may be sent to Amplitude.

<AccordionGroup>
  <Accordion title="Activate a connection and view the integration status">
    Click **Activate** to activate a connection. Airbridge starts sending data upon activating a connection. When clicking **Deactivate**, data is no longer sent.

    The third-party integration status is displayed under the third-party solution name on the **\[Integrations]>\[Third-party Integration]** page. Refer to the table below for the integration status types.

    | Status         | Description                                                               |
    | -------------- | ------------------------------------------------------------------------- |
    | (No message)   | No connection has been configured or cannot verify the integration status |
    | Not Configured | At least 1 connection has been configured but data is not being sent      |
    | Configured     | Data is being sent to the third-party                                     |
  </Accordion>

  <Accordion title="Edit event schema and delivery rules">
    **Event Schema**

    Click **Configuration** on the **\[Event Schema]** tab page to edit the event and event property selection.

    Click an event from the Events list and click the **\[gear]** icon from the **\[Property Settings]** tab. In the **\[Applied Rules]** tab, the delivery rules can be configured at the event level.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-event-schema-property-settings.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=8b96ae2708a1a8c2a37c9fd69fbb39b6" alt="17-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-event-schema-property-settings.png" />
    </Frame>

    **Delivery Rules**

    In the **\[Delivery Rules]** tab, view all delivery rules applied to the connection. Click **Add Rule** to add new delivery rules. Click the **\[gear]** icon to edit the rules. Click **Download** to export the delivery rules as a CSV file or Google Spreadsheet file.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-delivery-rule-settings.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=03a0a61f076f7dcc5a33691df87310ae" alt="18-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-delivery-rule-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="View and edit connection info">
    In the **\[Connection Info]** tab, you can see the connection details. Click **Edit** to edit the connection name and the credentials used for the integration. The credentials are not fully disclosed.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-info-edit.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=01095a746794fef993f211b354dd8465" alt="21-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-info-edit.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

#### Manage connections

<AccordionGroup>
  <Accordion title="Duplicate connections">
    Click **Action** and select **Duplicate** to duplicate connection settings to create a new connection with a new connection name.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-connection-duplicate-menu.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=2d0e31948a120a87742203f127502e2d" alt="19-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-connection-duplicate-menu.png" />
    </Frame>
  </Accordion>

  <Accordion title="Delete connections">
    Click the **\[...]** icon and select **Delete** to delete a connection. Active connections cannot be deleted. Deactivate the connection first to delete it.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/yyE9NRM9Kdp2rW-x/asset/image/google-analytics-4-connection-delete.png?fit=max&auto=format&n=yyE9NRM9Kdp2rW-x&q=85&s=60401d134485ae7b2f28a2ebe7277fe0" alt="03-en-GA4 (1)" width="1500" height="857" data-path="asset/image/google-analytics-4-connection-delete.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Using Airbridge Data in Amplitude

Once the integration is successfully implemented, Airbridge data is made available in Amplitude.

The user properties sent from Airbridge using the V1 integration method have their names prefixed with \[Airbridge]. The events sent from Airbridge using the V2 integration method will have their names prefixed with \[Airbridge] only when configured to do so.

Refer to the information below to learn how to use Airbridge data in Amplitude.

<AccordionGroup>
  <Accordion title="View user data">
    In **\[User Look-Up]**, the Airbridge events and properties can be viewed at the user level.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-user-lookup-event-properties.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=b34640e1c9820185426065eb9e49effd" alt="09 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-user-lookup-event-properties.png" />
    </Frame>
  </Accordion>

  <Accordion title="Create charts">
    Make use of the Airbridge event data when creating charts in Amplitude. Refer to the information below to learn how to use the Airbridge event data when creating an [Event Segmentation Chart](https://help.amplitude.com/hc/en-us/articles/360052274852-Build-an-event-segmentation-analysis) in Amplitude.

    **Select events**

    Click **Add Event or Metric** and select an event from Airbridge events. Unless the Airbridge events have been assigned to a specific category, the Airbridge events are under the category, **Uncategorized** or **Unexpected**.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-event-list-selection.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=f9d577fdfc5be5d57233b466288e7964" alt="06 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-event-list-selection.png" />
    </Frame>

    The event property of the selected event can be set as a filter or a GroupBy. Click **Filter by** to view the metric data of a specific event. Click **Group-by** to view the data into specific groups.

    For example, if the chart has been configured like in the image below, you can visualize the **Install (App)** event data with the `channel` property being **example\_channel** by different platforms.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-segmentation-platform-breakdown.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=0fd7867c94929fedf7f23f25664efcea" alt="07 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-segmentation-platform-breakdown.png" />
    </Frame>

    ###### Configure filters

    After selecting an event, scroll down to find **Segment by** where you can configure the user conditions. Click **Filter by** to use the user properties imported from Airbridge for filter configuration.

    Click **Performed** to select an event and view the number of users who performed the event. You can then click **Add Property filter** to use the properties imported from Airbridge for filter configuration.

    For example, if the chart has been configured like in the image below, you can view the number of users who performed the **Order Complete** event more than 1 time during Aug 22, 2023 - Aug 29, 2023, and the `channel` property is `example_channel`.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-segmentation-filter-chart.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=07395d911f111b42a843be15435e9510" alt="08 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-segmentation-filter-chart.png" />
    </Frame>
  </Accordion>

  <Accordion title="Manage events">
    Navigate to **\[Data]>\[Events]** to manage events.

    **Add a category**

    Hover over the CATEGORY column and click **Add a category** to find the events easily. Only events with the `Live` status can be added to a category.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-event-category-selection.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=d28ea405d4a1b5c8a5e07cd87aecf689" alt="10 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-event-category-selection.png" />
    </Frame>

    **Create custom events**

    Select events you frequently use for chart configuration and click **CREATE CUSTOM EVENT** to group them into a single custom event.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-custom-event-selection.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=6422cf61b41748318c089dd1b824ecd9" alt="11 kr amplitude revamp 20230828" width="1400" height="800" data-path="asset/image/amplitude-custom-event-selection.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Attention

<AccordionGroup>
  <Accordion title="User matching between Airbridge users and Amplitude users">
    The process for matching Airbridge users with Amplitude users varies based on the integration methods.

    **V1 integration method**

    Ad ID is used for user matching, which is GAID for Android and IDFA, IDFV for iOS. If Airbridge has not collected an Ad ID, Amplitude receives null or other values that cannot be used for user matching. In this case, user matching may fail. Amplitude discards the data after 72 hours when the continued attempts to match the user fail.

    The V2 integration method shows a higher success rate in user matching. In particular, for apps with Amplitude JS SDK or React Native SDK, the V2 integration method is recommended as Ad ID collection is not possible due to Apple and Google’s privacy policies.

    **V2 integration method**

    The following identifiers are used for user matching. The identifiers are listed by their priority.

    1. Amplitude Device ID (device.alias.amplitude\_device\_id)
    2. Amplitude Device ID (user.alias.amplitude\_device\_id)
    3. [Airbridge Device ID](/en/guides/identity-matching) (device.deviceUUID)
    4. Browser Client ID(browser.clientID)

    If the Amplitude Device ID is not available, Airbridge sends the Airbridge Device ID and the Browser Client ID to Amplitude, which shows a lower success rate of user matching.

    In particular, to perform user matching for apps with Amplitude JS SDK or React Native SDK, the Amplitude Device ID must be available by Airbridge as Ad ID (GAID for Android and IDFA, IDFV for iOS) collection is not possible due to Apple and Google’s privacy policies.

    Should a user matching fail, Amplitude will identify the user as a new user. Consequently, this may lead to an inflated user count and result in overcharging for service fees. To avoid excessive charges, ensure that the pre-setup is completed before implementing the integration.
  </Accordion>

  <Accordion title="Data sharing policy of Meta ads">
    Events attributed to Meta ads shall not be sent or shared with third parties in accordance with the Meta Privacy Policy. The data shall only be used internally by the entity that ran the ad for the purpose of analyzing the performance of the Meta ads campaign.

    Accordingly, Airbridge sends the `channel` event property of events attributed to Meta ads as “Restricted” to any third parties.

    However, [Meta ads web campaign data](/en/guides/meta-business-website-conversion) collected through tracking links or campaign data collected through custom channel tracking links are not masked when sent to third parties.
  </Accordion>

  <Accordion title="How Amplitude updates user property">
    In case a null value has been sent as a property to Amplitude, the previously sent value remains as the user property of the user within Amplitude. Refer to Amplitude’s user guide on [user properties](https://help.amplitude.com/hc/en-us/articles/115002380567-Overview-of-user-properties-and-event-properties-in-Amplitude#h_39e46c92-7b7f-4358-a96f-c82cc3342e3e).

    Let’s say the event property X of a user has been sent from Airbridge to Amplitude in the order shown in the following table. A null value has been sent after the `sneakers` are sent. In this case, the user property X will show `sneakers` in Amplitude.

    | **Sending Order** | **Event Property X sent from Airbridge** | **User Property X logged to Amplitude** |
    | ----------------- | ---------------------------------------- | --------------------------------------- |
    | 1                 | sneakers                                 | sneakers                                |
    | 2                 | `null`                                   | sneakers                                |
    | 3                 | boots                                    | boots                                   |

    To make sure that unintended user property values are logged to Amplitude when no data has been collected, Airbridge sends `-` instead of a null value for some event properties. Refer to this **section** of the article to see the list of event properties of which `-` is sent when no data has been collected.

    Let’s say the event property Y of a user has been sent from Airbridge to Amplitude in the order shown in the following table. `-` has been sent after `sneakers`. In this case, the user property Y will show `-` in Amplitude.

    | **Sending Order** | **Event Property Y sent from Airbridge** | **User Property Y logged to Amplitude** |
    | ----------------- | ---------------------------------------- | --------------------------------------- |
    | 1                 | sneakers                                 | sneakers                                |
    | 2                 | `-`                                      | `-`                                     |
    | 3                 | boots                                    | boots                                   |

    <Info>
      **Note**

      When no data is collected, `-` is sent to Amplitude as the touchpoint-related properties. For the connections that fall into the following conditions, however, null values are sent as the touchpoint-related properties.

      * Connections created before 2024-02-29
      * Connections not activated or not edited after 2024-02-29
    </Info>

    **Example case**

    When no data has been collected for the `Channel` and `Campaign` properties, Airbridge sends `-` to Amplitude.

    When no data has been collected for the `Custom User Properties`, Airbridge sends a null value to Amplitude.

    Refer to the table to see how the second delivery of properties is logged to Amplitude.

    * `Campaign`: `-` is sent and logged
    * `Custom User Properties`: `null` is sent and therefore `sneakers` remains as the property value in Amplitude which was sent through the first delivery

    | **Sending Order** | **Event Properties sent from Airbridge**                                                   | **User Properties logged to Amplitude**                                                    |
    | ----------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
    | 1                 | `Channel`=`Ad Channel 1`<br />`Campaign`=`Summer`<br />`Custom User Properties`=`sneakers` | `Channel`=`Ad Channel 1`<br />`Campaign`=`Summer`<br />`Custom User Properties`=`sneakers` |
    | 2                 | `Channel=Unattributed`<br />`Campaign`= `-`<br />`Custom User Properties`=`null`           | `Channel=Unattributed`<br />`Campaign`= `-`<br />`Custom User Properties`=`sneakers`       |
    | 3                 | `Channel`=`Ad Channel 2`<br />`Campaign`=`Summer2`<br />`Custom User Properties`=`boots`   | `Channel`=`Ad Channel 2`<br />`Campaign`=`Summer2`<br />`Custom User Properties`=`boots`   |
  </Accordion>

  <Accordion title="Avoiding session duplication">
    When implementing the V2 integration method, make sure the Session Start Timestamp is unchecked when selecting event properties to send to Amplitude to avoid session duplication. The Session Start Timestamp is the Session ID of the session collected through the Airbridge SDK. It is unchecked by default. When implementing the V1 integration method, the Session Start Timestamp is not sent by default.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-session-start-property.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=fa9a409a1e5a005be4fdd887da6a7968" alt="01-en-Amplitude" width="1400" height="800" data-path="asset/image/amplitude-session-start-property.png" />
    </Frame>

    Session duplication occurs when the Airbridge SDK and the Amplitude SDK collect the same session and log them as different Session IDs. Therefore, the Session Start Timestamp, which is the Session ID in Airbridge shall not be sent to Amplitude to avoid duplication.

    When the Session Start Timestamp is not sent, Airbridge sends null as the Session ID. In Amplitude, the Session ID with a null value will be logged as -1. Amplitude excludes such sessions from aggregation to avoid session duplication for the User Session Chart and Pathfinder Chart.

    <Frame>
      <img src="https://mintcdn.com/airbridge-help-center/IylSMf3jgUEEjRbr/asset/image/amplitude-profile-personal-settings.png?fit=max&auto=format&n=IylSMf3jgUEEjRbr&q=85&s=19df63052d297f0ca907bebf88c71937" alt="01 kr amplitude v2" width="1500" height="727" data-path="asset/image/amplitude-profile-personal-settings.png" />
    </Frame>

    When the Session Start Timestamp is sent to Amplitude, the session count could be inflated, and duplicate data with different Session IDs from the same session could be shown simultaneously.
  </Accordion>

  <Accordion title="Number of events may differ">
    When it comes to events that involve individual product items defined by the [Semantic Attributes](/en/guides/airbridge-event-elements#attributes), Airbridge logs events defined by actions regardless of how many products are involved in the action, whereas Amplitude and Mixpanel log events by individual product items. Therefore, Airbridge sends such events by individual product items following the [Airbridge Event Taxonomy](/en/guides/airbridge-event-taxonomy).

    Semantic Attributes with `products.$0` are attributes that involve product items.

    **Example case**

    Let’s say the `Order Complete` event has been defined with a Semantic Attribute, as shown below. When the event occurs, the product ID is logged per product item.

    | Category                            | Action | Label | Value | Attribute                                                |
    | ----------------------------------- | ------ | ----- | ----- | -------------------------------------------------------- |
    | airbridge.ecommerce.order.completed | -      | -     | -     | eventData.goal.semanticAttributes.products.\$0.productID |

    Based on this taxonomy design, if a user orders 5 different product items and then 1 `Order Complete` event occurs, 1 `Order Complete` event will be logged to Airbridge, whereas in Amplitude and Mixpanel, 5 `Order Complete` events will be logged.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/amplitude" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/amplitude" />
