Liftoff 연동

adstage에서는 Liftoff(Accelerate) 앱 광고의 비용을 API 키로 수집하고, 트래킹 링크로 유입된 클릭·설치·이벤트를 liftoff.ads 채널로 집계하며, 귀속된 설치·이벤트를 Liftoff로 돌려보낼 수 있습니다. Liftoff는 2021년 Vungle과 합병했으므로 Vungle로 집행하던 광고도 이 페이지를 따릅니다.

베타

Liftoff 연동은 실제 광고주 계정으로 검증하는 중입니다. 수집된 수치가 Liftoff 콘솔과 다르면 adstage 고객지원팀에 알려 주세요.

1. 연동 개요

비용 수집은 연동 > 광고 채널 연동 > Liftoff의 비용 연동 탭에서, 트래킹 링크와 전환 전송은 딥링크 > 생성에서 링크마다 설정합니다. 연동 화면 검색창에 vungle을 입력해도 Liftoff 카드가 나옵니다.

2. 비용 수집 연동하기

API 키 발급받기

Liftoff는 콘솔에서 리포팅 API 키를 직접 발급하지 않습니다. Liftoff 담당 매니저(AM 또는 CSM)에게 Reporting API key와 secret을 요청하면 메일로 받습니다. 키 하나로 그 광고주 계정에 속한 모든 앱·캠페인의 리포트를 읽습니다.

연동 절차

1. 연동 > 광고 채널 연동 > Liftoff에서 비용 연동 탭을 엽니다. 화면 위쪽의 Liftoff 키 발급 방법 안내와 Liftoff 리포팅 API 문서 링크에서 발급 절차를 다시 볼 수 있습니다.

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

3. 연동 계정 추가를 클릭하고 계정 이름(adstage에서 이 계정을 구분할 이름), API 키, API Secret을 입력한 뒤 연동을 클릭합니다.

4. adstage가 저장 전에 Liftoff로 키를 확인하고(인증 중... 표시) 통과하면 암호화해 저장합니다. 계정이 추가되면 첫 수집이 바로 시작됩니다. Liftoff 리포트는 비동기로 만들어지므로 첫 수집에 몇 분이 걸릴 수 있으며, 그동안 상태는 준비 중으로 표시됩니다.

주의하세요

키가 거부되면 "Liftoff 에서 키를 거부했습니다. 키와 권한을 확인해 주세요", Liftoff 서버에 닿지 못하면 "키 확인을 위해 Liftoff 에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요"가 표시됩니다. 같은 키를 한 조직에 두 번 등록하면 "이미 등록된 계정입니다"로 거절됩니다.

연동 상태 확인하기

계정 목록에서 계정명, 상태, 데이터가 업데이트된 최근 일시, 관리(삭제)를 확인합니다.

• 준비 중: 계정 추가 직후 첫 수집이 진행 중입니다.
• 성공: Liftoff API 호출이 정상입니다. 광고를 집행하지 않아 수집된 데이터가 없어도 성공으로 표시됩니다.
• 실패: 키가 폐기되었거나 권한이 없어 데이터를 가져오지 못했습니다. 표시에 마우스를 올리면 원인을 볼 수 있고, 매 주기마다 다시 시도하므로 원인이 해결되면 자동으로 성공으로 돌아옵니다. Liftoff의 요청 제한이나 일시적인 서버 오류는 실패로 바꾸지 않고 다음 주기에 다시 시도합니다.

상태가 성공이어도 비용 데이터가 3일 넘게 쌓이지 않으면 상태 옆에 경고가 나타나고, 마우스를 올리면 "N일째 광고비 데이터가 수집되지 않았습니다"가 표시됩니다. 데이터가 다시 들어오면 경고는 사라집니다.

키를 바꾸려면 관리 열의 삭제 아이콘으로 계정을 지운 뒤 새 키로 다시 추가합니다. 삭제해도 이미 수집된 데이터는 남습니다.

3. 트래킹 링크 만들기

Liftoff는 MMP 없이 광고주가 직접 클릭 URL을 받는 방식을 지원합니다. 광고를 클릭하면 Liftoff가 사용자를 adstage 트래킹 링크로 보내면서 캠페인·소재 정보와 클릭 ID(트래킹 토큰)를 채워 주고, adstage가 링크의 리다이렉트 설정에 따라 스토어나 앱으로 보냅니다.

1. 딥링크 > 생성에서 광고 채널로 Liftoff를 고릅니다.

2. 캠페인과 광고소재 칸에 Liftoff 매크로가 자동으로 채워지고 프리셋 표시와 함께 잠깁니다. 이름을 직접 입력하지 않아도 Liftoff가 클릭할 때 실제 이름으로 바꿔 주며, 그래야 비용 수집의 캠페인 이름과 같은 값이 들어옵니다.

3. 광고그룹 칸은 비워 둡니다. Liftoff에는 광고 그룹 매크로가 없습니다.

4. 광고가 노출된 앱(지면)까지 나눠 보려면 채널 상세정보 추가를 누릅니다. 매체 칸이 Liftoff 앱 ID 매크로로 채워집니다.

5. 리다이렉트 설정을 지정하고 저장한 뒤 생성된 링크를 복사합니다.

링크에는 다음 값이 들어갑니다. 클릭 ID, 캠페인 ID, 소재 ID, Liftoff App ID는 입력 여부와 관계없이 항상 붙습니다.

완성된 링크는 다음과 같은 형태입니다.

https://adg.im/@{조직}/track/liftoff.ads?short_path={링크경로}&campaign=${CAMPAIGN_NAME}&campaign_id=${CAMPAIGN_EXTERNAL_ID}&ad_creative=${CREATIVE_NAME}&ad_creative_id=${CREATIVE_EXTERNAL_ID}&sub_channel=${APP_ID}&click_id=${TRACKING_TOKEN}&liftoff_app_id=${EXTERNAL_ID}

복사한 링크는 Liftoff 담당자에게 전달해 캠페인의 클릭 URL로 등록을 요청합니다. 등록할 때 매크로가 계정에 맞는 이름인지 담당자와 함께 확인하세요.

주의하세요

• 링크 안의 매크로를 지우거나 바꾸지 마세요. 트래킹 토큰이 없으면 설치를 Liftoff 클릭과 맞출 수 없고 포스트백도 보낼 수 없습니다.
• 비용은 캠페인 단위까지만 수집됩니다. 리포트를 소재 단위로 나누면 전환만 소재별로 나뉘고 비용은 캠페인 행에 남습니다.

4. Liftoff로 전환 보내기

귀속된 설치와 이벤트를 Liftoff에 알려 주면 Liftoff가 캠페인 최적화에 사용합니다. 설정은 링크마다 따로 하며, 공통 동작(중복 방지·재시도)은 매체사 포스트백을 참고하세요.

사전 준비

Liftoff는 포스트백에 앱의 번들 ID를 요구합니다. 트래킹 링크 > 설정 > 딥링크 설정에서 Android 패키지명과 iOS Bundle ID를 먼저 등록하세요. 등록하지 않으면 번들 ID가 빈 값으로 나갑니다.

설정 절차

1. Liftoff 트래킹 링크의 생성 또는 상세 화면에서 네트워크 포스트백 섹션의 매체사로 설치 포스트백 전송 스위치를 켭니다. 주소 칸이 비어 있으면 Liftoff 프리셋이 바로 채워집니다. 비어 있지 않다면 매체 프리셋에서 Liftoff — Install & events (Advertiser Attribution)를 고르세요.

2. 채워진 설치 포스트백 URL 템플릿을 확인합니다. 설치와 이벤트를 같은 주소로 보내므로 이벤트 포스트백 URL 템플릿은 비워 둡니다.

https://analytics.liftoff.io/customer_tracker/v1/{liftoff_app_id}/events?third_party_tracking_token={click_id}&client_ip={ip}&event_name={event}&event_timestamp={timestamp}&platform={platform}&bundle_id={bundle_id}&idfa={idfa}&google_aid={gaid}&revenue={revenue}&currency_code={currency}

3. 전송 대상 이벤트를 정합니다. 기본값은 install뿐입니다. 구매 등 설치 후 이벤트도 보내려면 이벤트를 추가하고, Liftoff와 합의한 이름이 다르면 이벤트명 매핑에 넣습니다. 설치 이름 install은 바꾸지 마세요.

4. 저장한 뒤 Liftoff 담당자에게 엔드투엔드 테스트를 요청합니다. 클릭 리다이렉트·귀속·포스트백이 모두 준비된 상태에서 Liftoff가 직접 수신을 확인한 뒤 개통합니다.

참고하세요

• 그 링크로 귀속된 설치·이벤트만 전송됩니다. 같은 클릭의 같은 이벤트는 한 번만 나가며 install과 first_open은 하나로 묶입니다.
• 링크가 여러 개면 링크마다 포스트백을 설정해야 합니다.

5. 수집되는 데이터

리포트에서는 매체 보고 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다. 지출·노출·클릭·설치가 모두 0인 날은 저장하지 않습니다.

6. 주의사항

• Liftoff와 adstage 간에 수치 차이가 발생할 수 있습니다. 집계 시점(전일 확정 전 수집)과 시간대 기준의 차이 때문입니다.
• Liftoff에서 키를 폐기하거나 권한을 회수하면 수집이 중단됩니다. 새 키를 받아 계정을 다시 추가하세요.
• Liftoff 리포트 생성 API는 호출 횟수가 제한되어 있어 adstage는 계정을 하나씩 순서대로 수집합니다.
• 채널 이름을 liftoff로 직접 입력해 만든 커스텀 링크의 유입도 liftoff.ads 채널로 집계됩니다.

7. 문제 해결

키 등록이 거절될 때

1. API key와 secret을 앞뒤 공백 없이 그대로 붙여 넣었는지 확인합니다.
2. 등록할 때 adstage는 계정 정보 조회와 리포트 생성 권한을 함께 확인합니다. 둘 중 하나라도 거부되면 키 거부로 표시되므로 담당자에게 리포팅 권한을 확인하세요.
3. "연결하지 못했습니다"는 Liftoff 서버 쪽 일시적인 문제입니다. 잠시 후 다시 시도합니다.

데이터가 수집되지 않을 때

1. Liftoff 비용 연동 스위치가 켜져 있는지 확인합니다.
2. 상태가 실패이면 마우스를 올려 원인을 확인하고, 인증 오류라면 계정을 삭제한 뒤 새 키로 다시 추가합니다.
3. 상태가 성공인데 데이터가 없다면 해당 기간에 지출·노출·클릭·설치가 모두 0인 경우입니다. Liftoff 콘솔에서 캠페인 상태를 확인하세요.
4. 첫 수집이 길어지면 상태가 준비 중으로 남을 수 있습니다. 다음 주기(최대 4시간)에 자동으로 다시 수집합니다.

포스트백이 Liftoff에 도달하지 않을 때

1. 광고 클릭이 adstage 트래킹 링크를 거쳤는지, 링크에 클릭 ID와 Liftoff App ID 매크로가 남아 있는지 확인합니다.
2. 딥링크 설정에 패키지명과 Bundle ID가 등록되어 있는지 확인합니다.
3. 보내려는 이벤트가 전송 대상 이벤트에 있는지, 이름이 Liftoff와 합의한 값인지 확인합니다.
4. Liftoff 담당자와 테스트 클릭을 진행해 수신 여부를 대조합니다.

8. 자주 묻는 질문

Vungle로 집행하던 계정도 연동할 수 있나요?

네. Liftoff는 2021년 Vungle과 합병했습니다. Liftoff 담당자에게 Reporting API 키를 받으면 같은 방법으로 연동합니다.

앱이 여러 개면 계정을 여러 번 등록해야 하나요?

아니요. 키 하나로 그 계정에 속한 모든 앱의 캠페인이 수집됩니다. 포스트백 주소의 App ID도 링크에서 자동으로 채워지므로 앱마다 트래킹 링크만 따로 만들면 됩니다.

Liftoff가 집계한 설치 수와 adstage 설치 수가 왜 다른가요?

설치수 (Channel)는 Liftoff가 보고한 값이고, adstage 설치는 트래킹 링크 클릭과 SDK 이벤트를 맞춘 값입니다. 직접 연동에서는 Liftoff가 adstage의 포스트백으로 설치를 집계하므로, 포스트백이 정상 동작해야 두 수치가 가까워집니다.

9. 참고 문서

• Liftoff Reporting API — API 키 발급(담당 매니저), 인증, 청구 시간대, 전일 데이터 확정 시점
• Liftoff Advertiser Attribution — MMP 없는 직접 연동 절차와 개통 전 테스트
• Augmenting MMP Data via S2S — 포스트백 주소와 파라미터
• Liftoff Tracking URL Macros — 클릭 URL 매크로 목록
• Liftoff 회사 소개 — 2021년 Vungle 합병