adstage
트래킹연동하기

당근 광고 연동

adstage에서는 당근 광고로 유입된 클릭·설치·이벤트를 트래킹 링크로 측정해 daangn.ads 채널로 집계할 수 있습니다. 당근 광고 소재의 랜딩 URL에 adstage 트래킹 링크를 넣으면, 당근이 클릭 순간 캠페인·광고 그룹·소재 ID와 클릭 ID를 링크에 채워 보냅니다.

1. 연동 개요

기능지원 여부설명
클릭 귀속지원트래킹 링크로 유입된 클릭·설치·이벤트를 daangn.ads 채널로 집계
전환 전송지원adstage가 측정한 전환을 당근 광고 OpenAPI로 전송 (전환 추적 코드 + OpenAPI 키)
비용 수집지원당근 광고 OpenAPI 성과 조회로 캠페인별 일자 비용 수집 (KST·KRW)

당근은 2026년부터 당근 광고 OpenAPI를 제공합니다. 광고주가 전문가모드 온라인 문의에서 키를 직접 발급받으면 MMP 등재 협의 없이 비용 수집과 전환 전송을 바로 켤 수 있습니다. OpenAPI는 전문가모드 광고 계정 에서만 쓸 수 있고, 키 1개는 광고 계정 1개를 담당합니다.

2. 트래킹 링크 만들기

  1. 딥링크 > 생성에서 트래킹 링크를 선택합니다.

  2. 광고 채널로 Daangn Ads를 선택합니다.

  3. 캠페인·광고 그룹·광고소재 칸에 이름을 직접 입력합니다. 당근은 이름 매크로를 제공하지 않고 ID 매크로만 제공합니다. 이름을 비워도 ID는 항상 기록되지만, 리포트에서 알아보기 쉽도록 당근 광고 관리자의 이름과 같게 넣는 것을 권장합니다.

  4. 검색광고라면 키워드 칸에 {{keyword}}를 입력합니다. 당근이 사용자가 검색한 키워드로 바꿔 줍니다. 검색광고가 아니면 비워두세요.

  5. 리다이렉트 설정(앱스토어·앱·웹)을 지정하고 저장한 뒤, 생성된 트래킹 링크를 복사합니다.

링크에는 다음 매크로가 들어갑니다. 클릭 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없음직접 입력한 이름

예시:

https://adg.im/@{조직}/track/daangn.ads?short_path={링크경로}&campaign=fall_promo&campaign_id={{campaign_id}}&ad_group_id={{adgroup_id}}&ad_creative_id={{material_id}}&click_id={{click_id}}

3. 당근 광고에 링크 넣기

당근 광고 관리자에서 광고 소재를 만들 때 랜딩 URL에 위에서 복사한 트래킹 링크를 넣습니다. 당근은 광고 클릭 시 링크 안의 {{...}} 자리를 실제 값으로 바꾼 뒤 그 주소로 이동시킵니다.

주의하세요

  • 당근은 축약 URL 사용을 권장하지 않습니다. adg.im/{링크경로} 형태의 짧은 주소가 아니라, 위처럼 매크로가 들어간 트래킹 링크 원본을 넣으세요.
  • 당근의 변동 파라미터는 웹사이트로 랜딩되는 광고를 기준으로 안내되어 있습니다. 앱 설치를 목표로 하는 광고에서 치환되는지는 집행 전 테스트 클릭으로 확인하세요. 리포트에서 campaign_id 등이 {{campaign_id}} 그대로 남아 있다면 치환되지 않은 것입니다.

4. OpenAPI 키 발급받기

비용 수집과 전환 전송은 모두 당근 광고 OpenAPI 키 하나로 동작합니다. 키는 광고주가 직접 신청합니다.

  1. 당근비즈니스 전문가모드에 로그인하고 왼쪽 메뉴 하단의 [고객센터] > [온라인 문의] 를 누릅니다.
  2. [+ 문의하기] 에서 문의 유형을 [광고 도구 및 전환] > [OpenAPI 키 발급] 으로 고릅니다.
  3. 키를 발급받을 광고 계정(광고주 ID) 을 선택하고 문의를 등록합니다.
  4. 바로 오는 키 확인 링크를 열어 키를 복사합니다.

주의하세요

  • 키 확인 링크는 받은 뒤 24시간 안에 한 번만 열 수 있습니다. 열자마자 안전한 곳에 저장하세요.
  • 키를 새로 발급받으면 기존 키는 즉시 폐기됩니다. 재발급했다면 adstage에 넣은 키도 새 키로 바꿔야 합니다.
  • OpenAPI는 전문가모드 광고 계정에서만 쓸 수 있습니다. 간편모드 계정은 키를 발급받을 수 없습니다.
  • 키 1개는 광고 계정 1개만 담당합니다. 여러 계정을 운영한다면 계정마다 키를 발급받아 각각 등록하세요.

5. 비용 수집 켜기

연동 > 광고 채널 연동 > Daangn Ads > 비용 연동 탭에서 계정 추가를 누르고 OpenAPI 키와 광고 계정 ID를 넣습니다. 당근은 모든 API 호출에 광고 계정 ID(X-ADVERTISER-ID)를 요구하므로 두 값이 모두 있어야 연동됩니다(키만 보내면 당근이 401로 거절합니다).

adstage는 캠페인 목록을 먼저 읽고, 캠페인별 일자 성과(노출·도달·클릭·비용·설치·전환)를 가져옵니다. 리포트 기준은 KST(Asia/Seoul)·KRW 입니다.

6. 전환 전송 켜기

  1. 당근 전문가모드 광고 도구 > 전환 추적 관리에서 전환 추적 코드를 만들고 코드 ID(kmctc) 를 복사합니다.
  2. 연동 > 광고 채널 연동 > Daangn Ads > 전환 API 탭에서 전환 추적 코드·OpenAPI 키·광고 계정 ID를 저장합니다.
  3. 앱 전환을 보낸다면 앱 ID 칸도 채웁니다(당근이 앱 전환에 앱 ID를 요구합니다).
  4. 토글을 켜면 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 채널로 집계됩니다.

목차