Uninstallトラッキング

注意: Uninstallトラッキングはエンタプライズ顧客のみ提供されます。

アプリでUninstallトラッキングを活性化するには下記の手順に順ってください。

• Singular内のアプリ設定にてUnistallトラッキングが活性化されたか確認ください。詳しい内容は  Setting Up iOS Install Tracking 文書をご参照ください。
• アプリ内にて registerDeviceTokenForUninstall又は registerDeviceToken メソッドを使用し、Apple Push Notification Service(APNS)から変換されたデバイストークンを渡します。このコードは必ずSingularのStartSession 前に呼び出される必要が有ります。

アプリが現在Push Notificationをサポートしてない場合には Appleのガイドをご参照ください。

NSString* apns = @"b0adf7c9730763f88e1a048e28c6
8a9f806ed032fb522debff5bfba010a9b052";
NSData* data = [apns dataUsingEncoding:NSUTF8StringEncoding];
[Singular registerDeviceTokenForUninstall:data];

Singular SDK JavaScriptインタフェース

アプリ内のjavaScriptコードからSingularを呼び出しを必要とする場合、 JavaScript インタフェースをご使用頂けます。

例えば、JavaScriptインタフェースを設定した場合、次のように JavaScriptコードからSingularにイベントを転送する事が可能です。

Singular.event('event'); 
Singular.event('test', JSON.stringify({"a1":"bar",
    "a2":"boo", "a3":"baz"})); 

このインタフェースは次のようなSDKメソッドを支援します。

• setCustomUserID
• unsetCustomUserID
• event
• revenue

Enabling the JavaScript Interface

JavaScriptインタフェース活性化

注意: AppleはiOS 8.0以上からアプリにウェブコンテンツを追加する際、WKWebView를を使用する事を推薦している為 UIWebView又は WebView 使用は推薦していません。詳しい内容はAppleのWKWebView文書をご参照ください。

WKWebViewの使用際にJavaScriptインタフェースを使用する為には WKNavigationDelegate プロトコルの webView メソッドにいくつかのコードを追加する必要が有ります。このプロトコルはウェブビューがナビゲーション要請を処理する際にカスタム行動を発動させるよう実装する事を手伝うプロトコルです。

Swift:

extension ViewController: WKNavigationDelegate { 
 func webView(_: WKWebView, decidePolicyFor: WKNavigationAction, 
    decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) { 

// Singular ハンドラー 
 let js = "typeof(Singular)" 
 webView.evaluateJavaScript(js) { (result, error) -> Void in 
     if let resultString = result as? String { 
         if resultString.isEqual("undefined") { 
         do { 
             let contents = try String(contentsOfFile: 
                 Bundle.main.path(forResource: "Singular", ofType: "js")!) 
         self.webView.evaluateJavaScript(contents, 
             completionHandler: nil) 
         } catch { 
         } 
     } 
                 else { 
                     print(decidePolicyFor.request) 
                     Singular.processJSRequestWK(self.webView, 
                         withURL:decidePolicyFor.request) 
                 } 
             }  
         } 
      
 // 他のコードは下に追加してください。   
} 

iOS 8.0から使用が中断された以前UIWebViewを使用する場合、次のようにUIWebViewDelegate ファイルの webView:shouldStartLoadWithRequest:navigationType: メソッドをアップデータしてください。

Objective-C:

- (BOOL)webView:(UIWebView *)webView 
    shouldStartLoadWithRequest:(NSURLRequest *)request
    navigationType:(UIWebViewNavigationType)navigationType{ 
   if([[webView stringByEvaluatingJavaScriptFromString:@"typeof(Singular)"] isEqualToString:@"undefined"]) { 

   // HTMLにSingular.js注入  
   [webView stringByEvaluatingJavaScriptFromString:[NSString
       stringWithContentsOfFile:[[NSBundle mainBundle] 
       pathForResource:@"Singular" ofType:@"js"] usedEncoding:nil error:nil]]; 
   } else { 
   // Singular.jsにて要請処理
   [Singular processJSRequest:webView withURL:request]; 
   } 

   // 次のコードは下に追加してください。 

   return true; 
}

GDPR 規定遵守

Singular SDKはお客様がGDPR規定を遵守し、ユーザーのトラッキング同意及び非同意事項をSingularにお知らせするに必要な様々なメソッドを提供します。

[Singular trackingOptIn];

Singular.trackingOptIn()

[Singular trackingUnder13];

Singular.trackingUnder13()

[Singular stopAllTracking];

Singular.stopAllTracking()

[Singular resumeAllTracking];

Singular.resumeAllTracking()

[Singular isAllTrackingStopped]; // 返還値 true/false

Singular.isAllTrackingStopped() // 返還値 true/false