쿼리 작성 및 실행

쿼리 만들기

참고: 모든 사용자가 쿼리를 만들고 수정할 수 있는 것은 아닙니다. Ads Data Hub의 액세스 제어에 대해 자세히 알아보세요.

1. Ads Data Hub에서 쿼리 탭으로 이동합니다.
2. + 쿼리 만들기를 클릭합니다. 분석 쿼리 템플릿 페이지가 열립니다.
3. 선택사항: 펼치기를 클릭하여 템플릿 SQL을 미리 봅니다.
4. 템플릿 사용을 클릭하여 사용할 템플릿을 선택하거나 빈 템플릿을 클릭하여 템플릿을 처음부터 새로 만듭니다.
5. 보고서 이름을 입력합니다.
6. BigQuery 호환 SQL을 사용하여 쿼리를 작성하거나 수정합니다. Google 테이블 탭에서 사용 가능한 테이블과 필드를 찾아 SQL에 삽입할 수 있습니다.
7. 선택사항: 매개변수를 구성합니다.
8. 선택사항: 필터링된 행 요약을 구성합니다.
9. 저장을 클릭합니다.

매개변수

매개변수를 사용하면 쿼리가 더 유연해집니다. 예를 들어 여러 캠페인에 동일한 쿼리를 실행하고 싶을 수 있습니다. 매번 실행하기 전에 중복 쿼리를 만들거나 캠페인 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 쿼리 작업의 시간대입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다. 팁: WHERE 절에서와 같이 쿼리에서 시간대를 사용할 때 불일치를 방지하려면 time_zone을 사용하여 새 작업에 설정된 시간대와 일치하도록 하세요. 데이터 소스와 동일한 시간대를 사용하는 것도 중요합니다.

필터링된 행 요약

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

참고: 집계 요구사항은 필터링된 행 요약 자체에 적용됩니다. 그 결과 필터링된 행 요약이 집계 요구사항보다 낮아지면 필터링된 행 요약 자체가 필터링됩니다.

쿼리 수정

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

쿼리 실행

핵심사항: 실제 데이터로 {queries} 쿼리를 실행하기 전에 샌드박스를 사용하여 쿼리를 작성하고 테스트해 보아야 합니다. Ads Data Hub에서 쿼리를 작성하기 위한 권장사항에 대해 자세히 알아보기

쿼리를 실행하기 전에 조인의 출력이 포함될 데이터 세트에 대한 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로 탐색 또는 데이터 스튜디오로 탐색을 선택합니다. 데이터가 새 창에 표시됩니다.