광고 성과 확인에 꼭 필요한 5~15개의 주요 이벤트만 수집하는 편입니다. 이벤트를 많이 수집할수록 관리 리소스가 드므로, 광고 성과 확인에 꼭 필요한 이벤트만 선별하여 수집하는 것이 좋습니다.

SDK를 통해 이벤트를 수집한다면 자동으로 수집되는 기기 정보가 있습니다.

• 에어브릿지가 국가 코드(Country Code), 앱 버전(App Version) 등 일부 정보를 자동으로 수집하여 광고 사기 검증 규칙 설정 등에 유용하게 사용됩니다. (▶ 에어브릿지 SDK에서 자동으로 수집하는 데이터)

위 사항에 해당하지 않는 이벤트는 에어브릿지의 Server To Server Event API를 통해 전송할 수 있습니다. API를 사용할 경우 다음 사항을 고려해야 합니다:

• Server To Server Event API는 device ID (웹의 경우 cookie ID) 또는 User ID를 식별자로 사용합니다. Airbridge SDK에서 Device ID를 획득하여 저장한 후, API에 전송하거나, Airbridge SDK에서 사용자 식별자를 설정하여 API로 전송한 이벤트와 SDK 이벤트가 User ID로 매칭되도록 해야 합니다.

• eventTimestamp는 이벤트 전송 시점 기준으로 24시간 이내여야 하며, 24시간 이상 차이나는 경우 에어브릿지 서버에서 이벤트를 처리하지 않습니다. 전송 시점 기준 24시간 이내의 eventTimestamp를 사용해 주세요.

• 원활한 포스트백을 위해 device 하위의 osName과 osVersion을 함께 전송해 주세요.

자세한 API 리퀘스트 및 제한사항은 아래 API 가이드를 참고해주세요.

▶ Server To Server Event API 가이드

'광고 노출 (adImpression)' 이벤트는 앱 내 광고 지면에서 유저가 광고를 봤는지를 트래킹하는 이벤트입니다. 예를 들어, 모바일 앱에서 광고로 수익을 창출하는 게임사는 유저가 앱 내 광고를 보면 아이템을 지급하는 광고 지면을 갖고 있을 수 있습니다. 이 경우, 유저가 앱 내 광고를 본 시점에 광고 노출 이벤트를 수집합니다. 만약, 구글 애드몹, 앱러빈 맥스, 유니티 레벨플레이와 같은 광고 미디에이션 플랫폼을 사용하고 있다면 아래 가이드에서 예시 코드를 확인해주세요.

▶ 미디에이션 플랫폼 연동하기

서비스 외부 지면에서 발생하는 광고 노출과 클릭 데이터는 트래킹 링크를 통해 혹은 광고 채널 연동이 완료되면 수집됩니다. 이 데이터는 대시보드에서 'Impressions', 'Clicks'로 확인할 수 있으며, 별도로 앱 내에서 이벤트를 추가로 수집할 필요는 없습니다.

에어브릿지가 매체로 포스트백하는 기준은 '이벤트'입니다. 매체에 포스트백해야 하는 정보는 이벤트로 수집해 주세요.

예시:

• 게임에서 레벨 10을 달성했을 때 포스트백을 진행할 겁니다.

  • 'achieve_level_10'과 같은 커스텀 이벤트를 수집하세요.

• 첫 구매 이벤트를 내부 기준에 맞춰 엄격하게 전송합니다.

  • 구매 완료 이벤트와 별도로 'order_complete_first'와 같은 커스텀 이벤트를 수집해 주세요.

시맨틱 어트리뷰트는 선택 사항으로, 광고 성과 분석에 필요한 경우에만 수집하시면 됩니다. 즉, 광고 성과를 확인하는 데 필요하지 않다면 수집하지 않아도 됩니다.

권장드리는 시맨틱 어트리뷰트 목록은 다음과 같습니다:

• 제품 관련 이벤트(예 'Add to Cart', 'Product View' 등)

  • currency, product ID, product name, price, quantity

• 구매 완료와 구매 취소 이벤트

  • currency, transactionID, product ID, product name, price, quantity

• 광고 노출 이벤트

  • currency