> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 세그먼트의 플레이어 내보내기 자습서

> GetPlayersInSegment를 대체하는 최신 API인 ExportPlayersInSegment 및 GetSegmentExport API를 사용하여 세그먼트에서 PlayFab 플레이어 프로필을 내보냅니다.

# 세그먼트의 플레이어 내보내기

이 자습서는 ExportPlayersInSegment API와 GetSegmentExport API를 사용하여 세그먼트의 플레이어 프로필을 내보내는 데 필요한 단계를 안내합니다. 이 API는 GetPlayersInSegment API의 더 새롭고 개선된 버전입니다.

### 1단계

페이로드로 세그먼트 ID를 사용하여 ExportPlayersInSegment API에 POST 요청을 보냅니다. 응답의 ‘ExportId‘는 내보내기 작업의 고유 식별자입니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/ExportPlayersInSegment.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=0f535cbc01662f81a695bf25de88b330" alt="세그먼트에서 플레이어 내보내기" width="1618" height="786" data-path="images/playfab/data-analytics/acting-data/ExportPlayersInSegment.png" />

<Note>
  이 API에는 값이 타이틀 비밀 키인 ‘X-SecretKey’ 헤더가 필요합니다. ‘Content-Type’ 헤더는 ‘application/json’으로 설정되어야 합니다.
</Note>

### 2단계

위 API 호출에서 받은 ExportId를 페이로드로 사용하여 GetSegmentExport API에 POST 요청을 보냅니다. 응답에는 내보내기 작업의 ‘State’가 있습니다. 내보내기 상태가 ‘Complete’인 경우, 응답에는 인덱스 파일을 다운로드할 수 있는 ‘IndexUrl’이 포함됩니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/GetSegmentExport.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=4aa11d28756553e3af3c78c76124adb0" alt="세그먼트 내보내기 가져오기" width="1430" height="629" data-path="images/playfab/data-analytics/acting-data/GetSegmentExport.png" />

<Note>
  이 API에는 값이 타이틀 비밀 키인 ‘X-SecretKey’ 헤더가 필요합니다. ‘Content-Type’ 헤더는 ‘application/json’으로 설정되어야 합니다.
</Note>

### 3단계

IndexUrl에서 인덱스 파일을 다운로드합니다. 인덱스 파일은 각 줄이 세그먼트의 플레이어 프로필 조각을 다운로드할 수 있는 URL인 파일입니다. 다음은 인덱스 파일의 예입니다. 인덱스 파일에는 2개의 URL(내보내기 조각)이 있습니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/IndexFile.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=0de6e8a4519b5ded129f982e779f44d3" alt="Index File.png" width="1606" height="374" data-path="images/playfab/data-analytics/acting-data/IndexFile.png" />

### 4단계:

인덱스 파일의 각 줄을 반복하여 각 URL에서 플레이어 프로필을 다운로드합니다. 플레이어 프로필 파일은 tsv 형식을 사용합니다. 예를 들어, 위 인덱스 파일의 첫 번째 URL에서 다운로드한 플레이어 프로필은 다음과 같습니다:

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/PlayerProfilesRetrievedFromTheIndexFileURL.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=ddd0cccdadb1aa046e579e594ec6eafb" alt="인덱스 파일 URL에서 검색된 플레이어 프로필" width="1430" height="125" data-path="images/playfab/data-analytics/acting-data/PlayerProfilesRetrievedFromTheIndexFileURL.png" />


## Related topics

- [세그먼트의 플레이어 수 계산 자습서](/ko/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)
- [플레이어 사용자 지정 속성을 활용한 고급 세그멘테이션](/ko/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [Economy V2 타깃 오퍼](/ko/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [플레이어 세그먼트](/ko/services/playfab/player-progression/player-data/player-segments.md)
- [플레이어 세그먼트 구성](/ko/services/playfab/player-progression/player-data/player-segment-configuration.md)