UI에 보고서 매핑

이 가이드로 사용자 인터페이스(UI)에 있는 애드워즈 보고서의 개념과 관계를 매핑하여 애드워즈 API 보고서처럼 만들 수 있습니다

  1. 항목
  2. 필터링
    1. 기간
    2. 필터
  3. 세분화
  4. 페이지 매김
  5. 정렬
  6. 다운로드 형식
  7. 보고서 예약 및 이메일 발송
  8. 공통 항목
  9. 보고서 유형
    1. 캠페인 보고서
    2. 광고그룹 보고서
    3. 광고 보고서
    4. 키워드 보고서
    5. 자동 게재위치 보고서
    6. 선택 게재위치 보고서
    7. URL 보고서
    8. 검색어 보고서
    9. 지역별 보고서
    10. 성별 보고서
    11. 연령대 보고서
    12. 도착 URL 보고서
    13. 무료 클릭 보고서
    14. 잠재고객 보고서
    15. 주제 보고서
    16. 광고 확장 보고서(업그레이드됨)
    17. 광고 확장 보고서(기존)
    18. 제외 키워드 보고서
    19. 게재위치 제외 보고서
    20. 캠페인 광고 일정 타겟 보고서
    21. 캠페인 위치 타겟 보고서
    22. 캠페인 플랫폼 타겟 보고서
    23. 키워드 없는 카테고리 보고서
    24. 키워드 없는 검색 보고서

다음 표는 API로 옮길 때 UI에서 쓰는 일반 용어와 그 용어의 매핑을 정리한 것입니다.

UI API
항목 fields
기간 dateRange
필터 predicates
세분화 세분화시키는 특정 필드
페이지 매김 paging
다운로드 형식 downloadFormat

항목

UI 내 항목들은 API의 fields와 같습니다. 메뉴에 있는 항목으로 UI의 항목을 맞춤설정하세요. API에서는 fields 속성을 이용해 해당 항목을 보고서에 포함시킬 수 있습니다. 보고서당 이용할 수 있는 모든 필드를 보려면 보고서 유형 참조 문서를 참조하세요. 항목의 이름은 API 보고서 정의에서 쓰는 필드 이름이지만 표시 이름은 UI에 표시되는 항목의 이름입니다. 


필터링

기간

애드워즈 UI에는 계정의 통계를 나타내는 표와 이 통계의 기간을 제어하는 드롭다운 메뉴가 있습니다. API에서도 dateRangeType에 대해  '최근 7일'과 같은 사전 정의된 기간을 사용하여 컨트롤할 수 있습니다.


필터

UI 내 필터는 API의 predicates와 일치합니다. 전환이 5미만일 경우 필터를 통해 보고서 결과를 좁힐 수 있습니다. Predicates는 보고서 필드(예: 전환), 연산자(예: LESS_THAN) 및 값(예: 5)으로 구성됩니다. 보고서에 predicates를 포함할 경우 모든 포괄(AND) 조건으로 간주됩니다. Predicates에 잘못된 ID가 들어 있을 경우 결과에는 빈 응답이 표시됩니다.


세분화

자세한 통계를 위해 분류 기준별로 데이터를 나눌 수 있습니다. 예를 들어 Google 디스플레이 네트워크와 별도로 Google 검색 네트워크에 대한 노출수만을 확인하려면 네트워크별로 보고서를 분류합니다.

자세한 내용은 세분화를 참조하세요.


페이지 매김

UI에서 보고서를 검토하려면 각 데이터 표 밑에 있는 컨트롤을 이용하세요. 여기서 페이지를 전환할 수 있고 정의된 크기 세트에서 디스플레이할 결과의 갯수를 선택할 수 있습니다. API SOAP 서비스에서는 가능하지만, UI에서는 보고서에 명시된 모든 paging 매개변수는 무시됩니다.


정렬

UI에서 특정 항목별로 정렬하려면 해당 항목을 선택하면 됩니다. 현재 이 기능은 API SOAP 서비스에서는 지원되지만 보고서에서는 지원되지 않습니다.

다운로드 형식

보고서는 UI에서 여러 형식(csv, tsv, xml 등)으로 다운로드할 수 있습니다. 이 형식은 대부분 API에서도 지원됩니다.


보고서 예약 및 이메일 발송

보고서 예약 및 이메일 발송은 UI에서 지원되나 API에서는 지원되지 않습니다.


공통 항목

 UI는 API 보고서와 마찬가지로 다른 보고서 내의 공통 항목을 공유합니다. 다른 보고서 유형에서도 노출, 클릭, 전환 같은 필드와 기타 다른 필드도 공유가 가능합니다.

보고서 유형

아래에서 UI 보고서가 각각의 API 보고서 유형에 어떻게 매핑되는지 보여 줍니다. 또한 보고서별로 세분화 수준의 기본값을 설명하고 해당 보고서를 UI에서 어떻게 찾는지도 알려 줍니다. 보고서 유형 페이지는 모든 API 보고서에 대해 UI 항목 이름이나 '표시 이름'과 API 필드 이름이나 일반 '이름' 간의 매핑을 나열합니다.

캠페인 보고서

위에서 제시한 캠페인 보고서를 받으려면 상위 '캠페인' 탭으로 이동하여 '광고그룹' 탭 왼쪽에 있는 내부 '캠페인' 탭을 선택합니다. 특정 캠페인을 보고 있다면 '캠페인' 내부 탭은 나타나지 않습니다. 이 경우 탐색 패널 왼쪽 상단에 있는 '모든 온라인 캠페인' 옵션을 클릭하세요.

캠페인 보고서는 API에서 CAMPAIGN_PERFORMANCE_REPORT 유형에 매핑됩니다.


광고그룹 보고서

위에서 제시한 광고그룹 보고서를 받으려면 상위 '광고그룹'으로 이동합니다.

 광고그룹 보고서는 API에서 ADGROUP_PERFORMANCE_REPORT 유형에 매핑됩니다.


광고 보고서

위에서 제시한 광고 보고서를 받으려면 상위 '광고' 탭으로 이동합니다.

광고 보고서는 API에서 AD_PERFORMANCE_REPORT 유형에 매핑됩니다.


키워드 보고서

위에서 제시한 키워드 보고서를 받으려면 상위 '키워드' 탭으로 이동합니다.

키워드 보고서는 API에서 KEYWORDS_PERFORMANCE_REPORT 유형에 매핑됩니다.


자동 게재위치 보고서

위에서 제시한 자동 게재위치 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부의 '게재위치' 탭을 선택합니다. 항목 '상태'가 '자동'인 행은 게재위치 이외의 기준에 따라 광고를 게재하는 게재위치입니다.

 자동 게재위치 보고서는 API에서 AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT 유형에 매핑됩니다. API 내 자동 게재위치 데이터는 이 보고서를 통해서만 지원되며 AdGroupCriterionService에서는 지원되지 않습니다. API 보고서에는 '기타 도메인' 행의 통계가 지원되지 않습니다


선택 게재위치 보고서

위에서 제시한 선택 게재위치 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부 '게재위치'로 이동합니다. 열 '상태'가 '관리'인 행은 게재위치 기준에 따라 광고를 게재하는 게재위치입니다.

선택 게재위치 보고서는 API에서 PLACEMENT_PERFORMANCE_REPORT 유형에 매핑됩니다.


URL 보고서

위에서 제시한 URL 보고서를 받으려면 상위 '캠페인' 탭으로 이동한 다음 '키워드' 탭의 오른쪽에 있는 내부 '네트워크' 탭을 선택합니다. '선택 게재위치'의 오른쪽에 있는 '세부 정보 표시' 링크를 클릭하여 선택 게재위치를 확장한 다음 데이터 표 상단에 있는 'URL 목록 표시->모두' 메뉴에서 클릭합니다.

 URL 보고서는 API에서 URL_PERFORMANCE_REPORT 유형에 매핑됩니다.


검색어 보고서

위에서 제시한 검색어 보고서를 받으려면 상위 '측정기준'으로 이동한 다음 '검색어' 보기를 선택합니다.

검색어 보고서는 API에서 SEARCH_QUERY_PERFORMANCE_REPORT 유형에 매핑됩니다.


지역별 보고서

위에서 제시한 지역별 보고서를 받으려면 상위 '측정기준' 탭으로 이동하고 '지역별' 보기를 선택합니다.

지역별 보고서는 API에서 GEO_PERFORMANCE_REPORT 유형에 매핑됩니다.


성별 보고서

위에서 제시한 성별 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부 '성별' 탭을 선택합니다.

성별 보고서는 API에서 GENDER_PERFORMANCE_REPORT 유형에 매핑됩니다.

연령대 보고서

위에서 제시한 연령대 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부 '연령' 탭을 선택합니다.

연령대 보고서는 API에서 AGE_RANGE_PERFORMANCE_REPORT 유형에 매핑됩니다.

도착 URL 보고서

위에서 제시한 도착 URL 보고서를 받으려면 상위 '측정기준' 탭으로 이동하고 '도착 URL' 보기를 선택합니다.

도착 URL 보고서는 API에서 DESTINATION_URL_REPORT 유형에 매핑됩니다.


무료 클릭 보고서

무료 클릭이란 동영상 광고, 디스플레이 광고, 추가 제품 정보 및 추가 위치 정보를 클릭하기 전에 발생하는 상호작용을 말합니다. '동영상 재생 25%' 또는 '길찾기'가 좋은 예입니다.

무료 클릭 보고서는 API에서는 광고 전환 보고서라 불리며 API에서 CREATIVE_CONVERSION_REPORT 유형에 매핑됩니다.


잠재고객 보고서

위에서 제시한 잠재고객 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부 '관심분야 및 리마케팅' 탭을 선택합니다. '관심분야 및 리마케팅' 탭이 보이지 않을 경우 오른쪽 아래 가장자리에 아래 화살표를 클릭하여 '관심분야 및 리마케팅'을 선택합니다.

잠재고객 보고서는 API에서 AUDIENCE_PERFORMANCE_REPORT 유형에 매핑됩니다.


주제 보고서

위에서 제시한 주제 보고서를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동한 다음 내부 '주제' 탭을 선택합니다. '주제' 탭이 보이지 않을 경우 오른쪽 아래 가장자리에 화살표를 클릭하여 '주제'를 선택합니다.

주제 보고서는 주제당 한 행씩, 주제 수준에서 합산한 모든 통계를 보여 줍니다. 다른 분류 기준 필드가 사용되는 경우 캠페인당 두 행 이상 표시됩니다. 자세한 내용은 세분화를 참조하세요.

주제는 API에서는 업종으로 통합니다. 주제 보고서는 API에서 DISPLAY_TOPICS_PERFORMANCE_REPORT 유형에 매핑됩니다.


광고 확장 보고서(업그레이드됨)

 위에서 제시한 업그레이드된 광고 확장 보고서를 받으려면 상위 '광고 확장' 탭으로 이동하여 '보기' 오른쪽 옆에 있는 목록 상자에서 '업그레이드됨'을 선택하고 보고 싶은 특정 보기(예: '추가 사이트링크 정보')를 선택합니다. '광고 확장' 탭이 보이지 않을 경우 오른쪽 아래 가장자리에 아래 화살표를 클릭하여 '광고 확장'을 선택합니다.

광고 확장 보고서는 API에서 PLACEHOLDER_FEED_ITEM_REPORT 유형에 매핑됩니다. 'AdExtensionType' 필드는 UI에서와 같은 확장 유형별로 필터링하기 위해 placeholderTypes로 필터링할 수 있습니다.


광고 확장 보고서(기존)

 위에서 제시한 기존 광고 확장 보고서를 받으려면 상위 '광고 확장' 탭으로 이동하여 '보기' 오른쪽 옆에 있는 목록 상자에서 '업그레이드되지 않음'을 선택하고 보려는 특정 보기(예: '위치 확장')를 선택합니다. '광고 확장' 탭이 보이지 않을 경우 오른쪽 아래 가장자리에 아래 화살표를 클릭하여 '광고 확장'을 선택합니다. 선택한 확장에 업그레이드된 확장(예: 추가 위치 정보)이 없을 경우 '업그레이드됨'을 선택할 목록 상자가 표시되지 않습니다.

광고 확장 보고서는 API에서 AD_EXTENSIONS_PERFORMANCE_REPORT 유형으로 매핑됩니다. 'AdExtensionType' 필드는 UI에서와 같이 확장 유형별로 필터링하기 위해 predicate로 사용될 수 있습니다.


제외 키워드 보고서

위에서 제시한 제외 키워드 표를 받으려면 상위 '키워드' 탭으로 이동하여 페이지 하단으로 스크롤한 다음 확장되지 않는 경우 '제외 키워드' 링크를 클릭합니다.

제외 키워드 데이터는 API에서 CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT 유형에 매핑됩니다.


게재위치 제외 보고서

위에서 제시한 제외 게재위치 제외 표를 받으려면 상위 '디스플레이 네트워크' 탭으로 이동하고 페이지 하단으로 스크롤한 다음 확장되지 않는 경우 '제외' 링크를 클릭합니다.

 게재위치 제외 데이터는 API에서 CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT 유형에 매핑됩니다.

캠페인 수준에서 게재위치 제외 데이터를 검색하려면 CampaignCriterionService를 참조하세요.


캠페인 광고 일정 타겟 보고서

위에서 제시한 캠페인 광고 일정 보고서를 받으려면 상위 '설정' 탭으로 이동한 다음 내부 '광고 일정' 탭을 선택합니다.

캠페인 광고 일정 데이터는 API에서 CAMPAIGN_AD_SCHEDULE_TARGET_REPORT 유형에 매핑됩니다.


캠페인 위치 타겟 보고서

위에서 제시한 캠페인 위치 타겟 보고서를 받으려면 상위 '설정' 탭으로 이동한 다음 내부 '위치' 탭을 선택합니다.

 캠페인 위치 타겟 데이터는 API에서 CAMPAIGN_LOCATION_TARGET_REPORT 유형에 매핑됩니다. 


캠페인 플랫폼 타겟 보고서

 위에서 제시한 캠페인 플랫폼 타겟 보고서를 받으려면 상위 '기기' 탭으로 이동한 다음 내부 '플랫폼' 탭을 선택합니다.

캠페인 플랫폼 타겟 데이터는 API에서 CAMPAIGN_PLATFORM_TARGET_REPORT 유형에 매핑됩니다.


키워드 없는 카테고리 보고서

 위에서 제시한 키워드 없는 카테고리 보고서를 받으려면 상위 '자동 타겟' 탭으로 이동한 다음 '카테고리 표시...' 목록 상자에서 '모두'를 선택합니다.

키워드 없는 카테고리 데이터는 API에서 KEYWORDLESS_CATEGORY_REPORT 유형에 매핑됩니다.


키워드 없는 검색 보고서

위에서 제시한 키워드 없는 검색 보고서를 받으려면 상위 '자동 타겟' 탭으로 이동한 다음 '검색어 표시...' 목록 상자에서 '모두'를 선택합니다.

키워드 없는 검색 데이터는 API에서 KEYWORDLESS_QUERY_REPORT 유형에 매핑됩니다.


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

도움이 필요하시나요? 지원 페이지를 방문하세요.