16.3 Adobe Experience Platform에 GCP 및 BigQuery 연결

목표

  • Google Cloud Platform에서 API 및 서비스 살펴보기
  • Google API를 테스트하는 OAuth 놀이터에 대해 잘 알고 있어야 합니다.
  • Adobe Experience Platform에서 간단한 BigQuery 연결 만들기

컨텍스트

Adobe Experience Platform은 BigQuery 데이터 세트를 Adobe Experience Platform으로 가져오는 데 도움이 되는 Sources 내의 커넥터를 제공합니다. 이 데이터 커넥터는 Google BigQuery API를 기반으로 합니다. 따라서 Adobe Experience Platform로부터 API 호출을 받을 수 있도록 Google Cloud Platform 및 BigQuery 환경을 적절하게 준비해야 합니다.

Adobe Experience Platform에서 BigQuery 소스 커넥터를 구성하려면 다음 4개의 값이 필요합니다.

  • project
  • clientId
  • clientSecret
  • refreshToken

지금까지 프로젝트 ID​만 있습니다. 이 프로젝트 ID 값은 연습 16.1 동안 BigQuery 프로젝트를 만들 때 Google에서 생성한 임의 ID입니다.

프로젝트 ID를 구분된 텍스트 파일로 복사하십시오.

자격 증명 이름 지정
프로젝트 ID random descented-task-306413

상단 메뉴 모음에서 프로젝트 이름​을 클릭하면 언제든지 프로젝트 ID를 확인할 수 있습니다.

데모

오른쪽에 프로젝트 ID가 표시됩니다.

데모

이 연습에서는 다른 3개의 필수 필드를 가져오는 방법을 알아봅니다.

  • clientId
  • clientSecret
  • refreshToken

16.3.1 Google Cloud API 및 서비스

시작하려면 Google Cloud Platform 홈 페이지로 돌아가십시오. 이렇게 하려면 화면의 왼쪽 상단에 있는 로고를 클릭하면 됩니다.

데모

홈 페이지에 있으면 왼쪽 메뉴로 이동하여 API & 서비스​를 클릭한 다음 대시보드​를 클릭합니다.

데모

이제 API & 서비스 홈페이지가 표시됩니다.

데모

이 페이지에서는 다양한 Google API 연결의 사용을 확인할 수 있습니다. Adobe Experience Platform이 BigQuery에서 읽을 수 있도록 API 연결을 설정하려면 다음 단계를 수행해야 합니다.

  • 우선 향후의 인증을 활성화하려면 OAuth 동의 화면을 만들어야 합니다. 프로그래머틱 액세스가 허용되기 전에 Google의 보안상의 이유로 첫 번째 인증을 수행해야 합니다.
  • 두 번째, API 인증 및 BigQuery Connector 액세스에 사용할 API 자격 증명(clientId 및 clientSecret)이 필요합니다.

16.3.2 OAuth 동의 화면

먼저 OAuth 동의 화면 만들기 API & 서비스 홈 페이지의 왼쪽 메뉴에서 OAuth 동의 화면​을 클릭합니다.

데모

그러면 다음 내용이 표시됩니다.

데모

사용자 유형을 선택합니다.외부. 그런 다음 CREATE​을 클릭합니다.

데모

그러면 OAuth 동의 화면 구성 창에 있게 됩니다.

여기서 해야 할 일은 응용 프로그램 이름 필드에 동의 화면 이름을 입력하고 사용자 지원 이메일​을 선택합니다. 응용 프로그램 이름에 대해 다음 이름 지정 규칙을 사용합니다.

이름 지정
ldap - AEP BigQuery Connector vangeluw - 플랫폼 BigQuery Connector

데모

다음으로 개발자 연락처 정보​가 표시될 때까지 아래로 스크롤하고 이메일 주소를 입력합니다.

데모

저장 후 계속​을 클릭합니다.

데모

그러면 이것을 보실 수 있습니다. 저장 후 계속​을 클릭합니다.

데모

그러면 이것을 보실 수 있습니다. 저장 후 계속​을 클릭합니다.

데모

그러면 이것을 보실 수 있습니다. 대시보드로 돌아가기​를 클릭합니다.

데모

그러면 이것을 보실 수 있습니다. PUBLISH APP​을 클릭합니다.

데모

CONFIRM​을 클릭합니다.

데모

그러면 이것을 보실 수 있습니다.

데모

다음 단계에서 API 설정을 완료하고 API 자격 증명을 얻습니다.

16.3.3 Google API 자격 증명:클라이언트 암호 및 클라이언트 ID

왼쪽 메뉴에서 자격 증명​을 클릭합니다. 그러면 다음 내용이 표시됩니다.

데모

+ 자격 증명 만들기 단추를 클릭합니다.

데모

3개의 옵션이 표시됩니다. OAuth 클라이언트 ID​을 클릭합니다.

데모

다음 화면에서 웹 응용 프로그램​을 선택합니다.

데모

몇 개의 새 필드가 표시됩니다. 이제 OAuth 클라이언트 ID의 이름​을 입력하고 인증된 리디렉션 URI​을 입력해야 합니다.

다음 이름 지정 규칙을 따르십시오.

필드
이름 ldap - AEP BigQuery Connector vangeluw - 플랫폼 BigQuery Connector
허가된 리디렉션 URI https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

Adobe Experience Platform에서 BigQuery 소스 커넥터의 설정을 마치는 데 필요한 RefreshToken을 가져오려면 나중에 이 필드가 필요하므로 인증된 리디렉션 URI 필드는 매우 중요한 필드입니다.

데모

계속하기 전에 인증된 리디렉션 URI 필드에 값을 저장하려면 URL을 입력한 후 Enter 단추를 물리적으로 푸시해야 합니다. Enter 단추를 클릭하지 않으면 OAuth 2.0 Playplace​의 이후 단계에서 문제가 발생합니다.

다음으로 만들기​를 클릭합니다.

데모

이제 클라이언트 ID와 클라이언트 암호를 확인할 수 있습니다.

데모

이 두 필드를 복사하여 데스크탑에 있는 텍스트 파일에 붙여넣습니다. 나중에 이러한 자격 증명을 항상 액세스할 수 있지만 BigQuery 프로젝트 ID 옆의 텍스트 파일에 자격 증명을 저장하면 더 쉽습니다.

Adobe Experience Platform의 BigQuery 소스 커넥터 설정에 대한 요약으로, 이제 다음 값을 이미 사용할 수 있습니다.

BigQuery Connector 자격 증명
프로젝트 ID 자신의 프로젝트 ID(예::complested-task-306413)
clientid yourclientid
cilentsecret yourclientsecret

refreshToken​이(가) 아직 없습니다. 보안상의 이유로 refreshToken은 요구 사항입니다. API 환경에서 토큰은 일반적으로 24시간마다 만료됩니다. 따라서 24시간마다 보안 토큰을 새로 고치려면 refreshToken​이 필요합니다. 그러면 소스 커넥터 설정이 Google 클라우드 플랫폼 및 BigQuery에 계속 연결할 수 있습니다.

16.3.4 BigQuery API 및 refreshToken

Google 클라우드 플랫폼 API에 액세스하기 위해 refreshToken을 가져오는 방법은 다양합니다. 이러한 옵션 중 하나는 Postman을 사용하는 경우입니다.
하지만 Google은 OAuth 2.0 필드​라는 도구인 API를 테스트하고 재생하기 쉬운 것을 구축했습니다.

OAuth 2.0 놀이터​에 액세스하려면 https://developers.google.com/oauthplayground로 이동하십시오.

그런 다음 OAuth 2.0 놀이터 홈페이지가 표시됩니다.

데모

화면 오른쪽 상단에 있는 톱니바퀴 아이콘을 클릭합니다.

데모

설정이 위 이미지에서 볼 수 있는 설정과 동일한지 확인합니다.

설정을 100%로 확신

완료되면 자체 OAuth 자격 증명 사용 상자를 선택합니다.

데모

두 개의 필드가 표시되어야 하며 해당 필드의 값이 있습니다.

데모

다음 표를 입력하십시오.

놀이터 API 설정 Google API 자격 증명
OAuth 클라이언트 ID 사용자 자신의 클라이언트 ID(데스크탑의 텍스트 파일에서)
OAuth 클라이언트 암호 사용자 자신의 클라이언트 암호(데스크탑의 텍스트 파일에서)

데모

바탕 화면에 만든 텍스트 파일에서 클라이언트 ID클라이언트 암호​를 복사합니다.

데모

자격 증명을 입력한 후 닫기​를 클릭하십시오.

데모

왼쪽 메뉴에서는 사용 가능한 모든 Google API를 볼 수 있습니다. BigQuery API v2​를 검색합니다.

데모

그런 다음 아래 이미지에 지정된 범위를 선택합니다.

데모

선택했으면 API 인증​이라는 파란색 단추가 표시됩니다. 클릭합니다.

데모

GCP 및 BigQuery 설정에 사용한 Google 계정을 선택합니다.

큰 경고가 나타날 수 있습니다.이 앱이 확인되지 않았습니다. Platform BigQuery Connector가 아직 공식적으로 검토되지 않았기 때문에 Google은 이것이 진정한 앱인지 아닌지를 알지 못합니다. 이 알림은 무시해야 합니다.

고급​을 클릭합니다.

데모

그런 다음 ldap로 이동 - AEP BigQuery Connector(안전하지 않음)​를 클릭합니다.

데모

만든 OAuth 동의 화면으로 리디렉션됩니다.

데모

2FA(Two-Factor Authentication)를 사용하는 경우 사용자에게 전송된 확인 코드를 입력합니다.

데모

이제 Google은 8개의 다른 Permission 프롬프트를 표시합니다. 8개의 모든 권한 요청에 대해 허용​을 클릭합니다. (API가 프로그래머틱 요청을 승인하기 전에 실제 사람으로부터 한 번 추적하고 확인해야 하는 절차)

다시 한 번, 8개의 다른 팝업 창​이 표시되지 않습니다. 모든 팝업 창에 대해 허용​을 클릭해야 합니다.

데모

8개의 권한 요청 후에 이 개요를 볼 수 있습니다. 허용​을 클릭하여 프로세스를 완료합니다.

데모

마지막 허용-클릭 후 OAuth 2.0 놀이터로 다시 전송되며 다음과 같은 내용이 표시됩니다.

데모

토큰 에 대한 Exchange 인증 코드를 클릭합니다.

데모

2초 후 2단계 - 토큰 보기에 대한 Exchange 인증 코드가 자동으로 닫히고 3단계 - API에 요청 구성​이 표시됩니다.

토큰 에 대한 2단계 Exchange 인증 코드로 돌아가야 합니다. 따라서 토큰​에 대한 2단계 Exchange 인증 코드를 다시 클릭하여 새로 고침 토큰​을 다시 시각화합니다.

데모

이제 새로 고침 토큰​이 표시됩니다.

데모

새로 고침 토큰​을 복사하고 다른 BigQuery 소스 커넥터 자격 증명과 함께 데스크탑의 텍스트 파일에 붙여 넣습니다.

BigQuery 소스 커넥터 자격 증명
프로젝트 ID 자신의 임의 프로젝트 ID(예::apt-summer-273608)
clientid yourclientid
cilentsecret yourclientsecret
새로 고침 토큰 crefreshtoken

다음으로 Adobe Experience Platform에서 소스 커넥터를 설정합니다.

연습 16.3.5 - 큰 쿼리 테이블로 플랫폼 연결

다음 URL로 이동하여 Adobe Experience Platform에 로그인합니다.https://experience.adobe.com/platform.

로그인하면 Adobe Experience Platform 홈 페이지에 표시됩니다.

데이터 수집

계속하기 전에 샌드박스​를 선택해야 합니다. 선택할 샌드박스의 이름은 --aepSandboxId--입니다. 화면 상단의 파란색 줄에 있는 프로덕션 제품 텍스트를 클릭하면 이 작업을 수행할 수 있습니다.

데이터 수집

적절한 샌드박스를 선택하면 화면 변경 사항이 나타나고 이제 전용 샌드박스에 있습니다.

데이터 수집

왼쪽 메뉴에서 소스로 이동합니다.

데모

그러면 소스 홈페이지가 표시됩니다. 소스 메뉴에서 데이터베이스​를 클릭합니다.

데모

Google BigQuery 카드를 클릭합니다. 다음으로 + 구성​을 클릭합니다.

데모

이제 새 연결을 만들어야 합니다.

새 계정​을 클릭합니다. 이제 GCP 및 BigQuery에서 설정한 설정을 기반으로 아래의 모든 필드를 채우십시오.

데모

먼저 연결 이름을 지정합니다.

다음 명명 규칙을 사용하십시오.

BigQuery Connector 자격 증명
계정 이름 ldap - BigQuery 연결 vangeluw - BigQuery 연결
설명 ldap - BigQuery 연결 vangeluw - BigQuery 연결

어떤 것이 다음과 같은 것을 줄 것인가?

데모

다음으로, 데스크탑의 텍스트 파일에 저장한 GCP 및 BigQuery API 계정 인증-세부 정보를 채웁니다.

BigQuery Connector 자격 증명
프로젝트 ID 자신의 임의 프로젝트 ID(예::apt-summer-273608)
clientId
cilentSecret
refreshToken

계정 인증-세부 정보는 다음과 같아야 합니다.

데모

이러한 필드를 모두 채운 후 소스 연결​을 클릭합니다.

데모

계정 인증 세부 정보가 올바르게 입력된 경우 연결 확인을 보고 연결이 제대로 작동하는지 시각적으로 확인할 수 있습니다.

데모

연결이 생성되었으므로 다음​을(를) 클릭하십시오.

데모

이제 연습 16.2에서 만든 BigQuery 데이터 세트를 볼 수 있습니다.

데모

잘 했다! 다음 연습에서는 이 표에서 데이터를 로드하여 Adobe Experience Platform의 스키마 및 데이터 세트에 대해 매핑합니다.

다음 단계:16.4 BigQuery에서 Adobe Experience Platform으로 데이터 로드

모듈 16으로 돌아가기

모든 모듈로 돌아가기

이 페이지에서는