# Android용 고급 설정 > 사용자 세그먼트, 커스텀텀 파라미터, 단가 등 Android용 고급 설정을 설정 광고 게재와 수익화 최적화합니다. ## 세그먼트 정의##define-segments 이제 특정 잠재 고객에게 맞게 광고를 게재하는 방법을 쉽게 커스터마이즈할 수 있습니다. 사용자 속한 세그먼트 따라 광고를 게재할 수 있도록 SDK가 서버에 사용자 세부 정보를 알려야 합니다. 레벨플레이 SDK는 다음 세 가지 메서드를 지원하여 사용자 세그먼트 설명하기 위해 서버로 데이터를 전달합니다. * **기기 프로퍼티**: 레벨플레이 SDK는 위치, 기기 모델, 기기 제조사, 앱 버전, OS 등 사용자의 기기에 관련된 특정 표준 파라미터를 자동으로 수집합니다. 이 데이터를 전달할 필요는 없습니다. * **사용자 속성**: 전체적인 사용자 데이터(예: 연령, 성별, 생성일)는 API를 통해 전달되어야 합니다. (다음 섹션 지원되는 세그먼트 프로퍼티의 전체 목록과 설명을 참조하십시오.) 지침에 따라 SDK가 레벨플레이 플랫폼에서 정의한 세그먼트에 따라 다양한 사용자를 분류할 수 있도록 사용자 세부 정보를 전송합니다. * **커스텀 세그먼트**: 사용자 세부 정보를 서버로 전달하지 않고 커스텀 세그먼트를 만들고 해당 사용자 세그먼트에 맞춤형 광고 설정을 지정할 수 있습니다. 동적 세분화 레벨플레이 SDK 7.2.0 이상을 사용하는 경우 레벨플레이 세그먼트 API 사용하여 세션 중에 세분화를 변경할 수 있습니다. 이는 다음 로드된 광고에 영향을 미치며 각 광고 유닛을 로드하기 전에 호출되어 워터폴에 동적으로 영향을 미칠 수 있습니다. 레벨플레이 세분화에 대한 자세한 내용은 [여기](/grow/levelplay/platform/settings/segments.md)에서 확인할 수 있습니다. ### 사용자 프로퍼티 전달##pass-user-properties 레벨플레이 플랫폼에서 세그먼트를 정의하면 서버에 사용자 세부 정보를 알려야 합니다. 세그먼트를 지지대 어떤 프로퍼티를 서버에 보낼지 정의합니다. 다음 방법 중 **하나**를 통해 이 정보를 전송할 수 있습니다. 1. 사용자 속한 세그먼트 익숙하다면 세그먼트 이름을 입력합니다. ```java mLPSegment.setSegmentName(name); ``` 2. 사용자 세부 정보를 보내주십시오. 레벨플레이 SDK는 API 세그먼트 사용자 속성 위해 설정할 수 있는 다양한 표준 사용자 프로퍼티를 제공합니다. 아래로 스크롤 사용자 세그먼사용자그먼트 ```java // Create segment object mLPSegment = new LevelPlaySegment(); // Set user's level mLPSegment.setLevel(level); // Set user creation date mLPSegment.setUserCreationDate(date); // Set user's total in-app purchases mLPSegment.setIAPTotal(iapt); // Set user's paying status mLPSegment.setIsPaying(isPaying); ``` 또한 세그먼트 최대 5개의 커스텀 사용자 프로퍼티를 설정할 수 있습니다. ```java // Set custom parameters (up to 5) mLPSegment.setCustom(key, value); ``` 다음으로, 세그먼트를 기반으로 광고 유닛을 게재하여 사용자 광고 경험 맞춤화하려면 세그먼트 이름 또는 사용자 프로퍼티를 사용하여 다음 함수 호출. ```java LevelPlay.setSegment(mLPSegment); ``` ### **지원되는 사용자 세그먼트 프로퍼티**##**supported-user-segment-properties** | 세그먼트 속성 | Type | 제한 | 설명 | | ---------------- | ------------------------ | ------------------------------------------------- | ------------------------------------------------------------ | | segmentName | 문자열 | 영숫자 최대 32자 | 레벨플레이 계정에 있는 세그먼트 특정 이름입니다. | | 지급 | 부울 | 참 또는 거짓 | 사용자 인앱 구매에 비용을 지출한 경우 true. 사용자 인앱 구매에 비용을 지출하지 않은 경우 false. | | iap\_total | 더블 | 1-999999.99 | 사용자 인앱 구매에 지출한 총 금액입니다. | | userCreationDate | 길이 | 0보다 작을 수 없음 | 사용자 앱을 설치한 날짜(밀리초)입니다. | | 커스텀 파라미터 | key=string, value=string | 레벨플레이 SDK는 최대 5개의 커스텀 파라미터 영숫자 최대 32개의 문자를 지원합니다. | 서버에 디스패치 추가 데이터 | 다음 콜백 등록하여 사용자 속한 세그먼트 이름을 수신합니다. 콜백 문자열(세그먼트 이름)이 비어 있음을 반환하면 레벨플레이 세그먼트 모듈에서 사용자 대해 상관 관계 있는 세그먼트를 찾을 수 없습니다. ```java SegmentListener onSegmentReceived(문자열 세그먼트){} ``` ## 보상형 광고 서버 간 콜백에 대한 커스텀 파라미터##custom-parameters-for-rewarded-server-to-server-callbacks 레벨플레이 보상형 광고 유닛은 서버 측 이벤트를 지원하여 성공적인 광고 완료 이벤트 후 사용자에게 제공해야 하는 보상을 알려줍니다. 자세히 알아보기 [여기](/grow/levelplay/platform/settings/server-to-server-callback.md). 서버 파라미터 외에도 클라이언트 통해 런타임 커스텀 파라미터를 공유할 수 있습니다. 이를 구현하려면 **setMetaData** API를 사용하여 커스텀 파라미터를 **레벨플레이\_보상형 광고\_Server\_Params**에 전달합니다. 커스텀 파라미터는 세션 동안 여러 번 업데이트하여 이전 값을 오버라이드할 수 있습니다. 커스텀 파라미터를 재설정하려면 **레벨플레이\_보상형 광고\_Server\_Params**를 빈 배열로 설정합니다. ### 예제 구현 코드##example-implementation-code 1. **Java** ```java LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", List.of("key1=value1", "key2=value2")); ``` 2. **Kotlin** ```kotlin LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", listOf("key1=value1", "key2=value2")) ``` 그러면 해당 콜백 수신됩니다. 예: ```text http://www.mydomain.com/rewardsCallback?appUserId=[사용자_ID]&rewards=[리워드]&eventId=[이벤트_ID]&itemName=[ITEM_NAME]& 커스텀_key1=value1& 커스텀_key2=value2 ``` > **Note:** > > Min LevelPlay SDK 8.11.0. 최대 2,048자 허용. ## **가격 단위 설정**##**price-floor-configuration** Floor 설정 API 사용하면 특정 광고 유닛의 단가를 설정할 수 있습니다. 사용자 가격 한도를 설정하면 타게팅 효율성을 높이고 지연 줄이고 광고 성과를 최적화할 수 있습니다. 광고 오브젝트 생성할 때 단가를 할당해야 하며, 해당 오브젝트 모든 후속 로드에 적용됩니다. 참고: Min SDK 8.9.0 | 프로퍼티 | Type | 설명 | | :--- | :----- | :--------------------------------------------- | | 단가 | double | 기존 인스턴스와 입찰자에 적용되는 최소 eCPM을 정의하는 USD 기준 가격입니다. | ### 인터스티셜 광고 예시##interstitial-ads-example ```java // Define a price floor configuration var adConfig = new LevelPlayInterstitialAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build(); // Apply the configuration to an interstitial ad unit var interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig); ``` 전체 인터스티셜 광고 구현은 [여기](/grow/levelplay/sdk/android/interstitial-integration.md)에서 사용할 수 있습니다. ### 보상형 광고 예시##rewarded-ads-example ```java // Define a price floor configuration val adConfig = LevelPlayRewardedAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build() // Apply the configuration to a rewarded ad unit val rewardedAd = LevelPlayRewardedAd("adUnitId", adConfig) ``` 전체 보상형 광고 구현은 [여기](/grow/levelplay/sdk/android/rewarded-ads-integration.md)에서 사용할 수 있습니다. ### 배너 광고 예시##banner-ads-example ```java // Define a price floor configuration var adConfig = new LevelPlayBannerAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build(); // Apply the configuration to a banner ad unit var bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig); ``` 전체 배너 광고 구현은 [여기](/grow/levelplay/sdk/android/banner-integration.md)에서 사용할 수 있습니다. ## **레벨플레이 SDK 오류 코드**##**levelplay-sdk-error-codes** 레벨플레이 SDK는 SDK 연동의 장애를 설명하는 오류 피드백 메커니즘을 제공합니다. 무언가 잘못되었거나 연동의 한 부분이 올바르게 완료되지 않은 경우 이러한 오류가 표시됩니다. 레벨플레이 오류 오브젝트에는 **오류 코드**와 **메시지가** 포함되어 있습니다. 다음은 가능한 모든 오류와 함수에 따라 해당 메시지. | 오류 코드 | 광고 단위 | 설명 | | ----- | --------------------- | ------------------------------------------------------------------------------------------------ | | 508 | 해당 없음 | * Mediation/네트워크의 초기 실패 * Demand Only 모드가 아닌 API 호출 * Demand Only 모드에서 비요청 전용 API 호출 | | 509 | 인터스티셜 광고, 보상형 동영상 | **Show Fail**: 표시할 광고가 없습니다 | | 510 | 인터스티셜 광고, 보상형 비디오, 배너 | **로드 실패**: 서버 응답 실패 | | 520 | 인터스티셜 광고, 보상형 동영상 | **Show Fail**: 인터넷 연결 없음. ShouldTrackNetworkState가 활성화되어 있고, 사용 가능한 **Show Fail**: 인터넷 연결 없음 | | 524 | 인터스티셜 광고, 보상형 동영상 | **Show Fail**: %@ 플레이스먼트가 속도별로 정의된 한도에 도달했습니다. **Show Fail**: 플레이스먼트 %@가 한도에 도달했습니다. | | 526 | 인터스티셜 광고, 보상형 동영상 | **Show Fail**: 광고 유닛이 세션당 일일 한도에 도달했습니다 | | 604 | Banner | 로드할 수 없습니다 | | 605 | 배너 | 예기치 않은 예외 | | 606 | Banner | 첫 번째 로드 시 모든 네트워크에 배너 채우지 않음 | | 1007 | 인터스티셜 광고, 보상형 동영상 | **경매 실패**: 경매 요청에 필요한 모든 정보가 포함되지 않았습니다 | | 1022 | 보상형 비디오 | **Show Fail**: 다른 RV가 표시되는 동안 RV를 표시할 수 없습니다 | | 1023 | 보상형 비디오 | **Show Fail**: 표시할 수 있는 광고가 없을 때 호출되는 RV 표시 | | 1035 | 인터스티셜 광고 | **빈 폭포** | | 1036 | 인터스티셜 광고 | **Show Fail**: 다른 인터스티셜 광고가 표시되는 동안 인터스티셜 광고를 표시할 수 없습니다 | | 1037 | 인터스티셜 광고 | **로드 실패**: 다른 인터스티셜 광고가 표시되는 동안 인터스티셜 광고를 로드할 수 없습니다 | | 1039 | 인터스티셜 광고 | 호출하는 동안 인터스티셜 광고 |