인앱 이벤트

인앱이벤트와 관련된 기본 개념 및 용어에 대해 학습합니다.

인앱이벤트는 앱에서 사용자가 어떻게 상호작용하는지 인사이트를 제공합니다. 앱스플라이어 SDK를 사용하면 이러한 상호작용을 쉽게 기록할 수 있습니다.

인앱이벤트 SDK 가이드

이벤트의 세부 구조

인앱이벤트는 다음 2개 파트로 구성됩니다.

  • 이벤트 이름: 고유 이벤트 ID입니다. 일반적으로 이를 통해 마케터가 대시보드에서 이벤트를 봅니다.
  • 이벤트 값: 이벤트 파라미터라는 키 값 쌍으로 구성되는 객체입니다. 이벤트 파라미터는 발생 이벤트에 대한 추가 컨텍스트 및 정보를 제공합니다.

이벤트 이름 및 이벤트 파라미터는 사전 정의이거나 사용자정의입니다.

👍

인앱이벤트 생성기 도구를 사용하여 모든 주요 플랫폼에 대한 인앱이벤트 코드를 빠르게 정의하고 생성합니다.

이벤트 상수

SDK에서 사전 정의된 이벤트 및 파라미터는 상수로 노출됩니다.

이벤트를 보낼 때 원시 문자열 대신 상수를 사용하는 것이 좋습니다.

  • 이는 이름 지정 불일치 발생 가능성을 줄입니다.
  • 사용 중인 이벤트/파라미터 이름에 대한 변경사항은 사용자에게 투명하게 공개되며 유지보수가 덜 필요합니다.

기술적으로 사전 정의된 이벤트 이름/파라미터는 접두사가 다음과 같은 문자열입니다. af_.

사용자정의 이벤트 및 이벤트 파라미터

사용자정의 이벤트 이름 및 파라미터는 사용자정의되며 일반적으로 앱의 비즈니스 로직 및 사용자 앱과의 상호작용별로 시나리오를 설명합니다.

🚧

주의사항

사전 정의된 이벤트와의 혼동을 피하려면 맞춤 이벤트 이름 앞에 다음을 붙이지 마십시오. af_.

Valid custom event names

사용자정의 이벤트 이름은 다음 규칙을 따라야 합니다.

  • 최대 100자여야 합니다.
  • 비영어 문자를 사용해도 됩니다.

Valid custom event parameters

사용자정의 이벤트 파라미터

  • 1,000자를 넘지 않아야 합니다. 더 긴 경우, 잘려서 보여집니다.
  • 가격과 수익: 숫자와 소수점만 사용합니다. 예: 5 혹은 5.2
  • 가격과 수익 데이터 값은 소수점 5째 자리까지 표기할 수 있습니다. 예: 5.12345

📘

참고

For events with revenue, including in-app purchases, subscriptions, and ad revenue events, AppsFlyer customers with an ROI360 subscription should avoid using the af_revenue parameter in their in-app events. Doing so can result in duplicate revenue being reported. Instead, they should utilize the purchase connector and the ad revenue SDK API.

이벤트 구조 정의 이해하기

이론상으로 마케터는 인앱이벤트 정의의 안내에 따라 명확한 이벤트 구조 정의를 제공해야 합니다. 예를 들어 af_content_view eCommerce 앱의 이벤트 정의는 다음과 같습니다.

이벤트 이름이벤트 파라미터파라미터 값위치/시기(선택사항)
af_content_viewaf_price
af_content_type
af_content_id
af_price: 항목 가격
af_content_type: 항목 카테고리.
af_content_id: 항목 SKU.
사용자가 항목 보기로 이동할 때.
  • 첫 번째 열(이벤트 이름)은 의 두 번째 인수로 logEvent전달하는 값입니다.

    af_content_view 일반적으로 이를 통해 마케터가 대시보드에서 이벤트를 봅니다. 마케터가 제공하는 원시 문자열 값 대신 사전 정의된 이벤트 상수를 사용하는 것이 좋습니다.

  • 두 번째 열(이벤트 파라미터)은 이벤트와 연관된 이벤트 파라미터를 나열합니다. 이 경우 다음 이벤트 파라미터를 다음으로 전달해야 합니다. logEvent:

    • af_price
    • af_content_type
    • af_content_id
  • 세 번째 열(파라미터 값)에는 이벤트 파라미터에 지정된 특정 값에 대한 추가 정보가 들어 있습니다. 위의 예에서 마케터는 이벤트 매개 변수 값이 표시된 항목의 af_content_id SKU여야 한다는 것을 분명히 전달합니다.

  • 네 번째 열은 마케터가 앱에서 이벤트가 발생해야 하는 위치 및 시기를 설명하는 곳입니다.

위의 예제 정의가 안드로이드iOS에서 어떻게 구현되는지 참조하세요.

오프라인 인앱이벤트

SDK는 인터넷 연결이 없을 때 발생하는 인앱이벤트를 캐시할 수 있습니다.

  • SDK는 앱스플라이어 서버에 이벤트를 전송하고 응답을 기다립니다.
  • SDK가 200 응답을 받지 못하는 경우 이벤트가 캐시에 저장됩니다
  • 저장된 이벤트는 다음 200 응답을 받으면 서버로 다시 전송됩니다.
  • 캐시에 다수의 이벤트가 있는 경우에는, 순서대로 하나씩 서버로 전송됩니다(배치되지 않은 것으로, 이벤트당 네트워크 요청 하나).

SDK는 이벤트를 최대 40개 캐시할 수 있습니다. 오직 처음 40개의 오프라인 이벤트만 저장됩니다. 그 이후 다음 응답이 성공적일 때까지, 이후 발생하는 모든 이벤트는 저장되지 않고 버려집니다.