연동 방법

카카오모먼트는 디스플레이 광고, 동영상 광고, 메시지 광고 등을 집행할 수 있는 카카오의 광고 플랫폼입니다. 카카오모먼트를 포스트백 연동하려면 카카오 비즈니스 대시보드에서 에어브릿지와 연동할 픽셀 & SDK ID 값이 필요합니다. 이 픽셀 & SDK ID 값을 에어브릿지 안에 포스트백 연동 키로 삽입해야 연동이 이루어집니다.

아래 순서에 따라 카카오 비즈니스 대시보드, 에어브릿지 대시보드를 활용해 카카오모먼트 포스트백 연동을 할 수 있습니다.

 

1. 카카오 ID로 카카오 비즈니스 대시보드에 접속합니다.

418_kakaomomentbasicintegration_KR_jw_01.png

2. 상단 메뉴에서 [서비스/도구]>[픽셀&SDK]로 이동합니다.

418_kakaomomentbasicintegration_KR_jw_02.png

3. ‘+ 픽셀 & SDK 만들기‘ 버튼을 누릅니다.

418_kakaomomentbasicintegration_KR_jw_03.png

4. 원하는 이름의 픽셀 & SDK를 만듭니다. 이때 ‘확인’ 버튼이 아닌 ‘등록' 버튼을 눌러야 픽셀 & SDK가 생성됩니다.

418_kakaomomentbasicintegration_KR_jw_04.png

5. 생성된 픽셀 & SDK ID 값을 드래그해서 복사합니다. 팝업창을 끄더라도 생성된 픽셀 & SDK를 누르면 해당 픽셀 & SDK ID 값을 볼 수 있습니다.

418_kakaomomentbasicintegration_KR_jw_05.png

6. 에어브릿지 대시보드에서 [Integrations]>[Integrated Ad Channels]로 이동해 연동하는 매체로 카카오를 선택합니다. 이때 카카오 키워드 광고를 선택하지 않게 주의하시기를 바랍니다.

418_kakaomomentbasicintegration_KR_jw_06.png

7. [포스트백] 탭으로 이동해 [연동 정보] 탭을 누릅니다.

8. 복사한 픽셀 & SDK ID 값을 포스트백 연동 키로 붙여넣고, ‘등록하기' 버튼을 누릅니다.

418_kakaomomentbasicintegration_KR_jw_07.png

 

 

포스트백 설정

스탠다드 이벤트

에어브릿지와 카카오모먼트 사이에 매핑되어 있는 스탠다드 이벤트는 총 11개입니다. 이 이벤트는 별도의 매핑을 하지 않아도 앞선 포스트백 연동을 통해 카카오모먼트로 전송됩니다.

픽셀 & SDK 기본 이벤트 명 카카오 비즈니스 대시보드 노출 명
CompleteRegistration

회원가입

Search 검색
ViewContent 콘텐츠/상품 조회
ViewCart 장바구니 보기
AddToCart 장바구니추가
AddToWishlist 관심상품추가
SignUp 서비스신청
Participation 잠재고객
Purchase 구매
AppLaunch 앱실행
AppInstall 설치

 

커스텀 이벤트

위 스탠다드 이벤트를 제외한 나머지 이벤트를 포스트백 전송하려면 해당 이벤트를 카카오모먼트에서 커스텀 이벤트로 매핑해야 합니다. 이중 픽셀 & SDK 기본 이벤트와 매핑되지 않은 에어브릿지 스탠다드 이벤트는 Home Screen, Product Catalog, Sign-in입니다.

이 3가지 이벤트는 별도의 매핑을 하지 않는다면 모두 앱실행(AppLaunch)이라는 표준 이벤트로 매핑됩니다. 각 이벤트는 카카오 비즈니스 대시보드의 표준 이벤트에 커스텀 이벤트로 추가해 별도의 이벤트로 분류할 수 있습니다.

아래 3가지 설정을 마치고 나면 커스텀 이벤트 매핑까지 포함한 카카오모먼트 포스트백 연동을 할 수 있습니다.

 

커스텀 이벤트 추가

1. 카카오 ID로 카카오 비즈니스 대시보드에 접속합니다.

418_kakaomomentbasicintegration_KR_jw_01.png

2. 상단 메뉴에서 [서비스/도구]>[픽셀&SDK]로 이동합니다.

418_kakaomomentbasicintegration_KR_jw_02.png

3. 기존에 생성한 픽셀 & SDK 중 에어브릿지와 연동한 픽셀 & SDK를 누릅니다.

418_kakaomomentcustomeventplus_KR_jw_08.png

4. 픽셀 & SDK 연동 현황에서 [수집 이벤트] 탭을 누릅니다.

418_kakaomomentcustomeventplus_KR_jw_09.png

5. 커스텀 이벤트는 ‘추가' 버튼이 있는 표준 이벤트에 한해 추가할 수 있습니다. 추가하려는 커스텀 이벤트의 성격에 따라 원하는 표준 이벤트를 선택하고, ‘추가' 버튼을 누릅니다.

418_kakaomomentcustomeventplus_KR_jw_03.png

6. 커스텀 이벤트 추가창이 뜨면 아래와 같은 속성을 입력합니다.

418_kakaomomentcustomeventplus_KR_jw_04.png

커스텀이벤트명: 카카오모먼트 대시보드에 노출될 커스텀 이벤트 이름을 입력합니다.

서비스 출처: ‘선택안함' 상태 그대로 둡니다.

태그: 포스트백을 전송할 때 사용할 태그 값으로, 설정하려는 커스텀 이벤트의 성격에 맞게 입력합니다.

매개변수: 특정 표준 이벤트에 한해 매개변수의 상세 조건을 추가합니다. 표준 이벤트별 생성 가능한 매개변수와 각 매개변수의 특징은 다음과 같습니다.

표준 이벤트 매개변수 설명

콘텐츠/상품 조회(ViewContent)

장바구니추가(AddToCart)

관심상품 추가(AddToWishList)

ID 상품 고유값을 ,(콤마)로 구분해서 최대 10개까지 입력할 수 있습니다.
검색(Search) Keyword 검색 키워드를 ,(콤마)로 구분해서 최대 10개까지 입력할 수 있습니다.
구매(Purchase)

ID

Total Price

Total Quantity

상품 고유값, 총 구매 금액, 총 구매 건수를 입력할 수 있으며, 이중 Total Price와 Total Quantity는 최솟값과 최대값을 입력해야 합니다.

코드 예시: 해당 커스텀 이벤트의 코드 예시를 볼 수 있습니다.

blockquote-check.svg

매개변수와 코드 예시

위 표에 없는 표준 이벤트에 커스텀 이벤트를 추가할 때는 매개변수 입력란이 표시되지 않습니다. 또한, 앱실행 표준 이벤트에 커스텀 이벤트를 추가할 때는 코드 예시가 표시되지 않습니다.

7. 정상적으로 저장됐다면 새로운 커스텀 이벤트가 선택한 표준 이벤트 아래 등록된 상태를 볼 수 있습니다. 해당 커스텀 이벤트에 커서를 올리면 설정한 태그 값 역시 확인할 수 있습니다.

418_kakaomomentcustomeventplus_KR_jw_05.png

 

포스트백 URL 생성

blockquote-caution.svg

주의하세요

포스트백 URL 생성은 오너 혹은 마케터 권한을 가진 유저에 의해서만 가능합니다. 만약 에어브릿지에 접근하는 계정의 권한이 오너나 마케터가 아닌 에이전시나 미디어 파트너라면 포스트백 URL을 조회만 할 수 있습니다.

카카오 비즈니스 대시보드에서의 커스텀 이벤트 추가 과정을 거쳤다면 에어브릿지 대시보드에서는 전송할 커스텀 이벤트의 포스트백 URL을 설정해야 합니다.

 

1. 에어브릿지 대시보드에서 [Integrations]>[Integrated Ad Channels]로 이동해 연동하는 매체로 카카오를 선택합니다. 이때 카카오 키워드 광고를 선택하지 않게 주의하시기를 바랍니다.

418_kakaomomentbasicintegration_KR_jw_06.png

2. [포스트백] 탭으로 이동해 [포스트백 URL] 탭을 누르고, ‘+ 포스트백 URL 생성' 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_13.png

3. 커스텀 이벤트 중 카카오 비즈니스 대시보드에서 추가한 커스텀 이벤트를 찾아서 선택하고, ‘다음’ 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_14.png

4. ‘기존 URL 불러오기’ 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_15.png

blockquote-check.svg

인앱이벤트 템플릿

카카오모먼트의 기본 이벤트 중 설치 이벤트를 제외한 인앱이벤트는 모두 같은 템플릿을 사용합니다. 그렇기에 어떤 인앱이벤트를 선택해서 기존 URL을 불러오더라도 원활하게 포스트백 연동을 할 수 있습니다.

5. 이미 카카오로 포스트백을 전송 중인 이벤트를 선택하고, ‘적용’ 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_16.png

6. ‘저장' 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_17.png

7. 생성된 포스트백 URL을 누르고, '상세 보기·수정' 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_18.png

8. 수정창이 뜨면 카카오 비즈니스 대시보드에서 설정한 커스텀 이벤트 태그 값을 활용해 ‘Event Identifier (Channel)’의 값을 입력합니다. ‘카카오 표준 이벤트 이름 + |(수직선) + 카카오 커스텀 이벤트 태그 값’ 같은 형태로 바꿔 써넣고, ‘저장’ 버튼을 누릅니다.

418_kakaomomentpostbackurl_KR_jw_07.png

 

예시1) 카카오 비즈니스 대시보드에서 콘텐츠/상품 조회(ViewContent) 표준 이벤트에 설정한 커스텀 이벤트의 태그 값이 LikeProduct일 때

ViewContent|LikeProduct

 

예시2) 카카오 비즈니스 대시보드에서 앱실행(AppLaunch) 표준 이벤트에 설정한 커스텀 이벤트의 태그 값이 HomeScreen일 때

AppLaunch|HomeScreen

 

이벤트 스키마 설정

전송하려는 커스텀 이벤트의 포스트백 URL을 생성했다면 마지막으로 이벤트 스키마를 설정해야 합니다. 이벤트 스키마를 설정해야 해당 커스텀 이벤트가 발생했을 때 생성한 포스트백 URL로 카카오모먼트에 포스트백을 전송할 수 있습니다.

이벤트 스키마는 아래와 같은 순서로 설정할 수 있습니다.

 

1. [포스트백] 탭에서 [이벤트 스키마] 탭을 누르고, ‘설정' 버튼을 누릅니다.

418_kakaomomenteventskima_KR_jw_20.png

2. 카카오 비즈니스 대시보드에서 생성한 픽셀 & SDK의 ID 값을 포스트백 연동 키로 입력하고, ‘다음' 버튼을 누릅니다. 이미 포스트백 연동을 마친 상태라면 연동 시 입력한 포스트백 연동 키가 빈 칸에 자동으로 입력되어 있습니다.

418_kakaomomenteventskima_KR_jw_21.png

3. 이미 이벤트 스키마가 설정된 이벤트에 추가로 포스트백을 전송할 이벤트까지 선택하고 ‘다음' 버튼을 누릅니다.

418_kakaomomenteventskima_KR_jw_22.png

4. 마지막으로 전송 규칙을 확인하고 ‘저장’ 버튼을 누릅니다.

418_kakaomomenteventskima_KR_jw_23.png

 

 

비용 연동

에어브릿지 대시보드에서 카카오모먼트 계정 로그인을 통해 캠페인을 운영 중인 계정의 비용 데이터를 연동하여 전환 성과와 함께 조회할 수 있습니다.

비용 연동을 통해서 조회할 수 있는 지표는 다음과 같습니다.

  • Metrics
    • 노출수: Impressions (Channel)
    • 클릭수: Clicks (Channel)
    • 광고비용: Cost (Channel)
  • Groupby
    • Event Datetime 필드
      • Event Date, Event Year, Event Month, Event Week, Event Day of the month, Event Day of the week, Event Hour
    • 캠페인 파라미터
      • Channel, Campaign, Ad Group, Ad Creative, Campaign ID, Ad Group ID, Ad Creative ID, Ad Account ID
blockquote-caution.svg

주의하세요

캠페인 파라미터를 설정할 때, 트래킹 링크와 카카오모먼트 대시보드에 동일한 값을 입력하시는 것을 권장합니다. 캠페인 파라미터 값은 영문(대소문자),국문, 숫자, _, -만 사용하기를 강력히 권장합니다. 특히 기호(/, #, +) 및 공백은 사용하지 않는 것을 권고합니다. 자세한 내용은 트래킹 링크 구조와 파라미터를 참조하시기 바랍니다.

 

 

설정하기

 

1. [Integrations]>[Integrated Ad Channels]>[카카오]에 있는 [비용 연동] 탭을 클릭합니다. [Integrated Ad Channels]에서 [카카오 키워드 광고]가 아닌 [카카오]를 선택합니다. 이후, [비용 연동] 탭에서 카카오모먼트 비용 연동 토글을 클릭해 켭니다.

418_kakadaCost_KR_js_01.png

 

2. 카카오모먼트 비용 연동 토글이 켜지면 ‘카카오 로그인’ 버튼이 생깁니다. ‘카카오 로그인' 버튼을 클릭해서 로그인 과정을 진행합니다. 로그인 하는 계정은 비용을 연동하는 광고 계정과 연결되어 있어야 합니다.

418_kakadaCost_KR_js_02.png

 

3. 카카오 광고 계정 목록에서 연동할 카카오 광고 계정을 선택합니다.

418_kakadaCost_KR_js_03.png

 

4. 비용 연동이 된 계정은 하단 리스트에 표시됩니다. 연동 직후의 계정 상태는 Waiting입니다. 데이터 연동 스케줄에 맞춰 데이터가 동기화가 이뤄지면, 계정 상태는 Active가 됩니다.

blockquote-check.svg

대시보드 설정 변경 기록

대시보드 설정 변경 기록은 계정 리스트의 위에 있는 최근 수정일과 최근 수정 계정 항목에서 확인할 수 있습니다. 이 항목 옆에 있는 화살표 아이콘을 클릭해 Activity History에서 ‘Kakao’라는 매체의 최근 수정일에 변경된 설정을 확인할 수 있습니다.

418_kakadaCost_KR_js_05.png

 

 

중단하기

  • ‘비용 연동 토글’을 비활성화하면 연동된 모든 광고 계정을 통한 비용 연동이 중단됩니다.
  • 연동을 중지하는 시점부터 데이터를 가져오지 않으며, 연동 중단 이전의 데이터는 계속 확인할 수 있습니다.
  • 연동된 광고 계정을 삭제하지 않은 상태로 '비용 연동' 토글만 비활성화하면 연동된 계정 정보는 저장됩니다.
  • 이후 토글을 다시 활성화하면 저장되었던 계정 정보를 불러오며 별도의 로그인이 필요하지 않습니다.

 

연동 계정 삭제

잘못된 광고 계정을 연동했거나 해당 광고 계정으로 더이상 광고를 운영하지 않는 경우 연동된 광고 계정 테이블의 우측에 위치한 ['관리' > '삭제'] 를 클릭하여 광고 계정을 삭제할 수 있습니다.

kakao_da_account_delete.png

 

광고 계정 추가

기존에 연동을 완료한 카카오 광고 계정 외에 다른 광고 계정을 추가하려는 경우 '카카오 로그인' 버튼을 클릭하여 카카오 광고 계정을 추가로 등록할 수 있습니다. 이후 과정은 비용 연동 설정과 동일합니다.

 

 

비용 데이터 참고사항

업데이트 주기

'카카오 비용 연동' 토글이 ON인 상태에서 광고 계정 등록이 완료되면 비용 데이터 수집이 시작됩니다. 비용 데이터의 업데이트는 매일 4시간 간격으로(0시, 4시, 8시, 12시, 16시, 20시) 진행되며, 오늘 포함 최근 7일치의 비용 데이터가 업데이트됩니다.

 

연동 상태

  • Waiting: 광고 계정 추가 후 4시간 간격의 업데이트가 진행되기 전까지의 대기 상태입니다. 비용 데이터 업데이트는 매일 4시간 간격으로(0시, 4시, 8시, 12시, 16시, 20시) 진행됩니다.
  • Active: 최근에 정상적으로 비용 데이터 업데이트가 완료되었으며, 가장 최근의 업데이트 완료 시간이 노출됩니다.
  • Error: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트되지 않습니다.
    • 카카오 로그인 정보가 올바르지 않습니다
      • 로그인 에러로, 연동된 계정의 비밀번호 변경 등과 같은 이슈로 인해 발생합니다. 이슈 해결을 위해서는 해당 계정을 삭제 후 광고 계정을 다시 등록합니다.
    • 카카오 API가 응답하지 않습니다
      • 가장 최근에 진행된 업데이트 작업에서 카카오모먼트 API가 응답하지 않은 경우입니다.
  • Warning: 가장 최근에 진행된 업데이트 작업에서 데이터를 업데이트 시도하였으나 오늘 포함 최근 7일 동안 캠페인이 운영되지 않아 연동된 데이터가 없는 경우입니다.
  • Expired: 아래 상황 중 하나에 해당하는 경우, 비용 데이터가 정상적으로 업데이트되지 않습니다.
    • 카카오모먼트 연동 토큰이 만료된 경우
    • 연동한 카카오 디벨로퍼스의 애플리케이션을 삭제한 경우
    • 연동한 카카오 디벨로퍼스의 REST API 키를 재발급한 경우
    • 연동된 광고 계정이 비활성화된 경우

 

 

데이터 조회하기

연동된 비용 데이터는 Actuals 리포트에서 아래 메트릭을 추가하여 확인하실 수 있습니다.

  • Touchpoint
    • Impressions (Channel)
    • Clicks (Channel)
  • Cost
    • Cost (Channel)

      https://help.airbridge.io/hc/article_attachments/4407497457689/mceclip0.png

blockquote-check.svg

Impressions vs Impressions(Channel)

'Impressions', 'Clicks' 메트릭은 에어브릿지에서 트래킹 링크를 통해 직접 수집한 데이터이며, 'Impressions (Channel)', 'Clicks(Channel)' 메트릭은 매체(카카오모먼트) 연동을 통해 수집한 데이터입니다.

 

 

데이터 조회 시 유의 사항

카카오모먼트의 비용 데이터 조회 시 아래 사항들에 유의하시기 바랍니다.

 

비용 데이터 수치 차이

    • 비용 데이터는 변경될 수 있습니다. 카카오모먼트에서 최근 7일 내의 비용 데이터를 업데이트하면 에어브릿지에도 비용 데이터가 업데이트됩니다.
    • 비용 데이터는 실시간이 아닌 4시간 간격으로 업데이트 됩니다. 따라서 비용 데이터 조회 시점에 따라서 매체 측 데이터와 약간의 오차가 발생할 수 있습니다. (예. 2021년 9월 9일에 확인한 2021년 9월 8일의 데이터와 2021년 9월 10일에 확인한 2021년 9월 8일의 데이터가 다를 수 있습니다. 카카오모먼트의 비용 데이터가 업데이트되면 업데이트된 값을 다시 가져오기 때문입니다.)

캠페인 파라미터 관련

    • 카카오모먼트 채널에 사용하는 트래킹 링크 기본 탬플릿에는 캠페인 ID, 광고그룹 ID, 소재 ID를 받는 부분이 없습니다.
    • 반면에 카카오모먼트 API로 가져온 캠페인 파라미터에는 캠페인 ID, 광고그룹 ID, 소재 ID가 있습니다.
    • 따라서 카카오 채널의 데이터에 대해 캠페인 ID로 분류(Groupby)를 하면 트래킹 링크로 가져온 데이터는 값이 비어져 있을 것이고, 카카오 API로 가져온 데이터에는 값이 채워져 있습니다.
    • 카카오모먼트 대시보드의 캠페인 이름과 트래킹 링크 파라미터의 캠페인 이름은 동일하게 설정하기를 권장합니다. 같은 캠페인의 이름을 다르게 설정할 경우 비용 데이터 연동에 오차가 발생할 수 있기 때문입니다. 

비용 데이터 미노출

    • Actuals 리포트에서 캠페인, 광고그룹, 광고 소재 이외의 항목으로 Groupby를 설정하면 해당 Groupby행에는 비용 데이터가 표시되지 않습니다.
      • Campaign ID로 Group by를 설정하면 해당 Campaign ID에 대한 Cost(Channel) 값 노출됩니다.

        https://help.airbridge.io/hc/article_attachments/4407533463833/mceclip1.png

      • Campaign ID 값 외에 Event Category 등의 항목을 추가하면 Event Category 값이 있는 행에는 Cost(Channel) 값이 노출되지 않습니다.

        https://help.airbridge.io/hc/article_attachments/4407533344665/first.png