2015-12-30

ExactTargetのMobilePush試してみた【iOS編】

今回はiOSアプリに対してExactTargetのPush通知機能を実装してみます。

参考URL

Androidの実装に関しては過去記事を参照してください↓

Push通知用の証明書とProvisioning Profileの取得

通常のiOSアプリのPush通知の設定と同じく、証明書とProvisoning Profileを取得します。

全体的な流れはこんな感じ↓

AppID作成 →キーチェーンアクセスでCSR発行して対象のAppIDにアップロード →証明書ダウンロード&インストール →エクスポートした証明書をAppCenterにアップロード →ProvisioningProfileでアプリをビルド

詳細は以下を参照。

Journey Builderの方のリファレンスには証明書しか書いてませんが、Provisoning Profileも必要なので注意してください。

App Centerのアプリケーション設定

Androidの回と同様、App Centerでアプリケーションを設定します。

以下の設定画面で、取得してp12形式で書き出した証明書と書き出すときに設定したパスワードを入力すればOKです。設定後はApplicationIDとAccessTokenをメモります。

etmc_appcenter_ios

アプリの作成

今回はPush通知受け取るだけのシンプルなアプリを作成します。

Single View Aplicationを選択

etmc_mobilepush_ios1

アプリケーションの基本情報を適当に設定

etmc_mobilepush_ios2

Enable BitcodeがYesになっていることを確認します。

etmc_mobilepush_ios3

プロビジョニングプロファイルをセットします。

etmc_mobilepush_ios4

githubのコードからダウンロードして「JB4A-SDK」のフォルダごとドラッグアンドドロップでプロジェクトにインポートします。こんな感じ↓

etmc_mobilepush_ios_library

AppDelegate.mを以下のように修正します。kETAppID_***、kETAccessToken_***などはAppCenterで作成したApplicationID、AccessTokenをセットしてください。

#import "AppDelegate.h"
#import "ETPush.h"

// Code@ AppIDs and Access Tokens for the debug and production versions of your app
// These values should be stored securely by your application or retrieved from a remote server
static NSString *kETAppID_Debug       = @"change_this_to_your_debug_appId";
static NSString *kETAccessToken_Debug = @"change_this_to_your_debug_accessToken";
static NSString *kETAppID_Prod        = @"change_this_to_your_production_appId";
static NSString *kETAccessToken_Prod  = @"change_this_to_your_production_accessToken";

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    BOOL successful = NO;
    NSError *error = nil;
#ifdef DEBUG
    // Set to YES to enable logging while debugging
    [ETPush setETLoggerToRequiredState:YES];
    
    // configure and set initial settings of the JB4ASDK
    successful = [[ETPush pushManager] configureSDKWithAppID:kETAppID_Debug
                                              andAccessToken:kETAccessToken_Debug
                                               withAnalytics:YES
                                         andLocationServices:YES
                                               andCloudPages:YES
                                             withPIAnalytics:YES
                                                       error:&error];
#else
    // configure and set initial settings of the JB4ASDK
    successful = [[ETPush pushManager] configureSDKWithAppID:kETAppID_Prod
                                              andAccessToken:kETAccessToken_Prod
                                               withAnalytics:YES
                                         andLocationServices:YES
                                               andCloudPages:YES
                                             withPIAnalytics:YES
                                                       error:&error];
#endif
    //
    // if configureSDKWithAppID returns NO, check the error object for detailed failure info. See PushConstants.h for codes.
    // the features of the JB4ASDK will NOT be useable unless configureSDKWithAppID returns YES.
    //
    if (!successful) {
        dispatch_async(dispatch_get_main_queue(), ^{
            // something failed in the configureSDKWithAppID call - show what the error is
            [[[UIAlertView alloc] initWithTitle:NSLocalizedString(@"Failed configureSDKWithAppID!", @"Failed configureSDKWithAppID!")
                                        message:[error localizedDescription]
                                       delegate:nil
                              cancelButtonTitle:NSLocalizedString(@"OK", @"OK")
                              otherButtonTitles:nil] show];
        });
    }
    else {
        // register for push notifications - enable all notification types, no categories
        UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:
                                                UIUserNotificationTypeBadge |
                                                UIUserNotificationTypeSound |
                                                UIUserNotificationTypeAlert
                                                                                 categories:nil];
        
        [[ETPush pushManager] registerUserNotificationSettings:settings];
        [[ETPush pushManager] registerForRemoteNotifications];
        
        // inform the JB4ASDK of the launch options - possibly UIApplicationLaunchOptionsRemoteNotificationKey or UIApplicationLaunchOptionsLocalNotificationKey
        [[ETPush pushManager] applicationLaunchedWithOptions:launchOptions];
    }
    
    return YES;
}

- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
{
    // inform the JB4ASDK of the notification settings requested
    [[ETPush pushManager] didRegisterUserNotificationSettings:notificationSettings];
}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    // inform the JB4ASDK of the device token
    [[ETPush pushManager] registerDeviceToken:deviceToken];
}

-(void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
    // inform the JB4ASDK that the device failed to register and did not receive a device token
    [[ETPush pushManager] applicationDidFailToRegisterForRemoteNotificationsWithError:error];
}


-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
{
    // inform the JB4ASDK that the device received a local notification
    [[ETPush pushManager] handleLocalNotification:notification];
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))handler {
    
    // inform the JB4ASDK that the device received a remote notification
    [[ETPush pushManager] handleNotification:userInfo forApplicationState:application.applicationState];
    
    // is it a silent push?
    if (userInfo[@"aps"][@"content-available"]) {
        // received a silent remote notification...
        
        // indicate a silent push
        [[UIApplication sharedApplication] setApplicationIconBadgeNumber:1];
    }
    else {
        // received a remote notification...
        
        // clear the badge
        [[ETPush pushManager] resetBadgeCount];
    }
    
    handler(UIBackgroundFetchResultNoData);
}

@end

アプリを起動させてみる

起動すると、通知の許可設定ダイアログが出てくるので、OKをクリックします。

etmc_mobilepush_ios_dialog

これでデバイスがExactTargetに登録されるので、管理画面を使ってPush通知配信したり、デバイストークンやSubscriberKeyによるAPIを利用したPush通知を行うことが出来ます。APIでのPush通知の方法に関してはこちらの記事を参照。

その他のSDKの処理について

SubscriberKeyの取得、登録
[[ETPush pushManager] getSubscriberKey];
[[ETPush pushManager] setSubscriberKey:@"input your subscriber key"];

ちなみに取得の方はExactTargetのサーバから取得するのではなくローカルの値を見に行っています。つまり、setSubscriberKeyで設定した値を取得するので、初期値(おそらくGUID)のSubscriberKeyを取得することは出来ないっぽいです。

 

属性の登録

[[ETPush pushManager] addAttributeNamed:@"hoge" value:@"fuga"];
[[ETPush pushManager] updateET];

updateETをすることを忘れずに(画面遷移があるとSDK内に組み込まれているupdateETメソッドが呼ばれるみたいですが、念のため属性登録をする場所にはupdateETを入れたほうが無難)

 

デバイストークンの取得

[[ETPush pushManager] deviceToken];
このエントリーをはてなブックマークに追加