モバイル：iOS Campaign Callbacksとは？どのように使用されているのでしょうか？

Last Updated 12月 21, 2022

Download as PDF

Share Article Copy link to clipboard

概要

WalkMe Mobile SDKバージョン1.6.0の時点で、WalkMe Mobile SDKはCampaign Callbacksをサポートしています。

コールバックはWalkMeキャンペーンイベントに登録するアプリをプログラム的な方法です。 Campaign Callbacksインターフェイスを実装することで、アプリケーションはコールバックオブジェクトを介して転送されたデータ（Campaignおよびユーザー情報を含む）を使用し、その情報をWalkMeとは関係のない任意の分析またはCRMシステムに渡すなど、アプリケーションの目的に使用できます。または、キャンペーンとのユーザーのやり取りに応じて、アプリまたはユーザー設定を更新します。

ユースケース

Campaign Callbacksは、以下のとおりです：

• オンボーディングを任意の分析システムから追跡する
• WalkMe Shoutoutを使用したユーザーエンゲージメントに基づいてCRMで機会を創出する（「無料デモに興味がありますか？ はい/いいえ」
• サポートシステムと統合して、WalkThruの使用/完了をサポートトップのトピックと比較する

以下は、Campaign Callbacksを実装するために必要なすべての手順の説明です。

Campaign Callbacksの使用

Campaign Callbacksに登録するには、まずこのプロトコルを実装します：

/**
 * Interface definition for a callback to be invoked in Campaign actions.
 */
@protocol WMCampaignInfoDelegate <NSObject>

/**
 * Called after campaign was dismissed.
 *
 * @param campaignInfo The dismissed campaign info.
 */
- (void)campaignDidDismiss:(WMCampaignInfo *)campaignInfo;

@end

プロトコルを実装したら、メソsetCampaignInfoDelegateッドを使用してCampaign Callbacksイベントに登録する：

/**
 * Register a delegate to campaign events
 *
 *@param delegate The delegate
 *
 */
+ (void)setCampaignInfoDelegate:(id<WMCampaignInfoDelegate>)delegate;

コールバック戻りオブジェクトはWMCampaignInfo、次の情報を含むクラスです：

@interface WMCampaignInfo : NSObject

@property (nonatomic,strong) NSString* campaginCta;
@property (nonatomic,strong) NSString* campaignCtaId;
@property (nonatomic,strong) NSString* campaignId;
@property (nonatomic,strong) WMUserData* userData;
@property (nonatomic,strong) NSDictionary* campaignData;

@end

前述のように、には、次に説明するWMUserDataオブジェクトが含まれますWMCampaignInfo：

これはオブWMUserDataジェクトの構造です：

@interface WMUserData : NSObject

/** 
* User Attributes in current session.
*/
@property (nonatomic,strong) NSDictionary *userAttributes;

/**
* Private User Attributes in current session.
*/
@property (nonatomic,strong) NSDictionary *privateUserAttributes;

/**
 * User Session Duration in second.
 */
@property (nonatomic,strong)  NSNumber* sessionDuration;

/**
 * User's iOS version
 */
@property (nonatomic,strong)  NSString* systemVersion;

/**
 * Device Unique ID
 */
@property (nonatomic,strong)  NSString* deviceId;

/**
 * Device Model.
 */
@property (nonatomic,strong)  NSString* deviceModel;

/**
 * Device Orientation PRT_REG / LSL.
 */
@property (nonatomic,strong)  NSString* deviceOrientation;

/**
 * The application version.
 */
@property (nonatomic,strong)  NSString* appVersion;

/**
 * The application name.
 */
@property (nonatomic,strong)  NSString* appName;

/**
 * Locale language for user's device.
 */
@property (nonatomic,strong)  NSString* locale;

/**
 * WalkMe SDK version.
 */
@property (nonatomic,strong)  NSString* sdkVer;

/**
 * Session unique id.
 */
@property (nonatomic,strong)  NSString* sessionId;

/**
 * If Push notification approved for user.
 */
@property (nonatomic,strong)  NSString* isPushEnabled;

/**
 * User device timezone.
 */
@property (nonatomic,strong)  NSString* timezone;

/**
 * User current network ( WIFI / 3G ).
 */
@property (nonatomic,strong)  NSString* network;

/**
 * User OS System Name.
 */
@property (nonatomic,strong)  NSString* systemName;

/**
 * Current Timestamp for this User.
 */
@property (nonatomic,strong)  NSString* timestamp;

@end