# 쿠팡 클릭 이벤트 페이지 연동 가이드 ## 1. 이벤트 페이지 URL 연동 {% code overflow="wrap" %} ``` https://click-reward.adpopcorn.com/sample?identifier={adid_or_idfa} ``` {% endcode %} * 이벤트 페이지 URL은 매체별로 구분됩니다. * 이벤트 페이지의 주소는 사업팀()을 통해 전달됩니다. * **(필수) identifier에 android의 경우 adid, ios일 경우 idfa를 넘겨주어야 합니다.** ## 2. 웹뷰 내 JavascriptInterface 설정 이벤트 페이지의 원활한 동작을 위해 아래 가이드를 참고하여 JavascriptInterface 설정을 진행해 주어야 합니다. ### 2.1 공통 사항 * 호출은 **APSSPClickReward** 객체로 호출합니다. 이에 아래와 같이 각 OS 환경에 맞게 APSSPClickReward 를 등록해 주어야 합니다. {% tabs %} {% tab title="Android" %} 
webView = new WebView(context.getApplicationContext());
webView.addJavascriptInterface(this, "APSSPClickReward");
{% endtab %} {% tab title="iOS" %} 
wkContentController = [[WKUserContentController alloc]init];
[wkContentController addScriptMessageHandler:self name:@"APSSPClickReward"];

webViewConfiguration = [[WKWebViewConfiguration alloc]init];
webViewConfiguration.userContentController = wkContentController;

webView = [[WKWebView alloc] initWithFrame:CGRectMake(0, 0, [UIScreen     mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height) configuration:webViewConfiguration];
{% endtab %} {% endtabs %} ### 2.2 Interfaces #### 2.2.1 closeWebView() * 설명 : 이벤트 페이지의 상단 백버튼 클릭 시, 호출되며 현재의 웹뷰 화면을 종료 처리해 주어야 합니다. * 아래 샘플 코드를 참고해, 매체사의 개발환경에 맞게 변형하여 처리해 줍니다. {% tabs %} {% tab title="Android" %} ```java @JavascriptInterface public void closeWebView(){ finish(); } ``` {% endtab %} {% tab title="iOS" %} ```objectivec #pragma mark WKUIDelegate - (void)userContentController:(nonnull WKUserContentController *)userContentController didReceiveScriptMessage:(nonnull WKScriptMessage *)message { if([message.name isEqualToString:@"APSSPClickReward"]){ id JSON; if ([[message body] isKindOfClass:[NSString class]]) { id strJson = [message body]; NSData *nsData = [strJson dataUsingEncoding:NSUTF8StringEncoding]; JSON = [NSJSONSerialization JSONObjectWithData:nsData options:0 error:nil]; } else { JSON = [message body]; } NSString *action = [self checkNilToBlankString:[JSON valueForKey:@"action"]]; if([action isEqualToString:@"closeWebView"]) { [webView loadHTMLString:@"" baseURL:nil]; [webView stopLoading]; webView.UIDelegate = nil; webView.navigationDelegate = nil; [webView removeFromSuperview]; webView = nil; [self.navigationController popViewControllerAnimated:NO]; } } } - (NSString *)checkNilToBlankString:(id)target { NSString *returnString = @""; if (!([target isEqual:[NSNull null]] || target == nil)) { returnString = target; } return returnString; } ``` {% endtab %} {% endtabs %} #### 2.2.2 adClicked() * 설명 : 이벤트 페이지의 광고를 클릭 한 시점에 발생하는 이벤트입니다. * 클릭 이벤트 발생 시, 매체사가 원하는 동작 처리를 할 때 사용 가능하며, 아래 샘플 코드를 참고해, 매체사의 개발환경에 맞게 변형하여 처리해 줍니다. {% tabs %} {% tab title="Android" %} ```java @JavascriptInterface public void adClicked(){ // 리워드 지급 } ``` {% endtab %} {% tab title="iOS" %} ```objectivec #pragma mark WKUIDelegate - (void)userContentController:(nonnull WKUserContentController *)userContentController didReceiveScriptMessage:(nonnull WKScriptMessage *)message { if([message.name isEqualToString:@"APSSPClickReward"]){ id JSON; if ([[message body] isKindOfClass:[NSString class]]) { id strJson = [message body]; NSData *nsData = [strJson dataUsingEncoding:NSUTF8StringEncoding]; JSON = [NSJSONSerialization JSONObjectWithData:nsData options:0 error:nil]; } else { JSON = [message body]; } NSString *action = [self checkNilToBlankString:[JSON valueForKey:@"action"]]; if([action isEqualToString:@"closeWebView"]) { [webView loadHTMLString:@"" baseURL:nil]; [webView stopLoading]; webView.UIDelegate = nil; webView.navigationDelegate = nil; [webView removeFromSuperview]; webView = nil; [self.navigationController popViewControllerAnimated:NO]; } else if([action isEqualToString:@"adClicked"]) { // 리워드 지급 처리 등 } } } - (NSString *)checkNilToBlankString:(id)target { NSString *returnString = @""; if (!([target isEqual:[NSNull null]] || target == nil)) { returnString = target; } return returnString; } ``` {% endtab %} {% endtabs %} ### 2.3 쿠팡 광고 클릭에 대한 처리 아래 설정이 누락될 경우, 광고 클릭 시, 웹뷰 내에서 광고 페이지로 랜딩됩니다. 이에 반드시 연동을 진행해 주어야 합니다. {% tabs %} {% tab title="Android" %} 

private void setWebViewSetting(){
      webView = new WebView(context.getApplicationContext());
      webView.addJavascriptInterface(this, "APSSPClickReward");
      webView.getSettings().setJavaScriptEnabled(true);
      webView.setWebViewClient(new WebViewClient() {
          @Override
          public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {             
              Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
              intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);
              startActivity(intent);
              return true;
          }
      });
}
{% endtab %} {% tab title="iOS" %} 
#pragma mark WKUIDelegate
- (nullable WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures
{
    NSString *requestString = navigationAction.request.URL.absoluteString;
    if(navigationAction.navigationType == WKNavigationTypeLinkActivated ||
       navigationAction.navigationType == WKNavigationTypeOther)
    {
        NSURL *requestURL = [NSURL URLWithString:requestString];
        if(@available(iOS 10, *))
        {
            [[UIApplication sharedApplication] openURL:requestURL options:@{} completionHandler:^(BOOL success) {
                if (success) {
                    [_webView stopLoading];
                }
            }];
        }
        else
        {
            [[UIApplication sharedApplication] openURL:requestURL];
            [_webView stopLoading];
        }
    }
    return nil;
}

#pragma mark - WKNavigationDelegate
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler
{
    NSString *requestString = navigationAction.request.URL.absoluteString;
    if(navigationAction.navigationType == WKNavigationTypeLinkActivated)
    {
        decisionHandler(WKNavigationActionPolicyCancel);
        NSURL *requestURL = [NSURL URLWithString:requestString];
        if(@available(iOS 10, *))
        {
            [[UIApplication sharedApplication] openURL:requestURL options:@{} completionHandler:^(BOOL success) {
                if (success) {
                    [_webView stopLoading];
                }
            }];
        }
        else
        {
            [[UIApplication sharedApplication] openURL:requestURL];
            [_webView stopLoading];
        }
        return;
    }
    decisionHandler(WKNavigationActionPolicyAllow);
}
{% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/extra-guide/coupang-click-reward-page-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.