모바일용 서버-투-서버 이벤트 API (S2S-mobile)

앱스플라이어가 S2S 인앱 이벤트를 처리할 때, 앱스플라이어 ID를 사용하여 어트리뷰션 필드가 채워지고, 이를 통해 인앱 이벤트 이전에 발생한 관련 인스톨 이벤트를 식별합니다.

즉, 앱스플라이어가 논오가닉 S2S 인앱 이벤트와 연관시키는 일부 데이터는 오가닉 S2S 인앱 이벤트와는 연관되지 않습니다.

매개변수를 채우기 위한 값을 얻으려면 백엔드 로직이 필요합니다. 여기서는 앱스플라이어 ID를 얻는 방법을 설명합니다.

• 앱스플라이어 ID는 필수 요소이며 이벤트를 귀속하는 데 사용됩니다.
• 사용자가 모바일 앱을 처음 인스톨 할 때 발생합니다.
• CUID를 앱에 설정하여 귀사의 CUID를 앱스플라이어 ID에 매핑해야 합니다. 

각 사용자가 어떤 이벤트를 수행했는지 더 쉽게 파악할 수 있도록 다음과 같은 흐름을 구현하세요:

• 사용자가 앱을 인스톨 할 때 고객 유저 ID를 설정하세요.
• 앱스플라이어 로데이터 리포트에는 CUID와 앱스플라이어 ID가 포함됩니다. 이를 얻으려면 데이터 전달 도구 중 하나나 앱스플라이어 Push API를 사용하세요. 
• 로데이터 리포트를 사용하여 CUID와 앱스플라이어 ID를 매칭시키세요. 
• 앱스플라이어 ID는 귀하의 앱에 통합된 SDK에서 사용할 수 있습니다 (안드로이드/iOS).
• 내부 시스템에서 앱스플라이어 ID를 고객 유저 ID에 매핑하세요 (향후 사용을 위해 중요).

앱스플라이어 ID를 귀사의 CUID와 매핑하면 사용자를 수행한 이벤트와 매칭할 수 있습니다. 그런 다음 이벤트 값, 이벤트 통화, 이벤트 시간 등 다른 값을 얻어서 서버-투-서버 인앱 이벤트를 발송할 수 있습니다.

appsflyer_id은 서버-투-서버 이벤트 메시지의 필수 매개변수입니다. 앱스플라이어는 이 매개변수를 사용하여 이벤트를 원래 디바이스와 어트리뷰션된 미디어 소스에 귀속시킵니다. 다음 방법 중 하나를 사용하여 ID를 얻을 수 있습니다:

• 모바일 디바이스에서 앱스플라이어 SDK API를 호출하여:
  안드로이드 네이티브iOS 네이티브유니티리액트 네이티브

  getAppsFlyerUID

  getAppsFlyerUID

  getAppsFlyerId

  getAppsFlyerUID

• 앱스플라이어 플랫폼에서 다음 중 하나를 사용하여: Pull API, Push API, 로데이터 내보내기 설치

alt타임스탬핑 로직 다이어그램alt

S2S 이벤트가 앱스플라이어에 대량으로 도달하면 eventTime 속성 값과 도착 시간에 맞추어 타임스탬프가 찍힙니다. eventTime 속성은 인앱 이벤트의 발생 시간을 나타냅니다.

도착 시, 이벤트는 다음과 같이 타임스탬프가 지정됩니다:

• 이벤트 기록에 eventTime 매개변수가 포함되어 있지 않으면, 이벤트 시간은 HTTP 메시지 도착 시간으로 설정됩니다.
• 02:00 UTC 이전에 도착한 이벤트는 eventTime 값으로 타임스탬프가 찍힙니다. 즉, 이벤트에 eventTime이 타임스탬프 찍히려면 그날이나 다음 날 02:00 UTC까지 보고되어야 합니다.
• 전날 또는 그 이전에 발생하고 02:00 UTC 이후에 도착한 이벤트는 도착 시간(즉, API 호출 시간)으로 타임스탬프가 찍힙니다.
• 미래 eventTime 값으로 도착하는 이벤트(eventTime > 도착 시간):
  • 보고된 eventTime과 도착 시간이 같은 날짜이면, 이벤트는 eventTime 값으로 타임스탬프가 찍힙니다.
  • 보고된 eventTime이 다음 날짜이면, 이벤트는 도착 시간으로 타임스탬프를 찍습니다.
• eventTime 값이 잘못된 이벤트는 HTTP 메시지 도착 시간으로 타임스탬프가 찍힙니다.

예시

• eventTime = 월요일 21:00으로 이벤트가 전송되었습니다.

수익 값이 음수인 이벤트도 전송 가능합니다. 예를 들어, 구매가 취소된 경우입니다. af_revenue 매개변수는 이를 기록하기 위해 음수 값을 가질 수 있습니다. 

af_quantity을 채울 때 귀사의 시스템 로직에 따라 음수 값으로 채울 수 있습니다. 앱스플라이어는 af_quantity을 사용하지 않습니다.

• 엔드포인트: 사용된 엔드포인트가 올바른지 확인하세요.
• 페이로드에 필수 파라미터가 포함되어 있는지 확인하세요. 여기를 참조하세요.
• 이벤트를 발생시키는 앱스플라이어 ID가 실제 appsflyer_id이며 실제 앱 설치와 관련이 있는지 확인하세요. 여기를 참조하세요.
• S2S 이벤트는 하나의 S2S 요청에서 멀티이벤트를 지원하지 않습니다. 각 이벤트는 별도의 이벤트로 발송해야 합니다.
  • 응답 시간을 단축하기 위해 비동기 메서드로 이벤트를 발송할 수 있습니다.
• 개요 대시보드에서 날짜 범위는 이벤트 날짜가 아닌 인스톨 날짜(LTV(유저생애가치))와 관련이 있습니다.
  • 올바른 날짜 범위를 선택했는지 확인하세요.
  • 대시보드의 날짜 범위가 이벤트 날짜가 아닌 디바이스의 인스톨 날짜(appsflyer_id)에 맞게 설정되었는지 확인하세요.
• 이벤트 로데이터 리포트: 날짜 범위는 인스톨 날짜가 아닌 이벤트 날짜와 관련이 있습니다. 

S2S 이벤트를 발송했지만 수익이 기록되지 않는 경우, 발송한 JSON이 문자열화되었는지 확인하세요. 가장 중요한 부분은 JSON의 이벤트 값 파라미터입니다. 다음 예와 같이 문자열로 변환해야 합니다.

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

문자열화되지 않으면 이벤트 값이 올바르게 처리되지 않고 수익이 기록되지 않습니다.

수익 값은 어떤 형식으로도 변환되지 않아야 합니다. 소수점을 포함할 수 있습니다. 통화 기호나 코드, , 구분 기호를 포함하지 마십시오. 수익은 -로 접두사를 붙일 수 있습니다.

• 유효한 값의 예는 다음과 같습니다: 123, -123.45, 123.456 
• 잘못된 값의 예: 1,234.56, 1,234

로데이터 필드는 S2S 호출에서 전송된 값으로만 채워집니다(인스톨 이벤트에서 생성된 값으로 채워질 수 있는 포스트백 필드와는 다릅니다).

다음 필드는 S2S API로 보고할 수 없으며, 따라서 로데이터 리포트의 S2S 이벤트에서는 채워지지 않습니다:

• WIFI
• 오퍼레이터
• 언어
• 디바이스 모델
• 디바이스 카테고리
• 앱 버전: app_version_name을 사용할 수 있습니다
• 앱 이름
• 유저 에이전트

S2S 이벤트, 예를 들면 로그인 이벤트,는 앱이 설치되고 SDK가 시작될 때 앱스플라이어로 전송될 수 있습니다. 그러나 이러한 S2S 인앱 이벤트가 앱스플라이어가 인스톨 이벤트를 처리 완료하기 전에 도착하면, 일반적으로 20~30초 이상 필요하면, 속성이 지정되지 않은 오가닉 이벤트로 표시될 수 있습니다.

인스톨 직후 발생하는 S2S 인앱 이벤트를 서버에 리포팅하기 전에 잠시 지연시키는 것을 권장합니다.