리치 인앱 이벤트 - 개요

인앱이벤트를 전송하려면 개발자가 앱에 해당되는 코드를 구현해야 합니다. 이벤트 이름과 이벤트 파라미터는 다음과 같이 분류합니다.

• 사전 정의: 서로 다른 앱에서 일반적으로 사용되는 이벤트 이름 및 이벤트 파라미터입니다. 다음과 같은 이유로 사전 정의된 이벤트 이름 및 이벤트 파라미터를 가능한 한 많이 사용할 것을 권장합니다.
  • 사전 정의된 이름 지정을 통해 파트너에 대한 이벤트를 자동 매핑할 수 있습니다. 
  • 앱스플라이어가 특정 이벤트의 이름이나 이벤트 파라미터를 변경하더라도, 기존의 구현 내용이 이전 버전과 호환됩니다.
• 사용자정의: 다음은 앱에서 발생하는 특정 사용자 시나리오에 대해 정의하는 이벤트 이름 및 파라미터입니다. 사용자 정의 이벤트 이름 또는 파라미터 이름 문자열을 사용할 수 있지만, 사용자 정의 이벤트는 개발자가 관리해야 합니다. 팁 및 제한 사항을 참조하십시오.

구매 또는 항공편 예약과 같은 인앱이벤트를 전송할 때마다 관련 수익을 함께 보냅니다. 인앱이벤트에서 수익을 전달하는 유일한 파라미터는 af_revenue입니다.

• SDK에서 수익 기록
• Unity에서 수익 기록

또한 사용자가 구매를 취소하거나 환불할 경우 마이너스 수익을 기록할 수 있습니다. 마이너스 수익을 기록하려면 af_revenue에 전달하는 수익 값에 마이너스 기호(-)를 추가하기만 하면 됩니다.

af_revenue는 사용자 수익을 누적하는 유일한 파라미터입니다. 비즈니스 로직 상에서의 실제 수익 창출을 나타내는 인앱이벤트와 함께 사용하세요.

또한 거래 취소나 환불 등의 이벤트를 기록할 때에 af_revenue가 마이너스 수익 값을 가질 수 있습니다.

수익 값에는 숫자(필요한 경우 소수점 포함)만 포함되어야 합니다.

• 다른 문자를 포함하거나 수익 가치의 형식을 다른 방식으로 지정하지 마십시오 .즉, 쉼표, 통화 기호 f(또는 예: $), 특수 문자 또는 텍스트가 없어야 합니다.
• 앱스플라이어는 소수점 이하 다섯 자리까지 정밀도로 수익 값을 제공합니다.
• 이 값의 범위는 -10,000에서 10,000 사이의 달러 또는 이에 상응하는 원래 통화 금액이어야 합니다.이 범위를 벗어난 값은 로데이터 리포트에 포함되지만 집약형 리포트에는 포함되지 않습니다. 
• 예시: 1234.56
• 수익을 문자열로 보낼 때 따옴표 안의 값은 유효해야 합니다.예: "1234.56".

참고:

• 앱스플라이어는 SDK가 전송하는 정확한 수익을 표시합니다. 앱스플라이어로 전송되기 전에 SDK 단계에서 개발자가 포함하지 않는 한, VAT나 앱 스토어 커미션과 같은 기타 다른 계산은 포함되지 않습니다.

af_currency는 af_revenue(또는 af_price)에 표시되는 통화를 나타냅니다. 이벤트의 파라미터에서 af_currency가 빠져 있으면, 앱스플라이어가 기본값인 "USD"로 전송합니다.

수익으로 집계되지 않는 수익화 파라미터로 af_price를 사용할 수 있습니다(“장바구니 추가” 이벤트에서와 동일). 이 파라미터는 개별 아이템 가격을 나타냅니다. 총 구매 금액은 af_revenue 파라미터에 표시됩니다.

수익 통화

앱스플라이어에서 통화 설정 및 통화 변환을 처리하는 방법을 이해하는 것이 중요합니다.

앱스플라이어는 통화 변환을 사용하여 앱 설정 통화와 인앱이벤트 통화 간의 차액을 처리합니다.

위의 다이어그램은 다음 프로세스를 보여줍니다.

1. 인앱이벤트는 각 이벤트마다 다른 통화를 전송합니다
2. 앱스플라이어는 모든 통화를 USD로 표준화합니다
3. 앱스플라이어는 수익 데이터를 처리합니다
4. 대시보드의 수익 데이터는 앱 설정 통화로 표시됩니다
5. 앱스플라이어는 로데이터 리포트의 수익 데이터를 이벤트 통화 및 앱 설정 통화 모두로 채웁니다

앱스플라이어는 공개 환율을 사용하여 통화를 변환합니다. 환율은 매 시간 업데이트됩니다. 앱스플라이어는 통화 변환을 수행할 때마다 마지막 시간의 업데이트 환율을 사용합니다.

통화 변환

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

통화 표시

통화는 앱 설정에서 설정합니다. 앱 설정에서 설정한 통화가 대시보드에 표시되는 통화입니다. 인앱이벤트를 보내는 통화에 관계없이 대시보드의 수익은 항상 앱 설정에서 설정한 통화로 표시됩니다.

측정할 인앱 이벤트를 결정한 후에는 인앱 이벤트 생성기를 사용하여 다음과 같이 이벤트 및 파라미터를 정의합니다.

1. 기록할 시나리오에 가장 적합한 이벤트 이름을 선택하십시오.
2. 이벤트와 연관시킬 이벤트 파라미터를 선택하십시오. 이벤트에 대한 추가 컨텍스트를 제공하고 데이터를 보강하는 파라미터를 선택하십시오.
3. 인앱 이벤트 생성기에서 완료된 파일을 다운로드한 다음 개발자와 공유합니다.

다음 표에서는 일반적인 애플리케이션 이벤트의 예제와 흐름을 포함하는 기사에 대한 링크를 제공합니다.

비즈니스 수직 구조	기사 제목
	권장하는 게이밍 앱 이벤트
	권장 이커머스 앱 이벤트
	권장 엔터테인먼트 앱 이벤트
	권장 금융 및 뱅킹 앱 이벤트
	권장 P2P 대출 앱 이벤트
	권장 온라인 교육 앱 이벤트
	권장 승차 공유 앱 이벤트
	권장 항공편 예약 앱 이벤트
	권장 호텔 예약 앱 이벤트
	권장 헬스케어 앱 이벤트
	권장 통신 앱 이벤트
	권장되는 eWallet 앱 이벤트
	권장 스포츠 베팅 이벤트

인앱이벤트는 사용자 생애 기간 인스톨을 담당하는 미디어소스로 어트리뷰트됩니다. 이벤트 데이터는 생애 가치 또는 활동 데이터로 표시됩니다. 

다음 위치에서 인앱이벤트 데이터를 볼 수 있습니다.

• 대시보드 개요 페이지: 실시간 LTV 사용자 인입(UA) 성과를 표시합니다. 참고: 여기에는 인앱이벤트를 통해 리포된 오가닉 사용자와 논오가닉 사용자로 나눈 수익과 이중 기여한 리타겟팅 수익이 포함됩니다.
• 이벤트 페이지: 미디어소스에서의 LTV 인앱이벤트 성과를 표시합니다.
• 액티비티 페이지: 선택한 날짜 범위에 대한 인앱 액티비티를 표시합니다.
• 로데이터 인앱이벤트 리포트: 전체 사용자 기반에서 수행하는 액션의 연대순 목록을 의미하는 활동 데이터를 표시합니다. 이 보고서에는 이벤트 파라미터 값이 포함됩니다. 예:

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  로데이터는 프리미엄 기능임을 참고하십시오.

앱에서 이벤트 이름 및 파라미터를 정의할 때는 다음 사항에 유의하십시오.

• 로데이터 리포트에서 데이터 일관성을 위해 모든 플랫폼에서 동일한 인앱이벤트 이름 및 구조를 정의하고 사용하는 것이 좋습니다.
• 최소한의 이벤트를 사용하여 다양한 소스에서 오는 사용자의 품질을 쉽게 비교할 수 있습니다.
• 사용자의 프라이버시를 보호하는 것이 중요합니다. 인앱이벤트 값을 직접 식별할 수 있는 제한된 데이터로 채우지 마십시오. 예를 들어 이메일 주소, 이름, ID 번호 및 일부 위치의 우편 번호입니다. 제한된 데이터에 대한 자세한 내용은 서비스 개인 정보 보호 정책을 참조하십시오.
• 앱스플라이어는 인게이지먼트 중에 기기의 IP 주소를 수집합니다. 일부 지역 또는 사용 시나리오에서, IP 주소는 개인 식별 정보로 간주될 수 있습니다. 앱스플라이어는 IP 주소를 통해 광범위한 지리적 위치(도시, 구 수준)를 도출하지만 특정 주소는 아닙니다. 필요한 경우 IP 주소를 마스킹하도록 설정하여 로데이터 리포트에 나타나지 않도록 할 수 있습니다. 
• 앱스플라이어에서 보여지는 수익 데이터가 발생할 수 있는 유일한 방법은 인앱이벤트입니다. 이벤트별로 매출 파라미터를 연결하여, 대시보드에서 전체 수익을 확인할 수 있습니다. 수익화 파라미터에 대해 자세히 알아보십시오.

  

앱에서 이벤트 이름 및 파라미터를 정의할 때는 다음 사항에 유의하십시오.

• 인앱이벤트 이름으로 영문 소문자 및 숫자(a-z 및 0-9)만 사용할 것을 권고합니다. 이벤트 이름은 대소문자를 구분합니다. 예를 들어 af_purchase와 af_PURCHASE는 로데이터상 서로 다른 두 이벤트입니다. 그러나 집약형 리포트(예: 개요 또는 이벤트)에서는 단일 이벤트로 표시될 수 있습니다.
• 카디널리티는 하루에 300개의 고유 이벤트로 제한됩니다. 더 알아보기
• 고유 사용자는 앱을 인스톨한 후 처음 100개의 이벤트에 대해서만 계산됩니다.
• 이벤트 이름은 다음 문자로 시작할 수 없습니다: " = + - 
• 이벤트 값에는 인코딩된 URL 또는 ASCII로 인코딩된 경우를 제외하고 + 문자가 포함되어서는 안 됩니다.
• 이벤트 이름에는 공백이 포함될 수 없습니다. 이벤트 이름 앞이나 뒤에 밑줄이 그어진 공백(낮은 대시)을 사용할 수 있습니다.
• 이벤트 값은 로데이터 리포트에서 단축될 수 있으므로 2000자를 초과해서는 안 됩니다. 
• 참조 URL을 이벤트 값으로 포함하는 경우, 반드시 인코딩된 URL이어야 합니다.
• 메타 광고에는 이벤트 이름 및 매개변수와 관련하여 몇 가지 제한사항이 있습니다. 여기에서 제한 사항에 대해 읽어보십시오.

수익 값은 어떠한 파라미터와 이벤트로도 전송할 수 있습니다. 그러나 앱스플라이어 로데이터 및 집약형 데이터에 수익(마이너스 수익 포함)을 등록하려면 af_revenue 파라미터를 사용해야 합니다. 항상 비즈니스 로직상에서 실제 수익 창출을 나타내는 인앱이벤트와 함께 사용하십시오.

af_currency는 af_revenue(또는 af_price)에 표시되는 통화를 나타냅니다. 이벤트의 파라미터에서 af_currency가 빠져 있으면, 앱스플라이어가 기본값인 "USD"로 전송합니다.

af_revenue 파라미터에 대한 자세한 내용은 수익 어트리뷰션 가이드에서 확인하십시오.

인앱이벤트는 앱 인스톨의 원본 미디어 소스에 어트리뷰트됩니다.

앱 인스톨 시(첫 번째 앱 실행) 앱스플라이어는 다양한 어트리뷰션 방법을 사용하여 인스톨 어트리뷰션을 결정합니다. 동시에 앱스플라이어 SDK는 어트리뷰션 세부정보와 연결된 새로운 고유 앱스플라이어 ID를 생성합니다.

앱의 동일한 디바이스에서 수행되는 모든 후속 인앱이벤트에는 이 ID가 있습니다. 이를 통해 앱스플라이어는 이벤트를 원본 미디어 소스에 어트리뷰트할 수 있습니다. 광고주는 이를 사용하여 앱에서 전체 유저 여정을 추적할 수 있습니다.

최근 리타겟팅된 사용자의 이벤트는 이중 어트리뷰션을 가질 수 있습니다.

앱스플라이어는 다음과 같은 경우에 어트리뷰션 인스톨의 이벤트를 오가닉으로 분류합니다.

• 설치일로부터 24개월 이상 경과
• 미디어 소스의 용어는 사용자 수준 데이터 삭제를 지시합니다.
• 사용자는 기기에 저장된 앱의 데이터를 삭제하여 새로운 앱스플라이어 ID를 강제로 생성합니다.

사용자가 인터넷에 연결되지 않았을 때 이벤트가 발생한 경우라도 앱스플라이어는 여전히 이벤트를 기록할 수 있습니다. 작동원리는 이렇습니다.

1. SDK가 앱스플라이어 서버에 이벤트를 전송하고 응답 성공을 기다립니다.
2. SDK에서 성공 응답을 받지 못하는 경우는 이벤트가 캐시에 저장됩니다.
3. 저장된 이벤트는 다음 성공 응답을 받을 때 서버로 다시 전송됩니다.
4. 캐시에 다수의 이벤트가 있는 경우에는 순서대로 하나씩 서버로 전송됩니다.

복합 인앱이벤트(complex in-app events)를 사용하면, 단일 API 호출로 복수의 이벤트를 전송할 수 있습니다.

서로 밀접하게 연관된 사용자 행동을 그룹으로 묶어서 보려고 할 때 유용합니다. (예: 단일 세션에서 여러 개의 제품을 하나의 장바구니에 추가하기).
예:

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

한 건의 거래에 복수의 아이템을 추가할 수 있습니다. 이벤트 파라미터당 하나의 값을 사용하는 대신, 쉼표로 구분하여 거래를 설명하는 항목 배열(array)로 처리할 수 있습니다. 형식은 JSON 문자열이어야 합니다.

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

인앱이벤트 중복 제거 메커니즘이 있습니다. 모든 인앱이벤트에 대해서 10초 이내에 동일한 appsflyer_id로부터 같은 인앱이벤트를 받았는지 여부를 확인합니다. 동일한 이벤트를 발견하면, 메커니즘에 따라 중복 이벤트를 제거합니다.

다음의 필드가 같은 경우에 두 이벤트는 동일한 것으로 판단합니다.

• 이벤트 이름
• 이벤트 값(event value)
• 앱 ID
• AppsFlyer ID

앱스플라이어는 달리 지시하거나, 요구하거나, 법에서 허용하는 경우를 제외하고 24개월 동안 사용자 수준(로데이터)을 유지합니다. 일부 SRN/파트너는 앱스플라이어를 비롯한 어트리뷰션 제공자에게 24개월 기간이 만료되기 전에 SRN/파트너 관련 사용자 수준 데이터를 삭제하도록 요구합니다.

삭제 후 삭제된 사용자와 관련된 이벤트가 오가닉으로 표시됩니다. 과거 집약형 데이터는 동일하게 유지됩니다. 자세한 정보는 데이터 리텐션 및 삭제 의무를 참고하십시오.

• 안드로이드 SDK와 iOS SDK는 OS(운영 체제) 파라미터를 자동으로 추가합니다.
• S2S API의 경우 2021년 7월 1일부터 iOS 앱에 대한 OS(운영 체제) 파라미터를 전송해야 합니다. 이 파라미터를 전송하지 않으면 데이터는 iOS 14.5 사용자로부터 온 것으로 간주되며 이것은 로데이터를 사용할 수 있는 방식에 영향을 미칩니다.