보고서 작성 및 실행

보고서 만들기

  1. Ads Data Hub에서 쿼리 탭으로 이동합니다.
  2. + 쿼리 만들기를 클릭합니다. 새 보고서 만들기 페이지가 열립니다.
  3. 선택사항: 검색하고, 아이콘을 선택하고, 드롭다운 옵션을 선택하여 템플릿을 필터링합니다.
    • 데이터 소스
    • 사용 사례
    • 인벤토리
    • MRC 인증
  4. 선택사항: expand_content 펼치기를 클릭하여 템플릿 세부정보 및 SQL을 미리 봅니다.
  5. 템플릿 사용을 클릭하여 사용할 템플릿을 선택하거나 add_circle 추가를 클릭하여 템플릿을 처음부터 새로 만듭니다.
  6. 보고서 이름을 입력합니다.
  7. BigQuery 호환 SQL을 사용하여 보고서를 작성하거나 수정합니다. Google 테이블 탭에서 사용 가능한 테이블과 필드를 찾아 SQL에 삽입할 수 있습니다.
  8. 선택사항: 매개변수를 구성합니다.
  9. 선택사항: 필터링된 행 요약을 구성합니다.
  10. 저장을 클릭합니다.

매개변수

매개변수를 활용하면 보고서의 가용 범위가 넓어집니다. 예를 들어 여러 캠페인을 대상으로 동일한 보고서를 실행하고 싶을 수 있습니다. 이 경우 매번 중복된 보고서를 만들거나 캠페인 ID를 하드코딩하지 않고, 하나 이상의 캠페인 ID를 받는 매개변수가 보고서 실행 시점에 실행 카드에서 입력되도록 구성할 수 있습니다. 매개변수를 사용하면 코드를 깔끔하게 유지하고, 수정 과정에서 오류가 발생할 가능성이 줄어들며, 수정 없이 보고서를 재사용할 수 있습니다. 매개변수는 매개변수가 생성된 보고서로 범위가 제한되므로 다른 보고서에서 매개변수 이름을 재사용할 수 있습니다.

매개변수 유형

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

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

매개변수 만들기

  1. 저장된 보고서를 열거나 새 보고서를 만듭니다.
  2. 속성 > 매개변수 > 매개변수 추가를 클릭합니다.
  3. 이름 필드에 이름을 입력합니다. 이 이름을 사용해 보고서 텍스트의 매개변수를 참조합니다.
  4. 드롭다운 메뉴를 사용하여 매개변수 유형을 선택합니다.
    • 배열을 선택하면 추가 드롭다운 메뉴가 표시됩니다. 드롭다운 메뉴에서 배열 유형을 선택합니다.
  5. 선택사항: 원하는 매개변수를 모두 추가할 때까지 2~4단계를 반복합니다.
  6. ‘저장’을 클릭합니다.

매개변수 사용

보고서 텍스트에서 표준 SQL 매개변수 형식을 사용합니다. 그러면 매개변수 이름 앞에 @ 문자가 붙습니다. 다음 예에서는 보고서에 @campaign_ids라는 매개변수가 포함되어 있습니다.

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

  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

쿼리를 실행하면 새 작업 대화상자에 매개변수 필드가 포함됩니다. 정의한 각 매개변수의 값을 입력합니다.

매개변수 삭제

  1. 삭제할 매개변수가 있는 보고서를 엽니다.
  2. 속성 탭을 엽니다.
  3. 매개변수 카드에서 삭제할 매개변수 옆의 삭제 삭제를 클릭합니다.
  4. '저장'을 클릭합니다.

예약된 매개변수

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

start_date date

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

end_date date

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

time_zone string

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

필터링된 행 요약

필터링된 행 요약은 개인 정보 보호 검사로 인해 필터링된 데이터를 집계합니다. 필터링된 행의 데이터가 합산되어 포괄 행에 추가됩니다. 필터링된 데이터는 추가로 분석할 수 없지만 결과에서 필터링된 데이터 양에 대한 요약 정보는 확인할 수 있습니다.

보고서 수정

  1. Ads Data Hub에서 쿼리 탭으로 이동합니다.
  2. 수정할 보고서의 이름을 클릭합니다.
  3. 보고서를 수정합니다.
  4. 저장을 클릭합니다.

보고서 실행

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

  1. Ads Data Hub에서 쿼리 탭으로 이동합니다.
  2. 실행할 보고서의 이름을 클릭합니다.
  3. 실행을 클릭합니다.
    • 보고서에 사용될 것으로 예상되는 바이트 수가 페이지 상단에 표시됩니다.
  4. 광고 데이터 출처 드롭다운에서 ID를 선택합니다. 이 ID는 쿼리할 광고 데이터와 연결된 ID의 광고 데이터여야 합니다. 샌드박스 데이터를 쿼리하려면 ADH 샌드박스 고객을 선택하세요.
  5. 데이터 이동 색인을 사용하는 경우 데이터 이동 색인 출처 드롭다운에서 데이터 이동 색인을 선택합니다.
  6. 대상 테이블 필드에 보고서 결과를 저장할 위치를 지정합니다.
  7. 시작일과 종료일을 입력하여 보고서 기간을 설정합니다.
  8. 시간대를 입력합니다. 구매 채널의 시간대와 일치하는 시간대를 입력해야 합니다.
  9. 선택사항: 원하는 매개변수의 값을 입력합니다.
  10. 실행을 클릭합니다.

결과 보기

보고서 실행이 완료된 후 '작업' 페이지에서 결과를 미리 볼 수 있습니다. BigQuery, Sheets 또는 데이터 스튜디오에서 데이터를 살펴볼 수도 있습니다.

미리보기

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

BigQuery

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

Sheets 및 데이터 스튜디오

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