권장 이커머스 앱 이벤트

요약: 이커머스 앱에 대해 제안된 인앱 이벤트를 기록하여 사용자 여정 내내 사용자의 질을 측정합니다.

InApp_Events_ecommerce.png이커머스

이커머스 앱을 통해 구매자는 온라인으로 쉽게 물건을 검색하고 구매할 수 있습니다. 기록할 것을 제안하는 대표적인 이벤트는 검색, 구매, 장바구니 추가, 찜한 목록 추가입니다. 

이벤트 기록에 의해 다음을 확인할 수 있습니다.

  • 가장 인기 있는 카테고리
  • 구매자가 검색하는 제품
  • 결제를 완료한 구매자 수
  • 반복 구매하는 사용자와 한 번만 구매하는 구매자 수

 중요!

  • 인앱 이벤트 구현과 관련한 마케터용 지침을 반드시 읽어보십시오.
  • 구현 프로세스를 간소화하려면 본 문서에서 설명하는 모든 일반적인 인앱 이벤트가 포함된 CSV 파일을 다운로드한 다음 비즈니스 요구에 따라 이벤트를 수정하십시오. 완료되면 파일을 개발사와 공유하십시오.
  • 본 문서에 포함된 각 권장 이벤트에 대해 iOS, 안드로이드 및 Unity 개발자를 위한 코드 샘플이 있습니다.
  • 개발사에 대한 자세한 지침은 앱스플라이어 개발자 허브에서 확인할 수 있습니다.

인앱 이벤트 기록에 대한 자세한 정보는 리치 인앱 이벤트 가이드를 참조하십시오.

Flowchart_for_recommended_events e-Commerce_app_user_journey

사전 정의된 이벤트에 대한 권장 구조

다음 섹선에서는 이커머스 수직 구조에 일반적인 이벤트 구조 목록을 제공합니다. 각 구조에는 사용할 미리 정의된 이벤트 이름과 제안된 이벤트 파라미터가 포함됩니다. 인앱 이벤트에는 비즈니스 요구를 충족하는 이벤트 파라미터가 포함될 수 있습니다.

가입 완료(af_complete_registration)

목적

앱을 설치하고 등록 프로세스를 완료한 사용자 수와 사용자가 선호하는 등록 방법에 대해 알아봅니다.

트리거

사용자가 등록 프로세스를 완료한 시간

이벤트 파라미터

이름 설명 예시 값
af_registration_method 가입 방법 유형 이메일, 페이스북

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REGSITRATION_METHOD,"Facebook");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(),AFInAppEventType.COMPLETE_REGISTRATION, eventValue);

로그인(af_login)

목적

등록된 사용자의 잔존율 파악

트리거

사용자가 성공적으로 로그인한 시간

이벤트 파라미터

추가 파라미터 없이 전송 가능

코드 예

Android iOS - Objective C iOS - Swift Unity

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.LOGIN, null);

검색(af_search)

목적

사용자가 무엇을 찾고 있는지, 어떤 검색 결과가 가장 관련성이 높고 구매로 이어지는지 알아봅니다.

트리거

다음 중 하나입니다.

  • 사용자가 검색 버튼을 클릭했을 때
  • 사용자가 검색 결과 페이지를 방문했을 때

이벤트 파라미터

이름 설명 예시 값
af_search_string 검색 용어 빨간색 드레스, 운동화
af_content_list 콘텐츠 ID 목록 001, 092

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.SEARCH_STRING, "red shoes");
eventValue.put(AFInAppEventParameterName.CONTENT_LIST, new String[] {"001", "092"});
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.SEARCH, eventValue);

콘텐츠 조회(af_content_view)

목적

특정 제품의 열람률을 알아봅니다. 이 이벤트는 다음을 제공합니다.

  • 제품 판매와 열람과의 상관 관계를 알 수 있습니다.
  • 어떤 카테고리가 가장 인기가 있는지 제품 열람을 통해 알 수 있습니다.
  • 구매자가 보고 있는 제품과 통화와의 상관 관계를 알 수 있습니다.

트리거

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

이벤트 파라미터

이름 설명 예시 값
af_price 제품 가격 2000
af_content

해당되는 경우 국제 상품 번호(EAN) 또는 기타 제품 또는 콘텐츠 식별자

Facebook 동적 광고에 필요한 파라미터

ABC123
af_content_id

제품 ID

Facebook 동적 광고에 필요한 파라미터

102
af_content_type

제품 카테고리

Facebook 동적 광고에 필요한 파라미터

신발
af_currency 제품 상세 정보 페이지의 통화 THB, USD

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, "2000");
eventValue.put(AFInAppEventParameterName.CONTENT, "ABC123";
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "102";
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shoes");
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.CONTENT_VIEW, eventValue);

목록 뷰(af_list_view)

목적

구매자가 가장 많이 보는 목록(예를 들어, 새로 추가된 제품, 관련 제품 또는 권장 제품)을 기록합니다.

트리거

사용자가 특정 목록을 보는 시기

이벤트 파라미터

이름 설명 예시 값
af_content_type 목록 유형 연관, 추천, 신상품
af_content_list 카테고리의 콘텐츠 ID 목록 001, 092

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "related products");
eventValue.put(AFInAppEventParameterName.CONTENT_LIST, new String[] {"001", "092"});
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), "af_list_view", eventValue);

찜한 목록 추가(af_add_to_wishlist)

목적

구매자가 찜한 목록에 추가하는 제품 및 카테고리를 기록합니다. 어떤 제품이 위시리스트에 가장 자주 추가되는지를 알게 되면, 이 제품을 할인 판매하거나 좋은 조건을 제시하여 구매를 촉진할 수 있습니다. 찜한 목록에 추가한 제품에 따라 사용자를 리타겟팅할 수도 있습니다.

트리거

사용자가 아이템을 찜한 목록에 추가하는 시기

이벤트 파라미터

이름 설명 예시 값
af_price 제품의 가격 600
af_content_id 제품 ID 300
af_content_type 제품 카테고리 신발, 전자 제품
af_currency 제품 세부 사항 페이지에 표시되는 통화 GBP

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, 600);
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "300");
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "electronics");
eventValue.put(AFInAppEventParameterName.CURRENCY, "GBP");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.ADD_TO_WISH_LIST, eventValue);

장바구니에 추가(af_add_to_cart)

목적

사용자가 장바구니에 제품을 추가하는 시기를 기록합니다. 이 이벤트에 의해 다음을 확인할 수 있습니다.

  • 구매자가 한 번의 구매에 추가하는 평균 제품 개수
  • 두 개의 다른 제품을 추가할 때 걸리는 시간 간격
  • 장바구니를 버리는 구매자 수

트리거

사용자가 제품을 장바구니에 추가하는 시기

이벤트 파라미터

필드 이름 설명 예시 값
af_price 제품 가격 350, 1000
af_content

해당되는 경우 국제 상품 번호(EAN) 또는 기타 제품 또는 콘텐츠 식별자

Facebook 동적 광고에 필요한 파라미터

ABC123
af_content_id

제품 ID

Facebook 동적 광고에 필요한 파라미터 

001, 092
af_content_type

제품 유형

Facebook 동적 광고에 필요한 파라미터

셔츠, 신발
af_currency 제품 통화 THB, USD
af_quantity 동일한 제품을 장바구니에 추가한 개수 2, 5

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, "350");
eventValue.put(AFInAppEventParameterName.CONTENT, "ABC123");
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "001");
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shirt");
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.QUANTITY, "2");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.ADD_TO_CART, eventValue);

초기화된 결제(af_initiated_checkout)

목적

구매자가 결제를 진행할 때 어떻게 행동하는지 이해합니다. 이 이벤트에 의해 다음을 확인할 수 있습니다.

  • 구매 이벤트에서 평균 가격 대비 구매자가 결제할 때의 평균 가격
  • 사용자가 결제 진행 후 제품을 추가 또는 삭제하는지 여부

트리거

사용자가 결제를 시작했지만 아직 완료하지 않은 경우

이벤트 파라미터

필드 이름 설명 예시 값
af_price 장바구니에 담긴 총금액 4000
af_content_id 장바구니에 담긴 제품 ID 221, 124
af_content_type 제품 카테고리 목록 셔츠, 바지
af_currency 결제 시기의 통화 THB
af_quantity 장바구니에 담긴 총 아이템 개수 2, 5

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, 350);
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "221");
// for multiple product categories, set the param value as: new String {"221", "124"}
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shirt");
// for multiple product categories,, set the param value as: new String {"shirt", "pants"}
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.QUANTITY, 2);
// for multiple product categories,, set the param value as: new int {2, 5}
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.INITIATED_CHECKOUT, eventValue);

구매(af_purchase)

목적

앱에서 구매 경향에 대해 알 수 있습니다. 이 이벤트는 다음을 제공합니다.

  • 광고 네트워크와 광고 에이전시 전반에 대한 사용자의 LTV 및 캠페인의 ROI를 알 수 있습니다.
  • 사용자에게 가장 인기 있는 아이템이 어느 것인지 알 수 있습니다.
  • 캠페인 타게팅을 최적화하기 위해서, 구매한 아이템 내역을 기반으로 크로스 캠페인을 진행할 수 있습니다.

트리거

사용자가 성공적인 구매 후 감사 페이지를 방문한 시기

이벤트 파라미터

이름 설명 예시 값
af_revenue 구매 추정 수익 1205.99
af_price 전체 구매액 4000
af_content

해당되는 경우 국제 상품 번호(EAN) 또는 기타 제품 또는 콘텐츠 식별자

Facebook 동적 광고에 필요한 파라미터

ABC123
af_content_id

아이템 ID

Facebook 동적 광고에 필요한 파라미터

121, 262
af_content_type

아이템 카테고리

Facebook 동적 광고에 필요한 파라미터

신발, 바지
af_currency 통화 코드 AUD
af_quantity 장바구니에 담긴 아이템 개수 2, 5
af_order_id 구매한 다음에 발생한 주문 ID X123ABC
af_receipt_id

주문 ID

CRITEO 및 Google Ad Words 리타게팅 연동에 필요한 파라미터

X123ABC

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, 350);
eventValue.put(AFInAppEventParameterName.CONTENT, "ABC123");
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "221");
// for multiple product categories, set the param value as: // new String {"221", "124"}
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shirt");
// for multiple product categories,, set the param value as: new String {"shoes", "pants"}
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.QUANTITY, 2);
// for multiple product categories, set the param value as: new int {2, 5}
eventValue.put(AFInAppEventParameterName.RECEIPT_ID, "X123ABC");
eventValue.put("af_order_id", "X123ABC");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue);

사용자정의 이벤트에 대한 권장 구조

다음 섹션에서는 사용자정의 이벤트 이름과 사용할 제안된 이벤트 파라미터가 포함된 이벤트 구조 목록을 제공합니다. 인앱 이벤트에는 비즈니스 요구를 충족하는 이벤트 파라미터가 포함될 수 있습니다.

첫 번째 구매(first_purchase)

목적

구매 이벤트와 동일합니다. 또한 이 이벤트를 통해 다음을 확인할 수 있습니다.

  • 새 구매자가 구매하는 데 걸리는 시간
  • 최초 구매자가 구매하려고 하는 제품
  • 최초 구매의 평균 가격과 수익

트리거

사용자가 첫 구매를 완료하는 시기

이벤트 파라미터

이름 설명 예시 값
af_revenue 구매 수익 1205.99
af_price 전체 구매액 4000
af_content

해당되는 경우 국제 상품 번호(EAN) 또는 기타 제품 또는 콘텐츠 식별자

Facebook 동적 광고에 필요한 파라미터

ABC123
af_content_id

아이템 ID

Facebook 동적 광고에 필요한 파라미터

121, 262
af_content_type

아이템 카테고리

Facebook 동적 광고에 필요한 파라미터

신발, 바지
af_currency 통화 AUD
af_quantity 장바구니에 담긴 아이템 개수 2, 5
af_order_id 구매한 다음에 발생한 주문 ID X123ABC
af_receipt_id

주문 ID

CRITEO 및 Google Ad Words 리타게팅 연동에 필요한 파라미터

X123ABC

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.PRICE, "350");
eventValue.put(AFInAppEventParameterName.CONTENT, "ABC123");
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "221");
// for multiple product categories, set the param value as: new String {"221", "124"}
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shirt");
// for multiple product categories set the param value as: new String {"shoes", "pants"}
eventValue.put(AFInAppEventParameteName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.QUANTITY, "2");
// for multiple product categories, set the param value as: new int {2, 5}
eventValue.put(AFInAppEventParameterName.RECEIPT_ID, "X123ABC");
eventValue.put("af_order_id", "X123ABC");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), "first_purchase", eventValue);

장바구니에서 삭제(remove_from_cart)

목적

이 이벤트 기록을 통해 다음을 할 수 있습니다:

  • 구매자가 장바구니에서 삭제하는 항목 확인
  • 구매자가 장바구니에서 삭제하는 제품 아이템 카테고리 확인
  • 장바구니에 담기 이벤트의 데이터와 비교하여, 결제하지 않은 제품에 대한 통찰력을 얻을 수 있습니다.

트리거

사용자가 장바구니에서 아이템을 삭제하는 시기

이벤트 파라미터

이름 설명 예시 값
af_content_id 아이템 또는 제품 ID 521
af_content_type 아이템 또는 제품 카테고리 신발

코드 예

Android iOS - Objective C iOS - Swift Unity
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "521");
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "shoes");
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), "remove_from_cart", eventValue);
도움이 되었습니까?