airbridge

[핵심 가이드] 한 주문서에 여러 상품이 포함된 경우의 구매 이벤트 설계 가이드

리포트데이터에어브릿지 온보딩

광고 캠페인의 성과를 정확하게 분석하려면, 유저가 어떤 광고를 보고 어떤 브랜드 또는 상품을 구매했는지 추적하는 것이 중요합니다. 이를 위해 에어브릿지에서는 구매 이벤트의 데이터 설계를 아래와 같이 권장드립니다.

에어브릿지의 이벤트 구조

에어브릿지의 데이터 구조상 action, label에는 각각 하나의 값만 전송할 수 있습니다. 

브랜드, 카테고리에 대한 분석 니즈가 있기 때문에, 보통 action이나 label에는 해당 값을 수집하게 됩니다. 이때 유저가 다수의 상품을 구매할 경우, 다수의 상품 중 어떤 상품의 값을 action 혹은 label에 넣어야할지 명확하지 않습니다.

따라서 유저가 하나의 주문서로 여러 상품을 구매하는 경우에는 다음과 같이 두 개의 이벤트로 데이터를 나누어 전송해야 합니다.

  • 상품 단위 구매 이벤트: airbridge.ecommerce.order.completed (Standard Event)

  • 주문 단위 구매 이벤트: order_complete_transaction (Custom Event)


구매 이벤트 택소노미 예시

상품 단위 구매 이벤트를 Standard Event로 사용하는 이유

  • 주요 매체들과 포스트백 전송 규격이 사전에 협의되어 있어, 별도 설정 없이 정확하게 데이터를 전송할 수 있습니다.

주문 단위 구매 이벤트를 Custom Event로 사용하는 이유

  • 총 결제 금액 기준의 CVR, ROAS 분석이 가능해집니다.

권장 수집 시맨틱 어트리뷰트 항목

📌 참고: 시맨틱 어트리뷰트는 예시이며, 실제 서비스에서는 보유한 값만 수집하시면 됩니다.

항목

용도

productID, productName, currency

매체 포스트백용 (매우 권장)

transactionID

데이터 정합성 확인용

price, quantity, categoryName, brandName

상품 분석 정교화용 (선택)

샘플 코드

1개의 주문서(transaction id : 16874326) 에 

  • Coke Zero (3개 * $1.99)

  • Coke(2개 * 1.00) 

총 $7.97 결제한 경우

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
// 상품 단위 - Coke Zero
airbridge.events.send('airbridge.ecommerce.order.completed',
{
    value: 5.97,
    semanticAttributes: {
        products: [
            {
            productID: 'coke_zero',
            name: 'Coke Zero',
            price: 1.99,
            quantity: 3,
			categoryName : "soda",
			categoryID: "1111",
			brandName : "Coca cola",
			brandID : "2222"
            }
        ],
        currency: 'USD',
        transactionID: '16874326',
	   action : "Soda",
	   label : "Coke"
    }
})



// 상품 단위 - Coke
airbridge.events.send('airbridge.ecommerce.order.completed',
{
    value: 2,
    semanticAttributes: {
        products: [
            {
            productID: 'coke',
            name: 'Coke',
            price: 1,
            quantity: 2,
			categoryName : "soda",
			categoryID: "1111",
			brandName : "Coca cola",
			brandID : "2222"
            }
        ],
        currency: 'USD',
        transactionID: '16874326',
	   action : "Soda",
	   label : "Coke"
    }
})



// 주문 단위
airbridge.events.send('order_complete_transaction',
{
    value: 7.97,
    semanticAttributes: {
        currency: 'USD',
        transactionID: '16874326'
    }
})


에어브릿지 리포트 예시

실제 구매 데이터 기준으로, 각 매체·캠페인별 유입 유저가 주로 구매한 상품 카테고리와 브랜드를 확인할 수 있습니다.
예를 들어 특정 캠페인을 통해 유입된 유저가 Coca-Cola를 집중적으로 구매했다면, 해당 광고가 콜라 제품 구매 전환에 효과적이었음을 의미합니다. 

상품 단위 이벤트를 활용하면 구매 상품 분석이 가능합니다.

 또한 주문서 단위 이벤트는 CVR, ROAS 등 효율 지표 분석에 활용됩니다.

두 이벤트를 함께 수집하면 유입 경로부터 상품 구매까지의 전환 흐름과 광고 효율을 유기적으로 분석할 수 있습니다.