인앱 이벤트

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

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

인앱이벤트 SDK 가이드

이벤트의 세부 구조

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

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

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

👍

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

이벤트 상수

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

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

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

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

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

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

🚧

주의사항

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

Valid custom event names

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

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

Valid custom event parameters

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

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

이벤트 구조 정의 이해하기

이론상으로 마케터는 인앱이벤트 정의의 안내에 따라 명확한 이벤트 구조 정의를 제공해야 합니다. 예를 들어 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개의 오프라인 이벤트만 저장됩니다. 그 이후 다음 응답이 성공적일 때까지, 이후 발생하는 모든 이벤트는 저장되지 않고 버려집니다.