플러터의 고급 설정
사용자 세그먼트, 커스텀텀 파라미터, 단가 등 Flutter용 고급 SDK 설정을 설정 광고 게재와 수익화 최적화합니다.
읽는 시간 7분최근 업데이트: 8시간 전
세그먼트 정의
이제 특정 잠재 고객에게 맞게 광고를 게재하는 방법을 쉽게 커스터마이즈할 수 있습니다. 사용자 속한 세그먼트 따라 광고를 게재할 수 있도록 SDK에 사용자 세부 정보를 서버에 알려야 합니다.
Unity 레벨플레이 SDK는 다음 메서드를 지원하여 Unity 사용자 세그먼트 간략하게 설명합니다.
메서드 | 설명 | 참고 |
|---|---|---|
| 기기 속성 | Unity 레벨플레이 SDK는 위치, 기기 모델, 기기 제조사, 앱 버전, OS 등 사용자 기기 관련된 특정 표준 파라미터를 자동으로 수집합니다. | 이 데이터를 Unity와 공유할 필요가 없습니다. |
| 사용자 속성 | 생성일과 같은 포괄적인 사용자 데이터(아래에 설명이 포함된 지원되는 전체 세그먼트 프로퍼티 목록 참조)는 API 통해 전달되어야 합니다. | 지침에 따라 사용자 세부 정보를 전송하여 SDK가 레벨플레이 플랫폼에서 정의한 세그먼트에 따라 사용자를 분류할 수 있습니다. |
| 커스텀 세그먼트 | 사용자 세부 정보를 Unity 서버로 전달하고 해당 사용자 세그먼트 맞게 광고 설정을 커스터마이즈하지 않고 커스텀 세그먼트 생성할 수 있습니다. |
참고
레벨플레이 SDK 7.2.0 이상을 사용하는 경우 LevelPlaySegment API 사용하여 세션 중에 세분화를 변경할 수 있습니다. 이는 다음 로드된 광고에 영향을 미치며 각 광고 유닛을 로드하기 전에 호출되어 워터폴에 동적으로 영향을 미칠 수 있습니다. 레벨플레이 세분화에 대해 자세히 알아볼 수 있습니다. 여기.
사용자 프로퍼티 전달
레벨플레이 플랫폼에서 세그먼트를 정의했으면 Unity 서버에 사용자 세부 정보를 알려야 합니다.
세그먼트를 지지대 Unity 서버에 전송할 프로퍼티를 정의합니다. 다음 방법 중 하나를 통해 이 정보를 전송할 수 있습니다.
-
사용자 속한 세그먼트 익숙하다면 세그먼트 이름을 입력합니다.segment.setSegmentName(name);
-
Unity 사용자 세부 정보를 보냅니다. 레벨플레이 SDK는 API 세그먼트 사용자 속성 위해 설정할 수 있는 다양한 표준 사용자 프로퍼티를 제공합니다. 아래로 스크롤 사용자 세그먼사용자그먼트final segment = LevelPlaySegment();segment.level = levelParam;segment.isPaying = isPayingParam;segment.userCreationDate = dateTimeParam;segment.iapTotal = iaptParam;// up to 5 custom paramssegment.setCustom(key: 'CustomKey1', 값: 'CustomVal1');// Set LevelPlay SegmentLevelPlay.setSegment(segment);
지원되는 사용자 세그먼트 프로퍼티
세그먼트 속성 | Type | 제한 | 설명 |
|---|---|---|---|
| 문자열 |
| 지정된 이름 |
| 지급 | 부울 | 참 또는 거짓 |
|
| iap_total | Double | 1-999999.99 | 사용자가 인앱 구매에 지출한 총 금액입니다. |
| userCreationDate | 길이 | 0보다 작은일 수 없음 | 사용자가 앱을 설치한 날짜(밀리초) |
| 커스텀 파라미터 | key=string, value=string |
| 서비스 서버에 디스패치하려는 추가 데이터 |
보상형 광고 서버 간 콜백에 대한 커스텀 파라미터
레벨플레이 보상형 광고 유닛은 서버 측 이벤트를 지원하여 성공적인 광고 완료 이벤트 후 사용자에게 제공해야 하는 보상을 알려줍니다. 자세한 내용은 서버 간 콜백 설정을 참조하십시오.
클라이언트 통해 런타임 커스텀 파라미터를 공유할 수도 있습니다. 이를 구현하려면 API를 사용하여 커스텀 파라미터를 에 전달합니다. 이전 값을 오버라이드하는 세션 내에서 커스텀 파라미터를 여러 번 업데이트할 수 있습니다.
setMetadataLevelPlay_Rewarded_Server_Params커스텀 파라미터를 재설정하려면 를 빈 배열로 설정합니다.
LevelPlay_Rewarded_Server_Params예제 구현 코드
LevelPlay.setMetaData({ 'LevelPlay_Rewarded_Server_Params': ['key1=value1', 'key2=value2'],});
그러면 다음과 같은 해당 콜백 수신됩니다.
http://www.mydomain.com/rewardsCallback?appUserId=[사용자_ID]&rewards=[리워드]&eventId=[이벤트_ID]&itemName=[ITEM_NAME]& 커스텀_key1=value1& 커스텀_key2=value2
레벨플레이 SDK 오류 코드
Unity 레벨플레이 SDK 연동의 실패에 대한 설명을 제공하는 오류 피드백 메커니즘을 제공합니다. 무언가 잘못되었거나 연동의 한 부분이 올바르게 완료되지 않은 경우 이러한 오류가 표시됩니다.
레벨플레이 Error 오브젝트 오류 코드와 메시지 포함되어 있습니다. 다음은 가능한 모든 오류와 함수에 따라 해당 메시지.
오류 코드 | 광고 단위 | 설명 |
|---|---|---|
| 508 | 해당 없음 |
|
| 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 | 인터스티셜 광고 | 호출하는 동안 인터스티셜 광고 |