{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Index","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"be8a0b64-3087-4f78-8e40-ec075d3d1e62"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Push는 다음의 두 가지 항목을 변경하여, 파트너 환경에 더 잘 어울리는 방식으로 사용할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"[1] Dialog 를 보여주는 방식을 설정할 수 있습니다. 다음 두 가지 방법으로 Register/Unregister 를 할 수 있습니다.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default dialog - SDK 에서 제공하는 Register/Unregister dialog 사용","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom view - SDK 에서 제공하는 Register/Unregister 함수 사용","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"두 가지 방법 모두 Customize 할 수 있습니다. 자세한 내용은 아래를 참고 부탁드립니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"[2] Feed 를 Customize 할 수 있습니다. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CTA 버튼 변경하기","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"툴바 Title 변경하기 ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Push Feed 는 일부 커스터마이즈를 제한하고 있어, 다음의 항목만 커스터마이즈가 가능합니다. (버즈빌에서 이미 제공하는 Feed Type 을 사용하고 있는 경우, Push 의 피드와는 별도의 적용이 필요합니다.)","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Dialog 설정하기","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Default dialog - SDK 에서 제공하는 Register/Unregister dialog customize","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1. PushDialogConfig 설정","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"colorConfirm","type":"text","marks":[{"type":"code"}]},{"text":": 확인버튼 색상 color resource id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"colorCancel","type":"text","marks":[{"type":"code"}]},{"text":": 취소버튼 색상 color resource id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"imageRegisterLogo","type":"text","marks":[{"type":"code"}]},{"text":": register dialog 로고 이미지 drawable resource id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"imageUnregisterLogo","type":"text","marks":[{"type":"code"}]},{"text":": unregister dialog 로고 이미지 drawable resource id","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"final PushDialogConfig pushDialogConfig = new PushDialogConfig.Builder()\n .colorConfirm(R.color.colorAccent)\n .colorCancel(R.color.colorPrimary)\n .imageRegisterLogo(R.drawable.benefit_push_dialog_image_logo)\n .imageUnregisterLogo(R.drawable.benefit_push_dialog_image_logo)\n .build();\n \nprivate BuzzAdPush initBuzzAdPush() {\n return new BuzzAdPush(\n App.UNIT_ID_PUSH,\n CustomNotificationWorker.class,\n pushDialogConfig\n );\n }\n\nBuzzAdPush buzzAdPush = initBuzzAdPush();\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2. Dialog Text 변경 (Optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"Text 는 기본으로 제공되며, 필요한 경우 아래와 같은 방법으로 변경이 가능합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"./res/values-ko/strings.xml","type":"text","marks":[{"type":"code"}]},{"text":" 에 Push 관련 string 을 같은 id 로 입력하면 dialog text 가 변경됩니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Push 설명 Dialog\n리워드 광고 구독하기\n원하는 시간대에 놓치는 리워드 광고를 모아서 참여할 수 있는 기능입니다. 간편하게 구독하고 푸짐한 리워드 받아가세요! 광고가 없는 경우에는 알림이 가지 않습니다.\n다음\n나중에 하기\n\nPush register (시간설정) Dialog\n구독 시간을 선택해 주세요\n모두 구독\n완료\n나중에 하기\n\nPush unregister Dialog\n구독을 취소합니다\n지금 구독을 취소하면 더 이상 리워드 광고 구독하기 알림을 받아볼 수 없습니다. 취소 하시겠습니까?\n구독 취소\n나중에 하기","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3. registerWithDialog/unregisterWithDialog 사용","type":"text"}]},{"type":"paragraph","content":[{"text":"이 방법을 사용하면 Push 에서 제공하는 Default Dialog 를 사용해서 간단하게 register/unregister 를 구현 가능합니다.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Register","type":"text"}]},{"type":"paragraph","content":[{"text":"Push register dialog 는 두개의 dialog 로 구성돼있습니다. 첫 번째는 Push 설명 Dialog, 두 번째는 Push 설정 Dialog. ","type":"text"}]},{"type":"paragraph","content":[{"text":"registerWithDialog(Activity, OnRegisterListener)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"registerWithDialog(Activity, showPushDescription, OnRegisterListener)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"(Optional) 설명 Dialog 가 필요하지 않은 경우 ","type":"text"},{"text":"registerWithDialog","type":"text","marks":[{"type":"code"}]},{"text":" 의 ","type":"text"},{"text":"showPushDescription","type":"text","marks":[{"type":"code"}]},{"text":" 파라미터를 false 로 설정하면 됩니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"buzzAdPush.registerWithDialog(activity, new BuzzAdPush.OnRegisterListener() {\n @Override\n public void onSuccess() {\n switchAdNotiRegister.setChecked(true);\n }\n\n @Override\n public void onCanceled() {\n switchAdNotiRegister.setChecked(false);\n }\n});","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Unregister","type":"text"}]},{"type":"paragraph","content":[{"text":"Unregister 확인 Dialog 를 보여주며 유저선택에 따라 unregister 합니다","type":"text"}]},{"type":"paragraph","content":[{"text":"unregisterWithDialog(Activity, OnRegisterListener)","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"buzzAdPush.unregisterWithDialog(activity, new BuzzAdPush.OnRegisterListener() {\n @Override\n public void onSuccess() {\n \n }\n\n @Override\n public void onCanceled() {\n \n }\n});","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Custom view - SDK 에서 제공하는 Register/Unregister dialog customize","type":"text"}]},{"type":"paragraph","content":[{"text":"이 방법은 Default 로 제공하는 Register Dialog 를 사용하지 않고, 직접 View 를 그리고 싶은 경우 사용합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"아래 함수들을 차례로 사용합니다.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Register","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 1. ","type":"text"}]},{"type":"paragraph","content":[{"text":"buzzAdPush.fetchPushHoursOptionIfNeeded","type":"text","marks":[{"type":"code"}]},{"text":": 설정 가능한 시간을 서버로부터 받아옵니다.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 2. ","type":"text"}]},{"type":"paragraph","content":[{"text":"buzzAdPush.getPushHoursOption","type":"text","marks":[{"type":"code"}]},{"text":": fetch 후 설정 가능한 시간을 읽어옵니다. (fetch 에 실패해도 이 함수를 호출하면 Push에서 default 로 제공하는 값을 사용할 수 있습니다.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"// Step 1\nbuzzAdPush.fetchPushHoursOptionIfNeeded(\n activity,\n new PushRepository.OnFetchResultListener() {\n @Override\n public void onFetchFail() {\n // Step 2. fetch 에 실패해도 Push에서 default 로 제공하는 값을 사용할 수 있습니다\n List list = buzzAdPush.getPushHoursOption(MainActivity.this);\n }\n \n @Override\n public void onFetchSuccess() {\n // Step 2\n List list = buzzAdPush.getPushHoursOption(MainActivity.this);\n }\n });","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 3. ","type":"text"}]},{"type":"paragraph","content":[{"text":"buzzAdPush.setPushHours","type":"text","marks":[{"type":"code"}]},{"text":": 설정 가능한 시간 중 유저가 선택한 시간을 Push SDK 에 등록합니다.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 4.","type":"text"}]},{"type":"paragraph","content":[{"text":"buzzAdPush.register","type":"text","marks":[{"type":"code"}]},{"text":": 위 단계 설정이 끝나면 Push 를 등록하여 활성화합니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"List result = new ArrayList<>();\n...\nresult.add(hour);\n...\n// Step 3\nbuzzAdPush.setPushHours(activity, result);\n// Step 4\nbuzzAdPush.register(activity);","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Unregister","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 5. ","type":"text"}]},{"type":"paragraph","content":[{"text":"buzzAdPush.unregister","type":"text","marks":[{"type":"code"}]},{"text":": Push 를 등록 해지 합니다.","type":"text"}]},{"type":"codeBlock","content":[{"text":"buzzAdPush.unregister(activity);","type":"text"}]},{"type":"paragraph"},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Feed 설정하기","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CTA Color 변경","type":"text"}]},{"type":"paragraph","content":[{"text":"여기에서는 CTA color 변경을 설명합니다. Color 변경 외에 CtaView를 Default로 제공되는 View가 아닌, 다른 모양의 View로 만들고 싶으신 경우, 아래의 ‘CtaView (버튼) Customization’ 항목을 참조해주세요.","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[167.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"wrap-left","width":50.0},"content":[{"type":"media","attrs":{"width":965,"id":"c2a079e5-f238-4987-8223-3e39085494e5","collection":"contentId-1230078968","type":"file","height":314}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[593.0]},"content":[{"type":"paragraph","content":[{"text":"기본 Color","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[167.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"wrap-left","width":50.0},"content":[{"type":"media","attrs":{"width":965,"id":"8c0323c5-46a8-4583-9264-76b74eb00afd","collection":"contentId-1230078968","type":"file","height":302}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[593.0]},"content":[{"type":"paragraph","content":[{"text":"변경 된 Color","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"project 의 colors.xml 파일에 아래의 color resource 값을 추가 하면 CTA color 가 변경됩니다. (Benefit 의 모든 CTA Color 가 변경됩니다.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"benefit_native_bg_cta_button_normal","type":"text","marks":[{"type":"code"}]},{"text":" CTA 가 노출 됐을 때","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"benefit_native_bg_cta_button_pressed","type":"text","marks":[{"type":"code"}]},{"text":" CTA 가 눌렸을 때","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"benefit_native_bg_cta_button_disabled","type":"text","marks":[{"type":"code"}]},{"text":" CTA 가 비활성화 상태 일 때","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n ...\n #1290FF\n #0072E1\n #DDDEDF\n","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"CtaView (버튼) Customization","type":"text"}]},{"type":"paragraph","content":[{"text":"CtaView를 Default로 제공되는 View가 아닌, 다른 모양의 View로 만들고 싶으신 경우 다음과 같이 설정을 진행하면 됩니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@Override\npublic void onBindViewHolder(NativeAdViewHolder holder, NativeAd nativeAd) {\n final NativeAdView view = (NativeAdView) holder.itemView;\n\n final Ad ad = nativeAd.getAd();\n final Creative.Type creativeType = ad.getCreative() == null ? null : ad.getCreative().getType();\n \n ...\n // View를 상속받는 CustomCtaView class를 생성하여 원하는 모양의 CtaView를 사용 할 수 있습니다.\n final CustomCtaView customizedCtaView = view.findViewById(R.id.customCtaView);\n\n // 아래 정보를 이용하여 cta view를 업데이트\n final String callToAction = nativeAd.getAd().getCallToAction();\n final int reward = nativeAd.getAd().getReward(); // 주의사항 참조\n final boolean participated = nativeAd.isParticipated();\n \n // 다음과 같은 function을 CustomCtaView class에 생성하여 텍스트 및 아이콘을 업데이트 할 수 있습니다.\n customizedCtaView.setCtaText(callToAction);\n customizedCtaView.setRewardText(reward);\n customizedCtaView.setRewardIcon(R.drawable.your_reward_icon);\n customizedCtaView.setParticiapted(participated); // 참여 완료된 광고에 대해서 UI를 처리하는 부분\n customizedCtaView.setBackgroundColor(Color.parseColor(“#3976FD”)); // 변경하려는 \"색상코드\"\n\n ...\n\n final List clickableViews = new ArrayList<>();\n clickableViews.add(customizedCtaView);\n ...\n\n nativeAdView.addOnNativeAdEventListener(new NativeAdView.OnNativeAdEventListener() {\n ...\n\n @Override\n public void onParticipated(@NonNull NativeAdView view, @NonNull NativeAd nativeAd) {\n // 매체사 기획에 따라 UI 처리\n // Customize 된 CtaView를 participated 상태에 맞게 업데이트\n final boolean participated = nativeAd.isParticipated();\n customizedCtaView.setParticipated(participated);\n }\n });\n}","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"※ 주의사항","type":"text"}]},{"type":"paragraph","content":[{"text":"유저가 적립을 받은지 시간이 얼마 지나지 않아서 리워드가 부여되지 않거나 또는 원래 광고 자체가 리워드를 가지고 있지 않은 경우가 있을 수 있습니다. 따라서 광고 레이아웃을 구성할 때 Ad Properties를 Assign 하는 과정에서 rewardImage와 rewardText에 대해서 reward > 0 인지 체크해서 리워드를 보여줄지 말지 결정하는 로직이 필요합니다 (아래의 샘플 코드 참조).","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"if (reward > 0) {\n customizedCtaVIew.showRewardImage(CtaView.ImageType.Default);\n customizedCtaVIew.setRewardText(String.format(Locale.US, \"+%d\", reward));\n} else {\n customizedCtaVIew.showRewardImage(null);\n customizedCtaVIew.setRewardText(null);\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Feed Toolbar 디자인 커스터마이즈","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"(중요) Feed Customization 주의사항","type":"text"}]},{"type":"paragraph","content":[{"text":"FeedToolbarHolder, class의 custom class를 생성할때 다음 조건 중 하나를 사용해야합니다. 아래의 조건에 맞지 않는 경우, class를 찾지못하는 현상이 발생하여 customization이 적용되지 않습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"각 클래스는 inner class 가 아니어야 합니다. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inner class로 생성을 해야할 경우, public static class로 선언이 되어야 합니다.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FeedToolbarHolder","type":"text","marks":[{"type":"code"}]},{"text":"를 구현하는 class 를 생성합니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class CustomFeedToolbarHolder implements FeedToolbarHolder {\n private FeedActivityToolbar toolbar;\n\n @Override\n public View getView(final Activity activity, @NonNull final String unitId) {\n // FeedActivityToolbar is a default toolbar view that you can only change the title and view's attributes. \n // Create a custom view and return it if you would like to add more UI components.\n this.toolbar = new FeedActivityToolbar(activity, unitId);\n toolbar.setNavigationOnClickListener(new View.OnClickListener() {\n @Override\n public void onClick(View view) {\n activity.finish();\n }\n });\n toolbar.setTitle(\"BuzzAdBenefit Feed\");\n toolbar.setBackgroundColor(Color.parseColor(\"#1290FF\")); // 변경하려는 \"색상코드\" 를 입력\n return toolbar;\n }\n\n @Override\n public void onTotalRewardUpdated(int totalReward) {\n // Use this callback if you want to show the current total points that users can get\n }\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FeedConfig","type":"text","marks":[{"type":"code"}]},{"text":" 빌","type":"text"},{"text":"드 시점","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e58cd79b-e5ab-4019-9952-a25b4f4f37bd"}}]},{"text":"에 해당 ","type":"text"},{"text":"FeedToolbarHolder","type":"text","marks":[{"type":"code"}]},{"text":" class 를 지정합니다.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"final FeedConfig feedConfig = new FeedConfig.Builder(context, \"YOUR_FEED_UNIT_ID\")\n\t...\n .feedToolbarHolderClass(CustomFeedToolbarHolder.class)\n .build();","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported