{event_detail} 매크로 안내

애드브릭스 커머스 이벤트 포스트백을 지원하기 위한 {event_detail} 매크로가 추가 되었습니다.

{event_detail} 매크로는 모든 커머스 이벤트의 내용을 URL 인코딩된 Json String으로 전달합니다.

위 매크로를 템플릿에 추가할 경우, 기존 커머스 이벤트 매크로들은 모두 빈 문자열로 치환됩니다.

매크로 상세

Json 데이터 구조

{event_detail} 매크로에 포함되는 정보를 안내합니다. 기본적인 Json Data 구조는 다음과 같습니다.

 주의  일부 Json array, object 는 광고주 앱의 연동 상태에 따라서 달라질 수 있습니다.

event_type : 커머스 이벤트
event_id : 커머스 이벤트 아이디
created_at : 이벤트 발생 시각
attributes : 주문 정보
order_id : 주문 아이디
discount : 할인가격
delivery_charge : 배송비
payment_method :결제방법
products :상품정보
product_id : 상품 아이디
product_name : 상품명
price : 상품가격
discount : 할인가격
quantity : 주문수량
currency : 화폐단위
extra_attrs : 상품옵션
category1 : 상품카테고리1
category2 : 상품카테고리2
category3 : 상품카테고리3
category4 : 상품카테고리4
category5 : 상품카테고리5

Json 데이터 샘플

애드브릭스 커머스 용 api를 통해 전달된 커머스 이벤트 데이터가 전달됩니다.

구매 이벤트

{  
    "event_type":"purchase",
    "event_id":"60c8deaf-4290-4fdf-bbde-58d1b4ec8504",
    "created_at":"20180315000000",
    "attributes":{  
        "order_id":"20180311510000",
        "discount":0,
        "delivery_charge":0,
        "payment_method":"CreditCard"
    },
    "products": [  
        {  
            "product_id":"1001",
            "product_name":"천연베이킹소다 액체세제 일반용",
            "price":10900.0,
            "discount":2000.0,
            "quantity":2,
            "currency":"KRW",
            "extra_attrs":{  
                "category1":"생활/주방",
                "category2":"세제",
                "category3":"세탁세제",
                "category4":"일반세탁세제"
            }
        },
        {  
            "product_id":"2002",
            "product_name":"베이킹소다 2kg(다목적)",
            "price":5000.0,
            "discount":1000.0,
            "quantity":2,
            "currency":"KRW",
            "extra_attrs":{  
                "category1":"생활/주방/자동차상품군",
                "category2":"세제",
                "category3":"주거세제",
                "category4":"생활세정제"
            }
        },
        {  
            "product_id":"3003",
            "product_name":"[LG생활건강] 한입 구연산 2KG",
            "price":9500.0,
            "discount":900.0,
            "quantity":1,
            "currency":"KRW",
            "extra_attrs":{  
                "category1":"생활/주방/자동차상품군",
                "category2":"세제",
                "category3":"주방세제",
                "category4":"주방세제"
            }
        }
    ]
}

상품 상세 이벤트

{  
    "event_type":"product_view",
    "event_id":"5c970148-430f-4a52-92e2-2175a94c4996",
    "created_at":"20180315131212",
    "attributes":{ },
    "products":[  
        {  
            "product_id":"4004",
            "product_name":"파인애플 1kg/팩",
            "price":7700.0,
            "discount":0.0,
            "quantity":2,
            "currency":"KRW",
            "extra_attrs":{  
                "category1":"신선",
                "category2":"유기농"
            }
        }
    ]
}

포스트백 전송

애드브릭스 포스트백 템플릿의 {event_detail} 매크로가 있는 경우, 커머스 이벤트 JSON을 URL 인코딩 처리하여 전달합니다.

* 위 매크로를 이용할 경우, 기존의 커머스 관련 매크로들은 동작하지 않습니다. ( order_id, product_id, price, quantity, 등)

포스트백 템플릿 샘플

adbrix_commerce_event={event_detail}

포스트백 전송 샘플

adbrix_commerce_event=%7B%22event_type%22%3A%22product_view%22%2C%22event_id%22%3A%225c970148-430f-4a52-92e2-2175a94c4996%22%2C%22created_at%22%3A%2220180315131212%22%2C%22attributes%22%3A%7B%7D%2C%22products%22%3A%5B%7B%22product_id%22%3A%224004%22%2C%22product_name%22%3A%22%ED%8C%8C%EC%9D%B8%EC%95%A0%ED%94%8C1kg%2F%ED%8C%A9%22%2C%22price%22%3A7700.0%2C%22discount%22%3A0.0%2C%22quantity%22%3A2%2C%22currency%22%3A%22KRW%22%2C%22extra_attrs%22%3A%7B%22category1%22%3A%22%EC%8B%A0%EC%84%A0%22%2C%22category2%22%3A%22%EC%9C%A0%EA%B8%B0%EB%86%8D%22%7D%7D%5D%7D

사용 방법

위 매크로를 사용하시기 위해서는 아래 양식을 작성하시어 abx_partner@igaworks.com 으로 신청해주셔야 합니다.