카카오 모먼트

커스텀 이벤트 포스트백 전송

카카오 모먼트의 경우 현재 아래와 같은 표준 이벤트들을 지원하고 있으며, 아래 카카오 표준 이벤트들과 맵핑되지 않는 에어브릿지 기본 이벤트 및 커스텀 이벤트는 카카오 모먼트의 커스텀 이벤트로 맵핑하여 포스트백을 전송해야 합니다.

카카오 픽셀&SDK 표준 이벤트명

카카오 모먼트 노출 이벤트명

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

 

에어브릿지 기본 이벤트 중 카카오 모먼트의 표준 이벤트와 맵핑이 되지 않는 이벤트들은 다음과 같습니다.

  • Home Screen
  • Product Catalog
  • Sign-in

카카오 모먼트의 표준 이벤트와 맵핑되지 않는 커스텀 이벤트는 모두 카카오 모먼트의 앱실행 이벤트(AppLaunch)로 맵핑이되며, 카카오 모먼트의 태그 기능을 사용하여 커스텀 이벤트로 별도 분류가 가능합니다.

카카오 모먼트의 커스텀 이벤트로 치환하여 포스트백을 전송하기 위해서는 '카카오 비즈니스 내 픽셀&SDK 페이지에서의 태그 설정' 및 '에어브릿지 대시보드 내에서의 포스트백 URL 설정' 두가지 설정이 필요합니다.

 

카카오 비즈니스 픽셀&SDK 태그 설정

아래 가이드에 따라 카카오 비즈니스 대시보드에서 전송할 커스텀 이벤트에 대한 픽셀&SDK 태그를 설정합니다.

  1. 카카오 비즈니스 대시보드로 접속하여 상단 메뉴에서 [서비스/도구 > 픽셀 & SDK] 페이지로 이동합니다.
    mceclip0.png

  2. 에어브릿지와 연동한 픽셀&SDK를 선택합니다.
    mceclip1.png

  3. 픽셀&SDK 연동 현황 섹션에서 [수집 이벤트] 탭을 클릭한 후 '앱실행' 이벤트의 태그 관리에서 '추가' 버튼을 클릭합니다.

    💡 카카오 모먼트의 표준 이벤트와 맵핑되지 않는 커스텀 이벤트는 모두 카카오 모먼트의 '앱실행 이벤트(AppLaunch)'로 분류되며, 하위 태그명을 통해서 커스텀 이벤트별로 분류가 가능합니다.

    mceclip3.png

  4. 태그 추가 모달이 노출되면 '이벤트 이름'으로 카카오 모먼트 대시보드에 노출될 커스텀 이벤트의 이름을 입력하고, '태그값'으로는 포스트백 전송 시 사용할 태그값(커스텀 이벤트명)을 입력 후 저장합니다. 추후 에어브릿지 대시보드에서 포스트백 URL 설정 시 여기서 입력한 태그값을 활용합니다.
    mceclip7.png
  5. 저장이 완료되면 '앱실행' 이벤트 하위에 입력한 이벤트 이름 및 태그값으로 추가 이벤트(커스텀 이벤트)가 등록된 것을 확인할 수 있으며, 이어서 에어브릿지 대시보드에서 포스트백 URL 생성 및 전송 설정을 완료해주시기 바랍니다. 
    mceclip5.png

 

 

커스텀 이벤트 포스트백 URL 생성

카카오 비즈니스 픽셀&SDK 태그 설정이 완료되면 아래 가이드에 따라 에어브릿지 대시보드에서 전송할 커스텀 이벤트에 대한 포스트백 URL을 설정합니다.

  1. 에어브릿지 대시보드에서 [Integrations > Integrated Channels > 카카오 > 포스트백 > 포스트백 URL] 탭으로 이동합니다.
  2. '포스트백 URL 생성' 버튼을 클릭하여 노출된 이벤트 중 커스텀 이벤트로 전송할 이벤트(카카오 비즈니스에서 픽셀&SDK 태그 설정을 완료한 이벤트)를 선택 후 '다음' 버튼을 클릭합니다.
    mceclip8.png
  3. '기존 URL 불러오기' 버튼을 클릭하고 현재 카카오로 전송중인 포스트백 URL 템플릿 중 하나를 선택 후 '적용' 버튼을 클릭합니다.
    * 현재 카카오 모먼트의 경우 표준 이벤트 중 설치 이벤트를 제외한 인앱 이벤트들은 모두 동일한 템플릿을 사용하고 있기 때문에 어떠한 인앱 이벤트를 선택하여 기존 URL을 불러오더라도 상관없습니다.
  4. 기존 URL을 불러왔으면 '저장' 버튼을 클릭하여 커스텀 이벤트에 대한 포스트백 URL 생성을 완료합니다.
  5. 이후 포스트백 URL 리스트 내에서 조금 전 생성한 포스트백 URL을 클릭하여 '상세 보기•수정' 버튼을 클릭합니다.
    mceclip9.png
  6. 수정창이 노출되면 'Event Identifier (Channel)'를 카카오 모먼트 대시보드에서 설정한 '태그값(커스텀이벤트명) + |(파이프라인) + 태그값(커스텀이벤트명)'으로 변경 후 저장하여 커스텀 이벤트에 대한 포스트백 URL 설정을 완료합니다.
    mceclip12.png

    • 예) 카카오 모먼트 대시보드에서 앱실행(AppLaunch) 하위에 설정한 태그값(커스텀 이벤트명)이 LikeProduct 인 경우 : 'LikeProduct|LikeProduct' 으로 변경
    • 예) 카카오 모먼트 대시보드에서 앱실행(AppLaunch) 하위에 설정한 태그값(커스텀 이벤트명)이 HomeScreen 인 경우 : 'HomeScreen|HomeScreen' 으로 변경

 

이벤트 스키마 설정

전송하고자하는 커스텀 이벤트에 대한 포스트백 URL을 생성 완료 후 해당 커스텀 이벤트 발생 시 생성한 포스트백 URL로 포스트백 전송될 수 있도록 이벤트 스키마를 설정합니다.

  1. 에어브릿지 대시보드에서 [Integrations > Integrated Channels > 카카오 > 포스트백 > 이벤트 스키마] 탭으로 이동합니다.
  2. '설정' 버튼을 클릭 후 포스트백 연동 키를 입력하고 '다음' 버튼을 클릭합니다.
    * 이미 등록된 포스트백이 있는 경우 연동 키 값이 자동으로 채워져 있습니다.
  3. 이미 이벤트 스키마가 설정된 이벤트에 추가로 포스트백을 전송할 이벤트를 선택하고 '다음' 버튼을 클릭 후 저장하여 설정을 마무리합니다.

 

비용 연동

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

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

  • 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

⚠️ 캠페인 파라미터 설정 시, 트래킹 링크와 카카오 모먼트 대시보드에 동일한 값을 입력하시는 것을 권장합니다.

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

 

설정하기

카카오 모먼트의 비용을 연동을 위해서는 카카오 디벨로퍼스 대시보드와 에어브릿지 대시보드에서 설정하는 과정이 모두 필요합니다. 각각의 대시보드에서 비용 연동을 설정하는 방법은 다음과 같습니다.

 

카카오 디벨로퍼스 대시보드에서 해야할 일 요약

  • 새 애플리케이션 등록
  • 비즈 앱 정보 등록 (사업자 정보 입력)
  • 플랫폼 등록 (Web만 등록하셔도 됩니다)
  • Redirect URI 등록 (에어브릿지 대시보드에 있는 Redirect URI를 복사해서 붙여 넣으세요)

에어브릿지 대시보드에서 해야할 일 요약

  • REST API 키 등록 (카카오 디벨로퍼스에 있는 REST API 키를 복사해서 붙여 넣으세요)
  • 비용 연동 토글 켜기
  • 카카오 로그인해서 연동할 광고 계정 선택하기

 

카카오 디벨로퍼스 대시보드에서 해야할 일

앱 정보 등록하기

1. 카카오 디벨로퍼스 에서 현재 광고를 운영중인 카카오 계정으로 로그인 합니다.

⚠️ 현재 카카오모먼트 광고를 운영하고 있는 계정으로 로그인합니다.

2. [내 애플리케이션] > [애플리케이션 추가하기]를 클릭합니다.
2.Kakao_developers_add.png

3. 앱 아이콘, 앱 이름, 사업자명을 정확하게 입력 후 저장합니다.

3.Kakao_developers_add_app.png

⚠️ 앱 아이콘 이미지를 등록하지 않으면 비즈앱으로 전환할 수 없습니다.

4. 왼쪽 메뉴바에서 [앱 설정] > [플랫폼 등록]을 선택 후 [Web 플랫폼 등록]을 클릭하여 내용을 입력합니다. 안드로이드 및 iOS 플랫폼은 선택 사항입니다.

4.kakao_developers_webplatform.png

⚠️ 웹 플랫폼이 없는 경우, http://app.airbridge.io를 입력하세요.

5. 왼쪽 메뉴바에서 [앱 설정] > [비즈니스]에서 [사업자 정보 등록]을 클릭하여 사업자 등록번호를 입력합니다.
5.kakao_developers_besiness.png

 

Redirect URI 등록하기

6. 에어브릿지 대시보드에서 [Integrated Ad Channels] > [카카오] > [비용연동] 메뉴의 Redirect URI를 복사합니다.
6.kakao_da_redirecturl.png

7. 카카오 디벨로퍼스 대시보드의 [제품 설정] > [카카오 로그인] > Redirect URI 등록 클릭 후 나타나는 팝업창에 복사한 Redirect URI를 붙여넣습니다.
7.kakao_developers_redirecturi.png

 

카카오 Open API 사용 권한 신청하기

8. 카카오 디벨로퍼스에 등록한 앱을 비즈앱으로 전환한 후 카카오 모먼트의 API 권한을 신청하셔야 연동 작업이 완료됩니다. API 사용 권한 신청은 마케터가 카카오 모먼트 담당자에 신청해야합니다.

 

에어브릿지 대시보드에서 해야할 일

REST API 등록하기

1. 카카오 디벨로퍼스 대시보드의 [앱 설정] >[요약 정보] >[앱 키] 메뉴의 REST API 키를 복사합니다.
1.kakao_developers_restapi.png

2. 에어브릿지 대시보드에서 [비용 연동] 메뉴의 REST API 키 입력창에 붙여넣습니다.
2.kakao_da_restapi.png

3. 카카오 비용 연동 토글을 켜고 카카오 로그인 버튼을 클릭합니다.

3.kakao_da_toggle.png

⚠️ REST API 키를 입력하지 않으면 토글 버튼을 활성화할 수 없습니다.

4. 비용을 연동할 광고 계정과 연결되어 있는 카카오 계정으로 로그인합니다.
4.kakao_login.png

5. 로그인 후 카카오 광고 계정 목록을 불러옵니다. 에어브릿지에서 비용을 확인할 광고 계정을 선택합니다.

5.kakao_select_account.png

⚠️ 카카오 광고 계정을 불러오려면 카카오 모먼트 API 사용 권한 신청이 완료되어야 합니다.

6. 선택 완료를 클릭하면 연동이 완료됩니다.
6.kakao_da_sucess.png

  • 연동 직후에는 Waiting 상태로 표시됩니다. 이후 데이터 연동 스케줄에 맞춰 데이터가 동기화되면 Active 상태로 표시됩니다.

💡Tip! 대시보드에서 설정을 변경하는 경우 최근 수정일 및 해당 액션을 수행한 최근 수정 계정 정보가 표기되며, 화살표 아이콘을 클릭하여 해당 날짜 및 'Kakao' 로 검색된 Activity History로 빠르게 이동할 수 있습니다.
⚠️ 로그인한 계정에서 접근 가능한 광고 계정들 중 현재 연동이 완료된 상태의 광고 계정은 리스트에 노출되지 않습니다.


카카오 계정 로그인이 정상적으로 완료되지 않은 경우, 아래의 상황별 해결방안을 참고하시기 바랍니다.

상황  원인  해결 방안 
관리자 설정 이슈(KOE006) Redirect URI 미설정 혹은 오류 Redirect URI 등록 및 확인
관리자 설정 이슈(KOE101) REST API 미설정 혹은 오류 REST API 등록 및 확인
광고 계정 선택 모달에서 승인 거부 카카오에 API 사용 미승인 API 승인 신청 후 로그인 재시도
에러 메세지 없이 로그인 불가 해당 광고 계정에 권한 없는 계정으로 로그인 시도 광고 계정에 권한이 있는 카카오 계정으로 로그인 재시도

 

  • 카카오 계정 로그인 시도 후 관리자 설정 이슈(KOE006) 오류가 나는 경우
    kakao_login_keo006_.png

    • 원인: 카카오 디벨로퍼스 대시보드에 Redirect URI를 등록하지 않았거나, 비정상적인 Redirect URI을 등록한 경우에 발생합니다.
    • 해결: 에어브릿지 대시보드에서 제공하는 Redirect URI를 카카오 디벨로퍼스 대시보드에 입력하시기 바랍니다.

     

  • 카카오 계정 로그인 시도 후 관리자 설정 이슈(KOE101) 오류가 나는 경우
    kakao_login_keo101_.png

    • 원인: 에어브릿지 대시보드에 REST API를 등록하지 않았거나 비정상적인 REST API를 등록한 경우에 발생합니다.
    • 해결: 카카오 디벨로퍼스에서 제공하는 REST API를 에어브릿지 대시보드에 입력하시기 바랍니다.

     

  • 광고 계정 선택 단계 후 승인이 거부되고 API 접근 오류가 나는 경우
    kakao_login_api_denied.png

    • 원인: 매체(카카오 모먼트) 측에 API 권한 신청을 받지 않은 경우에 발생합니다.
    • 해결: 매체 측에 API 권한 신청을 받은 후 로그인을 시도하시기 바랍니다.

     

  • 별도의 에러메세지 없이 로그인이 완료되지 않는 경우
    kakao_login_noaccount.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

💡 '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

 

도움이 되었습니까?
0명 중 0명이 도움이 되었다고 했습니다.