In this scenario, users who click an ad are redirected to a landing page where the Airbridge Web SDK is installed. Airbridge collects data from this website and the PC game to measure ad performance. This method is recommended when tracking campaigns where tracking links can’t be used. The collected cookie IDs can also be used for running effective retargeting campaigns.

Airbridge collects data using the tracking links across platforms to measure the performance of PC game ads.

Prepare a landing page to redirect users who click your ad. From the landing page, users can either start the PC game directly or navigate to other gaming platforms such as Steam or Epic Games Store.

Installing the Airbridge Web SDK to the landing page allows you to track ad performance without tracking links and run effective retargeting campaigns using the cookie IDs collected via the SDK.

Registering a mobile app is not required to get started. Simply enter a website or the desired landing page into the Website field. It can be changed afterward.

Refer to this article to learn more about getting started with Airbridge.

Install the Airbridge Web SDK to the desired landing page. By enabling the UTM parsing of the Web SDK, Airbridge can track data via UTM parameters without the use of tracking links.

• Airbridge Web SDK Setup

• UTM Parsing

Design the event taxonomy for your PC game measurement. The game events will be sent to Airbridge and recorded following the set event taxonomy.

• Event Taxonomy

Attention

Upon updating the probabilistic modeling settings, more conversions will be attributed to ad channels by Airbridge, and the change will be visible in the Airbridge reports.

To set up PC game measurement, the probabilistic modeling settings must be updated. Contact your Airbridge CSM for more details.

The following table shows the different endpoints for the PC Game Installs, PC Game Opens, and In-game events.

In-game events are events that are performed after the user performs the PC Game Install or PC Game Open events, such as Complete Tutorial, Achieve Level 1, etc.

Refer to the table below for the header configuration.

Attention

The API token required for configuring the Authorization header can be found on the [Settings]>[Tokens] page in the Airbridge dashboard.

Refer to the following table for sending the PC game events to Airbridge. The events can be defined as Standard or Ecutom Events depending on the information sent to eventData.goal. To learn more about Standard and Custom Events, refer to this article.

Airbridge supports the following devicesub-variables.

Sending device information recommended

We recommend sending the device information. The device information is required to view the PC game events by platform, OS, and other details in the Airbridge reports.

The PC game tracking results can be monitored in the Airbridge report by using the device information as GroupBys.

Attention

If the device information is not sent, you might see some unexpected results in your Airbridge reports.

In the following scenario, the attribution window is set to 3 days.

Refer to the example below.

curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9161' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ DEVICE_CLIENT_IP }}' \
--data '{
    "user": {
        "externalUserID": "abrid123"
    },
    "device": {
        "platform": "steam",
        "deviceType": "desktop",
        "osName": "Windows",
        "osVersion": "11",
        "deviceModel": "pc",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    }
}'

Refer to the example below.

curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9160' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ DEVICE_CLIENT_IP }}' \
--data '{
    "user": {
        "externalUserID": "abrid123"
    },
    "device": {
        "platform": "playstaion",
        "deviceType": "console",
        "osName": "playstation_5",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    }
}'

Refer to the example below to send various in-game events to Airbridge.

curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ DEVICE_CLIENT_IP }}' \
--data '{
    "user": {
        "externalUserID": "abrid123"
    },
    "device": {
        "platform": "iOS",
        "deviceType": "desktop",
        "osName": "iOS",
        "osVersion": "17.1",
        "deviceModel": "Mac",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    },
    "eventData": {
        "goal": {
            "category": "buy_item",
            "action": "weapon",
            "label": "longsword",
            "value": 1.234,
            "customAttributes": {
                "foo": "foo",
                "bar": 1.234
            }
        }
    }
}'

It is advised to send revenue events as Airbridge Standard Events so you can use the revenue data for postbacks and view them in Airbridge reports such as the Revenue Report.

When configuring theeventData.goal.categoryas airbridge.ecommerce.order.completed, the revenue data is sent as the Order Complete event, and the eventData.goal.value will be reported as the revenue amount.

curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ DEVICE_CLIENT_IP }}' \
--data '{
    "user": {
        "externalUserID": "abrid123"
    },
    "device": {
        "platform": "Android",
        "deviceType": "desktop",
        "osName": "Android",
        "osVersion": "7",
        "deviceModel": "pc",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    },
    "eventData": {
        "goal": {
            "category": "airbridge.ecommerce.order.completed",
            "value": 1.234,
            "semanticAttributes": {
                "currency": "USD"
            }
        }
    }
}'

Create a tracking link to use for your ad. When creating an integration channel tracking link in the Airbridge dashboard, click [Website] in the Redirection section and configure the destination for all platforms as the desired landing page. If you don't have a landing page for redirection purposes, you can enter the URL of the game distribution platform, such as Steam, Epic Games Store, etc.

For detailed instructions on how to create tracking links, refer to this article.

Registering a mobile app is not required to get started. Simply enter a website or the desired landing page into the Website field. It can be changed afterward.

Refer to this article to learn more about getting started with Airbridge.

Design the event taxonomy for your PC game measurement. The game events will be sent to Airbridge and recorded following the set event taxonomy.

• Event Taxonomy

Attention

Upon updating the probabilistic modeling settings, more conversions will be attributed to ad channels by Airbridge, and the change will be visible in the Airbridge reports.

To set up PC game measurement, the probabilistic modeling settings must be updated. Contact your Airbridge CSM for more details.

Suppose the "Level Achieved" event parameters have been configured as below.

• eventData.goal.action: The location information of the user who achieved a certain level within the game

• eventData.goal.label: The method of achieving the level

In the Airbridge report, select level_achieved (App) as the metric and Channel, Event Action, and Event Label as GroupBy to create a report view like the following image.

Suppose the parameters of the “Purchase Item” event have been configured as below.

• eventData.goal.category: purchase_item

• eventData.goal.action: The type information of the purchased item

• eventData.goal.label: The information on how the item was attached to the game character

In the Airbridge report, select purchase_item (App) as the metric and Channel, Event Action, and Event Label as GroupBy to create a report view like the following image.

Airbridge uses probabilistic approach for PC game measurement. The connection between touchpoints and conversions is inferred within a 6-hour timeframe, but the timeframe can be modified for PC game measurement.

Make sure to avoid the following mistakes.

• IP not sent: Send IP with the X-Forwarded-Forheader when an in-game event occurs.

• Wrong endpoint: Send events to the correct endpoints.

• S2S API configuration error: Send data via the S2S event API for in-app events.