Google Ads 연동

adstage에서는 Google Ads에서 발생한 웹·앱 전환 성과를 확인할 수 있습니다. 또한 Google Ads 비용 연동으로 운영 중인 캠페인의 광고비와 성과 데이터를 adstage 대시보드에서 조회할 수 있습니다.

Google Ads 연동 화면은 adstage 대시보드 광고 채널 연동 > 구글 애즈에서 확인할 수 있으며, 웹 캠페인 연동, 앱 캠페인 연동, 비용 연동, SKAN 연동 네 개의 탭으로 구성됩니다.

웹 캠페인 연동하기

Google Ads의 최종 URL 접미사(Final URL Suffix) 기능으로 Google Ads에서 발생한 웹 전환 성과를 확인할 수 있습니다. 최종 URL 접미사는 계정에 한 번 설정하면 모든 캠페인에 적용됩니다.

사전 준비

최종 URL 접미사는 랜딩 페이지 URL에 캠페인 정보를 붙입니다. 랜딩 웹페이지에 adstage 웹 SDK가 설치되어 있어야 이 정보를 읽어 전환에 연결할 수 있습니다. 구매 등 전환 이벤트는 웹사이트에서 웹 SDK로 전송해야 합니다. 설치 방법은 adstage 웹 SDK 설치하기에서 확인할 수 있습니다.

Google Ads에 최종 URL 접미사 설정하기

adstage 대시보드 광고 채널 연동 > 구글 애즈에서 웹 캠페인 연동 탭을 선택한 후 최종 URL 접미사 탭을 엽니다. 여기에 표시된 최종 URL 접미사를 복사합니다.

복사한 내용을 수정하면 Google Ads 광고 검수에서 반려되거나 데이터가 정상적으로 수집되지 않을 수 있으므로 그대로 사용해 주세요.

Google Ads에 접속한 후 관리자 > 계정 설정 > 추적 으로 이동합니다.

추적 섹션에서 최종 URL 접미사 필드에 adstage 대시보드에서 복사한 내용을 붙여넣고 저장을 클릭합니다. 저장하면 이후 발생하는 광고 클릭의 랜딩 페이지 URL에 추적 정보가 자동으로 추가됩니다.

최종 URL 접미사

최종 URL 접미사는 Google Ads 계정 레벨에 설정하면 해당 계정의 모든 캠페인에 자동으로 적용됩니다. 캠페인별로 개별 설정할 필요가 없습니다.

Google Ads에 추적 템플릿 설정하기

추적 템플릿(Tracking Template)을 설정하면 광고 클릭이 adstage의 클릭 트래커 adg.im에도 기록됩니다. adg.im은 Google이 인증한 클릭 트래커(Transparent Click Tracker)입니다.

웹 캠페인은 최종 URL 접미사만으로 측정됩니다

추적 템플릿은 최종 URL 접미사를 대체하지 않습니다. Google Ads의 병렬 추적(Parallel Tracking)에서는 사용자가 랜딩 페이지로 바로 이동하고 추적 템플릿은 백그라운드에서 호출되기 때문에, 캠페인 정보는 최종 URL 접미사로만 랜딩 페이지에 전달됩니다. 최종 URL 접미사가 없으면 전환에 캠페인·광고그룹·키워드 정보가 연결되지 않습니다.

또한 추적 템플릿과 최종 URL 접미사를 함께 설정하면 광고 클릭 1회가 adg.im과 웹 SDK에서 각각 기록되어 클릭 수가 중복 집계될 수 있습니다. 웹 캠페인에서는 최종 URL 접미사만 설정하는 것을 권장합니다.

adstage 대시보드 광고 채널 연동 > 구글 애즈에서 웹 캠페인 연동 탭을 선택한 후 추적 템플릿 탭을 엽니다. 여기에 표시된 추적 템플릿을 복사합니다.

Google Ads에 접속한 후 관리자 > 계정 설정 > 추적 으로 이동해 추적 템플릿 필드에 붙여넣습니다.

입력란 아래 테스트를 클릭해 결과에 "방문 페이지 찾음"이 표시되는지 확인한 뒤 저장을 클릭합니다.

병렬 추적 토글

추적 섹션의 병렬 추적 토글은 호텔 캠페인에만 적용됩니다. 검색·쇼핑·디스플레이·동영상 캠페인은 병렬 추적이 항상 사용되므로 토글을 따로 설정할 필요가 없습니다.

앱 캠페인 연동하기

앱 캠페인 연동 탭에서는 adstage를 Google Ads의 서드파티 앱 분석 제공업체로 연결해, adstage가 수집한 Android·iOS 앱 이벤트를 Google Ads 전환으로 전송합니다. 웹 이벤트는 전송되지 않습니다.

Google Ads Link ID 등록하기

앱 이벤트를 전송하려면 먼저 플랫폼별 Link ID를 등록해야 합니다.

1. Google Ads에서 도구 > 데이터 관리자 > 서드파티 앱 분석으로 이동한 뒤 기타 제공업체를 선택하고, 제공업체 ID(Provider ID)에 1749504903을 입력합니다. 이 ID는 adstage 앱 캠페인 연동 탭에도 표시되며, 클릭하면 복사됩니다.

2. Android와 iOS 각각에 대해 Link ID를 생성합니다. 두 플랫폼은 서로 다른 Link ID를 사용합니다.

3. 생성한 Link ID를 adstage 앱 캠페인 연동 탭의 Android 링크 ID, iOS 링크 ID 입력란에 각각 입력하고 저장합니다. 한 플랫폼의 Link ID만 등록하면 그 플랫폼의 이벤트만 전송됩니다.

전송되는 이벤트

• install·first_open: Google Ads 광고로 유입되었는지와 관계없이 항상 전송됩니다.
• 그 외 이벤트: Google Ads 광고로 유입된 사용자의 이벤트만 전송됩니다. 이벤트에 gclid·gbraid·wbraid가 있거나, 기기가 Google Ads로 기여된 경우입니다.

이벤트 설정을 저장하기 전에는 아래 기준으로 Google Ads 이벤트로 변환해 전송합니다. 목록에 없는 이벤트는 custom으로 전송됩니다.

인앱 이벤트 설정하기

Link ID를 등록하면 탭 아래에 adstage가 수집한 이벤트 목록이 표시됩니다. 이벤트마다 전송 여부를 켜고 끄고, 매핑할 Google Ads 이벤트 유형을 선택한 뒤 설정 저장을 클릭합니다. 전체 활성화, 전체 비활성화로 한 번에 바꿀 수도 있습니다.

비용 연동하기

비용 연동을 설정하면 Google Ads의 광고비와 성과 지표를 adstage에서 확인할 수 있습니다.

Google 계정으로 연동하기

adstage와 Google Ads를 연동하려면 Google 계정 인증이 필요합니다. OAuth 2.0 방식을 사용하여 안전하게 인증합니다.

adstage에서 Google 계정 연동 시작하기

1. adstage 대시보드 광고 채널 연동에서 **구글 애즈(google.ads)**를 선택합니다.

2. 비용 연동 탭에서 구글 애즈 비용 연동 스위치를 켠 뒤 연동 계정 추가를 클릭합니다. 스위치가 꺼져 있으면 버튼을 누를 수 없습니다.

3. Google 로그인 창이 열리면 Google Ads 계정에 접근 권한이 있는 Google 계정으로 로그인합니다.

4. adstage가 Google Ads 데이터에 접근할 수 있도록 권한을 승인합니다.

Google Ads 계정 선택하기

인증이 끝나면 Google Ads 계정 선택 창에 로그인한 Google 계정이 접근할 수 있는 Google Ads 계정 목록이 표시됩니다. 사용 중인 계정만 표시됩니다.

1. 연동할 계정을 선택합니다. 여러 계정을 한 번에 선택할 수 있으며, 계정 이름과 고객 ID(Customer ID)로 올바른 계정인지 확인합니다.

2. N개 계정 확정을 클릭하면 선택한 계정이 연동되고 첫 데이터 수집이 바로 시작됩니다.

연동 가능한 계정

로그인한 Google 계정이 직접 접근할 수 있는 광고주 계정만 목록에 표시됩니다. 관리자 계정(MCC)으로 로그인해도 하위 계정은 표시되지 않으며, 관리자 계정 자체를 연동하면 캠페인 데이터가 수집되지 않습니다. 연동할 광고주 계정에 사용할 Google 계정을 사용자로 직접 추가한 뒤 연동해 주세요.

주의하세요

• 이 조직에 이미 연동된 계정은 건너뜁니다. 선택한 계정이 모두 등록되어 있으면 "이미 등록된 계정입니다", 일부만 등록되어 있으면 "일부 계정이 이미 등록되어 건너뛰었습니다" 메시지가 표시됩니다.
• 로그인한 Google 계정으로 접근할 수 있는 계정이 없거나 Google Ads API 오류가 발생하면 "이 사용자에게 사용 가능한 구글 애즈 계정이 없습니다" 메시지가 표시됩니다.
• Google 로그인 중 권한 승인을 거부하면 연동되지 않습니다.

연동 계정 관리하기

연동된 Google Ads 계정은 adstage 대시보드의 비용 연동 탭에서 확인할 수 있습니다.

계정 목록 확인하기

연동된 계정 목록에서 다음 정보를 확인할 수 있습니다:

• 광고 계정: Google Ads 계정 이름과 고객 ID(Customer ID)
• 상태: 연동 상태 (준비 중, 성공, 실패)
• 데이터가 업데이트된 최근 일시: 비용 데이터가 마지막으로 저장된 시각
• 구글 애즈 계정: 연동에 사용한 Google 계정 이메일
• 관리: 계정 삭제

계정 삭제하기

연동을 해제하려면 계정 목록의 관리 열에서 삭제 아이콘을 클릭합니다. 계정 삭제 확인 창에서 삭제를 클릭하면 연동이 해제됩니다.

주의하세요

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

연동 상태 확인하기

비용 연동 상태는 계정 목록의 상태 열에서 확인할 수 있습니다.

상태 메시지 설명

• 준비 중: 계정 연동 직후 첫 데이터 수집이 진행 중입니다. 보통 몇 분 안에 끝납니다.
• 성공: Google Ads API 연결이 정상입니다.
• 실패: Google Ads에서 데이터를 가져오지 못했습니다(인증 만료, 권한 없음 등). 표시에 마우스를 올리면 오류 내용을 볼 수 있습니다. 업데이트할 때마다 다시 시도하며, 원인이 해결되면 자동으로 성공으로 돌아옵니다.

데이터 미수집 경고

상태가 성공이어도 광고 미집행 등으로 데이터가 들어오지 않을 수 있습니다. 비용 데이터가 3일 넘게 저장되지 않으면 상태 표시 옆에 ⚠️ 경고가 나타나고, 마우스를 올리면 조치 필요 안내와 함께 "N일째 광고비 데이터가 수집되지 않았습니다" 메시지가 표시됩니다. 이 경고가 보이면 연동을 확인해 주세요. 데이터 수집이 다시 시작되면 경고는 자동으로 사라집니다.

데이터 업데이트 주기

Google Ads 비용 데이터는 다음과 같이 업데이트됩니다:

• 업데이트 범위: 최근 30일 (D-30 ~ D-1, 업데이트 당일 제외)
• 업데이트 주기: 4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)

전환은 광고 클릭 후 시간이 지나서 잡히는 경우가 많기 때문에, 업데이트할 때마다 최근 30일 데이터를 다시 가져와 전환 수와 전환 금액을 최신 값으로 갱신합니다.

데이터 수집 시점

업데이트 당일(D-0) 데이터는 수치가 확정되지 않았기 때문에 수집하지 않습니다.

예를 들어 adstage에서 3월 17일에 비용 데이터를 업데이트하면 2월 15일부터 3월 16일까지의 데이터가 갱신됩니다.

수집되는 데이터

비용 연동으로 수집되는 데이터는 Google Ads가 보고한 기준 값이며, 일별로 캠페인·광고그룹·키워드·광고·검색어 단위로 저장됩니다. 리포트에서는 매체 보고 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다(예: 전환 금액 (Channel)).

SKAN 연동하기

SKAN 연동 탭의 스위치를 켜면 adstage가 iOS 앱 이벤트로 SKAdNetwork(SKAN) 전환값을 서버에서 계산하고, adstage iOS SDK가 이 값을 Apple에 전달합니다. SKAN은 iOS 앱 설치 어트리뷰션을 위한 Apple의 프레임워크입니다. 이 설정으로 adstage가 Google Ads에 데이터를 보내지는 않습니다.

1. adstage 대시보드 설정 > SKAN(SKAN 전환값 설정)에서 전환값 매핑 규칙을 설정하고 전체 저장을 클릭합니다. 저장된 설정이 없으면 SKAN 연동을 켜도 전환값이 계산되지 않습니다.

2. 광고 채널 연동 > 구글 애즈에서 SKAN 연동 탭을 선택합니다. 비용 연동 탭에서 연동한 Google Ads 계정 목록이 표시됩니다. 연동된 계정이 없다면 먼저 비용 연동하기에서 계정을 연동해 주세요.

3. 계정의 SKAN 스위치를 켭니다. 켜는 즉시 스위치 옆에 성공 상태가 표시됩니다.

참고하세요

• SKAN 연동은 조직 단위로 적용됩니다. Google Ads·Meta·Apple Search Ads·TikTok 중 한 계정이라도 SKAN이 켜져 있으면 조직의 iOS 앱 전체에 전환값 계산이 적용됩니다.
• adstage iOS SDK가 설치된 앱에서만 동작합니다.
• 비용 연동 상태와는 무관합니다. 비용 연동이 실패여도 SKAN 전환값 계산은 계속됩니다.

주의사항

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

웹 캠페인 연동

• 최종 URL 접미사는 계정 레벨에 설정하면 모든 캠페인에 자동 적용됩니다.
• 랜딩 웹페이지에 adstage 웹 SDK가 설치되어 있어야 하며, 전환 이벤트는 웹사이트에서 웹 SDK로 전송해야 합니다.
• 복사한 최종 URL 접미사를 수정하면 광고 검수 반려 또는 데이터 수집 중단이 발생할 수 있습니다.
• 추적 템플릿과 최종 URL 접미사를 함께 설정하면 클릭 수가 중복 집계될 수 있습니다. 웹 캠페인에서는 최종 URL 접미사만 설정하는 것을 권장합니다.
• 추적 템플릿의 redirect_url={lpurl}은 Google에 등록된 투명성 파라미터입니다. 수정하거나 삭제하면 추적 테스트가 실패하거나 광고가 비승인될 수 있습니다.

앱 캠페인 연동

• Android와 iOS는 Link ID를 각각 등록해야 합니다.
• GCLID 기반 기여는 광고 클릭 후 180일 이내에 발생한 이벤트까지 적용됩니다.
• 앱 추적 투명성(ATT)을 거부한 iOS 기기의 이벤트는 gbraid로 전송됩니다.
• 앱 이벤트 전송은 앱 캠페인 연동 탭의 Link ID로 켜고 끕니다. 비용 연동 탭의 스위치와는 별개입니다.

비용 연동

• Google Ads와 adstage 간에 수치 차이가 발생할 수 있습니다. 이는 집계 시점, 타임존, 필터링 기준의 차이 때문입니다.
• Google 계정에서 adstage의 접근 권한을 취소하면 데이터 수집이 중단됩니다.
• Google Ads API 할당량을 초과하면 일시적으로 데이터 수집이 지연될 수 있습니다.

문제 해결

연동 과정에서 문제가 발생하면 다음 사항을 확인해 주세요:

웹 캠페인 연동 문제

1. 최종 URL 접미사 설정 확인: Google Ads 계정 설정(관리자 > 계정 설정 > 추적)에서 최종 URL 접미사가 올바르게 입력되었는지 확인
2. 웹 SDK 설치 확인: 랜딩 페이지에 adstage 웹 SDK가 올바르게 설치되었는지 확인
3. 전환 이벤트 확인: 구매 등 전환 이벤트가 웹 SDK로 전송되고 있는지 확인
4. 랜딩 페이지 확인: 최종 랜딩 페이지 URL이 올바른지 확인
5. 추적 템플릿 테스트 확인: 추적 템플릿을 사용한다면 Google Ads 추적 섹션의 테스트 결과에 "방문 페이지 찾음"이 표시되는지 확인

비용 연동 문제

1. Google 계정 권한 확인: 로그인한 Google 계정이 연동할 Google Ads 계정에 직접 접근할 수 있는지 확인
2. 계정 선택 확인: 올바른 Google Ads 계정을 선택했는지 확인 (Customer ID 확인)
3. 상태 확인: 상태가 실패이면 마우스를 올려 오류 내용을 확인하고, 인증 만료·권한 문제라면 계정을 삭제하고 다시 연동
4. API 할당량 확인: Google Ads API 할당량을 초과하지 않았는지 확인

데이터가 수집되지 않을 때

1. 연동 활성화 확인: 구글 애즈 비용 연동 스위치가 켜져 있는지 확인
2. 경고 표시 확인: 계정 상태 옆에 ⚠️ 경고가 있는지 확인
3. 업데이트 주기 확인: 첫 수집은 연동 직후 시작되며, 이후 4시간마다 최근 30일(당일 제외) 데이터가 갱신됨
4. 권한 재확인: Google 계정의 adstage 앱 권한이 유효한지 확인

Google 인증 오류

1. 팝업 차단 확인: 브라우저에서 팝업이 차단되지 않았는지 확인
2. 쿠키 설정 확인: 서드파티 쿠키가 허용되어 있는지 확인
3. 다른 브라우저 시도: Chrome, Safari 등 다른 브라우저로 시도

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

Google Ads 연동 가이드

더 자세한 Google Ads 설정 방법은 Google Ads 고객센터에서 확인할 수 있습니다.

관련 자료

• ValueTrack 매개변수를 이용해 추적 설정하기
• 최종 URL 접미사 사용하기
• 서드파티 클릭 추적 서비스 가이드라인
• 인증된 Google 클릭 트래커 목록
• 자동으로 사용 설정되는 앱 전환 액션