Search Ads 360 전송(지원 중단됨)

Search Ads 360(이전 명칭: Doubleclick Search)용 BigQuery Data Transfer Service를 사용하면 Search Ads 360 보고 데이터의 반복되는 로드 작업을 자동으로 예약하고 관리할 수 있습니다.

지원되는 보고서

Search Ads 360용 BigQuery Data Transfer Service는 현재 다음과 같은 보고 옵션을 지원합니다.

Search Ads 360 보고서가 BigQuery Data Transfer Service 테이블 및 뷰로 변환되는 방식에 대한 자세한 내용은 Search Ads 360 보고서 변환을 참조하세요.

보고 옵션	지원
지원되는 API 버전	v2
일정	매일, 전송이 처음 만들어진 시간(기본값) 하루 중 시간을 구성할 수 있습니다.
새로고침 기간	지난 7일(기본값) 최대 30일까지 구성 가능 데이터 이동 색인 스냅샷은 하루에 한 번 생성되며 최근 실행 날짜의 파티션에 저장됩니다. 데이터 이동 색인 스냅샷은 백필 또는 새로고침 창을 통해 로드된 날짜에 대하여 업데이트되지 않습니다. 새로고침 창에 대해 업데이트되지 않는 데이터 이동 색인에 대한 자세한 내용은 백필 설정을 참조하세요.
최대 백필 기간	제한 없음 Search Ads 360에는 알려진 데이터 보관 제한이 없지만, BigQuery Data Transfer Service에는 하나의 백필로 요청 가능한 일수에 제한이 있습니다. 백필에 대한 자세한 내용은 백필 설정을 참조하세요.

시작하기 전에

Search Ads 360 전송을 만들기 전에 다음을 수행하세요.

BigQuery Data Transfer Service 사용 설정에 필요한 모든 작업을 완료했는지 확인합니다.
Search Ads 360 데이터를 저장하기 위한 BigQuery Data Transfer Service 데이터 세트를 만듭니다.
Pub/Sub의 전송 실행 알림을 설정하려면 pubsub.topics.setIamPolicy 권한이 있어야 합니다. 이메일 알림만 설정한다면 Pub/Sub 권한이 필요하지 않습니다. 자세한 내용은 BigQuery Data Transfer Service 실행 알림을 참조하세요.
프로젝트에서 Search Ads 360 API에 대해 액세스를 사용 설정합니다.

필수 권한

전송을 만드는 사람에게 다음과 같은 필수 권한이 있는지 확인합니다.

BigQuery Data Transfer Service:
- 전송을 만들 bigquery.transfers.update 권한
- 대상 데이터 세트에 대한 bigquery.datasets.get 및 bigquery.datasets.update 권한
사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.update, bigquery.datasets.update, bigquery.datasets.get 권한이 있습니다. BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어를 확인하세요.
Google Cloud:
- 프로젝트에 대한 Search Ads 360에서 데이터를 다운로드할 수 있는 serviceusage.services.use 권한
사전 정의된 IAM 역할 editor, owner, serviceusage.serviceUsageConsumer에는 serviceusage.services.use 권한이 포함되어 있습니다. 서비스 사용량의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 확인하세요.
Google Search Ads 360: 전송 구성에 사용된 Google Search Ads 360 대행사 ID 및 광고주 ID에 대한 읽기 액세스 권한입니다. 자세한 내용은 Google 계정 만들기 및 SA360 권한 가져오기를 참조하세요.

Search Ads 360 데이터 전송 설정

Search Ads 360 보고를 위한 데이터 전송을 설정하려면 다음 항목이 필요합니다.

대행사 ID: Google Search Ads 360 대행사 ID입니다. Search Ads 360 대행사 ID 검색에 대한 자세한 내용은 Google 계정 만들기 및 SA360 권한 가져오기를 참조하세요.
광고주 ID: Google Search Ads 360 광고주 ID입니다. Search Ads 360 광고주 ID 검색에 대한 자세한 내용은 Google 계정 만들기 및 SA360 권한 가져오기를 참조하세요.

Search Ads 360 보고를 위한 데이터 전송을 만들려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

BigQuery 페이지로 이동
전송을 클릭합니다.
전송 만들기를 클릭합니다.
전송 만들기 페이지에서 다음을 수행합니다.
- 소스 유형 섹션에서 소스로 Search Ads 360(이전 명칭: Doubleclick Search)을 선택합니다.
- 전송 구성 이름 섹션의 표시 이름에 전송 이름(예: My Transfer)을 입력합니다. 전송 이름은 나중에 수정해야 할 경우에 전송을 식별할 수 있는 값이면 됩니다.
- 일정 옵션 섹션에서 다음을 수행합니다.
  - 반복 빈도에 대해 전송을 실행하려는 빈도 옵션을 선택합니다. 일을 선택한 경우 UTC로 유효한 시간을 제공합니다.
    - 시간
    - 일
    - 주문형
  - 해당하는 경우 지금 시작 또는 설정 시간에 시작을 선택하고 시작 날짜와 실행 시간을 제공합니다.
- 대상 설정 섹션의 대상 데이터세트에서 데이터를 저장하기 위해 만든 데이터세트를 선택합니다.
- 데이터 소스 세부정보 섹션에서 다음을 수행합니다.
  - 대행사 ID에 사용자의 대행사 ID를 입력합니다.
  - 광고주 ID에 사용자의 광고주 ID를 입력합니다.
  - 삭제된 항목 및 측정항목을 전송에 포함하려면 삭제된 항목 포함을 선택합니다.
  - (선택사항) 테이블 필터의 경우 모든 테이블을 로드하려면 이 필드를 비워 둡니다. 지원되는 일부 테이블에 대해서만 데이터를 가져오려면 해당 테이블의 이름 프리픽스를 공백으로 구분하여 나열합니다. 예를 들면 Account AccountDeviceStats AccountFloodlightAndDeviceStats입니다. 지원되는 모든 테이블 이름은 Search Ads 360 보고서 변환을 참조하세요.
  - (선택사항) 커스텀 플러드라이트 변수의 경우 Search Ads 360 보고서 변환에 미리 정의된 열만 가져오려면 이 필드를 비워 둡니다.
    Search Ads 360에서 만든 커스텀 플러드라이트 변수를 가져오려면 다음 예시와 같이 해당 필드 이름을 JSON 형식으로 지정합니다.
    - [{ "cfv_name": "variable_name", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": "table_name", "bigquery_column_name": "custom_column_name" },{ "cfv_name": "variable_name_2", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": ["table_name_2","table_name_3"], "bigquery_column_name": "custom_column_name_2" }]
    - JSON 목록의 모든 항목에 대해 다음을 포함합니다.
      - cfv_name은 커스텀 플러드라이트 변수가 Campaign Manager에서 생성되었을 때 사용자가 지정한 '친숙한' 이름입니다. 이 친숙한 이름은 또한 커스텀 측정기준 및 측정항목을 설정할 때 Search Ads 360 UI에 표시됩니다.
      - cfv_type은 metric 또는 dimension이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
      - campaign_manager_type은 number 또는 string이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
      - destination_table_name은 커스텀 플러드라이트 변수를 추가하려는 대상 테이블의 이름 프리픽스 또는 이름 프리픽스 목록입니다. 예시: AccountDeviceStats, [AdDeviceStats,CampaignFloodtlightAndDeviceStats].
      - bigquery_column_name은 이 커스텀 플러드라이트 변수가 BigQuery 대상 테이블에서 갖게 될 열 이름입니다. 열 이름은 BigQuery 열 이름 형식 요구사항을 따라야 합니다.
- (선택사항) 알림 옵션 섹션에서 다음을 수행합니다.
  - 전환을 클릭해서 이메일 알림을 사용 설정합니다. 이 옵션을 사용 설정하면 전송 실행이 실패할 때 전송 관리자에게 이메일 알림이 발송됩니다.
  - Pub/Sub 주제 선택에서 주제 이름을 선택하거나 주제 만들기를 클릭합니다. 이 옵션은 전송에 대한 Pub/Sub 실행 알림을 구성합니다.
저장을 클릭합니다.

bq

bq mk 명령어를 입력하고 전송 생성 플래그 --transfer_config를 지정합니다. 다음 플래그도 필요합니다.

--data_source
--target_dataset
--display_name
--params

또한 --project_id 플래그를 입력하여 특정 프로젝트를 지정할 수도 있습니다. --project_id를 지정하지 않으면 기본 프로젝트가 사용됩니다.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source

각 항목의 의미는 다음과 같습니다.

project_id는 프로젝트 ID입니다.
dataset는 전송 구성 대상 데이터 세트입니다.
name은 전송 구성의 표시 이름입니다. 전송 이름은 나중에 수정해야 할 경우에 전송을 쉽게 식별할 수 있는 값이면 됩니다.
parameters에는 JSON 형식으로 생성된 전송 구성의 매개변수가 있습니다. 예를 들면 --params='{"param":"param_value"}'입니다. Search Ads 360의 경우 advertiser_id 및 agency_id 매개변수를 제공해야 합니다. 선택적으로 다음 매개변수를 설정할 수 있습니다.
- (선택사항) 지원되는 일부 테이블에 대해서만 데이터를 가져오도록 table_filter를 설정하고 해당 테이블의 이름 프리픽스를 공백으로 구분하여 나열합니다. 예를 들면 Account AccountDeviceStats AccountFloodlightAndDeviceStats입니다. 지원되는 모든 테이블 이름은 Search Ads 360 보고서 변환을 참조하세요.
- (선택사항) Search Ads 360에서 만든 커스텀 플러드라이트 변수를 가져오도록 custom_floodlight_variables를 설정하고 해당 필드 이름을 다음 예시와 같은 JSON 형식으로 지정합니다.
  - ```
  [{
    "cfv_name": "variable_name",
    "cfv_type": "metric or dimension",
    "campaign_manager_type": "number or string",
    "destination_table_name": "table_name",
    "bigquery_column_name": "custom_column_name"
  },{
    "cfv_name": "variable_name_2",
    "cfv_type": "metric or dimension",
    "campaign_manager_type": "number or string",
    "destination_table_name": "table_name_2",
    "bigquery_column_name": "custom_column_name_2"
  }]
```
- JSON 목록의 모든 항목에 대해 다음을 포함합니다.
  - cfv_name은 커스텀 플러드라이트 변수가 Campaign Manager에서 생성되었을 때 사용자가 지정한 '친숙한' 이름입니다. 이 친숙한 이름은 또한 커스텀 측정기준 및 측정항목을 설정할 때 Search Ads 360 UI에 표시됩니다.
  - cfv_type은 metric 또는 dimension이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
  - campaign_manager_type은 number 또는 string이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
  - destination_table_name은 커스텀 플러드라이트 변수를 추가하려는 대상 테이블의 이름 프리픽스입니다. 예: AccountDeviceStats
  - bigquery_column_name은 이 커스텀 플러드라이트 변수가 BigQuery 대상 테이블에서 갖게 될 열 이름입니다. 열 이름은 BigQuery 열 이름 형식 요구사항을 따라야 합니다.
- (선택사항) include_removed_entities를 true로 설정하여 삭제된 항목 및 측정항목을 전송에 포함합니다.
data_source는 데이터 소스(doubleclick_search)입니다.

예를 들어 다음 명령어는 광고주 ID 123, 대행사 ID 123, 대상 데이터 세트 mydataset를 사용해서 My Transfer라는 Search Ads 전송을 만듭니다. 기본 프로젝트에 전송이 생성됩니다.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"agency_id":"123", "advertiser_id":"123","include_removed_entities":"true"}' \
--data_source=doubleclick_search

명령어를 처음 실행할 때 다음과 같은 메시지를 받게 됩니다.

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

메시지 안내를 따라 명령줄에 인증 코드를 붙여넣습니다.

API

projects.locations.transferConfigs.create 메서드를 사용하고 TransferConfig 리소스의 인스턴스를 지정합니다.

Search Ads 360 전송 수동 트리거

Search Ads 360에서 전송을 수동으로 트리거하면 데이터 이동 색인 스냅샷이 하루에 한 번 생성되며 최근 실행 날짜의 파티션에 저장됩니다. 수동 전송을 예약하면 다음 테이블에 대한 데이터 이동 색인 스냅샷이 업데이트되지 않습니다.

계정
광고
광고주
AdGroup
AdGroupTarget
BidStrategy
캠페인
CampaignTarget
FeedItem
FloodlightActivity
키워드
NegativeAdGroupKeyword
NegativeAdGroupTarget
NegativeCampaignKeyword
NegativeCampaignTarget
ProductAdvertised
ProductGroup
ProductLeadAndCrossSellFloodlightStats
Video
Placement
Video

Search Ads 360 전송 설정 문제 해결

전송을 설정하는 데 문제가 있으면 BigQuery Data Transfer Service 전송 설정 문제 해결을 참조하세요.

데이터 쿼리

데이터가 BigQuery Data Transfer Service에 전송될 때 데이터는 수집 시간으로 파티션을 나눈 테이블에 기록됩니다. 자세한 내용은 파티션을 나눈 테이블 소개를 참조하세요.

자동 생성된 뷰를 사용하지 않고 직접 테이블을 쿼리하는 경우에는 쿼리에서 _PARTITIONTIME 유사 열을 사용해야 합니다. 자세한 내용은 파티션을 나눈 테이블 쿼리를 참조하세요.

잠재적 할당량 문제

Google Search Ads 360 API는 Google 프로젝트가 전송할 수 있는 요청 수에 대해 일일 할당량을 지정합니다. BigQuery Data Transfer Service 및 기타 서비스에 대해 하나의 프로젝트를 사용하면, 두 서비스가 할당량을 공유하며, 어느 한 서비스에서든 할당량 제한에 도달할 가능성이 있습니다.

이러한 잠재적 문제를 방지하고 기존 워크플로에 영향을 주지 않기 위해서는 다음과 같은 옵션들을 고려하세요.

BigQuery Data Transfer Service에 프로젝트를 별도로 설정합니다.

교차 프로젝트 테이블 조인 예시:

  #standardSQL
  select count(a.item1)
  from (select item1, item2 from project-A.data_set_a.table_name_a) a
  inner join
  (select item3, item4 from project-B.data_set_b.table_name_b) b
  on a.item1 = b.item3

Search Ads 360 지원에 연락하여 추가 할당량을 요청합니다. 자세한 내용은 추가 할당량 요청을 참조하세요.