시작하기

이 페이지에는 개발자가 애드센스 관리 API를 사용하여 애드센스 계정에 대한 정보를 조회하는 방법이 나와 있습니다. 여기에 나오는 내용을 이해하려면 웹 프로그래밍 개념 및 웹 데이터 형식에 대한 지식이 필요합니다.

목차

시작하기 전에

애드센스 계정 만들기

테스트용으로 사용할 애드센스 계정이 필요합니다. 이미 테스트 계정이 있다면 애드센스 사용자 인터페이스에서 바로 테스트 데이터를 설정, 수정 또는 확인할 수 있습니다.

애드센스 익히기

애드센스 소개 자료를 통해 애드센스의 기본 개념을 이해하고, 사용자 인터페이스를 둘러본 다음 코드를 작성하시기 바랍니다.

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

클라이언트 라이브러리 및 샘플 페이지에서 사용 가능한 라이브러리와 샘플에 대한 정보를 찾을 수 있습니다. 언어 탭을 클릭하고 링크를 따라가서 소스를 다운로드하세요. 클라이언트 라이브러리는 다음과 같은 작업을 처리합니다.

  • 인증
  • 서비스 발견
  • API 요청 만들기
  • 응답 파싱하기

클라이언트 라이브러리 설치 안내를 읽고 설정하세요. 설치 안내는 일반적으로 저장소의 루트 디렉토리에 있는 README 파일에서 찾을 수 있습니다.

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

애플리케이션 등록하기

애드센스 관리 API를 사용하려면 다음과 같이 개발 중인 애플리케이션을 Google에 등록해야 합니다.

  1. API 콘솔로 이동합니다.
  2. Google 계정에 로그인하거나 새 계정을 만듭니다.
  3. 새 프로젝트를 만듭니다.
  4. 새로 생성된 프로젝트에서 애드센스 관리 API 아래에 있는 활성화 버튼을 클릭합니다.
  5. API 액세스 섹션으로 이동합니다.
  6. 클라이언트 ID를 만듭니다.
    1. 웹 애플리케이션(웹 서버에 구현된 경우)
    2. 설치된 애플리케이션(나머지의 경우)

    참고: 서비스 계정은 보호된 데이터에 액세스하므로 지원되지 않습니다.

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

참고: 등록 시 사용하는 Google 계정은 귀하의 개발자 계정이어야 합니다. 즉, 이 애플리케이션의 사용자들에게 애플리케이션 개발자로 알리고픈 계정이어야 합니다. 애플리케이션 사용 시 각 사용자는 개인 계정에 액세스 권한을 부여하게 되므로, 이 계정을 애드센스 로그인용으로 지정하지 않아도 됩니다.

빠른 시작 가이드

다음 단계를 수행하여 첫 번째 요청을 만드세요. 이 단계는 사용 중인 라이브러리나 언어에 따라 약간씩 달라질 수 있습니다.

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

    광고 클라이언트는 애드센스 계정과 애드센스 제품(예: 콘텐츠 광고 또는 검색 광고 등) 간의 관계를 표시합니다. 애드센스 계정은 하나 이상의 광고 클라이언트를 가질 수 있습니다.

    1. 웹 애플리케이션의 경우 사용자는 액세스 권한을 부여하도록 선택할 수 있는 사이트로 리디렉션됩니다. 승인된 후에 사용자는 API 콘솔에서 정의된 콜백 URL로 리디렉션됩니다.
    2. 설치된 애플리케이션도 이와 유사하게 작동합니다. 클라이언트 라이브러리는 브라우저 창을 열고 인증 코드를 사용하려고 시도합니다. Android, Chrome 및 iOS 애플리케이션의 경우 이 방법은 플랫폼별로 달라집니다.
  2. reports.generate에서 API 탐색기를 사용하여 다음의 보고서를 요청합니다.
    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS

    보고서를 통해 수입 내역 및 이러한 수입에 영향을 미친 요소 등에 대한 정보를 자세히 파악할 수 있습니다. 계정 전체에 대해 보고서를 실행하거나 채널을 사용하여 특정 광고 단위에 대해 보고서를 실행할 수 있습니다.

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

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

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

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

  6. (선택사항) 애드센스 API 공지 그룹에 가입합니다.

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

다음에 대한 의견 보내기...

AdSense Management API
AdSense Management API