Frequently asked questions

This page covers support for iOS 14 and additional features you can configure after integrating BuzzAd SDK for iOS.

Support for iOS 14#

This section describes the features BuzzAd SDK for iOS provides for iOS 14.

Display the tracking authorization prompt#

BuzzAd SDK for iOS can display the tracking authorization prompt on iOS 14 and later. See Apple's documentation for details about tracking authorization.

Follow these steps to display the tracking authorization prompt on iOS 14 and later.

1. Add NSUserTrackingUsageDescription to Info.plist to set the text shown in the tracking authorization prompt.

<key>NSUserTrackingUsageDescription</key>
<string>Tracking Usage Description - Buzzvil</string>

2. Display the tracking authorization prompt when the user logs in.

BuzzAdBenefit.login { builder in
  ...생략...
  builder.showAppTrackingTransparencyDialog = true
} onSuccess: {
} onFailure: { error in
}

[BuzzAdBenefit loginWithBlock:^(BZVLoginRequestBuilder * _Nonnull builder) {
  ...생략...
  builder.showAppTrackingTransparencyDialog = YES;
} onSuccess:^{
} onFailure:^(BZVError * _Nonnull error) {
}];

Add user support for action-based ads#

BuzzAd SDK for iOS provides ads that reward actions such as watching a video, installing an app or liking a Facebook page. If a user completes an action but does not receive points, the SDK provides a service that automates support request submission and handling (referred to here as VOC).

Follow these steps to add VOC support.

1. Design a UI element (an icon or tab) that opens the VOC support page.

2. Call the code below when the user clicks the UI you designed in step 1.

   • The YOUR_UNIT_ID argument is required. Use the Unit ID for the relevant placement.

BuzzAdBenefit.presentInquiryPage(on: YOUR_VIEW_CONTROLLER, unitId: @"YOUR_UNIT_ID")

[BuzzAdBenefit presentInquiryPageOnViewController:YOUR_VIEW_CONTROLLER unitId:@"YOUR_UNIT_ID"]

Change video autoplay settings#

By default, video ads play automatically only when the device is connected to Wi-Fi. Choose one of the following autoplay settings.

The following example enables autoplay only on Wi-Fi.

let userPreferences = BZVUserPreferences { builder in
  builder.autoPlayType = .onWifi
}
BuzzAdBenefit.setUserPreferences(userPreferences)

BZVUserPreferences *userPreferences = [BZVUserPreferences userPreferencesWithBlock:^(BZVUserPreferencesBuilder * _Nonnull builder) {
  builder.autoPlayType = BZVVideoAutoPlayOnWifi;
}];
[BuzzAdBenefit setUserPreferences:userPreferences];

Offline builds#

You can integrate BuzzAd SDK for iOS and build your app offline. First, obtain the frameworks provided by Buzzvil, then add the frameworks and a run script to your project.

Frameworks for offline builds#

Buzzvil provides the following frameworks for offline builds. Add all the frameworks listed below to your project for a successful build.

Add frameworks for offline builds#

Follow these steps to add the offline build frameworks to your project.

1. In the project menu, click the General tab.
2. Click + in Embedded Binaries to add Buzzvil's offline-build frameworks.

Add a run script#

Add a run script to remove unnecessary architectures from binaries built as universal frameworks.

Follow these steps to add the run script.

1. Select your project, then open the Build Phases tab.
2. Click + in the upper left and select New Run Script Phase.
3. Paste the script below.

APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"

find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK; do
FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"

EXTRACTED_ARCHS=()

for ARCH in $ARCHS; do
echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
done

echo "Merging extracted architectures: ${ARCHS}"
lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
rm "${EXTRACTED_ARCHS[@]}"

echo "Replacing original executable with thinned version"
rm "$FRAMEWORK_EXECUTABLE_PATH"
mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"

done

Run the SDK only on iOS 11 and later#

BuzzAd SDK for iOS runs on devices with iOS 11 or later. If your app supports earlier versions, call the SDK only on iOS 11 and later.

The following example calls BuzzAd SDK for iOS only on iOS 11 and later.

if #available(iOS 11, *) {
  // BuzzAd iOS용 SDK 코드
}

if (@available(iOS 11, *)) {
  // BuzzAd iOS용 SDK 코드
}

Check the ad type#

Use the functions provided by BZVNativeAd to identify ad types in Feed and Native.

The following ad type functions are available in BZVNativeAd.

The following example checks the ad type using BZVNativeAd.

let isActionType = nativeAd.isActionType()
let isCps = nativeAd.isCps()
let revenueType = nativeAd.revenueType

BOOL isActionType = [nativeAd isActionType];
BOOL isCps = [nativeAd isCps];
BZVRevenueType revenueType = nativeAd.revenueType;