보고서 만들기 및 실행

이 가이드에서는 보고서를 만들고 실행하는 방법과 결과를 확인하는 방법을 설명합니다.

보고서 만들기

분석가와 슈퍼 사용자는 보고서를 만들고 수정할 수 있습니다. Ads Data Hub의 액세스 제어에 대해 자세히 알아보세요.

  1. Ads Data Hub에서 보고서 페이지를 엽니다.
  2. + 보고서 만들기를 클릭합니다. 새 보고서 만들기 페이지가 열립니다.
    • 검색하고, 제품 아이콘을 선택하고, 드롭다운 옵션을 선택하여 템플릿을 필터링할 수 있습니다.
  3. 템플릿을 선택하고 템플릿 사용을 클릭하거나 SQL을 클릭하여 처음부터 시작합니다.
    • expand_content 펼치기를 클릭하여 템플릿 세부정보 및 SQL을 미리 봅니다.
  4. 보고서를 수정하려면 쿼리 수정을 클릭합니다. 쿼리 편집기를 사용하여 다음 작업을 할 수 있습니다.
    • BigQuery 호환 SQL을 사용하여 보고서를 맞춤설정합니다.
    • 속성 탭에서 매개변수를 구성합니다.
    • Google 테이블 탭에서 사용 가능한 테이블과 필드의 목록을 확인합니다.
    • 퍼스트 파티 테이블 탭에서 가져온 퍼스트 파티 테이블 및 스키마 목록을 확인합니다.
    • 실행을 클릭하여 SQL 쿼리를 실행합니다. SQL 쿼리 편집기에서 시작한 실행은 보고서의 실행 기록에 반영되지 않으며 홈 페이지의 최근 활동 섹션에 표시되지 않습니다.
    • 완료를 클릭하여 쿼리 변경사항을 확인하고 보고서 설정 페이지로 돌아갑니다.
  5. 보고서 이름을 입력합니다.
  6. 해당하는 경우 설정 카드에서 매개변수 값을 설정합니다.
  7. 이 보고서에서 실행되는 작업의 입력 및 출력을 구성합니다.
    • 광고 데이터 출처 필드에서 데이터 소스를 선택합니다. 이 ID는 쿼리할 광고 데이터와 연결된 Ads Data Hub 계정 ID여야 합니다. 샌드박스 데이터를 쿼리하려면 ADH 샌드박스 고객을 선택하세요.
    • 데이터 이동 색인을 사용하는 경우 데이터 이동 색인 계정 필드에서 데이터 이동 색인을 선택합니다.
    • 보고서의 기간과 시간대를 선택합니다. 보고서 시간대는 연결된 광고 계정(예: Google Ads 계정)의 시간대와 일치해야 합니다. 참고: 쿼리 테스트를 위한 맞춤 기간은 SQL 편집기 화면에서 쿼리를 실행하는 경우에만 지원됩니다.
    • 선택사항: 개인 정보 보호 설정을 변경하고 필터링된 행 요약을 구성합니다.
    • 보고서 결과를 저장할 BigQuery 프로젝트, 데이터 세트, 테이블을 선택합니다.
  8. 선택사항: 일정에 따라 보고서가 실행되도록 설정합니다.
  9. 저장을 클릭합니다.

매개변수

매개변수를 사용하면 특정 보고서를 실행하는 방법을 지정할 수 있습니다. SQL을 사용하여 보고서를 만들 때 (또는 보고서 템플릿에서 SQL을 수정할 때) 매개변수를 사용하면 보고서에서 동일한 SQL 코드를 재사용하고 보고서의 각 사본에 다른 매개변수 값을 설정할 수 있습니다. 예를 들어 보고서 세부정보 페이지의 설정 섹션에서 매개변수를 구성하고 값을 설정하여 서로 다른 캠페인 ID 세트에서 동일한 SQL 쿼리 또는 템플릿을 공유하는 두 보고서를 실행할 수 있습니다. 매개변수를 사용하면 SQL 코드를 깔끔하게 유지하고, 수정을 통해 오류가 발생할 가능성을 줄이고, SQL 자체에서 값을 수정하지 않고도 보고서에서 동일한 SQL 쿼리를 재사용할 수 있습니다.

다음 예에서는 보고서에 int64 캠페인 ID의 array를 허용하는 campaign_ids라는 매개변수가 포함되어 있습니다.

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

매개변수 유형

다음과 같은 유형의 매개변수가 허용됩니다.

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • 허용되는 유형의 array

보고서에 매개변수 추가

  1. 저장된 보고서를 열거나 새 보고서를 만듭니다.
  2. 쿼리 수정을 클릭합니다.
  3. 속성에서 매개변수 추가를 클릭합니다.
  4. 이름 필드에 이름을 입력합니다. 이 이름을 사용해 보고서 텍스트의 매개변수를 참조합니다.
  5. 드롭다운 메뉴를 사용하여 매개변수 유형을 선택합니다.
    • 배열 유형을 선택하면 추가 드롭다운 메뉴가 표시됩니다. 이 드롭다운 메뉴에서 배열 유형을 선택합니다.
  6. SQL 쿼리에서 표준 SQL 매개변수 형식 @PARAMETER_NAME을 사용하여 매개변수를 추가합니다. 다음 단계에 나온 예시를 참고하세요.
  7. 완료를 클릭한 후 저장을 클릭합니다.

매개변수 사용

  1. 매개변수가 구성된 보고서를 엽니다.
  2. 설정 창에서 정의한 각 매개변수의 값을 입력합니다.
  3. 저장을 클릭하여 파라미터 값을 유지합니다.

매개변수 삭제

  1. 매개변수가 구성된 보고서를 엽니다.
  2. 쿼리 수정을 클릭하여 SQL 편집기를 엽니다.
  3. 속성에서 삭제하려는 매개변수 옆에 있는 삭제 삭제를 클릭합니다.
  4. 완료를 클릭한 후 저장을 클릭합니다.

예약된 매개변수

다음 표에는 Ads Data Hub에 예약된 매개변수가 나와 있습니다. 이러한 매개변수는 보고서에 사용할 수 있지만 예약된 매개변수와 같은 이름으로는 매개변수를 만들 수 없습니다.

start_date date

보고서 작업의 시작일(해당 날짜 포함)입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다.
end_date date

보고서 작업의 종료일(해당 날짜 포함)입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다.
time_zone string

보고서 작업의 시간대입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다.

필터링된 행 요약

필터링된 행 요약은 데이터 차이 검사로 인해 필터링된 데이터를 집계합니다. 필터링된 행의 데이터가 합산되어 포괄 행에 추가됩니다. 필터링된 데이터는 추가로 분석할 수 없지만 결과에서 필터링된 데이터 양에 대한 요약 정보는 확인할 수 있습니다. 데이터 차이 검사 개인 정보 보호 모드를 사용하는 쿼리의 경우 Ads Data Hub에서 필터링된 행 요약을 자동으로 사용 설정하고 구성합니다. 쿼리를 수정하면 Ads Data Hub에서 선택한 열을 기반으로 구성을 자동으로 조정합니다. 필터링된 행 요약에 대해 자세히 알아보거나 수동으로 구성하려면 필터링된 행 요약을 참고하세요.

보고서 수정

  1. Ads Data Hub에서 보고서 페이지를 엽니다.
  2. 수정할 보고서의 이름을 클릭합니다.
  3. 보고서를 변경합니다. 예를 들어 SQL을 수정하거나, 매개변수 값을 관리하거나, 일정을 설정할 수 있습니다.
  4. 저장을 클릭합니다.

보고서 실행

보고서를 실행하기 전에 조인의 출력이 포함될 데이터 세트에 대한 dataEditor 권한을 서비스 계정에 부여해야 합니다. BigQuery의 액세스 제어에 대해 자세히 알아보기

  1. Ads Data Hub에서 보고서 페이지를 엽니다.
  2. 실행할 보고서의 이름을 클릭합니다.
  3. 실행을 클릭합니다.

일정에 따라 보고서 실행

  1. Ads Data Hub에서 보고서 페이지를 엽니다.
  2. 일정을 설정할 보고서의 이름을 클릭합니다.
    • 새 보고서의 일정을 설정하려면 보고서를 만든 다음 저장을 클릭합니다.
  3. + 일정 설정을 클릭합니다.
  4. 일정 창에서 아래 세부정보로 이 보고서 실행 예약 전환 버튼을 클릭하여 사용 설정합니다.
  5. 빈도에서 간격과 시간을 선택한 후 시간대를 입력합니다.
    • 대신 크론 표현식을 사용하려면 크론 표현식을 사용하여 일정 설정 전환 버튼을 클릭하여 사용 설정한 후 상자에 표현식을 입력합니다.
  6. 완료를 클릭합니다.
  7. 저장을 클릭하여 보고서에 변경사항을 커밋합니다.

홈 페이지에 예약된 작업을 표시하려면 소유자 필터 목록에서 모든 사용자를 선택합니다.

결과 보기

보고서 실행이 완료되면 보고서 세부정보 페이지에서 결과를 미리 볼 수 있습니다. 나중에 결과를 보려면 홈 페이지에서 보고서를 엽니다. BigQuery, Sheets 또는 데이터 스튜디오에서 데이터를 살펴볼 수도 있습니다.

미리보기

완료된 작업 내에서 미리보기를 클릭합니다. 처음 20개의 결과가 작업 아래에 표시됩니다.

BigQuery

결과는 기본적으로 BigQuery로 내보내집니다. 테이블 보기를 클릭하여 BigQuery를 새 창에 엽니다.

Sheets 및 데이터 스튜디오

탐색 드롭다운 메뉴를 열고 옵션에서 Sheets로 탐색 또는 데이터 스튜디오로 탐색을 선택합니다. 데이터가 새 창에 표시됩니다.