# 유저 편의 기능

Source: https://docs.buzzvil.com/docs/buzzbenefit-ios/v6/faq
Platform: iOS
SDK major version: v6
Language: Korean (ko)

Buzzvil SDK를 연동한 후 추가할 수 있는 유저 편의 기능을 구현하는 방법에 대해 알아보세요.

## 다크 테마(Dark theme) 설정

Buzzvil SDK는 시스템 테마 설정에 따라 자동으로 다크 테마가 적용됩니다. 버즈빌 지면을 라이트 테마 또는 다크 테마로 고정하고 싶은 경우 버즈빌 담당자(<help@buzzvil.com>)에게 연락하세요.

## iOS 17을 위한 대응

Buzzvil SDK에서 iOS 17를 대응하기 위해 적용된 사항에 대해 확인할 수 있습니다.

> ✏️   **참고**\
> 자세한 사항은 [Apple Developer - Privacy manifest files](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files#4284009), [Upcoming third-party SDK requirements](https://developer.apple.com/support/third-party-SDK-requirements/), [Privacy updates for App Store submissions](https://developer.apple.com/news/?id=3d8a9yyh)를 참고하세요.

### Privacy manifest

2024년 5월 1일부터 App Store의 모든 앱 및 SDK는 개인정보 보호 목록(Privacy Manifest)에 개인정보 관련 사항들을 명시해야 합니다. `BuzzvilSDK 6.0.0` 이상 버전에서는 개인정보 보호 목록이 포함이 되어 있습니다.

### XCFramework signature 적용

2024년 5월 1일부터 App Store의 모든 앱은 binary dependency로 SDK를 추가할 때, signature가 적용된 SDK를 추가해야 합니다. `BuzzvilSDK 6.0.0` 이상 버전에서는 signature 가 적용 되어 있습니다.

## 액션형 광고의 유저 문의 기능 추가하기

Buzzvil SDK는 동영상 시청, 앱 설치, 페이스북 페이지의 ‘좋아요’ 클릭 등 다양한 사용자 액션에 리워드를 지급하는 액션형 광고를 제공합니다. 액션형 광고에 참여한 사용자가 포인트 적립에 실패하는 경우, Buzzvil SDK에서는 문의(이하 VOC) 접수와 처리를 자동화하는 서비스를 제공합니다.

![](https://docs.buzzvil.com/api/content-image/buzzbenefit-ios/v6/image/10-faq/00-faq_inquiry.png)

VOC 기능을 추가하려면 다음의 절차를 따르세요.

1. VOC 처리 페이지를 불러오기 위한 UI(아이콘 또는 탭)을 디자인하세요.

2. 1번 단계에서 디자인한 UI를 클릭하면 아래의 코드를 호출하세요.

**Swift**

```swift
import BuzzAdBenefitSDK

BuzzAdBenefit.shared.openInquiryPage()

```

**Objective-C**

```objectivec
@import BuzzvilSDK;

[BuzzAdBenefit.sharedInstance openInquiryPage];
```

## 오프라인 빌드

오프라인 모드에서 Buzzvil SDK를 연동하고 앱을 빌드할 수 있습니다. 버즈빌에서 제공받은 프레임워크를 프로젝트에 추가해야 합니다. 오프라인 빌드를 진행하려면 버즈빌 담당자(<help@buzzvil.com>)에게 연락하세요.

### 오프라인 빌드용 프레임워크의 구성

버즈빌에서 오프라인 빌드를 위해 제공하는 프레임워크는 아래와 같이 구성되어 있습니다. 정상적인 빌드를 위해서는 아래에 나열된 프레임워크를 모두 프로젝트에 추가해야 합니다.

| 분류               | 파일명                            | 설명                                            |
| ---------------- | ------------------------------ | --------------------------------------------- |
| BuzzvilSDK       | `BuzzvilSDK.xcframework`       | 버즈빌 통합 프레임워크                                  |
| BuzzAdBenefitSDK | `BuzzAdBenefitSDK.xcframework` | 광고 지면을 사용하기 위한 프레임워크                          |
| BuzzAvatyeAdCash | `BuzzAvatyeAdCash.xcframework` | 버즈배너 및 추가 수익화 전면 광고를 위한 AvatyeAdCash 래핑 프레임워크 |
| AvatyeAdCash     | `AvatyeAdCash.xcframework`     | 배너 및 전면 광고 미디에이션 프레임워크                        |
| AdPopcornSSP     | `AdPopcornSSP.xcframework`     | AvatyeAdCash의 광고 미디에이션 의존성                    |

### 오프라인 빌드용 프레임워크 추가하기

프로젝트에 오프라인 빌드용 프레임워크를 추가하려면 다음의 절차를 따르세요.

1. \[프로젝트 메뉴] > **General** 탭을 클릭하세요.
2. **Frameworks, Libraries, and Embedded Content** 영역에서 **+** 버튼을 클릭하여 버즈빌의 오프라인 빌드용 프레임워크를 추가하세요.

## iOS 13 이상에서만 SDK가 동작하도록 구현하기

Buzzvil SDK는 iOS 13 이상의 기기에서 작동합니다. 그러므로 앱이 iOS 13 미만의 기기를 지원하는 경우, iOS 13 이상의 버전에서만 Buzzvil SDK 코드를 호출하세요.

> ❌   **오류**\
> iOS 13 미만의 기기에서 Buzzvil SDK 코드를 호출하면 앱이 비정상적으로 종료될 수 있습니다.

다음은 iOS 13 이상에서만 Buzzvil SDK 코드를 호출하는 예시입니다.

**Swift**

```swift
if #available(iOS 13.0, *) {
  // Buzzvil SDK 코드
}
```

**Objective-C**

```objectivec
if (@available(iOS 13.0, *)) {
  // Buzzvil SDK 코드
}
```