일반적인 문제

애드센스 관리 API에는 새 보고서 및 저장된 보고서를 생성하는 호출이 있습니다. 일일 수익과 같은 간단한 분석이나 국가별 맞춤 채널당 매우 복잡한 클릭률 표가 포함될 수 있습니다. 이 가이드에서는 API와의 강력한 통합을 위해 올바르게 처리해야 하는 특이 사례 목록을 제공합니다.

보고서 구조

보고서 결과는 ReportResult 객체로 반환됩니다. 전체 세부정보는 보고서 응답 참조를 확인하세요.

시간순 측정기준(날짜, 주, 월) 이용하기

보고서는 비어 있거나 데이터가 없을 수 있습니다.

요청에 지정된 기간 동안 활동이 없으면 광고 요청이 생성되지 않으며 보고서 서비스에서 해당 기간의 행을 표시하지 않습니다. 이는 예를 들어 그래프를 그리는 경우에 중요합니다.

자세한 내용은 날짜 입력 가이드를 참고하세요.

동일한 보고서에서 월 및 주 측정기준 요청하기

이 보고서는 부정적이거나 예상하지 못한 결과를 초래할 수 있습니다. 1주가 서로 다른 2개월에 속하는 경우, 동일한 주에 대해 매월 하나씩, 총 2개의 행이 표시됩니다.

예

크기	측정항목	시작일	종료일
WEEK MONTH	CLICKS	2014-04-28	2014-05-03

반환:

MONTH	WEEK*	CLICKS
2014-04	2014-04-27	50
2014-05	2014-04-27	43

* 한 주의 시작 요일

해결 방법

보고서에서 MONTH를 삭제합니다.

WEEK	CLICKS
2014-04-27	93

측정기준 값 수집

예를 들어 플랫폼 (데스크톱, 고급형 휴대기기 등)과 관련된 측정기준을 요청하면 활동이 있는 플랫폼만 표시됩니다. 특정 일, 주 또는 달에 고급형 휴대기기에서 유입된 방문이 없다면 해당 카테고리에 대한 정보가 없습니다.

예

크기	측정항목	시작일	종료일
PLATFORM_TYPE_NAME MONTH	AD_REQUESTS	2014-02-01	2014-03-31

반환:

MONTH	PLATFORM_TYPE_NAME	AD_REQUESTS
2014-03	데스크톱	100
2014-03	고급형 휴대기기	5
2014-04	데스크톱	75

해결 방법

보고서 결과를 처리할 때 결과에 표시되지 않는 측정기준 값의 값을 0이라고 가정합니다.

MONTH	PLATFORM_TYPE_NAME	AD_REQUESTS
2014-03	데스크톱	100
2014-03	고급형 휴대기기	5
2014-04	데스크톱	75
2014-04	고급형 휴대기기	0

연속된 여러 보고서 결합

보고서가 너무 커서 한 번에 모두 생성할 수 없고 일괄 처리해야 하는 경우가 있습니다. 앱에서 이러한 작업이 가능하면 다음 사례를 고려하세요.

• WEEK 또는 MONTH 측정기준을 사용 중이고 주 또는 월 중순에 보고서를 분할하는 경우 각 보고서에 다른 데이터가 포함된 중복된 항목이 포함됩니다.
• 서로 다른 측정기준을 사용하여 데이터를 조합하지 못할 수 있으므로 모든 보고서의 측정항목과 측정기준이 동일한지 확인하세요.

특수 계정

일부 사용자는 예상하거나 알지 못하는 속성이 있는 애드센스 계정을 보유하고 있을 수 있습니다. 다음 사항을 고려해야 합니다.

• 수천 개의 도메인 또는 사이트를 보유한 게시자
• 수천 개의 광고 단위 또는 맞춤 채널을 보유한 게시자
• 여러 광고 클라이언트 (검색용 애드센스, 동영상용 애드센스 등)에 대해 보고하려는 게시자

복수 계정

사용자는 두 개 이상의 애드센스 계정에 액세스할 수 있습니다. 따라서 API를 호출할 때마다 계정 ID를 지정해야 합니다. accounts.list 호출은 계정 목록을 가져오고 사용자에게 계정 선택기 대화상자가 표시되어야 합니다. 가져온 계정 수가 1개이면 우회를 우회할 수 있습니다.

시간대 변경

애드센스 게시자는 언제든지 시간대를 변경할 수 있으며 이로 인해 보고서가 급격히 올라가거나 떨어질 수 있습니다. 자세한 내용은 현지 시간대 보고 가이드를 참고하세요.