리치 인앱 이벤트 - 개요

요약: 미디어소스 및 캠페인으로 어트리뷰트된 설치 후 리치 인앱이벤트(예: 로그인, 등록 또는 인앱 구매)를 기록합니다.

 관련 자료

리치 인앱 이벤트로 작업하는 것을 완전히 이해하려면 다음 문서를 읽어보십시오.

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

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

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

인앱이벤트 소개

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

travel.png

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

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

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

이벤트 전송

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

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

인앱이벤트 설정

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

단계 역할 작업 상세 내용

1

마케터

측정하려는 인앱 이벤트를 결정합니다. 이벤트 이름이벤트 파라미터를 정의하고 개발자에게 보냅니다.  

사용자의 품질을 측정하기 위해 KPI로 사용할 수 있는 3-5개의 이벤트(예: 구매, 등록 및 공유)로 시작하는 것이 좋습니다. 이벤트 파라미터는 선택 사항이며 이벤트 이름과 함께 임의의 이벤트 파라미터를 사용할 수 있습니다.

일반적인 인앱이벤트에 대해서는 비즈니스 수직 구조별 권장 이벤트를 참조하십시오.

2 개발자

적용 가능한 경우 앱에서 코드를 구현하십시오. 

개발사 설명서는 여기에 있습니다.

3 [선택 사항] 마케터 개발자와 협력하여 고객 사용자 ID 필드(CUID)를 설정합니다. 

이 필드는 CUID를 키로 사용하여 앱스플라이어 어트리뷰션 데이터와 다른 데이터를 상호 참조함으로써 인앱이벤트 데이터를 풍부하게 만드는 데 도움이 됩니다.

4 [선택 사항] 마케터 대시보드에서 관련 파트너에 대한 이벤트 매핑을 수행하십시오.  이 작업은 연동하는 파트너에 따라 진행 중인 태스크입니다.

인앱이벤트 정의하기

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

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

 

eCommerce 앱의 마케터가 가장 인기 있는 범주를 더 잘 이해하고 제품 보기와 제품 판매를 연결하기 위해 사용자가 보는 콘텐츠 유형을 기록하려고 합니다.

다음 표에는 마케터가 개발자에게 전달하는 이벤트 구조의 예가 표시됩니다.
이벤트 이름 이벤트 파라미터 파라미터 값 이벤트가 트리거되는 시기는 언제입니까?
af_content_view af_price 제품 가격

사용자가 특정 제품 세부 사항 페이지 열람 시기

af_content_type 제품 카테고리의 이름(예: 신발)
af_content_id

제품 ID(예: SKU)

비즈니스 수직 구조별 권장 이벤트

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

비즈니스 수직 구조 기사 제목
InApp_Events_games.png  권장하는 게이밍 앱 이벤트
InApp_Events_ecommerce.png 권장 이커머스 앱 이벤트
InApp_Events_streaming.png 권장 엔터테인먼트 앱 이벤트
banking.png 권장 금융 및 뱅킹 앱 이벤트
InApp_Events_lending.png 권장 P2P 대출 앱 이벤트
education.png 권장 온라인 교육 앱 이벤트
InApp_Events_ride.png 권장 승차 공유 앱 이벤트
InApp_Events_flight.png 권장 항공편 예약 앱 이벤트
InApp_Events_hotel.png 권장 호텔 예약 앱 이벤트
5669_Healthcare_icon_3.png 권장 헬스케어 앱 이벤트
telecommunications_icon.png 권장 통신 앱 이벤트
InApp_Events_eWallet.png 권장되는 eWallet 앱 이벤트

인앱이벤트 데이터 보기

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

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

  • 대시보드 개요 페이지: 실시간 LTV 사용자 인입(UA) 성과를 표시합니다.
  • 이벤트 페이지: 미디어소스에서의 LTV 인앱이벤트 성과를 표시합니다.
  • 로데이터 인앱이벤트 리포트: 전체 사용자 기반에서 수행하는 액션의 연대순 목록을 의미하는 활동 데이터를 표시합니다. 이 보고서에는 이벤트 파라미터 값이 포함됩니다. 예:
    {
      "af_level":"10",
      "af_score":"3387",
      "arena":"7",
      "char_type":"paladin"
    }

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

팁 

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

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

    revenue_data.png

제한 사항

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

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

자주 하는 질문

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

수익 파라미터를 어떻게 사용합니까?

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

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


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

기기가 오프라인 상태인 경우 이벤트가 기록됩니까?

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

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

 참고

SDK의 캐시는 최대 40개의 이벤트를 저장할 수 있습니다. 따라서 오프라인 상태에서 발생한 첫 40개의 이벤트만 저장됩니다. 그 이후 다음 성공 응답을 받을 때까지의 모든 이벤트는 저장되지 않고 버려집니다.

로데이터에 표시된 이벤트 시간(event time)은 기기가 다시 온라인 상태가 된 후 앱스플라이어로 이벤트가 전송된 시간입니다. 이벤트가 실제로 일어난 시간이 아닙니다.

복합 인앱이벤트란 무엇이며 설정 방법은 무엇입니까?

복합 인앱이벤트(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 문자열이어야 합니다.

 

Smith 씨는 미국 온라인 상점에서 같은 셔츠 두 장과 구두 한 켤레 그리고 모자 하나를 한 건의 동일한 거래로 구매합니다. 나열된 각 아이템의 순서는 각 파라미터 값의 순서와 일치해야 합니다.


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

복수의 아이템은 포스트백에서 배열(array)로 전송됩니다. 현재 페이스북과 트위터는 배열 파라미터를 정확하게 분석할 수 없습니다. 이를 해결하기 위해서 앱스플라이어는 배열로 해당 SRN으로 전송하는 대신 아이템의 개수(af_quantity)를 합산합니다. 위의 예제에서 페이스북은 af_quantity=4를 수신합니다.

 참고

복수의 아이템은 다음 인앱 이벤트와 함께 사용할 수 있습니다.

af_add_to_cart, af_add_to_wishlist, af_tutorial_completion, af_initiated_checkout, af_purchase, af_rate, af_spent_credits, af_content_view, af_travel_booking, af_update

앱스플라이어가 이벤트 중복 제거를 어떻게 처리합니까?

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

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

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

 참고

중복제거는 SDK에서 전송된 인앱 이벤트에만 적용됩니다.

서버 간 전송된 S2S 인앱 이벤트는 중복제거를 할 수 없습니다.

앱스플라이어가 사용자 레벨 데이터를 얼마나 오래 유지하며 삭제 의무는 무엇입니까?

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

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

OS(운영 체제) 파라미터를 이벤트에 추가해야 합니까?

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