당근 광고 연동
adstage에서는 당근 광고로 유입된 클릭·설치·이벤트를 트래킹 링크로 측정해 daangn.ads 채널로 집계할 수 있습니다. 당근 광고 소재의 랜딩 URL에 adstage 트래킹 링크를 넣으면, 당근이 클릭 순간 캠페인·광고 그룹·소재 ID와 클릭 ID를 링크에 채워 보냅니다.
1. 연동 개요
| 기능 | 지원 여부 | 설명 |
|---|---|---|
| 클릭 귀속 | 지원 | 트래킹 링크로 유입된 클릭·설치·이벤트를 daangn.ads 채널로 집계 |
| 전환 전송 | 지원 | adstage가 측정한 전환을 당근 광고 OpenAPI로 전송 (전환 추적 코드 + OpenAPI 키) |
| 비용 수집 | 지원 | 당근 광고 OpenAPI 성과 조회로 캠페인별 일자 비용 수집 (KST·KRW) |
당근은 2026년부터 당근 광고 OpenAPI를 제공합니다. 광고주가 전문가모드 온라인 문의에서 키를 직접 발급받으면 MMP 등재 협의 없이 비용 수집과 전환 전송을 바로 켤 수 있습니다. OpenAPI는 전문가모드 광고 계정 에서만 쓸 수 있고, 키 1개는 광고 계정 1개를 담당합니다.
2. 트래킹 링크 만들기
-
딥링크 > 생성에서 트래킹 링크를 선택합니다.
-
광고 채널로
Daangn Ads를 선택합니다. -
캠페인·광고 그룹·광고소재 칸에 이름을 직접 입력합니다. 당근은 이름 매크로를 제공하지 않고 ID 매크로만 제공합니다. 이름을 비워도 ID는 항상 기록되지만, 리포트에서 알아보기 쉽도록 당근 광고 관리자의 이름과 같게 넣는 것을 권장합니다.
-
검색광고라면 키워드 칸에
{{keyword}}를 입력합니다. 당근이 사용자가 검색한 키워드로 바꿔 줍니다. 검색광고가 아니면 비워두세요. -
리다이렉트 설정(앱스토어·앱·웹)을 지정하고 저장한 뒤, 생성된 트래킹 링크를 복사합니다.
링크에는 다음 매크로가 들어갑니다. 클릭 ID와 캠페인·광고 그룹·소재 ID는 입력 여부와 관계없이 항상 붙습니다.
| adstage 파라미터 | 당근 매크로 | 값 |
|---|---|---|
click_id | {{click_id}} | 당근 광고 클릭 ID (클릭마다 부여, 귀속 기준) |
campaign_id | {{campaign_id}} | 캠페인 ID |
ad_group_id | {{adgroup_id}} | 광고 그룹 ID |
ad_creative_id | {{material_id}} | 광고 소재 ID |
term | {{keyword}} | 검색 키워드 (검색광고, 키워드 칸에 입력한 경우만) |
campaign ad_group ad_creative | 없음 | 직접 입력한 이름 |
예시:
3. 당근 광고에 링크 넣기
당근 광고 관리자에서 광고 소재를 만들 때 랜딩 URL에 위에서 복사한 트래킹 링크를 넣습니다. 당근은 광고 클릭 시 링크 안의 {{...}} 자리를 실제 값으로 바꾼 뒤 그 주소로 이동시킵니다.
주의하세요
- 당근은 축약 URL 사용을 권장하지 않습니다.
adg.im/{링크경로}형태의 짧은 주소가 아니라, 위처럼 매크로가 들어간 트래킹 링크 원본을 넣으세요.- 당근의 변동 파라미터는 웹사이트로 랜딩되는 광고를 기준으로 안내되어 있습니다. 앱 설치를 목표로 하는 광고에서 치환되는지는 집행 전 테스트 클릭으로 확인하세요. 리포트에서
campaign_id등이{{campaign_id}}그대로 남아 있다면 치환되지 않은 것입니다.
4. OpenAPI 키 발급받기
비용 수집과 전환 전송은 모두 당근 광고 OpenAPI 키 하나로 동작합니다. 키는 광고주가 직접 신청합니다.
- 당근비즈니스 전문가모드에 로그인하고 왼쪽 메뉴 하단의 [고객센터] > [온라인 문의] 를 누릅니다.
- [+ 문의하기] 에서 문의 유형을 [광고 도구 및 전환] > [OpenAPI 키 발급] 으로 고릅니다.
- 키를 발급받을 광고 계정(광고주 ID) 을 선택하고 문의를 등록합니다.
- 바로 오는 키 확인 링크를 열어 키를 복사합니다.
주의하세요
- 키 확인 링크는 받은 뒤 24시간 안에 한 번만 열 수 있습니다. 열자마자 안전한 곳에 저장하세요.
- 키를 새로 발급받으면 기존 키는 즉시 폐기됩니다. 재발급했다면 adstage에 넣은 키도 새 키로 바꿔야 합니다.
- OpenAPI는 전문가모드 광고 계정에서만 쓸 수 있습니다. 간편모드 계정은 키를 발급받을 수 없습니다.
- 키 1개는 광고 계정 1개만 담당합니다. 여러 계정을 운영한다면 계정마다 키를 발급받아 각각 등록하세요.
5. 비용 수집 켜기
연동 > 광고 채널 연동 > Daangn Ads > 비용 연동 탭에서 계정 추가를 누르고 OpenAPI 키와
광고 계정 ID를 넣습니다. 당근은 모든 API 호출에 광고 계정 ID(X-ADVERTISER-ID)를 요구하므로
두 값이 모두 있어야 연동됩니다(키만 보내면 당근이 401로 거절합니다).
adstage는 캠페인 목록을 먼저 읽고, 캠페인별 일자 성과(노출·도달·클릭·비용·설치·전환)를 가져옵니다. 리포트 기준은 KST(Asia/Seoul)·KRW 입니다.
6. 전환 전송 켜기
- 당근 전문가모드 광고 도구 > 전환 추적 관리에서 전환 추적 코드를 만들고 코드 ID(kmctc) 를 복사합니다.
- 연동 > 광고 채널 연동 > Daangn Ads > 전환 API 탭에서 전환 추적 코드·OpenAPI 키·광고 계정 ID를 저장합니다.
- 앱 전환을 보낸다면 앱 ID 칸도 채웁니다(당근이 앱 전환에 앱 ID를 요구합니다).
- 토글을 켜면 adstage가 측정한 전환이 당근으로 전송됩니다.
보내는 이벤트는 당근의 전환 이벤트 9종(설치·방문·회원가입·로그인·상세페이지 조회·장바구니 담기·잠재고객
수집·구매·서비스 신청)으로 매핑됩니다. 기본 매핑에 없는 커스텀 이벤트는 전송되지 않습니다.
page_view·screen_view 같은 조회성 이벤트는 호출량이 많아 기본 전송에서 빠져 있습니다. 방문
전환(VIEW_PAGE)을 당근에 보내야 한다면 이벤트 매핑 설정이 필요하니 고객지원으로 요청하세요.
설치 이벤트는 기기당 한 번만 보냅니다. 네이티브 SDK가 첫 실행에 install과 first_open을 연달아
보내도 당근에는 설치가 1건으로 전송됩니다.
주의하세요
- 당근으로 귀속된 전환만 보냅니다(당근 클릭 ID
kmckid가 있거나 채널이daangn.ads인 이벤트).- 당근은 MMP에게 채널 기여와 상관없이 모든 이벤트를 보내도록 요구합니다. adstage는 이 요구를 따르지 않고 당근 귀속 전환만 보냅니다 — 타 매체로 들어온 전환까지 보내면 당근이 그 성과를 자기 것으로 집계하기 때문입니다. 그래서 당근 광고 관리자에 보이는 전환 수가 당근 자체 집계(당근 픽셀·등재 MMP)보다 적을 수 있습니다. 두 숫자가 다른 것은 정상이며, adstage 리포트의 전환이 실제 당근 기여 전환입니다.
- 링크 단위로 설정하는 매체사 포스트백과는 별개 기능입니다. 당근 전환 전송은 이 탭에서 켜세요.
- 당근이 지정한 MMP(AppsFlyer, Airbridge, Adjust, Branch, Singular, Dfinery)에 전환 추적 코드를 따로 등록해 쓰고 있다면, 같은 전환이 두 번 집계되지 않도록 한쪽만 쓰세요.
7. 수집되는 데이터
| 항목 | 설명 |
|---|---|
| 채널명 | daangn.ads |
| 귀속 기준 | 당근 광고 클릭 ID(click_id) |
| 리포트 구분 | 캠페인·광고 그룹·소재 ID, 직접 입력한 이름, 검색 키워드 |
채널 이름을 daangn, karrot, 당근으로 직접 입력해 만든 기존 링크로 새로 들어오는 데이터도 daangn.ads 채널로 집계됩니다.

