Google Ads용 Openflow Connector 설정하기

참고

커넥터에는 커넥터 약관 이 적용됩니다.

이 항목에서는 Google Ads용 Openflow Connector를 설정하는 단계에 대해 설명합니다.

전제 조건

  1. Google Ads용 Openflow Connector 을 검토했는지 확인합니다.

  2. Openflow를 설정 했는지 확인합니다.

자격 증명 받기

Google Ads 관리자는 다음 단계를 수행합니다.

  • Google Cloud 프로젝트에 액세스할 수 있는지 확인하거나 새 프로젝트를 생성 합니다._

  • Google Cloud 프로젝트에 Google Ads API _가 활성화되어 있는지 확인합니다. 데이터를 수집하려면 Google Ads API 액세스 권한이 필요합니다.

  • Google Ads용 서비스 계정 인증을 구성 합니다.

  • 지침 에 따라 조직을 위한 개발자 토큰을 가져옵니다._

참고

개발자 토큰의 액세스 레벨은 기본 또는 표준이어야 합니다. 액세스 수준에 대한 자세한 내용은 설명서 를 참조하십시오.

Snowflake 계정 설정하기

Snowflake 계정 관리자는 다음 작업을 수행합니다.

  1. 새 역할을 생성하거나 기존 역할을 사용하여 데이터베이스 권한 권한을 부여합니다.

  2. 유형이 SERVICE 인 새 Snowflake 서비스 사용자를 생성합니다.

  3. Snowflake 서비스 사용자에게 이전 단계에서 생성한 역할을 부여합니다.

  4. 2단계의 Snowflake SERVICE 사용자에 대해 키 페어 인증 으로 구성합니다.

  5. Snowflake는 이 단계를 강력히 권장합니다. Openflow에서 지원하는 시크릿 관리자(예: AWS, Azure, Hashicorp)를 구성하고 공개 및 개인 키를 시크릿 스토어에 저장합니다.

    참고

    어떤 이유로든 시크릿 관리자를 사용하지 않으려면 조직의 보안 정책에 따라 키 페어 인증에 사용되는 공개 키와 개인 키 파일을 보호할 책임이 있습니다.

    1. 시크릿 관리자가 구성되면 인증 방법을 결정합니다. AWS 에서는 다른 시크릿을 유지할 필요가 없으므로 Openflow와 연결된 EC2 인스턴스 역할을 사용하는 것이 좋습니다.

    2. Openflow에서 오른쪽 상단의 햄버거 메뉴에서 이 시크릿 관리자와 연결된 매개 변수 공급자를 구성합니다. Controller Settings » Parameter Provider 로 이동한 다음 매개 변수 값을 가져옵니다.

    3. 이 시점에서 모든 자격 증명은 연결된 매개 변수 경로로 참조할 수 있으며 민감한 값은 Openflow 내에서 유지될 필요가 없습니다.

  6. 다른 Snowflake 사용자가 커넥터에서 수집한 원시 수집 문서 및 테이블에 대한 액세스가 필요한 경우(예: Snowflake에서 사용자 정의 처리를 위해), 해당 사용자에게 1단계에서 생성한 역할을 부여하십시오.

  7. 커넥터가 사용할 웨어하우스를 지정합니다. 가장 작은 데이터 웨어하우스 크기로 시작한 다음 복제되는 테이블 수와 전송되는 데이터의 양에 따라 크기를 실험해 보십시오. 테이블 수가 많은 경우 일반적으로 더 큰 규모의 웨어하우스보다는 멀티 클러스터 웨어하우스 에서 확장이 더 쉽습니다.

커넥터 설정하기

데이터 엔지니어는 다음 작업을 수행하여 커넥터를 설치하고 구성합니다.

커넥터 설치하기

#. Create a database and schema in Snowflake for the connector to store ingested data. Grant required 데이터베이스 권한 to the role created in the first step. Substitute the role placeholder with the actual value and use the following sql commands:

CREATE DATABASE GOOGLE_ADS_DESTINATION_DB;
CREATE SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA;
GRANT USAGE ON DATABASE GOOGLE_ADS_DESTINATION_DB TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
GRANT USAGE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
GRANT CREATE TABLE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
Copy

  1. Openflow 개요 페이지로 이동합니다. Featured connectors 섹션에서 View more connectors 을 선택합니다.

  2. Openflow Connector 페이지에서 커넥터를 찾아 Add to runtime 을 선택합니다.

  3. Select runtime 대화 상자의 Available runtimes 드롭다운 목록에서 런타임을 선택합니다.

  4. Add 를 선택합니다.

    참고

    커넥터를 설치하기 전에 커넥터가 수집한 데이터를 저장할 수 있도록 Snowflake에서 데이터베이스와 스키마를 생성했는지 확인하십시오.

  5. Snowflake 계정 자격 증명으로 배포를 인증하고 런타임 애플리케이션이 Snowflake 계정에 액세스할 수 있도록 허용할지 묻는 메시지가 표시되면 Allow 를 선택합니다. 커넥터 설치 프로세스를 완료하는 데 몇 분 정도 걸립니다.

  6. Snowflake 계정 자격 증명으로 런타임에 인증합니다.

커넥터 프로세스 그룹이 추가된 Openflow 캔버스가 표시됩니다.

커넥터 구성

  1. 가져온 프로세스 그룹을 마우스 오른쪽 버튼으로 클릭하고 Parameters 를 선택합니다.

  2. 플로우 매개 변수 에 설명된 대로 필수 매개 변수 값을 채웁니다.

플로우 매개 변수

매개 변수 컨텍스트에는 세 가지가 있습니다. Google Ads 대상 매개 변수 및 Google Ads 소스 매개 변수 는 각각 GoogleAds API 및 Snowflake와의 연결을 허용하는 역할을 합니다. Google Ads 수집 매개 변수 는 Google Ads에서 다운로드한 데이터의 재구성을 정의하는 데 사용됩니다. Google Ads 매개 변수 이 모든 매개 변수를 하나로 통합합니다.

플로우 실행

  1. 평면을 마우스 오른쪽 버튼으로 클릭하고 Enable all Controller Services 를 선택합니다.

  2. 가져온 프로세스 그룹을 마우스 오른쪽 버튼으로 클릭하고 Start 를 선택합니다. 커넥터가 데이터 수집을 시작합니다.

커넥터 재설정 방법

커넥터를 초기 상태로 완전히 초기화하려면 다음과 같이 하십시오.

  1. 큐에 더 이상 플로우 파일이 없는지 확인합니다.

  2. 모든 프로세서를 중지합니다.

  3. 초기 프로세서의 상태를 지웁니다.

    1. 프로세서 Get Google Ads Report 를 마우스 오른쪽 버튼으로 클릭하고 View State 를 선택합니다.

    2. Clear State 옵션을 선택합니다. 이렇게 하면 프로세서 상태가 초기화됩니다.

  4. 대상 테이블을 Snowflake에 놓습니다.

언어: 한국어