서버 간 모바일 이벤트 연동 API (모바일 S2S)

• 페이로드(payload) 파라미터는 하나 혹은 하나 이상의 디바이스 ID(OS에 따라 다름)로 구성됩니다.
• 디바이스 ID를 전송할 수 없다면?
  • 사용자가 광고 추적 제한(LAT, Limited Ad Tracking) 기능을 켜거나, iOS14를 사용하고 앱 추적 투명성(ATT, App Tracking Transparency)에서 IDFA 사용에 동의하지 않는 경우와 같이 통제할 수 없는 이유로 기기 ID를 전송할 수 없을 수도 있습니다. IDFV를 사용할 수 있으면 전송합니다. 
  • 광고 ID/기기 식별자를 전송하지 않으면 다음이 발생할 수 있습니다.
    • 포스트백 문제: 미디어 소스는 장치 식별자가 없는 포스트백을 수신하며, 따라서 미디어 소스에서는 이를 사용자와 연결할 수 없습니다. 
    • 잠재 고객 분할 및 규칙 실패. 잠재 고객 규칙 집합은 식별자를 필요로 합니다. 규칙 집합에서 사용하는 ID 유형에 따라 기기 ID 또는 고객 사용자 ID를 보냅니다.

"custom_data" : {"key_group" : { 
"key_a1" : "value a1", 
"key_a2" : "value a2" 
},
"key_b" : "value b"
}

curl --location --request POST 'https://api2.appsflyer.com/inappevent/<app_id_placeholder>' \
--header 'authentication: <dev_key_placeholder>
' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appsflyer_id": "9999999999999-9999999999999999999",
	"advertising_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
	"customer_user_id" : "example_customer_id_123",
	"ip": "199.0.2.1",
	"app_version_name" : "example_version_name",
	"eventTime" : "2020-02-25 12:00.000",
	"eventName": "af_purchase",
	"eventCurrency": "ZAR",
        "os" : "14.6",
        "att" : 3,
	"eventValue": 
	"{
		\"af_revenue\": \"1006\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }"
}
'

유의사항

• 테스트를 할 때, 논오가닉 인스톨의 앱스플라이어 ID를 사용하여 테스트 이벤트 어트리뷰션이 실시간으로 이루어지도록 하십시오. 오가닉 이벤트 어트리뷰션은 몇 시간 지연됩니다.
• 일부 이벤트 필드는 해당 앱 유저의 인스톨 어트리뷰션 이벤트를 이용하여 자동 생성됩니다. 예: 인스톨 시간, 미디어 소스 

테스트 기기로 논오가닉 인스톨 어트리뷰션하기

1. S2S 메시지를 테스트하기 위한 사용자정의 어트리뷰션 링크를 준비합니다. 링크의 미디어 소스 파라미터를 s2s_test로 설정하고 링크의 광고 ID(GAID, IDFA, 등)를 어트리뷰션 링크 스니펫 예제에 보여준 바와 같이 설정합니다. 
2. 테스트 기기를 등록합니다.
3. 테스트할 앱을 테스트 기기에서 삭제합니다.
4. 어트리뷰션 링크를 테스트 기기에 보냅니다.
5. 그 링크를 클릭합니다.
6. 앱을 설치하고 실행합니다.
7. 앱스플라이어 대시보드에서 인스톨이 어트리뷰션되었는지 확인합니다.
8. S2S 메시지에 사용할 앱스플라이어 ID를 가져옵니다.

S2S 테스트 메시지 전송하기

1. 할당된 앱스플라이어 ID를 이용하여 S2S 메시지를 준비합니다. 아래 S2S 메시지 전송 코드 예시를 참고하십시오.
2. 메시지를 전송합니다.
3. 다음 방식 중 하나로 발송된 메시지가 앱스플라이어에 어떻게 기록되는지 확인합니다.
   • 인앱 이벤트 로데이터 리포트를 다운로드합니다.이벤트 전송 후에 로데이터 보고서에 표시될 때까지 15분 정도 걸립니다. 
   • 푸시 API ( Postman과 Webhook 사이트와 같은 툴 사용을 고려하십시오.)
4. 다음 항목을 확인합니다.
   • S2S 메시지로 전송된 값이 리포트에 올바르게 생성되었는지 확인합니다. Event date, Event currency, Event revenue그리고 Event value 필드를 특히 주의해서 확인합니다.
   • 어트리뷰션 소스와 인스톨 시간은 앱스플라이어에서 자동으로 생성됩니다.
   • SDK 버전 같이 SDK가 제공하는 값은 표시되지 않습니다.

Android

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&advertising_id=<GAID>

iOS

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&idfa=<IDFA>

• 광고 ID/디바이스 ID는 페이스북과 구글 애즈 같은 SRN(Self Reporting Network)에 포스트백을 전송하기 위한 필수 요소입니다. 이 ID를 보낼 수 없으면, 포스트백을 전송할 수 없는 점을 고려하십시오.
• 앱스플라이어 ID만 전송하더라도, 인앱 이벤트가 기록되며 정확히 어트리뷰션됩니다.

앱스플라이어에서 S2S 인앱 이벤트를 처리할 때, 앱스플라이어 ID를 이용하여 어트리뷰션 필드 값이 자동으로 채워져, 입앱 이벤트 이전에 발생한 연관 인스톨을 확인합니다.

이는 논오가닉 S2S 인앱 이벤트 어트리뷰션에 사용되는 일부 데이터는 오가닉 S2S 인앱 이벤트 어트리뷰션에 사용되지 않음을 의미합니다.

파라미터 값을 얻는 백엔드 로직이 필요합니다. 앱스플라이어 ID를 얻는 방법은 다음과 같습니다.

• 앱스플라이어 ID는 필수이며, 이벤트를 어트리뷰션 하기 위해 사용됩니다.
• 앲스플라이어 ID는 앱 사용자가 모바일 앱을 처음 설치할 때 발급됩니다.
• 귀사의 CUID를 앱스플라이어 ID와 매핑하기 위해서는 CUID를 해당 앱에 설정해야 합니다. 

어떤 사용자가 어떤 이벤트를 수행했는지 간단히 파악하기 위해, 아래 순서대로 매핑 작업을 완료하십시오.

• 앱을 설치한 사용자에 대해 CUID(Customer User ID)를 설정하십시오.
• 앱스플라이어 로데이터 리포트에는 CUID와 앱스플라이어 ID가 모두 표시됩니다. 로데이터 리포트를 받으려면 데이터 전송 툴이나 앱스플라이어 Push API를 사용하십시오. 
• 로데이터 리포트를 이용하여 CUID와 앱스플라이어 ID를 매칭하십시오. 
• 앱스플라이어 ID는 (안드로이드/iOS) 앱에 연동된 SDK에서 확인할 수 있습니다.
• 귀사의 내부 시스템에서 앱스플라이어 ID를 CUID와 매핑하십시오. (추후 사용을 위해 중요)

앱스플라이어 ID와 CUID를 매핑하면, 사용자를 사용자가 수행한 이벤트와 매칭할 수 있습니다. 그리고 다른 값(event value, event currency, event time 등)을 가져온 다음, 서버 간 연동된 인앱 이벤트를 전송합니다. 

{
  "appsflyer_id": "1415211453000-6513894",
	"advertising_id": "38412345-8cf0-aa78-b23e-10b96e40000d",
	"eventName": "af_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"6\",
                \"af_currency\" \"USD"\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	"ip": "1.2.3.4",
	"eventTime": "2014-05-15 12:17:00.000"
}

appsflyer_id는 서버간 이벤트 메시지에서 필수 파라미터 입니다. 앱스플라이어는 이 파라미터를 이용하여 발생 이벤트에 대해 원래 기기와 어트리뷰션한 미디어 소스의 성과를 측정합니다. 앱스플라이어 ID 확인 방법:

• 앱스플라이어 SDK API를 호출하여 모바일 기기에서 확인:안드로이드, iOS.
• 앱스플라이어 플랫폼 대시보드 메뉴: Pull API, Push API,  로데이터 내려받기

수익(revenue) 값이 음수인 이벤트가 전송될 수 있습니다. 예를 들어, 구매가 취소되었습니다. af_revenue 파라미터는 구매 취소를 기록하기 위해 마이너스 값을 가질 수 있습니다. 

af_quantity를 사용하는 경우, 귀사의 시스템 로직에 따라 마이너스 값을 표기할 수 있습니다. 앱스플라이어는 af_quantity를 사용하지 않습니다.

마이너스 수익 예시

{
	"eventName": "cancel_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"-6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	
}

• 엔드포인트: 엔드포인트 설정이 올바른지 확인하십시오.
• 페이로드(payload)에 필수 파라미터가 포함되어 있는지 확인하십시오. 여기를 참조하세요.
• 이벤트를 발송하기 위해 사용하는 앱스플라이어 ID가 실제 appsflyer_id이며 특정 앱에 실제로 설치되었는지 확인하십시오. 테스트 ID는 이 문서에 제공되지 않습니다. 여기를 참조하세요.
• 한 S2S 요청(request)에서 복수의 이벤트를 지원하지 않습니다. 각 이벤트는 한 요청에 한 개씩 전송되어야 합니다. 
• 개요 대시보드에 표시된 기간은 앱 인스톨 일자(LTV) 기준이며 이벤트 발생일과는 관련이 없습니다.
  • 기간(날짜 기준)을 올바르게 선택했는지 확인하십시오.
  • 대시보드의 기간이 이벤트 발생일자가 아니라 기기(appsflyer_id)의 앱 설치 날짜와 일치하는지 확인하십시오.
• 단, 이벤트 로데이터 리포트의 기간은 인스톨 발생일이 아니라 이벤트 발생일 기준입니다.  

S2S 이벤트를 전송했지만 수익이 기록되지 않았다면 전송한 JSON이 문자열(string)인지 확인하십시오. 가장 중요한 부분은 JSON 안에 있는 이벤트 값 파라미터입니다. 다음 예시와 같이 문자열(string) 형식이어야 합니다.

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

문자열로 되어 있지 않으면, 이벤트 값이 올바로 처리되지 않고, 수익이 기록되지 않습니다.

수익 값은 어떤 식으로든 포맷되지 않아야 합니다. 소수점은 포함할 수 있습니다. 통화 기호나 코드 혹은 구분 기호인 ,를 포함하지 마세요. 수익(revenue) 앞에 - 기호를 붙일 수 있습니다.

• 유효한 값: 123, -123.45, 123.456 
• 잘못된 값: 1,234.56, 1,234

로데이터 필드는 S2S 호출로 전송된 값을 사용하여 생성됩니다. 그 중 일부 필드는 인스톨 이벤트를 이용하여 생성됩니다. 앱스플라이어 SDK를 사용하여 보고된 인앱 이벤트에서 유사하지만 동일하지 않은 동작이 관찰됩니다. SDK 리포팅 데이터와 S2S 이벤트 데이터 사이에 몇 가지 다른 점이 있습니다. 다음 필드는 S2S 이벤트에서 자동 생성되지 않습니다.

• wifi
• operator
• language
• Device Type
• Device Category
• App Version: app_version_name를 사용할 수 있습니다.
• App Name