시작하기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 문서는 애드센스 관리 API를 사용하여 애드센스 계정에 대한 정보를 가져오려는 개발자를 대상으로 합니다. 이 문서에서는 사용자가 웹 프로그래밍 개념과 웹 데이터 형식에 익숙하다고 가정합니다.

시작하기 전에

애드센스 계정 만들기

시작하려면 애드센스 계정에 가입하거나 로그인합니다.

애드센스 알아보기

애드센스 개념에 대해 잘 모른다면 애드센스에 대한 소개 정보를 읽고 코딩을 시작하기 전에 애드센스 UI를 실험해 보세요.

클라이언트 라이브러리 선택

클라이언트 라이브러리 및 샘플 페이지에서 사용 가능한 라이브러리와 샘플에 관한 정보를 찾을 수 있습니다. 선택한 언어의 탭을 클릭하고 링크를 따라 소스를 다운로드합니다. 클라이언트 라이브러리는 다음을 자동으로 처리합니다.

  • authentication
  • 서비스 검색
  • API 요청 작성
  • 응답 파싱

일반적으로 클라이언트 루트 디렉터리의 README 파일에 있는 안내에 따라 선택한 클라이언트 라이브러리를 설치하고 구성합니다.

지원되지 않는 언어를 사용하는 등 구현에 특별한 요구사항이 있는 경우 클라이언트 라이브러리를 사용하는 대신 API에 직접 요청을 수행할 수 있습니다.

애플리케이션 등록

AdSense Management API를 사용하려면 프로젝트를 만들고 클라이언트 ID를 생성하여 개발 중인 애플리케이션을 등록해야 합니다.

앱 등록

방금 만든 새 사용자 인증 정보로 클라이언트 라이브러리 프로젝트의 구성 파일을 수정합니다. 자세한 내용은 클라이언트 라이브러리 문서를 참고하세요.

참고: 등록에 사용된 Google 계정은 개발자 계정, 즉 애플리케이션 사용자에게 애플리케이션 개발자로 표시하려는 계정이어야 합니다. 사용자가 애플리케이션을 사용하는 동안 자신의 계정에 대한 액세스 권한을 부여하게 되므로 이 계정을 애드센스 로그인용으로 연결할 필요가 없습니다.

빠른 시작 튜토리얼

아래의 단계를 따라 첫 번째 요청을 수행하세요. 이 단계는 사용 중인 라이브러리 또는 언어에 따라 약간 다를 수 있습니다.

  1. 적절한 샘플을 사용하여 애드센스 계정에서 광고 클라이언트 목록을 가져옵니다. 이 요청은 애드센스 사용자가 프로젝트를 인증하고 승인하는 일회성 프로세스를 시작합니다.

    광고 클라이언트는 애드센스 계정과 애드센스 제품(예: 콘텐츠 광고 또는 검색 광고) 간의 연결을 나타냅니다. 애드센스 계정에는 하나 이상의 광고 클라이언트가 있을 수 있습니다.

    1. 웹 애플리케이션의 경우 사용자가 액세스 권한을 부여할 수 있는 사이트로 리디렉션됩니다. 승인되면 API 콘솔에 정의된 콜백 URL로 리디렉션됩니다.
    2. 설치된 애플리케이션도 이와 비슷하게 작동합니다. 클라이언트 라이브러리가 브라우저 창을 열고 승인 코드를 사용하려고 시도합니다. Android, Chrome, iOS 애플리케이션의 경우 이 방법은 플랫폼별로 다릅니다.
  2. reports.generate용 API 탐색기를 사용하여 다음 보고서를 요청합니다.
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    보고서에서는 수익이 발생하는지 여부와 수입에 영향을 미친 요소를 파악할 수 있습니다. 계정 전체 또는 채널 일부에 대해 광고 단위의 하위 집합을 실행할 수 있습니다.

  3. 애플리케이션에서 동일한 보고서를 요청해 보세요.
  4. 보고서를 광고 단위별로 필터링할 수 있습니다. adunits.list를 사용하여 광고 단위 목록을 가져옵니다. 광고 클라이언트 ID가 필요합니다 (1단계에서 확인). 광고 단위를 선택한 후 reports.generatefilter 매개변수에서 광고 ID를 사용하세요.

    광고 단위는 사용자가 구성하는 광고 자리표시자로, 게재되는 광고의 일부 속성 (예: 크기 및 모양)을 정의합니다.

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. 맞춤 또는 URL 채널을 기준으로 필터링하거나 여러 필터를 혼합해 보세요.

    채널은 일부 광고 단위의 실적을 추적하는 도구입니다. 채널에는 URL과 맞춤, 두 가지 유형이 있습니다. 전자는 특정 페이지 또는 도메인의 실적을 추적하는 데 사용되지만, 맞춤 그룹은 사용자가 선택한 특정 광고 단위 그룹의 실적을 추적할 수 있습니다.

참조 문서에서 사용 가능한 호출 및 리소스를 살펴보면 구현을 시작할 수 있습니다.