소매 및 전자상거래 앱과 웹사이트에서는 아래와 같은 이벤트를 사용하시기 바랍니다. 이러한 이벤트를 웹사이트에 구현하는 방법은 개발자 문서를 참고하세요.
소매 및 전자상거래 앱은 이 문서에 나열된 이벤트와 함께 모든 앱에 공통되는 이벤트를 기록해야 합니다. 지정된 매개변수와 함께 이벤트를 기록하면 보고서에 최대한 세부적인 정보가 포함되며, Firebase의 최신 및 통합 기능을 적용 즉시 활용할 수 있습니다.
| 이벤트 | 트리거 | 매개변수 |
|---|---|---|
| add_payment_info | 사용자가 결제 정보를 제출할 때 | coupon, currency, items, payment_type, value |
| add_shipping_info | 사용자가 배송 정보를 제출할 때 | coupon, currency, items, shipping_tier, value |
| add_to_cart | 사용자가 장바구니에 상품을 추가할 때 | currency, items, value |
| add_to_wishlist | 사용자가 위시리스트에 상품을 추가할 때 | currency, items, value |
| begin_checkout | 사용자가 결제를 시작할 때 | coupon, currency, items, value |
| generate_lead | 사용자가 양식을 제출하거나 정보를 요청할 때 | value, currency |
| purchase | 사용자가 구매를 완료할 때 | affiliation, coupon, currency, items, transaction_id, shipping, tax, value(필수 매개변수) |
| refund | 환불이 처리되었을 때 | affiliation, coupon, currency, items, transaction_id, shipping, tax, value |
| remove_from_cart | 사용자가 장바구니에서 상품을 삭제할 때 | currency, items, value |
| select_item | 목록에서 상품이 선택되었을 때 | items, item_list_name, item_list_id |
| select_promotion | 사용자가 프로모션을 선택할 때 | items, promotion_id, promotion_name, creative_name, creative_slot, location_id |
| view_cart | 사용자가 장바구니를 볼 때 | currency, items, value |
| view_item | 사용자가 상품을 볼 때 | currency, items, value |
| view_item_list | 사용자가 상품 또는 서비스 목록을 조회할 때 | items, item_list_name, item_list_id |
| view_promotion | 사용자에게 프로모션이 표시될 때 | items, promotion_id, promotion_name, creative_name, creative_slot, location_id |
SDK를 Android 17.2.5 이상 또는 iOS 16.20.0 이상으로 업데이트하려는 경우 고려할 사항
이전 버전의 SDK를 사용했으며 Android 17.2.5 이상 또는 iOS 16.20.0 이상으로 업그레이드하려는 경우 다음 사항을 고려해야 합니다.
- 업그레이드가 완료되면 이후 시점부터는 반복된 상품 배열 내의 상품 데이터에만 액세스할 수 있으며, 더 이상 이전 SDK 버전에서처럼 표준 이벤트 매개변수에서 상품 데이터를 사용할 수 없습니다.
- 이러한 변경사항은 여러 제품을 분석하도록 지원하기 위한 것입니다.
- 따라서 상품/제품 데이터에 대한 참조를 조정해야 할 수 있습니다.
이번 업그레이드로 BigQuery 스키마 형식이 변경됩니다. 상품/제품 데이터가 반복 필드에 표시되어 단일 이벤트에 속한 여러 제품을 분석할 수 있게 됩니다. 업그레이드 중에 상품/제품 데이터 필드를 참조하는 모든 쿼리를 조정해야 합니다.