리치 인앱 이벤트 - 개요

인앱이벤트를 기록하는 이유는 무엇일까요?

인앱이벤트는 앱에서 발생하는 상황에 대한 통찰력을 제공하며 앱 사용자의 가치와 다양한 미디어소스에서 발생하는 트래픽 품질을 확인하는 데 이상적인 도구입니다. 인앱이벤트를 기록하면 ROI(Return on Investment)나 LTV(Lifetime Value)와 같은 성과 지표를 측정할 수 있습니다.

사용자가 등록, 튜토리얼 완료, 장바구니 추가 또는 구매하면, 인앱이벤트 데이터에 세부 정보와 함께 이벤트를 기록할 수 있습니다. 인앱이벤트의 구현은 모든 설치 후 분석 목적에서 필수입니다.

인앱이벤트 소개

인앱이벤트는 이벤트 이름으로 구성되며 이벤트 파라미터를 포함할 수 있습니다. 인앱이벤트에 이벤트 파라미터를 추가하면 해당 이벤트를 리치 앱 이벤트라고 합니다. 이벤트 파라미터는 이벤트 발생에 대한 자세한 컨텍스트와 정보를 제공합니다. 예를 들어, 사용자가 예약했음을 아는 것은 도움이 되지만, 이벤트 파라미터는 구매 유형, 목적지 및 매출과 같은 세부 정보를 제공할 수 있습니다.

사전 정의된 사용자정의 이벤트

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

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

이벤트 전송

인앱이벤트를 앱스플라이어로 전송하는 방법에는 여러 가지가 있습니다.

• 앱스플라이어 SDK: 이벤트를 전송하는 가장 일반적인 방법입니다. SDK 수준에서 앱스플라이어의 인앱이벤트 API를 사용하면, 앱에서의 사용자 행동을 기록하는 리치 인앱이벤트를 전송할 수 있습니다.
• 서버 간 API: 모바일 앱 밖에서 일어나는 이벤트를 앱스플라이어에 직접 보낼 때는 이 서버 간 API를 사용하세요. 예를 들어, 웹과 모바일 인터페이스에서 모두 활동하는 사용자가 있다면, 각각의 소스에서 발생한 이벤트를 기록한 후 앱스플라이어 내의 같은 사용자로 어트리뷰트할 수 있습니다. 인앱이벤트뿐만 아닌, 웹사이트 이벤트, 오프라인 매장에서 발생한 이벤트 등도 가능합니다.
• 영수증 유효성 검증: 이것은 Apple과 Google과 같은 결제 플랫폼이 인앱 구매가 보고된 대로 이루어졌는지 확인하는 안전한 메커니즘입니다. 구매 유효성 검증은 부정한 수익 이벤트를 방지하기 위한 주요 도구입니다. 또한 이 기능으로 실제 수익을 파악하고 불완전한 인앱 구매를 제외할 수 있습니다. 
• 하이브리드 앱: 네이티브 뷰와 HTML 콘텐츠가 결합된 하이브리드 앱도 인앱이벤트를 기록할 수 있습니다. 그러나 SDK는 네이티브 측면에서만 이벤트를 전송할 수 있으므로 개발자는 모든 이벤트 데이터를 네이티브 코드로 전달해야 합니다.

인앱이벤트 설정

인앱이벤트를 설정하려면 마케터와 개발자가 다음과 같이 협력해야 합니다.

인앱이벤트 정의하기

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

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는 로데이터상 서로 다른 두 이벤트입니다. 그러나 집약형 리포트(예: 개요 또는 이벤트)에서는 단일 이벤트로 표시될 수 있습니다. 
• 이벤트 이름은 다음 문자로 시작할 수 없습니다. ", =,+, -.
• 이벤트 값은 1000자를 초과할 수 없습니다. 
• 참조 URL을 이벤트 값으로 포함하는 경우, 반드시 인코딩된 URL이어야 합니다.
• 페이스북에는 이벤트 이름 및 파라미터와 관련하여 몇 가지 제한이 있습니다. 여기에서 제한 사항에 대해 읽어보십시오.

자주 하는 질문

다음 섹션에는 인앱이벤트에 대한 다양한 FAQ가 포함되어 있습니다.

{
  "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"
   }
  ]
}

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