시작하기

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

시작하기 전에

애드센스 계정 만들기

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

애드센스 익히기

애드센스 소개 정보를 읽고 애드센스 UI를 둘러본 다음 코드를 작성해 보세요.

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

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

  • authentication
  • 서비스 탐색
  • API에 대한 요청 빌드
  • 응답 파싱

선택한 클라이언트 라이브러리를 설치하고 구성하는 방법에 대한 안내를 읽어보세요. 일반적으로 저장소의 루트 디렉터리에 있는 README 파일에 있습니다.

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

애플리케이션 등록

애드센스 관리 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.generate의 filter 매개변수에 광고 단위의 ID를 사용합니다.

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

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

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

참조 문서에서 사용 가능한 호출 및 리소스를 모두 알아보고 구현을 시작하세요.