유저 가이드개발자 가이드API
대시보드

    Server To Server Event

    Server to Server 방식으로 인앱/인웹 이벤트를 전송할 수 있습니다.

    인웹 이벤트 전송하기

    POST

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

    Server To Server 방식으로 인웹 이벤트를 전송합니다.

    전송 방식

    웹 SDK의 Cookie ID를 기준으로 어트리뷰션이 필요한 경우 사용합니다. [데이터 패칭 가이드]

    2. User ID(user.externalUserID)를 기준으로 한 이벤트 전송.

    User ID를 기준으로 어트리뷰션이 필요한 경우 사용합니다. Airbridge는 내부 ID 테이블에 기존에 user.externalUserID와 매칭되어있는 clientID를 기준으로 어트리뷰션 합니다. User ID를 사용하여 매칭하는 경우 Client ID를 보내지 않아도 되며, 아래 필드는 선택적 파라미터가 됩니다.

    파라미터

    설명

    eventData.shortID

    어트리뷰션 캠페인 파라미터 ID

    eventData.trackingData.channel

    어트리뷰션 캠페인 채널

    eventData.trackingData.params

    어트리뷰션 캠페인 파라미터

    Request

    Headers

    Accept-Language
    string

    API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.

    Content-Type
    string

    리소스의 미디어 타입을 나타냅니다. 기본값으로 application/json을 사용합니다.

    Authorization
    string

    API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.

    X-Forwarded-For
    필수string

    사용자의 IP를 X-Forwarded-For 헤더로 보낼 수 있습니다. X-Forwarded-For가 없는 경우 사용자의 IP(클라이언트 요청 IP)가 아닌 Server To Server API를 요청한 서버의 IP로 사용자 행동이 기록됩니다.

    ipv4(123.123.123.123), ipv6(2001:e60:87e3:81d4:cd57:5d52:ee2e:ff8d) 형태의 값을 받습니다.

    Path Params

    app_name
    필수string

    에어브릿지 앱 이름(App Name)

    Body Params

    eventUUID
    string

    고유 이벤트 ID.

    uuid4 포맷의 event uuid는 이벤트 고유 ID로 Deduplication에 사용되며, 넣지 않으면 event api에서 자동 생성하게 됩니다.

    eventTimestamp
    number

    이벤트 발생 시간.

    Millisecond 단위의 Unix Timestamp입니다. (Unixtime 기준 13자리)

    eventTimestamp가 이벤트 전송 시점 기준으로 24시간을 지나면 서버에서 처리하지 않습니다. 전송 시점 기준 24시간 이내의 timestamp를 사용해주세요.

    user
    object

    유저에 관한 정보를 담을 수 있습니다.

    browser
    object

    브라우저 정보를 담을 수 있습니다.

    eventData
    object

    에어브릿지에 전송할 이벤트를 정의하는 객체입니다.

    Request
    123456
    curl -X POST 'https://api.airbridge.io/events/v1/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":"add-to-cart","action":"shoes","label":"nike","semanticAttributes":{"query":"나이키","productListID":"list-id-1","cartID":"cart-id-1","transactionID":"12939172","inAppPurchased":true,"products":[{"position":"1","productID":"30372425","name":"나이키 커스텀","price":1000,"quantity":"1","currency":"KRW"}]}}}}'
    Payload
    12345678910111213141516171819202122232425262728293031323334353637383940
    {
  "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": "add-to-cart",
      "action": "shoes",
      "label": "nike",
      "semanticAttributes": {
        "query": "나이키",
        "productListID": "list-id-1",
        "cartID": "cart-id-1",
        "transactionID": "12939172",
        "inAppPurchased": true,
        "products": [
          {
            "position": "1",
            "productID": "30372425",
            "name": "나이키 커스텀",
            "price": 1000,
            "quantity": "1",
            "currency": "KRW"
          }
        ]
      }
    }
  }
}

    Response

    200SUCCESS

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

    인앱 이벤트 전송하기

    POST

    https://api.airbridge.io/events/v1/apps/{app_name}/mobile-app/9360

    Server To Server 방식으로 인앱 이벤트를 전송할 수 있습니다.

    전송 방식

    1. Device ID(device.deviceUUID)를 기준으로 한 이벤트 전송.

    SDK의 Device ID를 기준으로 어트리뷰션이 필요한 경우 사용합니다. [데이터 패칭 가이드]

    2. User ID(user.externalUserID)를 기준으로 한 이벤트 전송.

    User ID를 기준으로 어트리뷰션이 필요한 경우 사용합니다. Airbridge는 내부 ID 테이블에 기존에 user.externalUserID와 매칭되어있는 Device를 기준으로 어트리뷰션 합니다. User ID를 사용하여 매칭을 하는 경우 Device ID를 보내지 않아도 되며, User ID와 매칭된 디바이스가 없을 경우 해당 이벤트는 처리되지 않습니다.

    Request

    Headers

    Accept-Language
    string

    API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.

    Content-Type
    string

    리소스의 미디어 타입을 나타냅니다. 기본값으로 application/json을 사용합니다.

    Authorization
    string

    API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.

    X-Forwarded-For
    필수string

    사용자의 IP를 X-Forwarded-For 헤더로 보낼 수 있습니다. X-Forwarded-For가 없는 경우 사용자의 IP(클라이언트 요청 IP)가 아닌 Server To Server API를 요청한 서버의 IP로 사용자 행동이 기록됩니다.

    ipv4(123.123.123.123), ipv6(2001:e60:87e3:81d4:cd57:5d52:ee2e:ff8d) 형태의 값을 받습니다.

    Path Params

    app_name
    필수string

    에어브릿지 앱 이름(App Name)

    Body Params

    eventUUID
    string

    고유 이벤트 ID.

    uuid4 포맷의 event uuid는 이벤트 고유 ID로 Deduplication에 사용되며, 넣지 않으면 event api에서 자동 생성하게 됩니다.

    eventTimestamp
    number

    이벤트 발생 시간.

    Millisecond 단위의 Unix Timestamp입니다. (Unixtime 기준 13자리)

    eventTimestamp가 이벤트 전송 시점 기준으로 24시간을 지나면 서버에서 처리하지 않습니다. 전송 시점 기준 24시간 이내의 timestamp를 사용해주세요.

    user
    object

    유저에 관한 정보를 담을 수 있습니다.

    device
    object

    디바이스 정보를 담습니다.

    app
    필수object

    사용자의 앱 정보를 담습니다.

    eventData
    object

    에어브릿지에 전송할 이벤트를 정의하는 객체입니다.

    Request
    123456
    curl -X POST 'https://api.airbridge.io/events/v1/apps/{app_name}/mobile-app/9360' \
  -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"},"device":{"deviceUUID":"2dfca632-86f3-4d22-9746-cdfe7985c471","gaid":"2dfca632-86f3-4d22-9746-cdfe7985c471","ifa":"542177F1-5C23-438B-8088-82D34C94F6D7","ifv":"37EEC3E0-BF15-412E-ADBA-7D2E82E7A75F","deviceModel":"LG-H542","deviceIdentifier":"iPhone11,2","manufacturer":"Samsung","osName":"Android","osVersion":"5.0.2","locale":"ko-KR","timezone":"Asia/Seoul","orientation":"portrait","screen":{"width":123},"location":{"latitude":120.103,"speed":"12"},"network":{"carrier":"SKTelecom","cellular":true,"wifi":true}},"app":{"packageName":"com.ab180.co","version":"1.2.3"},"eventData":{"goal":{"category":"add-to-cart","action":"shoes","label":"nike","semanticAttributes":{"productListID":"list-id-1","cartID":"cart-id-1","transactionID":"12939172","inAppPurchased":true,"products":[{"position":"1","productID":"30372425","name":"나이키 커스텀","price":1000,"quantity":"1","currency":"KRW"}]}}}}'
    Payload
    12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
    {
  "eventUUID": "9b4b3e4e-2162-4ae6-8986-91ee84644262",
  "user": {
    "externalUserID": "19443",
    "externalUserEmail": "example@ab180.co",
    "externalUserPhone": "821012341234"
  },
  "device": {
    "deviceUUID": "2dfca632-86f3-4d22-9746-cdfe7985c471",
    "gaid": "2dfca632-86f3-4d22-9746-cdfe7985c471",
    "ifa": "542177F1-5C23-438B-8088-82D34C94F6D7",
    "ifv": "37EEC3E0-BF15-412E-ADBA-7D2E82E7A75F",
    "deviceModel": "LG-H542",
    "deviceIdentifier": "iPhone11,2",
    "manufacturer": "Samsung",
    "osName": "Android",
    "osVersion": "5.0.2",
    "locale": "ko-KR",
    "timezone": "Asia/Seoul",
    "orientation": "portrait",
    "screen": {
      "width": 123
    },
    "location": {
      "latitude": 120.103,
      "speed": "12"
    },
    "network": {
      "carrier": "SKTelecom",
      "cellular": true,
      "wifi": true
    }
  },
  "app": {
    "packageName": "com.ab180.co",
    "version": "1.2.3"
  },
  "eventData": {
    "goal": {
      "category": "add-to-cart",
      "action": "shoes",
      "label": "nike",
      "semanticAttributes": {
        "productListID": "list-id-1",
        "cartID": "cart-id-1",
        "transactionID": "12939172",
        "inAppPurchased": true,
        "products": [
          {
            "position": "1",
            "productID": "30372425",
            "name": "나이키 커스텀",
            "price": 1000,
            "quantity": "1",
            "currency": "KRW"
          }
        ]
      }
    }
  }
}

    Response

    200SUCCESS

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

    도움이 되었나요?

    더 필요한 내용이 있나요?