고급 설정

Vungle Agent

2024년 09월 17일 17:36

먼저 기본 플러그인 통합 문서의 지침을 따릅니다. 그런 다음 통합하고자 하는 광고의 유형(전면 광고 또는 보상형 광고, 배너 또는 MREC 광고)별 지침을 따릅니다. 이 문서에는 추가 정보가 포함되어 있으며 기본 통합을 완료했다고 가정하고 설명을 진행합니다.

OnPause 및 OnResume 기능

앱이 바탕화면으로 이동되었을 때 일시 정지된 광고가 다시 재생되도록 하는 onPause 및 onResume 기능에 대한 코드를 추가합니다.

void OnApplicationPause(bool pauseStatus) {
    if (pauseStatus) {
        Vungle.onPause();
    }
    else {
        Vungle.onResume();
    }
}

CCPA 구현

2020년 7월 1일부터 시행되는 CCPA(캘리포니아 소비자 개인정보 보호법)에 따라 퍼블리셔는 Unity Plugin 6.7.0.0으로 업데이트하여 CCPA를 준수해야 합니다.

updateCCPAStatus를 사용하여 사용자의 동의 상태를 설정하여 사용자가 Consent.DENIED를 전달하여 선택 해제했음을 지정합니다. 그리고 getCCPAStatus를 사용하여 특정 사용자의 현재 CCPA 상태를 가져옵니다.

public static void updateCCPAStatus(Consent consent)

public static Consent getConsentStatus()

샘플 코드

Vungle.updateCCPAStatus(Vungle.Consent.Denied);
Vungle.Consent CurrentCCPAStatus = Vungle.getCCPAStatus();

광고 구성 옵션

playAd 메서드로 옵션 딕셔너리를 수락하여 광고 재생 경험을 사용자 지정할 수도 있습니다.

public static void playAd(Dictionary<string,object> options, string placementID);

참고: 경우에 따라 보상형 광고는 인센티브 광고로 불리기도 합니다. 두 용어는 항상 같은 종류의 광고를 나타냅니다. SDK 코드와 보고 API에서는 '인센티브'라는 용어를 사용합니다.

옵션 딕셔너리는 다음 키를 허용합니다.

키 설명

orientation

광고의 방향을 설정합니다

VungleAdOrientation 열거형을 사용하여 정수에서 원하는 방향을 지정합니다

public enum VungleAdOrientation
{
    Portrait = 1,
    LandscapeLeft = 2,
    LandscapeRight = 3,
    PortraitUpsideDown = 4,
    Landscape = 5,
    All = 6,
    AllButUpsideDown = 7
}

`VungleAdOrientation` 값	방향	지원되는 플랫폼
1	세로	iOS, Android, Windows
2	가로(왼쪽)	iOS
3	가로(오른쪽)	iOS
4	세로(뒤집기 포함)	iOS
5	가로	iOS, Android, Windows
6	모두	iOS, Android, Windows
7	모든 방향(세로 뒤집기 제외)	iOS
8	동영상 맞춤	Android

v6.7.2.1 이하의 경우 Android 및 Windows는 orientation에 대해 true 또는 false를 사용합니다. 이는 v6.8.0.0에서도 마찬가지지만 향후 더 이상 사용하지 않을 것입니다.

userTag S2S 호출(사용되는 경우)에서 사용자 식별을 위해 전달되는 사용자의 문자열 키입니다.

alertTitle 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 제목으로 사용되는 문자열입니다.

alertText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 본문 텍스트로 사용되는 문자열입니다.

closeText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼에 사용되는 문자열 제목입니다.

continueText 사용자가 보상형 광고를 시청 도중에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼에 사용되는 문자열 제목입니다.

최소 디스크 공간

Vungle SDK에서 광고를 초기화하고 가져오기 전에 사용자 기기에서 사용 가능한 공간의 제한을 결정하기 위해 버전 6.4.0에 최소 디스크 공간 구성이 도입되었습니다. SetMinimumDiskSpaceForInitialization 코드의 기본값은 51MB이고 SetMinimumDiskSpaceForAd 코드는 50MB입니다. 크기는 MB가 아닌 바이트 단위로 입력됩니다.

Vungle.SetMinimumDiskSpaceForInitialization(minValue);
Vungle.SetMinimumDiskSpaceForAd(minValue);

Vungle.init(appID);

하드웨어 ID 비활성화

SDK 버전 6.4.0 이상의 경우 이제 퍼블리셔는 기기에서 SDK로 하드웨어 ID 전달을 제한할 수 있습니다.

//Set false to opt in for Hardware ID collection by SDK or true to opt out
Vungle.EnableHardwareIdPrivacy(m_disableHardwareID);

GDPR 권장 구현 지침

2019년 5월 25일부터 GDPR(General Data Protection Regulation, 일반데이터보호규정)이 유럽 연합에서 시행됩니다. GDPR을 준수하기 위해 개발자에게는 두 가지 옵션이 있습니다.

옵션 1(권장): Vungle이 요구사항을 처리하도록 허용합니다. Vungle은 유럽 사용자에게 광고를 재생하기 전에 동의 대화 상자를 표시하고 이후 광고에 대한 해당 사용자의 동의 여부를 기억합니다.
옵션 2: 퍼블리셔는 사용자 수준에서 GDPR 동의 과정을 제어한 후 Vungle에 사용자의 선택을 전달합니다. 이를 위해 개발자는 자체 메커니즘을 사용하여 사용자의 동의를 수집한 다음 Vungle API를 사용하여 사용자의 동의 상태를 업데이트하거나 쿼리할 수있습니다. 자세한 내용은 아래의 샘플 코드를 참조하십시오.

옵션 1의 권장 사항에 따라 Vungle API를 사용하여 업데이트하거나 사용자 동의 상태를 쿼리하려면 Vungle.Consent 열거자를 사용하고 현재 값을 다음 2개의 함수로 설정합니다.

// The Consent enum is used to represent the user's current GDPR opt-in status
public enum Consent {
    Undefined = 0,
    Accepted = 1,
    Denied = 2
}

// Sets the user's consent status
void updateConsentStatus(Vungle.Consent consent);

// Sets the user's consent status and also sets a string to track GDPR version
void updateConsentStatus(Vungle.Consent consent, string consentMessageVersion);

 // Gets the user's consent status 
Vungle.Consent getConsentStatus();