{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"ef46ed43-d4ce-4ec4-8434-1da1edddb0ba"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"670dd84e-7920-46c6-bc52-424376202532"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Buzzscreen","type":"text"}]},{"type":"paragraph","content":[{"text":"BuzzScreen 과 같이 연동하고 있는 경우 ","type":"text"},{"text":"com.android.tools.r8.errors.CompilationError: Program type already present: com.buzzvil.buzzresource.BuildConfig","type":"text","marks":[{"type":"code"}]},{"text":" 에러가 발생 할 수 있으며 BuzzScreen 3.11.+ 연동 시 해결됩니다.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Build","type":"text"}]},{"type":"paragraph","content":[{"text":"빌드할 때 다음과 같은 문제가 발생한 경우","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Warning: com.buzzvil.buzzad.benefit.pop.PopControlService: can't find referenced method 'android.view.DisplayCutout getCutout()' in library class android.view.Display","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"compileSdkVersion 을 29 이상으로 변경하거나,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"proguard rules 에 -dontwarn android.view.Display 를 추가","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"com.android.tools.r8.errors.CompilationError: Program type already present: com.buzzvil.buzzresource.BuildConfig","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Buzzscreen SDK와 같이 연동하고 있는 경우 Buzzscreen SDK 3.11.+ 연동 시 해결됩니다.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"java.lang.RuntimeException: Unable to start activity ComponentInfo{…/com.buzzvil.buzzad.browser.BuzzAdBrowserActivity}: java.lang.IllegalStateException: You need to use a Theme.AppCompat theme (or descendant) with this activity.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"BuzzAdBrowserActivity에 theme 설정이 되어있지 않아, 전역으로 설정된 theme이 맞지 않을 경우 문제가 발생 (수정 예정)","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AppCompat Theme중 하나를 상속받는 theme을 styles.xml에 정의","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AndroidManifest.xml에 다음 line을 추가","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"광고 할당","type":"text"}]},{"type":"paragraph","content":[{"text":"BuzzAdBenefit SDK는 광고를 받아오고 보여주는 역할을 합니다. 이때 유저 정보가 없다면 광고 할당을 받을 수 없기 때문에 반드시 유저 정보를 SDK에 등록하는 과정이 필요합니다. 그 과정은 ","type":"text"},{"text":"여기","type":"text","marks":[{"type":"link","attrs":{"href":"https://buzzvil.atlassian.net/wiki/spaces/BDG/pages/1987838608/2.#Step-3.-Set-user-profile"}}]},{"text":"에서 진행하실 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"setUserProfile","type":"text","marks":[{"type":"code"}]},{"text":"를 통해 유저 정보를 SDK에 등록하면 내부적으로 세션키를 발급 하는데 이는 광고 할당에 꼭 필요한 값입니다. 만약 ","type":"text"},{"text":"setUserProfile","type":"text","marks":[{"type":"code"}]},{"text":" 이후 짧은 시간 안에 광고 할당 요청을 하면 세션키 발급이 완료되지 않아 요청이 실패할 수 있습니다. 이런 경우에 다음과 같이 세션이 발급이 완료되었는지 확인할 수 있는 receiver를 등록하여 확인 후 광고 할당 요청을 보낼 수 있습니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// 1. create a BroadcastReceiver\nprivate BroadcastReceiver sessionReadyReceiver = new BroadcastReceiver() {\n @Override\n public void onReceive(Context context, Intent intent) {\n // Session is ready\n }\n};\n\n// 2. register the receiver to LocalBroadcastManager\nprivate void registerSessionReadyReceiver() {\n LocalBroadcastManager.getInstance(context).registerReceiver(sessionReadyReceiver, BuzzAdBenefit.getSessionReadyIntentFilter());\n}\n\n// 3. unregister the receiver when you're done\nprivate void unregisterSessionReadyReceiver() {\n LocalBroadcastManager.getInstance(context).unregisterReceiver(sessionReadyReceiver);\n}","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"액션형 광고 주의 사항","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b4e5585d-25bd-42de-b86c-2897829d9ac8"}}]}]},{"type":"paragraph","content":[{"text":"BuzzAd Benefit SDK는 비디오, 앱 인스톨, 페이스북 페이지 좋아요 등 다양한 유저 액션에 리워드를 지급하는 광고를 제공 하며 이를 액션형 광고로 칭합니다. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"액션형 광고 참여 단계에 따른 CTA 변화","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"06cdd8df-7f0c-4258-961e-66f4d988c7da"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":637,"id":"bdd66b0c-ddf0-45e1-aba6-027959054c98","collection":"contentId-1992851527","type":"file","height":236}}]},{"type":"paragraph","content":[{"text":"액션형 광고는 참여 전, 참여 확인 중, 참여 완료의 세가지 상태를 가지는데, CTA 버튼에 해당 상태 변화 적용해야 합니다. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2.2.3 버전 미만 버전에만 해당합니다.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"이전 버전으로 연동을 했었고, CTA 버튼을 custom class 로 구현하여 사용하고 있었다면, 아래의 변경 사항을 참고하여 모든 상황에서 CTA 가 정상적으로 보일 수 있게 적용하는 것을 권장합니다. (CTA 버튼 구현은, 광고지면 타입에서 다룹니다.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(기존) 액션형 광고의 경우, 포인트 적립 시점이 광고 클릭 시점과 다르기 때문에 CTA 를 '적립 완료'로 표시할 수 없었습니다. 광고 클릭이 확인되는 시점에 '참여 확인 중' 으로 변경하여 사용하고 있었습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(변경) 액션형 광고도 노출형과 같이, 적립 완료 콜백이 적용 됩니다. 참여 전 → 참여 확인 중 (is clicked) → 참여 완료 (is participated) 의 단계로 구분되어야 합니다. ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"액션형 광고에 대한 유저 VOC (문의하기) 사용하기","type":"text"}]},{"type":"paragraph","content":[{"text":"액션형 광고의 경우 종종 리워드 미적립을 이유로 유저가 문의(VOC)를 보내기도 합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"이러한 유저 VOC에 대한 접수 및 처리를 자동화 하기 위해 SDK에서는 미리 만들어 놓은 웹 페이지를 제공하고 있습니다. 이 문의하기 페이지는 연동되어 있는 ","type":"text"},{"text":"앱을 기준으로 조회하기 때문에, 유닛별로 구현할 필요가 없으며, VOC의 위치를 강제하지 않습니다.","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"아래의 단계를 통해 해당 기능을 사용하실 수 있습니다.","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VOC 페이지 로드를 위한 유저 진입 Icon/ Tab을 디자인 합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1번의 Icon/Tab이 클릭될 때 코드에서 ","type":"text"},{"text":"BuzzAdBenefit.getInstance().showInquiryPage(context)","type":"text","marks":[{"type":"code"}]},{"text":" 호출합니다.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"특정 유닛에 대해서만 문의하기 페이지를 보여주고 싶은 경우, ","type":"text"},{"text":"showInquiryPage(Context context, @Nullable final String unitId)","type":"text","marks":[{"type":"code"}]},{"text":" 을 사용할 수 있습니다. 보여주고 싶은 지면의 Unit Id 를 입력하여 사용할 수 있으며, Unit Id 가 null 로 들어올 경우 앱 기준으로 조회할 수 있습니다.","type":"text"}]}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Interstitial, Feed 타입의 경우, 문의하기에 사용하는 기본 제공 아이콘을 사용하실 수 있습니다. (아래를 클릭하여 이미지 및 적용 방법을 확인할 수 있습니다.)","type":"text"}]}]}]},{"type":"expand","attrs":{"title":"Interstitial, Feed 타입의 기본 아이콘 예시와 사용하는 방법"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Interstitial - InterstitialAdConfig에 ","type":"text"},{"text":"showInquiryButton(true)","type":"text","marks":[{"type":"strong"}]},{"text":" 설정을 하는 경우, 예시 중 1번과 같은 아이콘을 사용할 수 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Feed","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"53c45a60-b688-423f-b275-a983fc4e4a4b"}}]},{"text":" - Toolbar를 Customize 하지 않고 Default Toolbar를 사용하는 경우, 예시 중 2번과 같은 아이콘이 ","type":"text"},{"text":"이미 디자인에 포함","type":"text","marks":[{"type":"strong"}]},{"text":"되어 있습니다.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"type":"external","url":"https://github.com/Buzzvil/buzzad-benefit-sdk-publisher/raw/master/images/BAB_CS_Page_Example.png"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Custom In-App Browser 사용법","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"현재 Custom Launcher 를 사용하지 않을 경우 아래 가이드는 아무 영향이 없습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custome Launcher 사용할 예정이거나, 1.X 버전에서 이미 사용하고 있을 경우, 아래의 항목을 필수로 적용해야 합니다.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Custom launcher 사용시, 광고를 클릭했을 때 랜딩되는 In-App Browser를 Customize 할 수 있습니다. 예를 들어, 광고 랜딩 페이지 로드 등을 매체사가 지정하는 Class에서 구현할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"구현시 주의사항","type":"text","marks":[{"type":"strong"}]},{"text":" :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BuzzAdBrowser에서 제공하는 Fragment를 사용하여 In-App Browser를 구현해야 합니다. 사용하지 않을 경우, 일부 광고(액션형 광고, 체류 리워드 광고)가 제대로 동작하지 않을 수 있습니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Launcher에서 제공하는 LandingInfo 의 URL을 임의로 변경해서 사용하면 안됩니다. 이 경우 웹 페이지가 제대로 로드되지 않을 수 있습니다.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"[1] ","type":"text"},{"text":"CustomBrowserActivity","type":"text","marks":[{"type":"code"}]},{"text":" 를 구현합니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class CustomBrowserActivity extends AppCompatActivity {\n public static final String KEY_URL = \"com.sample.KEY_URL\";\n private BuzzAdWebView webView;\n\n @Override\n protected void onCreate(@Nullable Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(R.layout.activity_custom_browser);\n\n // URL을 KEY로 하여 WebView를 가지고있는 Fragment를 받아와 사용합니다.\n Intent intent = getIntent();\n BuzzAdBrowserFragment fragment = BuzzAdBrowser.getInstance(this).getFragment(intent.getStringExtra(KEY_URL));\n getSupportFragmentManager().beginTransaction().replace(R.id.browserContainer, fragment).commit();\n this.webView = fragment.getWebView();\n\n // Browser의 이벤트를 받을 수 있습니다. DeepLink가 열렸을 경우, Browser를 닫아주어야 빈 페이지가 보여지는 현상을 방지할 수 있습니다.\n BuzzAdBrowser.getInstance(this).setOnBrowserEventListener(new BuzzAdBrowser.OnBrowserEventListener() {\n \n // 기존에 사용하던 isDeepLink 를 아래로 대체\n @Override\n public void onDeepLinkOpened() {\n finish();\n }\n });\n }\n\n // Optional - BackButton을 눌렀을때 뒤로가기 기능\n @Override\n public void onBackPressed() {\n if (webView.canGoBack()) {\n webView.goBack();\n } else {\n super.onBackPressed();\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"[2] ","type":"text"},{"text":"activity_custom_browser.xml","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"?xml version=\"1.0\" encoding=\"utf-8\"?>\n\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"[3] ","type":"text"},{"text":"Launcher","type":"text","marks":[{"type":"code"}]},{"text":" 를 구현","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class MyLauncher implements Launcher {\n\n @Override\n public void launch(@NonNull Context context, @NonNull LaunchInfo launchInfo) {\n launch(context, launchInfo, null);\n }\n\n @Override\n public void launch(@NonNull final Context context, @NonNull final LaunchInfo launchInfo, @Nullable final LauncherEventListener listener) {\n launch(context, launchInfo, listener, null);\n }\n\n @Override\n public void launch(@NonNull final Context context, @NonNull final LaunchInfo launchInfo, @Nullable final LauncherEventListener listener, @Nullable List> javascriptInterfaces) {\n \n // Custom Browser 실행\n final Intent intent = new Intent(context, CustomBrowserActivity.class);\n intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);\n intent.putString(CustomBrowserActivity.KEY_URL, launchInfo.getUri().toString()); // URI는 변경 하면 안 됨\n context.startActivity(intent);\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"[4] ","type":"text"},{"text":"BuzzAdBenefit.init","type":"text","marks":[{"type":"code"}]},{"text":" 호출 이후에 생성한 ","type":"text"},{"text":"Launcher","type":"text","marks":[{"type":"code"}]},{"text":"를 세팅","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"BuzzAdBenefit.setLauncher(new MyLauncher());","type":"text"}]},{"type":"paragraph","content":[{"text":"[+] Custom launcher 사용시 Article의 sourceUrl 사용법","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class MyLauncher implements Launcher {\n @Override\n public void launch(@NonNull final Context context, @NonNull final LaunchInfo launchInfo, @Nullable final LauncherEventListener listener, @Nullable List> javascriptInterfaces) {\n if (launchInfo.getArticle() != null) {\n String sourceUrl = launchInfo.getArticle().getSourceUrl();\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"컨텐츠의 경우 url scheme에 따라 랜딩 방식을 다르게 처리하고 싶다면 (ex. 앱 안에서 브라우저 오픈 없이 다른 화면으로 이동되는 컨텐츠) 다음과 같은 방법으로 ","type":"text"},{"text":"NativeArticle","type":"text","marks":[{"type":"code"}]},{"text":" 객체의 ","type":"text"},{"text":"sourceUrl","type":"text","marks":[{"type":"code"}]},{"text":"을 가져와 분기 처리를 할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"[+] Custom launcher 사용시 광고 또는 컨텐츠인지 미리 판단하고 싶을 경우","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class MyLauncher implements Launcher {\n ...\n @Override\n public void launch(@NonNull final Context context, @NonNull final LaunchInfo launchInfo, @Nullable final LauncherEventListener listener, @Nullable List> javascriptInterfaces) {\n \n // 광고 또는 컨텐츠인지 미리 판단하고 싶을 경우, 다음을 이용하여 확인\n if (launchInfo.getAd() != null) {\n // 광고\n } else if (launchInfo.getArticle() != null) {\n // 컨텐츠\n } \n \n ...// Custom Browser 실행\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"앱에서 버즈빌의 UI만 다크테마가 적용되는 경우의 대처방법","type":"text"}]},{"type":"paragraph","content":[{"text":"BuzzAd SDK의 UI는 다크테마를 지원하고 있습니다. ","type":"text"},{"type":"hardBreak"},{"text":"앱에서 다크테마를 지원하지 않는 경우, 버즈빌에서 제공하는 UI만 다크테마가 적용되어 부자연스럽게 보일 수 있습니다.","type":"text"},{"type":"hardBreak"},{"text":"이런 경우, 아래의 코드를 추가하여 앱에 다크모드가 적용되지 않게 막을 수 있습니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"public class MyApplication extends Application {\n @Override\n public void onCreate() {\n super.onCreate();\n \n // 아래 코드 추가\n AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO);\n }\n}","type":"text"}]}],"version":1}