> ## 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.
# 보상형 광고 시작하기
> Game Manager에서 PlayFab 보상형 광고 배치를 설정하고, 보상을 구성하고, 게임 클라이언트에 비디오 광고를 통합하기 위한 빠른 시작입니다.
# 빠른 시작: 광고 배치 설정
보상형 광고는 보상의 대가로 플레이어가 비디오 광고를 시청하도록 인센티브를 제공하는 방법입니다. 관련 보상이 있는 각 광고는 광고 배치로 간주됩니다. 이 빠른 시작에서는 광고 배치를 설정하고 이에 대한 보상을 구성합니다.
## 필수 구성 요소
* [PlayFab 개발자 계정](https://developer.playfab.com/en-US/my-games).
* 광고 제공자의 애플리케이션 ID 및 광고 단위 유형.
## 광고 배치 설정
**Rewarded Ads** 탭에서 가장 먼저 볼 수 있는 것은 광고의 기본 대시보드입니다. 여기서 최근 광고 이벤트를 보여주는 그래프와 함께 광고에 대한 기본 KPI를 확인할 수 있습니다(이는 [PlayStream](/services/playfab/data-analytics/ingest-data/playstream-overview)에도 표시됩니다). 상단에서 **Placements**를 선택합니다.
광고 배치는 시스템의 가장 기본적인 부분입니다. 단일 배치를 "광고 위치"로 생각하세요. 즉, 표시할 광고 유형(배너, 비디오 등)과 플레이어가 게임의 어느 지점에서 그것을 볼 것인지(레벨 인터스티셜, "광고 보기" 클릭의 결과 등)입니다.
오른쪽 상단 모서리에서 **New Ad Placement**를 선택합니다. 원하는 대로 배치 이름을 지정하고 광고 제공자의 애플리케이션 ID 및 광고 단위 유형을 입력합니다. 특정 제공자의 애플리케이션 ID 및 광고 단위 유형을 어디에서 찾아야 할지 모르는 경우 알려주시면 함께 식별할 수 있습니다.
## 보상 추가
이제 특정 보상을 추가해야 합니다. 이 배치에 대한 각 가능한 보상에 대해 **New Reward**를 선택합니다. 보상에 이름을 지정하고 특정 보상이 제공될 때 클라이언트에 반환하고 싶은 설명 텍스트와 자산 패키지 URL을 입력합니다. 그런 다음 **Actions**에서 **Add Action**을 선택합니다. 일반 [PlayStream](/services/playfab/data-analytics/ingest-data/playstream-overview) 액션에서와 마찬가지로, 지금 여러 가지 다른 액션을 취할 수 있습니다. 즉, CloudScript 핸들러 실행, 아이템 부여 등입니다. 일반적으로 여기에서 가상 화폐나 아이템을 부여하지만, 다른 액션 유형을 사용하려는 경우 일반 PlayStream 액션 트리거와 동일한 방식으로 모두 처리됩니다.
몇 가지 보상을 정의한 후, 각 보상에 가중치를 부여하여 무작위 분포를 설정합니다. 타이틀에 대해 [세그먼트](/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview)를 정의한 경우 **Rewards** 아래의 **Segment Assignment** 도구에서 재정의를 설정할 수도 있습니다. 예를 들어, 항상 특정 보상을 받게 하려는 플레이어 그룹이 있는 경우 할당 목록에서 해당 세그먼트를 해당 보상으로 설정합니다. 세그먼트 할당은 우선순위 순서로 되어 있으므로 현재 플레이어와 일치하는 첫 번째 세그먼트가 사용됩니다. 다음 예제는 무료 보석을 시간의 0%, 보너스 경험치를 시간의 30%, "키" 아이템을 시간의 70% 제공하는 광고 배치를 정의합니다.
이 예에서는 **Segment Assignment**를 사용하여 우선순위 순서로 보상을 제공합니다. 플레이어가 "High XP Players" 그룹에 있는 경우 일반 무작위 선택이 이루어집니다. 그러나 플레이어가 "VIP players" 세그먼트에 있는 경우 해당 플레이어에게 "gems" 보상을 부여합니다.
광고를 처음 시청하는 플레이어를 위한 세그먼트를 만들고 더 바람직한 보상 중 하나를 부여하는 것을 고려하세요. 이는 플레이어가 보상형 광고에 계속 참여하도록 장려하고 전반적으로 더 높은 리텐션율을 이끌어낼 수 있습니다.
마지막으로, 플레이어가 광고에 대해 보상받을 수 있는 횟수를 제한하는 옵션이 있습니다. 이 예에서는 플레이어당 하루 4회로 제한했습니다(이 카운터의 일일 재설정은 UTC 00:00에 발생). 매일, 매시간 또는 2시간마다 제한을 재설정할 수 있습니다.
## 광고 배치 검색
최소한 하나의 광고 배치를 정의한 후, Client/GetAdPlacements를 사용해 사용 가능한 배치 목록을 쿼리할 수 있습니다. 호출에서 Identifier를 지정하여 지정된 배치에 대한 정보만 받도록 합니다. 특정 배치를 필터링하려면 위에서 정의한 이름이나 배치에 대해 PlayFab이 생성한 고유 식별자(위의 예에서 URL에 표시됨)를 사용할 수 있습니다. 그렇지 않으면 플레이어가 유효한 보상을 가진 모든 사용 가능한 배치가 플레이어에 대한 보상, 현재 남은 시청 횟수, 시청 제한을 재설정하는 시간과 함께 `AdPlacementDetails` 개체로 반환됩니다.
클라이언트 코드에서 광고 배치를 선택했으면 `PlacementId`와 `RewardId`를 저장해야 합니다. 다음 두 단계에서 이를 사용합니다.
## 광고 활동 보고
광고에 대해 "Opened", "Closed", "Start", "End"의 네 가지 활동 상태를 정의합니다. 보상형 광고를 사용할 때, 광고 SDK가 상태 변경을 보고할 때마다 활동 상태를 업데이트하기 위해 Client/ReportAdActivityRequest를 호출하고 있는지 확인하세요.
## 광고 활동 보상
광고 SDK가 광고 시청이 성공적으로 완료되었음을 보고하면 Client/RewardAdActivity를 호출해 보상을 트리거합니다. 이 호출에는 Client/GetAdPlacements에서 반환한 `PlacementId`와 `RewardId`가 필요합니다. 먼저 보상이 유효한지 확인한 다음 플레이어에 대해 처리합니다. 아이템은 즉시 부여되며, 호출은 그런 다음 아이템 부여, 가상 화폐 부여, 플레이어 통계 증가 액션에 의해 플레이어에게 이루어진 완전한 변경 사항 세트를 반환합니다.
마지막으로, GetAdPlacements 호출의 일부로 보상 ID가 플레이어에게 바인딩되지 않는다는 점에 유의해야 합니다. 제공한 가중치에 따라 GetAdPlacements를 여러 번 호출하면 보상이 변경될 수 있습니다. `RewardAdActivity` 호출에는 보상이 GetAdPlacements에서 마지막으로 반환된 것이 아니라 플레이어에게 유효하기만 하면 됩니다.
## Related topics
- [보상형 광고란?](/ko/services/playfab/economy-monetization/rewarded-ads/index.md)
- [터치 시작하기](/ko/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md)
- [Multiplayer Android 시작하기](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/android-specific-requirements.md)
- [터치 번들 레이아웃 시작하기](/ko/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-getting-started-with-sample-layouts.md)
- [XBOX 업적 보상 구성](/ko/services/xbox-services/player-data/achievements/title-managed/concepts/live-achievement-rewards.md)