구매 이벤트 전송

  • Parameter tag: 한 광고계정 내에서 같은 이벤트코드 내에서도 특별한 분류가 필요할 때 추가 합니다.
  • Parameter totalQuantity: 주문에 포함된 상품 수
  • Parameter currency: 주문 전체 금액
  • Parameter totalPrice: 결제 금액 통화 ISO4217 포맷
  • Parameter products: KakaoAdDetailProducts 클래스 객체의 Array 타입을 입력 받습니다. 개별 주문 상품 상세 정보의 리스트 입니다.

KakaoAdDetailProducts(products)

  • id 상품아이디 선택값
  • name 상품이름 선택값
  • quantity 상품수량 필수값
  • price 상품가격 필수값
  • brand 상품브랜드 선택값 (0.8.0 버전부터 제공)

변경사항

  • 0.8.0 버전부터 KakaoAdDetailProduct 클래스에 brand 프로퍼티가 새롭게 추가되었습니다.

brand 프로퍼티 사용법

이전 (0.7.x 이하)

Objective-C
// brand 프로퍼티 없음
KakaoAdDetailProduct *product = [[KakaoAdDetailProduct alloc] initWithId:@"product-id" name:@"상품명" quantity:2 price:50000];
Swift
// brand 프로퍼티 없음
let product = KakaoAdDetailProduct(id: "product-id", name: "상품명", quantity: 2, price: 50000)

현재 (0.8.0 이상)

Objective-C
// brand 프로퍼티 추가
KakaoAdDetailProduct *product = [[KakaoAdDetailProduct alloc] initWithId:@"product-id" name:@"상품명" quantity:2 price:50000 brand:@"브랜드명"];

// 기존 방식도 계속 지원
KakaoAdDetailProduct *productWithoutBrand = [[KakaoAdDetailProduct alloc] initWithId:@"product-id" name:@"상품명" quantity:2 price:50000];
Swift
// brand 프로퍼티 추가
let product = KakaoAdDetailProduct(id: "product-id", name: "상품명", quantity: 2, price: 50000, brand: "브랜드명")

// 기존 방식도 계속 지원
let productWithoutBrand = KakaoAdDetailProduct(id: "product-id", name: "상품명", quantity: 2, price: 50000)

사용 예시

다음은 브랜드 정보가 포함된 상품으로 구매 이벤트를 추적하는 예시입니다:

Objective-C

NSString* tag = @"tag";
KakaoAdDetailProduct* product_1 = [[KakaoAdDetailProduct alloc] initWithName:@"pencil" quantity:5 price:400];
KakaoAdDetailProduct* product_2 = [[KakaoAdDetailProduct alloc] initWithName:@"eraser" quantity:1 price:1000];
KakaoAdDetailProduct* product_3 = [[KakaoAdDetailProduct alloc] initWithId:@"product-1" name:@"ruler" quantity:3 price:1500];
KakaoAdDetailProduct *product_4 = [[KakaoAdDetailProduct alloc] initWithId:@"product-2" name:@"선풍기" quantity:2 price:50000 brand:@"카카오"];

NSInteger totalQuantity = 6;
double totalPrice = 3000;
NSString* currency = @"KRW";

[KakaoAdTracker sendPurchaseEventWithTag:tag totalQuantity:totalQuantity totalPrice:totalPrice currency:currency products:@[product_1, product_2, product_3, product_4]];

Swift

let tag = "tag"
let product_1 = KakaoAdDetailProduct(name: "pencil", quantity: 5, price: 400)
let product_2 = KakaoAdDetailProduct(name: "eraser", quantity: 1, price: 1000)
let product_3 = KakaoAdDetailProduct(id: "product-1", name: "ruller", quantity: 3, price: 1500)
let product_4 = KakaoAdDetailProduct(id: "product-2", name: "선풍기", quantity: 2, price: 50000, brand: "카카오")

let totalQuantity: Int = 6
let totalPrice: Double = 3000
let currency = "KRW"

KakaoAdTracker.sendPurchaseEvent(tag: tag, totalQuantity: totalQuantity, totalPrice: totalPrice, currency:currency, products:[product_1, product_2, product_3, product_4])

참고사항

  • brand 프로퍼티는 선택사항입니다. 필요한 경우에만 설정하시면 됩니다.
  • 브랜드 정보를 제공하면 더 정확한 광고 성과 측정이 가능합니다.
  • 기존 코드와의 호환성이 유지되므로 즉시 업그레이드해도 안전합니다.