AdSense

Google AdSense를 연결하여 웹 광고 수익을 추적하고 일일 수익 리포트를 받으세요.

Last updated: 2026-05-18

AdSense 연동은 OAuth를 통해 Google 계정을 연결하여 웹 광고 수익 데이터를 가져옵니다. 연결이 완료되면 Opseer가 자동으로 AdSense 계정을 감지하며, 수익 확인, 트렌드 추적, 일일 수익 리포트 수신이 가능합니다.

사전 준비

AdSense 접근 권한이 있는 Google 계정
활성화된 광고 배치가 있는 승인된 AdSense 계정
Starter / Plus / Max 플랜 (광고 수익 알림은 유료 기능)

AdSense 연결

개인 알림 설정으로 이동

사이드바의 "개인 알림" 메뉴로 이동합니다 (/dashboard/alert).

AdSense 연결 클릭

AdSense 섹션에서 "연결"을 클릭합니다. Google 인증 페이지로 리다이렉트됩니다.

권한 부여

Google에서 Opseer가 AdSense 데이터를 조회할 수 있도록 허용을 요청합니다. 권한을 확인하고 "허용"을 클릭합니다.

자동 계정 감지

인증 후 Opseer가 자동으로 AdSense 계정 ID (adsense_account_id)를 감지합니다. 설정에 표시되며 이후 모든 API 호출에 사용됩니다.

AdSense 연결은 프로젝트 단위가 아닌 사용자 단위입니다. 한 번 연결하면 모든 프로젝트에서 AdSense 데이터를 사용할 수 있습니다.

동작 방식

수익 데이터

Opseer는 AdSense API를 사용하여 일일 수익 데이터를 가져옵니다. 예상 수익, 페이지 뷰, 노출 수, 클릭 수, CPC 등이 포함됩니다. 웹 광고 성과에 대한 종합적인 개요를 제공합니다.

일일 리포트

개인 알림이 활성화된 경우, Opseer는 설정된 알림 시간에 일일 수익 요약을 발송합니다. 리포트에 포함되는 내용:

전일 총 예상 수익
전전일 대비 증감 비교
페이지 뷰, 노출 수, 클릭 수 요약
CPC 및 RPM 지표

알림 채널

개인 수익 알림은 프로젝트 알림과 별도입니다. 다음 채널을 통해 수신할 수 있습니다:

Slack (OAuth 연결)
Discord (OAuth 연결)
Telegram (DM 또는 Group 선택)
Webhook (HTTPS POST endpoint, AES 암호화 저장)

알림 시간 설정

일일 수익 리포트를 받을 시간을 선택합니다. 타임존, 시, 분을 설정하세요. Opseer가 내부적으로 UTC로 변환하여 매일 정확한 시간에 리포트를 발송합니다.

AdSense의 전일 수익 데이터는 보통 24시간 이내에 확정됩니다. 알림 시간을 오전 늦게나 오후로 설정하면 더 정확한 수치를 받을 수 있습니다.

두 연동 모두 동일한 방식으로 작동하지만, 추적하는 플랫폼이 다릅니다:

AdMob — 모바일 앱 광고 수익 (인앱 광고)
AdSense — 웹사이트 광고 수익 (웹 페이지 디스플레이 광고)

두 서비스를 동시에 연결할 수 있습니다. 각각 플랫폼별 지표를 포함한 별도의 일일 리포트를 발송합니다.

문제 해결

"No AdSense account found"

인증한 Google 계정에 승인된 AdSense 계정이 없다는 의미입니다. AdSense 계정을 소유한 Google 계정으로 로그인했는지, 그리고 Google에 의해 완전히 승인된 계정인지 확인하세요.

"Token expired" 또는 리포트 누락

Google OAuth 토큰은 주기적으로 만료됩니다. Opseer가 자동으로 갱신하지만, 토큰이 무효화된 경우 (예: 접근 권한 취소) 재연결이 필요합니다. 개인 알림에서 "재연결"을 클릭하세요.

연결 해제

개인 알림에서 AdSense 옆의 "연결 해제"를 클릭합니다. 저장된 OAuth 토큰이 삭제되고 수익 리포트 발송이 중지됩니다. AdSense 계정에는 영향을 주지 않습니다.