Google Cloud Storage 연결
개요 overview
Google Cloud Storage에 대한 실시간 아웃바운드 연결을 생성하여 정기적으로 Adobe Experience Platform의 데이터 파일을 고유한 버킷으로 내보냅니다.
API 또는 UI를 통해 Google Cloud Storage 저장소에 연결합니다. connect-api-or-ui
- 플랫폼 사용자 인터페이스를 사용하여 Google Cloud Storage 저장소 위치에 연결하려면 아래의 대상에 연결 및 이 대상에 대상 활성화 섹션을 참조하십시오.
- 프로그래밍 방식으로 Google Cloud Storage 저장소 위치에 연결하려면 흐름 서비스 API 자습서를 사용하여 파일 기반 대상에 대상 활성화를 읽어 보십시오.
지원되는 대상자 supported-audiences
이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.
내보내기 유형 및 빈도 export-type-frequency
대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.
데이터 세트 내보내기 export-datasets
이 대상은 데이터 세트 내보내기를 지원합니다. 데이터 세트 내보내기 설정 방법에 대한 자세한 내용은 튜토리얼을 참조하십시오.
- 플랫폼 사용자 인터페이스를 사용하여 데이터 세트를 내보내는 방법.
- 흐름 서비스 API를 사용하여 프로그래밍 방식으로 데이터 세트를 내보내는 방법.
내보낸 데이터의 파일 형식 file-format
대상 데이터 를 내보낼 때 Platform은 사용자가 제공한 저장소 위치에 .csv
, parquet
또는 .json
파일을 만듭니다. 파일에 대한 자세한 내용은 대상 활성화 자습서에서 내보내기에 지원되는 파일 형식 섹션을 참조하십시오.
데이터 세트 를 내보낼 때 Platform은 사용자가 제공한 저장소 위치에 .parquet
또는 .json
파일을 만듭니다. 파일에 대한 자세한 내용은 데이터 세트 내보내기 자습서에서 데이터 세트 내보내기에 성공했는지 확인 섹션을 참조하십시오.
Google Cloud Storage 계정에 연결하기 위한 필수 구성 요소 설정 prerequisites
Google Cloud Storage에 플랫폼을 연결하려면 먼저 Google Cloud Storage 계정에 대해 상호 운용성을 사용하도록 설정해야 합니다. 상호 운용성 설정에 액세스하려면 Google Cloud Platform을(를) 열고 탐색 패널의 클라우드 저장소 옵션에서 설정 을(를) 선택하십시오.
클라우드 저장소 및 설정이 강조 표시된
설정 페이지가 나타납니다. 여기에서 Google 프로젝트 ID에 대한 정보와 Google Cloud Storage 계정에 대한 세부 정보를 볼 수 있습니다. 상호 운용성 설정에 액세스하려면 상단 헤더에서 상호 운용성 을 선택하십시오.
상호 운용성 페이지에는 서비스 계정과 연결된 인증, 액세스 키 및 기본 프로젝트에 대한 정보가 포함되어 있습니다. 서비스 계정에 대한 새 액세스 키 ID와 비밀 액세스 키를 생성하려면 서비스 계정에 대한 키 만들기 를 선택하십시오.
새로 생성된 액세스 키 ID 및 비밀 액세스 키를 사용하여 Google Cloud Storage 계정을 플랫폼에 연결할 수 있습니다.
대상에 연결 connect
이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.
대상으로 인증 authenticate
대상에 인증하려면 필수 필드를 입력한 다음 대상에 연결 을(를) 선택하십시오.
-
액세스 키 ID: Platform에 Google Cloud Storage 계정을 인증하는 데 사용되는 61자 영숫자 문자열입니다. 이 값을 얻는 방법에 대한 자세한 내용은 위의 필수 구성 요소 섹션을 참조하십시오.
-
비밀 액세스 키: Platform에 Google Cloud Storage 계정을 인증하는 데 사용되는 40자의 base64로 인코딩된 문자열입니다. 이 값을 얻는 방법에 대한 자세한 내용은 위의 필수 구성 요소 섹션을 참조하십시오.
-
암호화 키: 필요한 경우 RSA 형식의 공개 키를 첨부하여 내보낸 파일에 암호화를 추가할 수 있습니다. 아래 이미지에서 올바른 형식의 암호화 키의 예를 봅니다.
이러한 값에 대한 자세한 내용은 Google Cloud Storage HMAC 키 안내서를 참조하십시오. 자신의 액세스 키 ID와 비밀 액세스 키를 생성하는 방법에 대한 단계는 Google Cloud Storage 소스 개요를 참조하세요.
대상 세부 정보 입력 destination-details
대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
-
이름: 이 대상의 기본 이름을 입력하십시오.
-
설명: 선택 사항입니다. 예를 들어 이 대상을 사용하는 캠페인을 언급할 수 있습니다.
-
버킷 이름: 이 대상에서 사용할 Google Cloud Storage 버킷의 이름을 입력하십시오.
-
폴더 경로: 내보낸 파일을 호스팅할 대상 폴더의 경로를 입력하십시오.
-
파일 형식: 내보낸 파일에 사용할 형식 Experience Platform을 선택하십시오. CSV 옵션을 선택할 때 파일 서식 옵션을 구성할 수도 있습니다.
-
Experience Platform 압축 형식: 내보낸 파일에 사용할 압축 형식을 선택합니다.
-
매니페스트 파일 포함: 내보내기 위치, 내보내기 크기 등에 대한 정보가 포함된 매니페스트 JSON 파일을 내보내기에 포함하려면 이 옵션을 켜십시오. 매니페스트의 이름은
manifest-<<destinationId>>-<<dataflowRunId>>.json
형식을 사용하여 지정합니다. 샘플 매니페스트 파일을(를) 봅니다. 매니페스트 파일에는 다음 필드가 포함되어 있습니다.flowRunId
: 내보낸 파일을 생성한 데이터 흐름 실행.scheduledTime
: 파일을 내보낸 시간(UTC)입니다.exportResults.sinkPath
: 내보낸 파일이 저장된 저장소 위치의 경로입니다.exportResults.name
: 내보낸 파일의 이름입니다.size
: 내보낸 파일의 크기(바이트)입니다.
경고 활성화 enable-alerts
경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.
대상 연결에 대한 세부 정보를 모두 제공했으면 다음 을 선택합니다.
필요한 Google Cloud Storage 권한 required-google-cloud-storage-permission
데이터를 Google Cloud Storage 저장소 위치에 연결하고 내보내려면 버킷에 대해 다음 Google Cloud Storage 권한이 필요합니다.
orgpolicy.policy.get
resourcemanager.projects.get
resourcemanager.projects.list
storage.managedFolders.create
storage.multipartUploads.abort
storage.multipartUploads.create
storage.multipartUploads.listParts
storage.objects.create
storage.objects.list
Google Cloud Storage의 액세스 제어 및 권한에 대해 자세히 알아보세요.
이 대상으로 대상자 활성화 activate
이 대상에 대한 대상자 활성화에 대한 지침은 대상자 데이터를 일괄 프로필 내보내기 대상으로 활성화를 참조하십시오.
일정 조정
예약 단계에서 Google Cloud Storage 대상에 대해 내보내기 일정을 설정할 수 있으며 내보낸 파일의 이름을 구성할 수도 있습니다.
속성 및 ID 매핑 map
매핑 단계에서는 프로필에 내보낼 특성 및 ID 필드를 선택할 수 있습니다. 내보낸 파일의 헤더를 원하는 이름으로 변경하도록 선택할 수도 있습니다. 자세한 내용은 일괄 처리 대상 활성화 UI 자습서에서 매핑 단계를 참조하십시오.
성공적인 데이터 내보내기 유효성 검사 exported-data
데이터를 성공적으로 내보냈는지 확인하려면 Google Cloud Storage 버킷을 확인하고 내보낸 파일에 예상 프로필 모집단이 포함되어 있는지 확인하십시오.
허용 목록에 추가하다 IP 주소 ip-address-allow-list
허용 목록에 추가하다 Adobe IP를 허용 목록에 추가하다에 추가해야 하는 경우 IP 주소 문서를 참조하십시오.