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 데이터세트를 만듭니다.
  • 기본 BigQuery 웹 UI를 사용하여 전송을 만들려면 권한 창을 볼 수 있도록 bigquery.cloud.google.com에서 팝업을 허용합니다. 전송을 성공하려면 Search Ads 360 캠페인을 관리하도록 BigQuery Data Transfer Service 권한을 허용해야 합니다.
  • Pub/Sub의 전송 실행 알림을 설정하려면 pubsub.topics.setIamPolicy 권한이 있어야 합니다. 이메일 알림만 설정한다면 Pub/Sub 권한이 필요하지 않습니다. 자세한 내용은 BigQuery Data Transfer Service 실행 알림을 참조하세요.

필수 권한

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

  • BigQuery Data Transfer Service:

    • 전송을 만들 bigquery.transfers.update 권한
    • 대상 데이터세트에 대한 bigquery.datasets.update 권한

    사전 정의된 IAM 역할 bigquery.admin에는 bigquery.transfers.updatebigquery.datasets.update 권한이 포함됩니다. BigQuery Data Transfer Service의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 참조하세요.

  • Google Cloud:

    • 프로젝트에 대한 Search Ads 360에서 데이터를 다운로드할 수 있는 serviceusage.services.use 권한

    editor, owner, serviceusage.serviceUsageConsumer 사전 정의된 IAM 역할에는 serviceusage.services.use 권한이 포함됩니다. 서비스 사용량의 IAM 역할에 대한 자세한 내용은 액세스 제어 참조를 확인하세요.

  • Google Search Ads 360: 전송 구성에 사용된 Google Search Ads 360 대행사 ID 및 광고주 ID에 대한 읽기 액세스 권한입니다. 자세한 내용은 Google 계정 만들기 및 SA360 권한 가져오기를 참조하세요.

Search Ads 360 데이터 전송 설정

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

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

Console

  1. Cloud Console에서 BigQuery 페이지로 이동합니다.

    BigQuery 페이지로 이동

  2. 전송을 클릭합니다.

  3. 전송 만들기를 클릭합니다.

  4. 전송 만들기 페이지에서 다음을 수행합니다.

    • 소스 유형 섹션에서 소스Search Ads 360(이전 명칭: Doubleclick Search)을 선택합니다.

      전송 소스

    • 전송 구성 이름 섹션의 표시 이름에 전송 이름(예: My Transfer)을 입력합니다. 전송 이름은 나중에 수정해야 할 경우에 대비해 전송을 식별할 수 있는 값이면 됩니다.

      전송 이름

    • 일정 옵션 섹션의 일정에서 기본값(지금 시작)을 유지하거나 설정 시간에 시작을 클릭합니다.

      • 반복에서 전송을 실행하는 빈도 옵션을 선택합니다.

        • 매일(기본값)
        • 매주
        • 매월
        • 커스텀
        • 주문형
      • 시작일 및 실행 시간에 전송을 시작할 날짜 및 시간을 입력합니다. 지금 시작을 선택하면 이 옵션은 사용 중지됩니다.

        전송 일정

    • 대상 설정 섹션의 대상 데이터세트에서 데이터를 저장하기 위해 만든 데이터세트를 선택합니다.

      전송 데이터세트

    • 데이터 소스 세부정보 섹션에서 다음을 수행합니다.

      • 대행사 ID에 사용자의 대행사 ID를 입력합니다.
      • 광고주 ID에 사용자의 광고주 ID를 입력합니다.
      • 삭제된 항목 및 측정항목을 전송에 포함하려면 삭제된 항목 포함을 선택합니다.
      • (선택사항) 테이블 필터의 경우 모든 테이블을 로드하려면 이 필드를 비워 둡니다. 지원되는 일부 테이블에 대해서만 데이터를 가져오려면 해당 테이블의 이름 프리픽스를 공백으로 구분하여 나열합니다. 예를 들면 Account AccountDeviceStats AccountFloodlightAndDeviceStats입니다. 지원되는 모든 테이블 이름은 Search Ads 360 보고서 변환을 참조하세요.

        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",
            "bigquery_column_name": "custom_column_name_2"
          }]
          
        • JSON 목록의 모든 항목에 대해 다음을 포함합니다.
          • cfv_name커스텀 플러드라이트 변수Campaign Manager에서 생성되었을 때 사용자가 지정한 "친숙한" 이름입니다. 이 친숙한 이름은 또한 커스텀 측정기준 및 측정항목을 설정할 때 Search Ads 360 UI에 표시됩니다.
          • cfv_typemetric 또는 dimension이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
          • campaign_manager_typenumber 또는 string이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
          • destination_table_name은 커스텀 플러드라이트 변수를 추가하려는 대상 테이블의 이름 프리픽스입니다. 예를 들면 AccountDeviceStats입니다.
          • bigquery_column_name은 이 커스텀 플러드라이트 변수가 BigQuery Data Transfer Service 대상 테이블에서 갖게 될 열 이름입니다. 열 이름은 [BigQuery Data Transfer Service 열 이름 형식 요건](https://cloud.google.com/bigquery/docs/schemas#column_names)을 따라야 합니다.

        Search Ads 360 CFV Console

    • (선택사항) 알림 옵션 섹션에서 다음을 수행합니다.

      • 전환을 클릭해서 이메일 알림을 사용 설정합니다. 이 옵션을 사용 설정하면 전송 실행이 실패할 때 전송 관리자에게 이메일 알림이 발송됩니다.
      • Pub/Sub 주제 선택에서 주제 이름을 선택하거나 주제 만들기를 클릭합니다. 이 옵션은 전송에 대한 Pub/Sub 실행 알림을 구성합니다.
  5. 저장을 클릭합니다.

기본 UI

  1. 기본 BigQuery 웹 UI로 이동합니다.

    기본 BigQuery 웹 UI로 이동

  2. 전송을 클릭합니다.

  3. 전송 추가를 클릭합니다.

  4. 새 전송 페이지에서 다음 안내를 따릅니다.

    • 소스에 대해 Search Ads 360(이전 명칭: Doubleclick Search)을 선택합니다.
    • 표시 이름에 전송 이름(예: My Transfer)을 입력합니다. 전송 이름은 나중에 수정해야 할 경우에 대비해 전송을 식별할 수 있는 값이면 됩니다.
    • 새로고침 기간에 데이터 전송에 포함할 일 수를 입력합니다. 1을 입력하면 일일 백필이 없습니다. 0을 입력하면 기본 새로고침 기간인 7일이 구성됩니다. 최댓값은 30입니다. 자세한 내용은 데이터 최신 여부 확인을 참조하세요.

      기존 이름 전송

    • 일정의 경우 기본값을 그대로 두거나(전송 생성 시간에서 매 24시간마다) 수정을 클릭하여 시간을 변경합니다.

      Search Ads 360 일정

    • 대상 설정 섹션의 대상 데이터세트에서 데이터를 저장하기 위해 만든 데이터세트를 선택합니다.

      Search Ads 360 기존 대상

    • 대행사 ID에 사용자의 대행사 ID를 입력합니다.

    • 광고주 ID에 사용자의 광고주 ID를 입력합니다.

    • 삭제된 항목 및 측정항목을 전송에 포함하려면 삭제된 항목 포함을 선택합니다.

    • (선택사항) 테이블 필터의 경우 모든 테이블을 로드하려면 이 필드를 비워 둡니다. 지원되는 일부 테이블에 대해서만 데이터를 가져오려면 해당 테이블의 이름 프리픽스를 공백으로 구분하여 나열합니다. 예를 들면 Account AccountDeviceStats AccountFloodlightAndDeviceStats입니다. 지원되는 모든 테이블 이름은 Search Ads 360 보고서 변환을 참조하세요.

      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",
            "bigquery_column_name": "custom_column_name_2"
        }]
        
      • JSON 목록의 모든 항목에 대해 다음을 포함합니다.

        • cfv_name커스텀 플러드라이트 변수Campaign Manager에서 생성되었을 때 사용자가 지정한 "친숙한" 이름입니다. 이 친숙한 이름은 또한 커스텀 측정기준 및 측정항목을 설정할 때 Search Ads 360 UI에 표시됩니다.
        • cfv_typemetric 또는 dimension이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
        • campaign_manager_typenumber 또는 string이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
        • destination_table_name은 커스텀 플러드라이트 변수를 추가하려는 대상 테이블의 이름 프리픽스입니다. 예를 들면 AccountDeviceStats입니다.
        • bigquery_column_name은 이 커스텀 플러드라이트 변수가 BigQuery Data Transfer Service 대상 테이블에서 갖게 될 열 이름입니다. 열 이름은 BigQuery Data Transfer Service 열 이름 형식 요건을 따라야 합니다.

        Search Ads 360 기존 cfv

    • (선택사항) 고급 섹션을 펼쳐서 전송 실행 알림을 구성합니다.

      • Pub/Sub 주제주제 이름(예: projects/myproject/topics/mytopic)을 입력합니다.
      • 전송 실행 실패 시 이메일 알림을 허용하려면 이메일 알림 전송을 선택합니다.
      • 전송 설정 시 사용 중지됨을 선택하지 않습니다. 기존 전송을 사용 중지하려면 전송 작업을 참조하세요.

        Pub/Sub 주제

  5. 추가를 클릭합니다.

  6. 메시지가 표시되면 허용을 클릭하여 Search Ads 360 보고 데이터를 관리하고 BigQuery Data Transfer Service에서 데이터를 액세스 및 관리할 수 있는 BigQuery Data Transfer Service 권한을 제공합니다. 권한 창을 보려면 bigquery.cloud.google.com에서 팝업을 허용해야 합니다.

    전송 허용

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_idagency_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_typemetric 또는 dimension이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
        • campaign_manager_typenumber 또는 string이어야 합니다. Search Ads 360 UI에서 커스텀 플러드라이트 변수 설정 방식에 맞게 선택하세요.
        • destination_table_name은 커스텀 플러드라이트 변수를 추가하려는 대상 테이블의 이름 프리픽스입니다. 예를 들면 AccountDeviceStats입니다.
        • bigquery_column_name은 이 커스텀 플러드라이트 변수가 BigQuery Data Transfer Service 대상 테이블에서 갖게 될 열 이름입니다. 열 이름은 BigQuery Data Transfer Service 열 이름 형식 요건을 따라야 합니다.
    • (선택사항) 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_items":"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 전송 설정 문제해결

전송을 설정하는 데 문제가 있으면 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 지원에 연락하여 추가 할당량을 요청합니다. 자세한 내용은 추가 할당량 요청을 참조하세요.