Google AdSense 지급 내역 도구

Google AdSense와 YouTube 확정 지급 내역을 분리해 조회하고 Excel로 저장합니다.

도구 열기 도구 목록으로
// about

도구 소개

계정과 서비스별로 AdSense와 YouTube 확정 지급 내역을 확인하고, 지급일과 금액을 검토한 뒤 환율을 적용해 Excel로 저장할 수 있습니다.

사용 방법

  1. 입력을 붙여넣거나 직접 입력합니다.
  2. 필요한 옵션을 선택합니다.
  3. 결과를 복사하거나 다운로드합니다.

이 도구를 찾는 이유

  • 빠른 변환, 정리, 일괄 작업에 유용합니다.
  • 디버깅, 공유, 콘텐츠 준비에 도움이 됩니다.
  • 당장 결과가 필요할 때 특히 편리합니다.
가이드 · 수익 · 5분 읽기

구글 애드센스·플레이 수익 지급 구조 이해하기: 예상 수익, 확정 수익, 환율, 장부 정리

블로그나 앱으로 구글 수익을 받기 시작하면 '대시보드 금액과 통장 입금액이 왜 다를까'라는 질문이 생깁니다. 수익이 확정되고 지급되기까지의 흐름을 알면 매달 정산이 훨씬 쉬워집니다.

애드센스 대시보드에 실시간으로 보이는 금액은 '예상 수익'입니다. 한 달이 끝나면 구글은 무효 트래픽(부정 클릭 등)을 걸러 내고 금액을 검토해, 보통 다음 달 초에 '확정 수익'으로 잔액에 반영합니다. 그래서 예상 수익과 확정 수익은 조금 다를 수 있습니다.

10월 1일~31일  예상 수익 발생 (대시보드)
11월 초         10월 수익 확정 → 잔액 반영
11월 21일 무렵  잔액 ≥ 지급 기준액이면 지급 시작
이후 며칠       은행 입금
애드센스의 예상 수익과 확정 수익의 차이, 월별 지급 일정과 지급 기준액, 지급이 보류되는 흔한 이유, 외화 수익을 원화 장부로 정리하는 방법을 설명합니다.
가이드 읽기 →
AI로 직접 만들기

이 도구를 AI로 직접 만들어 보세요

나만의 버전이 필요하다면 아래 작업지시 프롬프트를 AI 채팅에 붙여 넣거나, 스킬 파일을 AI 코딩 에이전트에 저장하세요. 저희가 이 도구를 만들 때 정리한 기능, 예외 상황, 테스트 케이스가 그대로 담겨 있습니다.

AI 작업지시 프롬프트

Claude, ChatGPT, Gemini 같은 AI 채팅에 그대로 붙여 넣으세요.

당신은 숙련된 풀스택 웹 개발자입니다. 아래 요구사항에 맞춰 "Google AdSense 지급 내역" 웹 도구를 만들어 주세요.

## 목표

Google 계정으로 로그인해 AdSense 확정 지급 내역을 조회하고, 애드센스·유튜브로 구분해 환율을 적용한 엑셀 보고서를 만드는 웹 도구를 만든다.

## 핵심 기능

- Google OAuth 로그인(adsense.readonly 범위만 요청)
- AdSense Management API로 계정·지급 내역 조회
- 지급 항목을 애드센스/유튜브로 분류
- 지급일 기준 환율 적용(공개 환율 API)
- 연도 범위 선택 후 Excel(.xlsx) 내보내기

## 입력

- Google 로그인
- 조회 연도 범위, 대상 통화

## 출력

- 지급 내역 표(지급일, 금액, 출처, 환산액)
- Excel 파일

## 예외 상황과 처리 규칙

- 토큰 만료 시 재로그인 처리
- AdSense 계정이 없거나 여러 개인 경우
- 환율 API 장애 시 재시도와 명확한 오류
- 주말·공휴일 지급일은 직전 영업일 환율 사용

## 구현 조건

- 서버 측 구현이 필요합니다(예: ASP.NET Core, Node.js). OAuth 클라이언트 시크릿은 서버에만 두고 저장소에 커밋하지 않습니다.
- 개인정보처리방침에 Google 사용자 데이터 사용 범위를 명시하고, 토큰은 연결 해제 시 즉시 삭제합니다.
- 모바일에서도 쓰기 편한 반응형 UI로 만들고, 입력 요소에는 레이블을 달아 키보드로도 조작할 수 있게 해 주세요.
- 결과에는 '복사' 버튼을 달고, 잘못된 입력에는 이해하기 쉬운 한국어 오류 메시지를 보여 주세요.
- 핵심 로직은 UI와 분리된 함수로 작성해 단위 테스트를 할 수 있게 해 주세요.

## 완료 기준 (테스트 케이스)

- 분류 로직 단위 테스트: 유튜브 항목이 유튜브로 분류
- 엑셀에 연도 범위 밖의 행이 없음
- 환율이 지급일 기준으로 적용

먼저 구현 계획을 5줄 이내로 설명한 다음 전체 코드를 작성하고, 마지막에 위 테스트 케이스를 확인하는 방법을 알려 주세요.

스킬 (SKILL.md)

Claude Code 같은 AI 코딩 에이전트에서 .claude/skills/build-google-adsense-earning/SKILL.md 경로로 저장하면, 이 도구를 만들거나 고칠 때마다 다시 쓸 수 있습니다.

---
name: build-google-adsense-earning
description: Google AdSense 지급 내역 도구를 새로 만들거나 수정할 때 사용합니다. Google 계정으로 로그인해 AdSense 확정 지급 내역을 조회하고, 애드센스·유튜브로 구분해 환율을 적용한 엑셀 보고서를 만드는 웹 도구를 만든다.
---

# Google AdSense 지급 내역 만들기

## 목표

Google 계정으로 로그인해 AdSense 확정 지급 내역을 조회하고, 애드센스·유튜브로 구분해 환율을 적용한 엑셀 보고서를 만드는 웹 도구를 만든다.

## 작업 순서

1. 아래 필수 기능, 입력, 출력을 확인하고 빠진 정보가 있으면 먼저 질문합니다.
2. 핵심 로직을 UI와 분리된 순수 함수로 구현합니다.
3. 검증 목록의 테스트 케이스로 로직을 확인합니다.
4. 입력 폼, 결과 영역, 복사 버튼을 갖춘 반응형 UI를 만듭니다.
5. 규칙에 적힌 예외 상황을 하나씩 재현해 보고 오류 메시지를 다듬습니다.

## 핵심 기능

- Google OAuth 로그인(adsense.readonly 범위만 요청)
- AdSense Management API로 계정·지급 내역 조회
- 지급 항목을 애드센스/유튜브로 분류
- 지급일 기준 환율 적용(공개 환율 API)
- 연도 범위 선택 후 Excel(.xlsx) 내보내기

## 입력

- Google 로그인
- 조회 연도 범위, 대상 통화

## 출력

- 지급 내역 표(지급일, 금액, 출처, 환산액)
- Excel 파일

## 규칙

- 토큰 만료 시 재로그인 처리
- AdSense 계정이 없거나 여러 개인 경우
- 환율 API 장애 시 재시도와 명확한 오류
- 주말·공휴일 지급일은 직전 영업일 환율 사용
- 서버 측 구현이 필요합니다(예: ASP.NET Core, Node.js). OAuth 클라이언트 시크릿은 서버에만 두고 저장소에 커밋하지 않습니다.
- 개인정보처리방침에 Google 사용자 데이터 사용 범위를 명시하고, 토큰은 연결 해제 시 즉시 삭제합니다.

## 검증

- [ ] 분류 로직 단위 테스트: 유튜브 항목이 유튜브로 분류
- [ ] 엑셀에 연도 범위 밖의 행이 없음
- [ ] 환율이 지급일 기준으로 적용

AI에게 맡길 때 팁

  • 첫 줄에 사용 중인 기술(예: React, Vue, 순수 HTML)을 적으면 프로젝트에 맞는 코드를 받을 수 있습니다.
  • 코드를 받기 전에 목록의 테스트 케이스를 실제로 실행하고 결과를 보여 달라고 요청하세요.
  • 실제 비밀번호, 고객 데이터, API 키는 프롬프트에 넣지 말고 예시 값으로 바꿔 쓰세요.