adstage

AppLovin 연동

베타

AppLovin 연동은 실제 광고주 계정으로 검증 중입니다. adstage 수치가 AppLovin 대시보드와 다르면 adstage 고객지원팀에 알려 주세요.

adstage에서는 AppLovin(Axon) 캠페인의 비용·노출·클릭·설치를 자동으로 수집해 리포트에서 확인할 수 있습니다. AppLovin 대시보드에서 발급한 Report Key 하나만 입력하면 되고, 별도 심사나 로그인 승인 절차는 없습니다. 연동은 adstage 대시보드 연동 > 광고 채널 연동 > AppLovin의 비용 연동 탭에서 진행합니다.

1. 연동 개요

기능지원 여부설명
비용 수집지원캠페인별 지출·노출·클릭·설치를 4시간마다 자동 수집
클릭 귀속담당자 확인 필요AppLovin 공식 문서는 지정한 측정 업체(MMP) 6곳으로만 트래킹을 설정하도록 안내합니다. adstage 트래킹 링크를 캠페인에 넣을 수 있는지는 AppLovin 담당자에게 확인해 주세요
전환 전송지원하지 않음adstage가 측정한 전환을 AppLovin으로 보내는 기능입니다. AppLovin이 측정 업체용 포스트백 규격을 공개하지 않아 제공하지 않습니다

2. Report Key 발급받기

Report Key는 AppLovin 리포팅 API를 호출할 때 쓰는 계정 단위 키입니다. 공식 문서가 안내하는 위치는 다음과 같습니다.

  1. AppLovin 광고주 대시보드(ads.applovin.com, 기존 주소 ads.axon.ai도 같은 곳으로 연결됩니다)에 마스터 계정으로 로그인합니다. adstage의 AppLovin 키 발급 페이지 열기 버튼으로도 열 수 있습니다.

  2. 오른쪽 위 계정 이름을 클릭하고 Keys로 이동합니다.

  3. Report Key를 복사합니다.

같은 단계가 adstage 대시보드의 AppLovin 키 발급 방법 안내에도 표시됩니다.

주의하세요

Keys 화면에는 Report Key 외에 Axon Event Key 등 다른 키도 있습니다. adstage에는 Report Key를 넣어야 하며, 다른 키를 넣으면 연동 단계에서 거부됩니다. Keys 메뉴가 보이지 않으면 계정을 관리하는 권한으로 로그인했는지 확인하고, 그래도 없으면 AppLovin 담당자에게 문의하세요.

3. 연동하기

  1. 연동 > 광고 채널 연동에서 AppLovin을 선택하고 비용 연동 탭을 엽니다.

  2. AppLovin 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 연동 계정 추가 버튼을 누를 수 없습니다.

  3. 연동 계정 추가를 클릭하면 AppLovin 비용 연동 창이 열립니다.

  4. 계정 이름에 adstage에서 이 계정을 구분할 이름을 입력하고, Report Key에 복사한 키를 붙여 넣습니다. 키는 입력 중에도 가려져 표시되며 앞뒤 공백은 자동으로 지워집니다.

  5. 연동을 클릭합니다. 저장 전에 adstage가 리포팅 API로 전일 데이터를 한 번 조회해 키가 유효한지 확인하고(버튼에 인증 중...이 표시됩니다), 확인이 끝나면 키는 암호화되어 저장되고 최근 30일 데이터의 첫 수집이 바로 시작됩니다.

연동 직후 계정 상태는 준비 중으로 표시되고, 첫 수집이 끝나면 성공으로 바뀝니다. 보통 몇 분 안에 끝납니다.

연동 단계 오류 메시지원인조치
이미 등록된 계정입니다같은 Report Key가 이 조직에 이미 등록되어 있음기존 계정을 그대로 사용
AppLovin 에서 키를 거부했습니다. 키와 권한을 확인해 주세요.키가 틀렸거나 Report Key가 아닌 다른 키를 입력함Keys 화면에서 Report Key를 다시 복사해 입력
키 확인을 위해 AppLovin 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.AppLovin API 일시 장애 또는 요청 제한잠시 후 다시 시도

4. 연동 계정 관리하기

연동된 계정은 비용 연동 탭의 계정 목록에서 계정명, 상태, 데이터가 업데이트된 최근 일시, 관리(계정 삭제) 열로 확인할 수 있습니다.

  • 상태는 준비 중(첫 수집 진행 중), 성공(마지막 수집 정상), 실패(AppLovin이 키를 거부하는 등)로 표시됩니다. 실패 표시에 마우스를 올리면 오류 내용을 볼 수 있고, 실패 상태여도 업데이트할 때마다 다시 시도해 원인이 해결되면 자동으로 성공으로 돌아옵니다.
  • 상태가 성공이어도 광고 미집행 등으로 데이터가 들어오지 않을 수 있습니다. 비용 데이터가 3일 넘게 저장되지 않으면 상태 옆에 경고 표시가 나타나고, 마우스를 올리면 "N일째 광고비 데이터가 수집되지 않았습니다" 안내가 보입니다.
  • Report Key를 바꾸려면 관리 열의 삭제 아이콘으로 계정을 삭제한 뒤 새 키로 다시 추가합니다. 등록한 키를 화면에서 수정하는 기능은 없습니다.
  • AppLovin 비용 연동 스위치를 끄면 이 조직의 모든 AppLovin 계정 수집이 중단됩니다. 계정 정보는 남아 있어 스위치를 다시 켜면 수집이 재개됩니다.

주의하세요

계정을 삭제하면 해당 계정의 데이터 수집이 중단됩니다. 이미 수집된 과거 데이터는 adstage에 보관되지만, 새로운 데이터는 수집되지 않습니다.

5. 수집되는 데이터

항목설명
수집 주기4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
업데이트 범위최근 30일 (D-30 ~ D-1, 업데이트 당일 제외). 업데이트할 때마다 이 기간을 다시 가져와 최신 값으로 갱신
데이터 계층캠페인 레벨 (일자 × 캠페인)
수집 지표지출, 노출수, 클릭수, 설치수
통화AppLovin 문서에 통화가 명시되어 있지 않아 광고주 과금 통화인 USD로 받고, 조직 기준 통화로 환산해 저장
시간대UTC (AppLovin 리포팅 API 기준)
채널명applovin.ads (리포트 채널 필터에서는 AppLovin)

리포트에서는 매체가 보고한 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다.

리포트 지표AppLovin 값
광고비 (Channel)광고주 지출(cost)
노출수 (Channel)노출(impressions)
클릭수 (Channel)클릭(clicks)
전환수 (Channel)AppLovin이 집계한 설치(conversions)
전환 금액 (Channel)수집하지 않음. 구매 매출은 adstage SDK로 측정한 값을 사용하세요

참고하세요

  • 캠페인은 AppLovin의 외부 캠페인 ID(campaign_id_external)로 구분합니다. 이 ID는 캠페인 이름을 바꿔도 유지되며, 클릭 매크로 {CAMPAIGN_ID}와 같은 값입니다.
  • 같은 날짜·캠페인이 Android와 iOS처럼 여러 행으로 나뉘어 오면 합산해 저장합니다. 플랫폼별로 나눈 수치는 제공되지 않습니다.
  • 지출·노출·클릭·설치가 모두 0인 날은 저장하지 않습니다.
  • AppLovin 리포팅 API는 최근 45일만 조회할 수 있어, 연동 시점에서 45일보다 오래된 데이터는 가져올 수 없습니다.

6. 트래킹 링크와 전환 전송

AppLovin 공식 문서는 캠페인을 집행하려면 AppLovin이 지정한 측정 업체(Adjust, AppsFlyer, Kochava, Tenjin, Singular, Branch)로 트래킹을 설정하도록 안내합니다. 그래서 adstage는 AppLovin용 트래킹 링크 템플릿을 제공하지 않으며, 딥링크 > 생성의 광고 채널 목록에도 AppLovin은 없습니다.

클릭 시 AppLovin이 채워 주는 매크로({CAMPAIGN_ID}, {CAMPAIGN_NAME}, {IDFA}, {EVENT_ID} 등)는 공개되어 있습니다. 목록에 없는 측정 도구의 링크를 캠페인에 넣을 수 있는지는 AppLovin 담당자에게 확인해 주세요. adstage도 AppLovin에 확인을 요청해 둔 상태이며, 회신이 오는 대로 이 페이지를 갱신합니다.

담당자가 허용한다면, 커스텀 링크의 채널 이름에 applovin 또는 axon을 넣어 만든 링크로 들어온 클릭·전환은 비용과 같은 applovin.ads 채널로 집계됩니다.

전환 전송은 제공하지 않습니다. AppLovin이 측정 업체용 포스트백 규격을 공개하지 않아, 링크 단위로 설정하는 매체사 포스트백에도 AppLovin 프리셋이 없습니다. 비용 수집은 트래킹 링크나 전환 전송 없이도 동작하므로, AppLovin 쪽 설치·전환 측정은 기존 MMP 설정을 그대로 두고 adstage는 비용 수집용으로 함께 쓰는 구성을 권장합니다.

7. 주의사항

아래 사항을 주의해 주세요.

  • AppLovin과 adstage 간에 수치 차이가 발생할 수 있습니다. AppLovin 리포트는 UTC 기준이고, 집계 시점과 통화 환산 기준도 다르기 때문입니다.
  • AppLovin에서 Report Key를 재발급하거나 삭제하면 기존 키로는 수집이 중단되고 상태가 실패로 바뀝니다. 계정을 삭제한 뒤 새 키로 다시 등록해 주세요.
  • Report Key는 AppLovin 계정 단위입니다. AppLovin 계정이 여러 개라면 계정마다 키를 발급받아 각각 등록합니다.
  • AppLovin 계정의 과금 통화가 USD가 아니라면 adstage 고객지원팀에 알려 주세요.
  • adstage는 AppLovin 리포트를 읽기만 하며 캠페인 설정을 변경하지 않습니다.

8. 문제 해결

계정 추가가 안 될 때

  1. 키 종류 확인: Keys 화면의 Report Key를 복사했는지 확인 (Axon Event Key 등 다른 키가 아닌지)
  2. 복사 누락 확인: 키가 중간에 끊겨 복사되지 않았는지 확인 (앞뒤 공백은 자동으로 지워집니다)
  3. 스위치 확인: AppLovin 비용 연동 스위치가 켜져 있어야 연동 계정 추가 버튼이 활성화됩니다
  4. 일시 장애: "연결하지 못했습니다" 메시지가 나오면 잠시 후 다시 시도

상태가 실패일 때

  1. 오류 내용 확인: 상태 표시에 마우스를 올려 오류 확인
  2. 인증 실패: "인증 실패 — 다시 연결하거나 키를 확인해 주세요"가 표시되면 키가 폐기·재발급된 것이므로 계정을 삭제하고 새 키로 다시 등록
  3. 요청 제한·일시 오류: 자동으로 다시 시도하므로 다음 업데이트를 기다리면 됩니다

데이터가 수집되지 않을 때

  1. 연동 활성화 확인: AppLovin 비용 연동 스위치가 켜져 있는지 확인
  2. 광고 집행 확인: 지출·노출·클릭·설치가 모두 0인 날은 저장되지 않으므로, AppLovin에서 실제로 광고가 집행되었는지 확인
  3. 업데이트 주기 확인: 첫 수집은 연동 직후 시작되며 이후 4시간마다 갱신됩니다. 당일 데이터는 수집하지 않으므로 오늘 수치는 내일부터 보입니다
  4. 조회 범위 확인: 연동 시점에서 45일보다 오래된 데이터는 가져올 수 없음

수치가 AppLovin 대시보드와 다를 때

  1. 시간대: AppLovin 대시보드를 UTC 기준으로 두고 같은 날짜를 비교
  2. 통화: adstage 값은 조직 기준 통화로 환산된 금액입니다
  3. 집계 시점: AppLovin 값은 사후에 바뀔 수 있으며, 최근 30일을 다시 가져올 때 반영됩니다
  4. 합산 단위: adstage는 캠페인 합계만 저장하므로 AppLovin에서 플랫폼·국가로 나눈 보기와는 직접 비교하지 않습니다

추가 지원이 필요한 경우 adstage 고객지원팀에 문의해 주세요.

9. 자주 묻는 질문

AppLovin 로그인(OAuth) 연동은 없나요?

없습니다. AppLovin 리포팅 API는 Report Key만으로 호출되므로 로그인이나 권한 승인 절차가 없습니다.

전환수 (Channel)과 adstage 설치 수가 왜 다른가요?

전환수 (Channel)은 AppLovin이 자체 기준으로 집계한 설치이고, adstage 설치는 adstage SDK와 트래킹 링크로 측정한 값입니다. AppLovin 트래킹 링크를 쓰지 못하는 동안에는 AppLovin 유입 설치가 adstage에서 applovin.ads 채널로 귀속되지 않으므로 두 값은 다를 수밖에 없습니다.

연동할 때 과거 데이터를 더 가져올 수 있나요?

연동 직후 최근 30일을 가져옵니다. AppLovin 리포팅 API는 최근 45일만 조회할 수 있어 그보다 오래된 데이터는 가져올 수 없습니다.

10. 참고 문서

次のページ

ようこそ

目次

1. 연동 개요2. Report Key 발급받기3. 연동하기4. 연동 계정 관리하기5. 수집되는 데이터6. 트래킹 링크와 전환 전송7. 주의사항8. 문제 해결계정 추가가 안 될 때상태가 실패일 때데이터가 수집되지 않을 때수치가 AppLovin 대시보드와 다를 때9. 자주 묻는 질문10. 참고 문서