User GuideDeveloper GuideAPI
Dashboard

    Tracking Link

    An Airbridge tracking link is an all-in-one link that serves as both a linking tool to redirect users and a tracking tool for attribution.

    When they are clicked on, tracking links enable users to reach their desired destination in the app regardless of the platform, channel, or device operating system. It also helps to analyze and attribute the source of user conversions such as link click, post-click install, and post-install purchase.

    It is advised to use the "Tracking link API token" when creating tracking links from the client server.

    POST

    https://api.airbridge.io/v1/tracking-links

    Request to create Tracking Link.

    rate limit : 50 tracking link per second

    Accept-Language
    string

    可以指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。参阅 密钥的生成及查询方法 来获取该键值。

    Body Params

    channel
    Requiredstring
    campaignParams
    object
    isReengagement
    enum
    ENUM VALUES
    OFF

    OFF is the default setting. The touchpoint can be attributed to both install events and post-install events (in-app events).

    ON-TRUE

    ON-TRUE is used for re-engagement campaigns for installed users. The touchpoint generated by the tracking link is attributed only to the deeplink open and the following in-app events, not to the install event.

    ON-FALSE

    ON-FALSE is used for user acquisition campaigns targeting uninstalled users. The touchpoint generated by the tracking link is attributed only to the install event and the following in-app events, not to the 'deeplink open' event.

    deeplinkUrl
    stringnullable
    deeplinkOption
    object
    fallbackPaths
    object
    ogTag
    object
    customShortId
    string
    Request
    12345
    curl -X POST 'https://api.airbridge.io/v1/tracking-links' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -d '{"channel":"my-channel","campaignParams":{"campaign":"2022_FW_Sale_Festival","ad_group":"UA","ad_creative":"Coat_840x600"},"isReengagement":"ON-TRUE","deeplinkOption":{"showAlertForInitialDeeplinkingIssue":true},"fallbackPaths":{"option":{"iosCustomProductPageId":"5ae82ffe-1f08-428d-b352-ac1c3a22aa1e","googlePlayCustomStoreListing":"custom-store-listing"}},"ogTag":{"title":"30% Off Winter Apparel for 3 Days Only","description":"Get great deals on apparel to keep you warm this winter","imageUrl":"https://static.airbridge.io/images/2021_airbridge_og_tag.png"}}'
    Payload
    1234567891011121314151617181920212223
    {
  "channel": "my-channel",
  "campaignParams": {
    "campaign": "2022_FW_Sale_Festival",
    "ad_group": "UA",
    "ad_creative": "Coat_840x600"
  },
  "isReengagement": "ON-TRUE",
  "deeplinkOption": {
    "showAlertForInitialDeeplinkingIssue": true
  },
  "fallbackPaths": {
    "option": {
      "iosCustomProductPageId": "5ae82ffe-1f08-428d-b352-ac1c3a22aa1e",
      "googlePlayCustomStoreListing": "custom-store-listing"
    }
  },
  "ogTag": {
    "title": "30% Off Winter Apparel for 3 Days Only",
    "description": "Get great deals on apparel to keep you warm this winter",
    "imageUrl": "https://static.airbridge.io/images/2021_airbridge_og_tag.png"
  }
}

    200SUCCESS

    Tracking Link was successfully created.

     Parameter

    Description

    trackingLink.id

    The ID of Tracking Link.

    trackingLink.channelType

    The channel type of Tracking Link.

    trackingLink.link.impression

    The Tracking Link generate impression event

    trackingLink.link.click

    The Tracking Link generate click event.

    trackingLink.link.serverToServerClick

    The Tracking Link generate S2S event.

    trackingLink.shortId

    The short ID of Tracking Link.

    trackingLink.shortUrl

    The short link of Tracking Link.

    trackingLink.trackingTemplateId

    The template ID of Tracking Link.

    404ERROR

    There is no such app. Please check the request token again.

    422ERROR

    There are some invalid values in request.

    429ERROR

    rate limit exceeded

    Response
    12345678910111213141516
    {
  "data": {
    "trackingLink": {
      "id": 10000,
      "link": {
        "click": "http://abr.ge/@airbridge/my-channel?...",
        "impression": "http://abr.ge/@airbridge/my-channel?...",
        "serverToServerClick": null
      },
      "shortId": "6nwx4w",
      "shortUrl": "http://abr.ge/6nwx4w",
      "channelType": "custom",
      "trackingTemplateId": "706f9839a7b50d87ab917dbb1b9fa7f3"
    }
  }
}
    GET

    https://api.airbridge.io/v1/tracking-links/{id}

    Get the details of a tracking link.

    Accept-Language
    string

    可以指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。参阅 密钥的生成及查询方法 来获取该键值。

    id
    Requiredstring

    The ID of the Tracking Link.

    idType
    string
    Request
    1234
    curl -X GET 'https://api.airbridge.io/v1/tracking-links/10000?idType=id' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

    200SUCCESS

    400ERROR

    There is an error in the field provided, or there is no such resource.

    422ERROR

    A field is missing or has an error.

    Response
    123456789101112131415161718192021222324252627282930313233343536373839404142
    {
  "data": {
    "link": {
      "click": "https://go.ab180.co/@ablog/my-channel?...",
      "impression": null,
      "serverToServerClick": null
    },
    "email": "contact@ab180.co",
    "ogTag": {
      "title": "AB180",
      "imageUrl": "http://static.airbridge.io/images/og_tags/50ca2e8d-07b2-4a0e-8294-f00ddb8e59ae.png",
      "description": "Discovering Metrics That Matter!"
    },
    "company": null,
    "shortId": "ri4lnp",
    "shortUrl": "https://go.ab180.co/ri4lnp",
    "createdAt": "2023-01-01T00:00:00+09:00",
    "channelName": "my-channel",
    "channelType": "custom",
    "deeplinkUrl": null,
    "fallbackPaths": {
      "ios": "itunes-appstore",
      "option": {
        "iosCustomProductPageId": null
      },
      "android": "google-play",
      "desktop": "https://airbridge.io"
    },
    "campaignParams": {
      "term": null,
      "subId": null,
      "subId1": null,
      "subId2": null,
      "subId3": null,
      "adGroup": null,
      "content": null,
      "campaign": "my-campaign",
      "adCreative": null
    },
    "isReengagement": false
  }
}
    PATCH

    https://api.airbridge.io/v1/tracking-links/{id}/og-tag

    Update the Open Graph of the tracking link.

    Accept-Language
    string

    可以指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。参阅 密钥的生成及查询方法 来获取该键值。

    id
    Requiredstring

    The ID of the Tracking Link.

    Body Params

    idType
    string
    title
    Requiredstring
    description
    Requiredstring
    imageUrl
    Requiredstring
    ogTag.websiteCrawl
    enum
    ENUM VALUES
    desktop

    The Open Graph of the desktop fallbackPath is crawled and used. The values set for title, description, and imageUrl will be ignored.

    Request
    12345
    curl -X PATCH 'https://api.airbridge.io/v1/tracking-links/10000/og-tag' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -d '{"idType":"id","title":"30% Off Winter Apparel for 3 Days Only","description":"Get great deals on apparel to keep you warm this winter","imageUrl":"https://static.airbridge.io/images/2021_airbridge_og_tag.png"}'
    Payload
    123456
    {
  "idType": "id",
  "title": "30% Off Winter Apparel for 3 Days Only",
  "description": "Get great deals on apparel to keep you warm this winter",
  "imageUrl": "https://static.airbridge.io/images/2021_airbridge_og_tag.png"
}

    200SUCCESS

    400ERROR

    The image URL used an incorrect URL type.

    404ERROR

    There is an error in the field provided, or there is no such resource.

    Response
    1
    {}
    PATCH

    https://api.airbridge.io/v1/tracking-links/{id}/routing

    Update the destination and fallback path for the Tracking Link.

    Accept-Language
    string

    可以指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。参阅 密钥的生成及查询方法 来获取该键值。

    id
    Requiredstring

    The ID of the Tracking Link.

    Body Params

    idType
    string
    deeplinkUrl
    stringnullable
    deeplinkOption
    objectnullable
    fallbackPaths
    object
    Request
    12345
    curl -X PATCH 'https://api.airbridge.io/v1/tracking-links/10000/routing' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}' \
  -d '{"idType":"id","deeplinkOption":{"showAlertForInitialDeeplinkingIssue":true}}'
    Payload
    123456
    {
  "idType": "id",
  "deeplinkOption": {
    "showAlertForInitialDeeplinkingIssue": true
  }
}

    200SUCCESS

    404ERROR

    There is an error in the field provided, or there is no such resource.

    Response
    1
    {}
    GET

    https://api.airbridge.io/v1/tracking-links

    Get a list of the Tracking Links.

    Accept-Language
    string

    可以指定用于 API 请求和结果返回的语言。遵守 ISO-639-1 格式。

    Content-Type
    string

    表示资源的媒体类型。默认使用 application/json。

    Authorization
    string

    用于 API 请求的键值。参阅 密钥的生成及查询方法 来获取该键值。

    from
    Requiredstring

    The start date for tracking link list query.

    to
    Requiredstring

    The end date for tracking list query.

    skip
    number

    The number of items to skip.

    size
    number

    The number of items to retrieve.

    Note that up to 500 can be set.

    keyword
    string

    The keyword to search for.

    channel_name
    string

    Filter channel.

    sort_key
    enum

    Sort standard. The default is createdAt

    ENUM VALUES
    createdAt

    Sort by created at.

    sort_type
    enum

    Sort by. (Default: DESC)

    ENUM VALUES
    DESC

    Descending.

    ASC

    Ascending.

    Request
    1234
    curl -X GET 'https://api.airbridge.io/v1/tracking-links?from=2023-04-01&to=2023-04-02&skip=0&size=10&sort_key=createdAt&sort_type=DESC' \
  -H 'Accept-Language: ko' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

    200SUCCESS

    400ERROR

    The field contains an error or is incorrectly formatted.

    Response
    12345678910111213
    {
  "data": {
    "totalCount": 2,
    "trackingLinks": [
      {
        "id": 10001
      },
      {
        "id": 10002
      }
    ]
  }
}

    Was this page helpful?

    Have any questions or suggestions?