Send In-web Events

curl -X POST 'https://api.airbridge.io/events/v2/apps/{app_name}/web/9320' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -H 'X-Forwarded-For: 2001:e60:87e3:81d4:cd57:5d52:ee2e:ff8d' \
  -d '{
  "eventUUID": "9b4b3e4e-2162-4ae6-8986-91ee84644262",
  "user": {
    "externalUserID": "19443",
    "externalUserEmail": "example@ab180.co",
    "externalUserPhone": "821012341234"
  },
  "browser": {
    "clientID": "05609013-bb5a-4594-bbc3-832cb1b87072",
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E302"
  },
  "eventData": {
    "shortID": "aef04",
    "trackingData": {
      "channel": "blog"
    },
    "goal": {
      "category": "airbridge.ecommerce.product.addedToCart",
      "value": 159990,
      "semanticAttributes": {
        "action": "shoes",
        "label": "nike",
        "query": "나이키",
        "transactionID": "12939172",
        "inAppPurchased": true,
        "currency": "KRW",
        "products": [
          {
            "position": "1",
            "productID": "30372425",
            "name": "나이키 커스텀",
            "price": 10990,
            "quantity": 1,
            "currency": "KRW"
          }
        ]
      }
    }
  }
}'

{
  "at": "2020-02-06 16:06:49",
  "data": "Event(9320) is successfully proccessed."
}

{
  "at": "2020-02-06 16:06:49",
  "error": "invalid_request",
  "ingested": 0
}

{
  "at": "2020-02-06 16:06:49",
  "error": "unauthorized",
  "ingested": 0
}

Send In-Web events in a server-to-server method. rate limit : 1000 requests per minute.

User Identifiers

AttentionIt is recommended to send all available user identifiers as they are crucial for accurate attribution, postback, cohort analysis etc.

Cookie IDs can be retrieved through the SDK(refer to the data fetching guide). The following attribution data must be sent along with the Cookie ID for proper attribution.

Request Body Key	Data Fetching Field	Description
eventData.shortID	Attribution Short ID	Campaign Parameter ID
eventData.trackingData.channel	Default Attribution Channel	Campaign Channel
eventData.trackingData.params	Default Attribution Parameters	Campaign Parameters

Request Example

{
  ...

  "browser": {
    "clientID": "05609013-bb5a-4594-bbc3-832cb1b87072"
  },
  "eventData": {
    "shortID": "aef04",
    "trackingData": {
      "channel": "blog",
      "params": {
        "ad_creative": "ad_creative",
        "ad_group": "ad_group",
        "campaign": "ad_campaign",
        "content": "ad_content",
        "medium": "ad_medium",
        "tracking_template_id": "ad_tracking_template_id"
      }
    }
  },
  "user": {
    "externalUserID": "19443",
    "externalUserEmail": "example@ab180.co",
    "externalUserPhone": "821012341234"
  }
  
  ...
}

2. User ID(`user.externalUserID`)

User IDs may be sent without Cookie IDs if data fetching is inconvenient. In such cases, Airbridge processes events based on the Cookie IDs mapped to the provided User ID. However, if no mapping is found, this may lower the accuracy of reports.

Request Example

{
    ...
    
    "user": {
        "externalUserID": "19443",
        "externalUserEmail": "example@ab180.co",
        "externalUserPhone": "821012341234"
    }

    ...
}

Try API Request

POST

https://api.airbridge.io/events/v2/apps/{app_name}/web/9320

Request

Headers

string

You can specify the language to use for API requests and responses. It follows the ISO-639-1 format.

string

Represents the media type of the resource. Defaults to application/json.

string

The key value to use for API requests. Instructions for getting API keys are in “how to generate API Keys”.

string

required

You can send the user’s IP in the X-Forwarded-For header. Without X-Forwarded-For, user behavior is logged with the IP of the server that requested the Server To Server API, not the user’s IP (client request IP).We accept values in the form of ipv4 (123.123.123.123), ipv6 (2001:e60:87e3:81d4:cd57:5d52:ee2e:ff8d).

Path Params

string

required

Airbridge App Name. (Unique ID)

Body Params

string

Random UUID v4 string.Accepts a random string in UUID4 format.The event uuid is used for duplication as a unique ID for the event, and will be generated automatically by the event api if not provided.

number

The time the event occurred. (default: current timestamp)A Unix timestamp in milliseconds (13 digits in Unixtime).If the eventTimestamp is older than 24 hours from the time the event was sent, it will not be processed by the server.

object

User information.

Show child attributes

string

User ID.Required when: required if device.deviceUUID is not sent.

string

User email.

string

User phone number.

object

Custom user attributes.Accepts data in JSON format.{ "age_group": "30", "brand": "Nike" }

object

Browser Information.

Show child attributes

string

required

Browser cookie ID fetched from the SDK. [Docs]If data fetching isn’t possible, sending the User ID(user.externalUserID) will make this field optional.

string

Browser’s user agent fetched from the sdk. [Docs]This field is used to decide the platform, OS name and OS version of the event.

object

required

Event information.

Show child attributes

string

required

Attribution campaign parameter Short ID. Provide the value fetched from the Airbridge SDK(Android iOS).NOTE: This value must be sent to the Airbridge server without processing or filtering.If data fetching is not an option, sending the User ID(user.externalUserID) will make this field optional.

object

required

Tracking data from SDK.

Show child attributes

string

required

Attribution campaign channel. Provide the value fetched from the Airbridge SDK(Android iOS).NOTE: This value must be sent to the Airbridge server without processing or filtering. (eg. values such as airbridge.websdk must also be sent)If data fetching is not an option, sending the User ID(user.externalUserID) will make this field optional.

object

required

Attribution campaign parameters. Accepts data in JSON format.Provide the value fetched from the Airbridge SDK(Android iOS).NOTE: This value must be sent to the Airbridge server without processing or filtering.If data fetching is not an option, sending the User ID(user.externalUserID) will make this field optional.

object

required

An object that can contain information about an event. It can contain categories, actions, labels, values, and semantic attributes. (Related Guide)

Show child attributes

string

required

The name of the Airbridge event

number

Event’s value.This may represent the product value of purchase events, or revenue for ad impressions etc.

object

Custom event attribute.{ "color": "red" }

object

Semantic Attributes. Predefined attributes for which Airbridge is supposed to collect data.

Show child attributes

string

Airbridge event property 1

string

Airbridge event property 2

string

User search query.

string

Product list ID.

string

Cart ID.

string

Transaction ID.

boolean

In-app purchases or not.true for in-app purchase, false for not an in-app purchase.

string

The currency for the payment event. You can use the currency used for the actual payment, as it will be converted to the currency set in your dashboard during event processing.

object[]

Product list.

Show child attributes

string

Product position.

string

Product ID.

string

Product name.

number

Product Price.

integer

Product quantity.

string

Currency.

curl -X POST 'https://api.airbridge.io/events/v2/apps/{app_name}/web/9320' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -H 'X-Forwarded-For: 2001:e60:87e3:81d4:cd57:5d52:ee2e:ff8d' \
  -d '{
  "eventUUID": "9b4b3e4e-2162-4ae6-8986-91ee84644262",
  "user": {
    "externalUserID": "19443",
    "externalUserEmail": "example@ab180.co",
    "externalUserPhone": "821012341234"
  },
  "browser": {
    "clientID": "05609013-bb5a-4594-bbc3-832cb1b87072",
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E302"
  },
  "eventData": {
    "shortID": "aef04",
    "trackingData": {
      "channel": "blog"
    },
    "goal": {
      "category": "airbridge.ecommerce.product.addedToCart",
      "value": 159990,
      "semanticAttributes": {
        "action": "shoes",
        "label": "nike",
        "query": "나이키",
        "transactionID": "12939172",
        "inAppPurchased": true,
        "currency": "KRW",
        "products": [
          {
            "position": "1",
            "productID": "30372425",
            "name": "나이키 커스텀",
            "price": 10990,
            "quantity": 1,
            "currency": "KRW"
          }
        ]
      }
    }
  }
}'

Response

200

400

Invalid requests (timestamp, sdk signature, app name, etc.).

401

When using an invalid authentication token.

{
  "at": "2020-02-06 16:06:49",
  "data": "Event(9320) is successfully proccessed."
}

{
  "at": "2020-02-06 16:06:49",
  "error": "invalid_request",
  "ingested": 0
}

{
  "at": "2020-02-06 16:06:49",
  "error": "unauthorized",
  "ingested": 0
}

API Reference

Tracking Link

Server-to-Server Event

Actuals Report

Revenue Report

Active Users Report

Retention Report

Raw Data

Attribution Result

Self-Serve Data Upload

SKAdNetwork Configuration API

User Identifiers

2. User ID(`user.externalUserID`)

Try API Request

Request

Headers

Path Params

Body Params

Response

200

400

401

​User Identifiers

​1. Cookie ID(browser.clientID)

​2. User ID(user.externalUserID)

Try API Request

​Request

​Headers

​Path Params

​Body Params

​Response

​200

​400

​401

User Identifiers

1. Cookie ID(`browser.clientID`)

2. User ID(`user.externalUserID`)

Request

Headers

Path Params

Body Params

Response

200

400

401