LinkedIn Ads용 Openflow 커넥터 설정

LinkedIn Ads용 Openflow 커넥터 설정

이 문서에서는 LinkedIn Ads용 Openflow 커넥터를 설정하는 단계를 설명합니다.

출처: Snowflake 문서

본문

사전 준비 사항

• LinkedIn Ads용 Openflow 커넥터 소개 문서를 검토했는지 확인하세요.
• Set up Openflow - Snowflake Deployments 또는 Set up Openflow - BYOC를 완료했는지 확인하세요.
• Openflow - Snowflake Deployments를 사용한다면 필수 도메인 구성 문서를 검토하고, LinkedIn Ads 커넥터에 필요한 필수 도메인에 대한 접근 권한을 부여했는지 확인하세요.

자격 증명 얻기

LinkedIn Ads 사용자는 다음 작업을 수행하세요.

• 선택 사항: 캠페인을 실행·관리할 광고 계정이 없다면 하나 만드세요.
• 사용자 계정이 광고 계정에서 최소한 VIEWER 역할을 보유하는지 확인하세요.
• 사용자 계정으로 Advertising API 접근을 신청하세요. 자세한 내용은 Microsoft quick start를 참조하세요.
• 새로 고침 토큰(refresh token)을 얻으세요. 3-legged oAuth와 r_ads_reporting 스코프를 사용하세요.
• LinkedIn Developer Portal에서 클라이언트 ID(client ID)와 클라이언트 시크릿(client secret)을 얻으세요. 이 자격 증명은 App Details의 Auth 탭에서 확인할 수 있습니다.

Snowflake 계정 설정

Openflow 관리자는 Snowflake 계정을 설정하기 위해 다음 작업을 수행하세요. 기본 SNOWFLAKE_MANAGED 인증 전략에서는 런타임의 execute-as 역할이 커넥터가 Snowflake에 접근할 때 사용하는 신원이므로, 해당 역할에 다음 권한을 부여하세요.

참고: Openflow - BYOC Deployments에 커넥터를 배포하면서 권장되는 SNOWFLAKE_MANAGED 대신 KEY_PAIR 인증 전략을 사용한다면, 런타임 관리 토큰에 의존하는 대신 동일한 execute-as 역할을 서비스 사용자에게도 부여해야 합니다. 서비스 사용자 생성은 'Set up key-pair authentication for Openflow - BYOC Deployments'를 참조하세요.

데이터베이스, 스키마, 웨어하우스 만들기

• 목적지 데이터베이스를 만듭니다.

USE ROLE OPENFLOW_ADMIN;
CREATE DATABASE IF NOT EXISTS <destination_database>;

• 목적지 스키마를 만듭니다.

CREATE SCHEMA IF NOT EXISTS <destination_database>.<destination_schema>;

• 런타임의 execute-as 역할에 필수 권한을 부여합니다.

GRANT USAGE ON DATABASE <destination_database> TO ROLE OPENFLOW_<RUNTIME_NAME>_EXECUTE_AS_RL;
GRANT USAGE ON SCHEMA <destination_database>.<destination_schema> TO ROLE OPENFLOW_<RUNTIME_NAME>_EXECUTE_AS_RL;
GRANT CREATE TABLE ON SCHEMA <destination_database>.<destination_schema> TO ROLE OPENFLOW_<RUNTIME_NAME>_EXECUTE_AS_RL;

• 웨어하우스를 만들거나(또는 기존 것을 사용) 사용 권한을 부여합니다.

CREATE WAREHOUSE IF NOT EXISTS <openflow_warehouse>
 WITH
 WAREHOUSE_SIZE = 'XSMALL'
 AUTO_SUSPEND = 300
 AUTO_RESUME = TRUE;

GRANT USAGE, OPERATE ON WAREHOUSE <openflow_warehouse> TO ROLE OPENFLOW_<RUNTIME_NAME>_EXECUTE_AS_RL;

• 커넥터가 수집한 테이블에 접근해야 하는 다른 Snowflake 사용자(예: Snowflake에서 사용자 지정 처리를 위해)가 있다면 해당 사용자에게 execute-as 역할을 부여하세요.

커넥터 설정

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

커넥터 설치

커넥터가 수집한 데이터를 저장할 Snowflake에 데이터베이스와 스키마를 만드세요. 'Snowflake 계정 설정'에 설명된 대로 execute-as 역할에 필수 데이터베이스 권한을 부여하세요.

데이터 엔지니어로서 커넥터를 설치하려면 다음을 수행하세요.

• Openflow의 Connector library 탭으로 이동하세요.
• Openflow connectors 페이지에서 커넥터를 찾아 Install을 선택하세요.
• Select runtime 대화상자의 Available runtimes 드롭다운 목록에서 런타임을 선택하고 Install을 클릭하세요.
  • 참고: 커넥터를 설치하기 전에 Snowflake에 커넥터가 수집한 데이터를 저장할 데이터베이스와 스키마를 만들었는지 확인하세요.
• Snowflake 계정 자격 증명으로 배포에 인증하고, 런타임 애플리케이션이 Snowflake 계정에 접근하도록 허용할지 묻는 프롬프트에서 Allow를 선택하세요. 커넥터 설치 과정은 완료까지 몇 분 걸립니다.
• Snowflake 계정 자격 증명으로 런타임에 인증하세요. 커넥터 프로세스 그룹이 추가된 Openflow 캔버스가 표시됩니다.

커넥터 구성

참고: 각 프로세스 그룹은 단일 보고서 구성에 대한 데이터를 가져옵니다. 정기 일정으로 여러 구성을 사용하려면 보고서 구성마다 별도의 프로세스 그룹을 만드세요.

• 가져온 프로세스 그룹을 마우스 오른쪽 버튼으로 클릭하고 Parameters를 선택하세요.
• 'Flow parameters'에서 설명한 대로 필수 파라미터 값을 채우세요.

Flow parameters

이 섹션에서는 다음 파라미터 컨텍스트에 따라 구성할 수 있는 플로우 파라미터를 설명합니다.

• Linkedin Ads Source Parameters: LinkedIn Ads API와 연결을 수립하는 데 사용.
• Linkedin Ads Destination Parameters: Snowflake와 연결을 수립하는 데 사용.
• Linkedin Ads Ingestion Parameters: 다른 두 파라미터 컨텍스트의 모든 파라미터와 특정 프로세스 그룹에 고유한 추가 파라미터를 포함. 이 컨텍스트는 수집 관련 세부 사항을 포함하므로, 새 보고서와 프로세스 그룹마다 새 파라미터 컨텍스트를 만들어야 합니다.

Linkedin Ads Source Parameters

Linkedin Ads Destination Parameters

Linkedin Ads Ingestion Parameters

다음 표는 다른 파라미터 컨텍스트에서 상속되지 않는 파라미터를 나열합니다.

참고: shares, campaigns, campaign groups, accounts, companies 중 최소 하나의 필터를 지정해야 합니다.

플로우 실행

• 평면(plane)을 마우스 오른쪽 버튼으로 클릭하고 Enable all Controller Services를 선택하세요.
• 가져온 프로세스 그룹을 마우스 오른쪽 버튼으로 클릭하고 Start를 선택하세요. 커넥터가 데이터 수집을 시작합니다.

더 알아보기 (Learn more)

• LinkedIn Ads용 Openflow 커넥터 소개
• Openflow 커넥터 소개