보고서 만들기
- Ads Data Hub에서 쿼리 탭으로 이동합니다.
- + 쿼리 만들기를 클릭합니다. 새 보고서 만들기 페이지가 열립니다.
- 선택사항: 검색하고, 아이콘을 선택하고, 드롭다운 옵션을 선택하여 템플릿을 필터링합니다.
- 데이터 소스
- 사용 사례
- 인벤토리
- MRC 인증
- 선택사항: expand_content 펼치기를 클릭하여 템플릿 세부정보 및 SQL을 미리 봅니다.
- 템플릿 사용을 클릭하여 사용할 템플릿을 선택하거나 add_circle 추가를 클릭하여 템플릿을 처음부터 새로 만듭니다.
- 보고서 이름을 입력합니다.
- BigQuery 호환 SQL을 사용하여 보고서를 작성하거나 수정합니다. Google 테이블 탭에서 사용 가능한 테이블과 필드를 찾아 SQL에 삽입할 수 있습니다.
- 선택사항: 매개변수를 구성합니다.
- 선택사항: 필터링된 행 요약을 구성합니다.
- 저장을 클릭합니다.
매개변수
매개변수를 활용하면 보고서의 가용 범위가 넓어집니다. 예를 들어 여러 캠페인을 대상으로 동일한 보고서를 실행하고 싶을 수 있습니다. 이 경우 매번 중복된 보고서를 만들거나 캠페인 ID를 하드코딩하지 않고, 하나 이상의 캠페인 ID를 받는 매개변수가 보고서 실행 시점에 실행 카드에서 입력되도록 구성할 수 있습니다. 매개변수를 사용하면 코드를 깔끔하게 유지하고, 수정 과정에서 오류가 발생할 가능성이 줄어들며, 수정 없이 보고서를 재사용할 수 있습니다. 매개변수는 매개변수가 생성된 보고서로 범위가 제한되므로 다른 보고서에서 매개변수 이름을 재사용할 수 있습니다.
매개변수 유형
다음과 같은 유형의 매개변수가 허용됩니다.
int64
float64
bool
string
date
timestamp
- 허용되는 유형의
array
매개변수 만들기
- 저장된 보고서를 열거나 새 보고서를 만듭니다.
- 속성 > 매개변수 > 매개변수 추가를 클릭합니다.
- 이름 필드에 이름을 입력합니다. 이 이름을 사용해 보고서 텍스트의 매개변수를 참조합니다.
- 드롭다운 메뉴를 사용하여 매개변수 유형을 선택합니다.
- 배열을 선택하면 추가 드롭다운 메뉴가 표시됩니다. 드롭다운 메뉴에서 배열 유형을 선택합니다.
- 선택사항: 원하는 매개변수를 모두 추가할 때까지 2~4단계를 반복합니다.
- ‘저장’을 클릭합니다.
매개변수 사용
보고서 텍스트에서 표준 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
쿼리를 실행하면 새 작업 대화상자에 매개변수 필드가 포함됩니다. 정의한 각 매개변수의 값을 입력합니다.
매개변수 삭제
- 삭제할 매개변수가 있는 보고서를 엽니다.
- 속성 탭을 엽니다.
- 매개변수 카드에서 삭제할 매개변수 옆의 삭제 삭제를 클릭합니다.
- '저장'을 클릭합니다.
예약된 매개변수
다음 표에는 Ads Data Hub에 예약된 매개변수가 나와 있습니다. 이러한 매개변수는 보고서에 사용할 수 있지만 예약된 매개변수와 같은 이름으로는 매개변수를 만들 수 없습니다.
start_date
|
date
보고서 작업의 시작일(해당 날짜 포함)입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다. |
end_date
|
date
보고서 작업의 종료일(해당 날짜 포함)입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다. |
time_zone
|
string
보고서 작업의 시간대입니다. 이 이름의 사용자 정의 매개변수는 무시되고 새 작업 대화상자에 설정된 값으로 대체됩니다. |
필터링된 행 요약
필터링된 행 요약은 개인 정보 보호 검사로 인해 필터링된 데이터를 집계합니다. 필터링된 행의 데이터가 합산되어 포괄 행에 추가됩니다. 필터링된 데이터는 추가로 분석할 수 없지만 결과에서 필터링된 데이터 양에 대한 요약 정보는 확인할 수 있습니다.
보고서 수정
- Ads Data Hub에서 쿼리 탭으로 이동합니다.
- 수정할 보고서의 이름을 클릭합니다.
- 보고서를 수정합니다.
- 저장을 클릭합니다.
보고서 실행
보고서를 실행하기 전에 조인의 출력이 포함될 데이터 세트에 대한 dataEditor
권한을 서비스 계정에 부여해야 합니다.
BigQuery의 액세스 제어에 대해 자세히 알아보기
- Ads Data Hub에서 쿼리 탭으로 이동합니다.
- 실행할 보고서의 이름을 클릭합니다.
- 보고서에 사용될 것으로 예상되는 바이트 수가 페이지 상단에 표시됩니다.
실행을 클릭합니다.
- 광고 데이터 출처 드롭다운에서 ID를 선택합니다. 이 ID는 쿼리할 광고 데이터와 연결된 ID의 광고 데이터여야 합니다. 샌드박스 데이터를 쿼리하려면 ADH 샌드박스 고객을 선택하세요.
- 데이터 이동 색인을 사용하는 경우 데이터 이동 색인 출처 드롭다운에서 데이터 이동 색인을 선택합니다.
- 대상 테이블 필드에 보고서 결과를 저장할 위치를 지정합니다.
- 시작일과 종료일을 입력하여 보고서 기간을 설정합니다.
- 시간대를 입력합니다. 구매 채널의 시간대와 일치하는 시간대를 입력해야 합니다.
- 선택사항: 원하는 매개변수의 값을 입력합니다.
- 실행을 클릭합니다.
결과 보기
보고서 실행이 완료된 후 '작업' 페이지에서 결과를 미리 볼 수 있습니다. BigQuery, Sheets 또는 데이터 스튜디오에서 데이터를 살펴볼 수도 있습니다.
미리보기
완료된 작업 내에서 미리보기를 클릭합니다. 처음 20개의 결과가 작업 아래에 표시됩니다.
BigQuery
결과는 기본적으로 BigQuery로 내보내집니다. 테이블 보기를 클릭하여 BigQuery를 새 창에 엽니다.
Sheets 및 데이터 스튜디오
탐색 드롭다운 메뉴를 열고 옵션에서 Sheets로 탐색 또는 데이터 스튜디오로 탐색을 선택합니다. 데이터가 새 창에 표시됩니다.