APIリファレンス 最終更新日 Thu, Nov 12, 2015
Edit on GitHubVersion 1.2.7
Growthbeat API
Growthbeatインスタンスの取得
Growthbeatインスタンスを取得します。
+ (instancetype)sharedInstance;
初期化
Growthbeatの初期化を行います。初期化では以下の処理が行われます。
- デバイス登録、認証
- Growth Push、Growth Analytics、Growth Messageの初期化(Growth Linkは別途初期化が必要)
- 基本情報の送信
- (void)initializeWithApplicationId:(NSString *)applicationId credentialId:(NSString *)credentialId;
パラメータ
項目名 | 詳細 |
---|---|
applicationId | アプリケーションID |
credentialId | クレデンシャルキー |
- (void)initializeWithApplicationId:(NSString *)applicationId credentialId:(NSString *)credentialId adInfoEnable:(BOOL)adInfoEnable;
パラメータ
項目名 | 詳細 |
---|---|
applicationId | アプリケーションID |
credentialId | クレデンシャルキー |
adInfoEnabled | 広告情報の送信設定。YES : 送信する NO :送信しない |
起動イベントの送信
アプリケーションの起動イベントを送信します。
- (void)start;
終了イベントの送信
アプリケーションの起動イベントを送信します。
- (void)stop;
ログの停止
Growthbeat SDKからのログ出力を全て停止します。 デフォルトでは、ログ出力がおこなわれます。
- (void) setLoggerSilent:(BOOL silent);
パラメータ
項目名 | 詳細 |
---|---|
silent | ログ出力を行うか。YES : ログ出力しない NO :ログ出力をする |
GrowthbeatユニークIDを取得する
SDK初期化時に作成される、GrowthbeatのユニークIDを取得できます。
- (void)getClient:(void(^)(GBClient *client))callback;
IntentHandlerを追加する。
[[GrowthbeatCore sharedInstance] addIntentHandler:[[GBCustomIntentHandler alloc] initWithBlock:^BOOL(GBCustomIntent *customIntent) {
NSDictionary *extra = customIntent.extra;
NSLog(@"extra: %@", extra);
return YES;
}]];
Growth Analytics API
GrowthAnalyticsインスタンスの取得
GrowthAnalyticsインスタンスを取得します。
+ (instancetype)sharedInstance;
基本タグの送信
端末の基本情報を送信します。基本情報には以下が含まれます。
- デバイスモデル
- OS
- 言語
- タイムゾーン
- タイムゾーンオフセット
- アプリバージョン
- 広告ID(Android:AdvertisingId, iOS:IDFA)
- 広告利用可否
- (void)setBasicTags;
特定のイベントを送信
起動イベント
ユーザーの起動イベントを送信します。セッション時間の計測を開始するために必要なメソッドです。
- (void)open;
終了イベント
アプリの終了イベントを送信します。セッション時間の計測を停止します。
- (void)close;
購入イベント
課金時にメソッドを呼び、課金額、アイテムのカテゴリなどを送信することができます。
- (void)purchase:(int)price setCategory:(NSString *)category setProduct:(NSString *)product;
パラメータ
項目名 | 詳細 |
---|---|
price | 価格 |
category | 任意のカテゴリ |
product | 任意のアイテム名 |
特定のタグを送信
ユーザーIDタグ
アプリのユニークなユーザーIDを送信します。
- (void)setUserId:(NSString *)userId;
パラメータ
項目名 | 詳細 |
---|---|
userId | 任意のユニークなユーザー名 |
名前タグ
アプリのユーザー名を送信します。
- (void)setName:(NSString *)name;
パラメータ
項目名 | 詳細 |
---|---|
name | 任意のユーザー名 |
年齢タグ
アプリのユーザーの年齢を送信します。
- (void)setAge:(int)age;
パラメータ
項目名 | 詳細 |
---|---|
age | ユーザーの年齢 |
性別タグ
変数は、GAGenderを用いてどちらか性別を送信してください。
- (void)setGender:(GAGender)gender;
パラメータ
項目名 | 詳細 |
---|---|
gender | 男性: GAGenderMale 女性: GAGenderFemale |
レベルタグ
アプリのユーザーのレベルを送信します。
- (void)setLevel:(int)level;
パラメータ
項目名 | 詳細 |
---|---|
level | ユーザーのレベル |
開発用タグ
開発用のフラグををつけます。
- (void)setDevelopment:(BOOL)development;
パラメータ
項目名 | 詳細 |
---|---|
development | 開発用の場合は YES |
乱数タグ
乱数を端末の情報として紐付けます。
- (void)setRandom;
カスタムイベント送信
イベントの送信
- (void)track:(NSString *)name;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Event:<YOUR_APPLICATION_ID>:Custom:<CUSTOM_EVENT_ID> YOUR_APPLICATION_ID : ApplicationID CUSTOM_EVENT_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
イベント名と任意のMapの送信
- (void)track:(NSString *)name properties:(NSDictionary *)properties;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Event:<YOUR_APPLICATION_ID>:Custom:<CUSTOM_EVENT_ID> YOUR_APPLICATION_ID : ApplicationID CUSTOM_EVENT_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
properties | カスタムイベントに持たせる任意のMap |
イベント名とイベント取得回数オプションの送信
- (void)track:(NSString *)name option:(GATrackOption)option;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Event:<YOUR_APPLICATION_ID>:Custom:<CUSTOM_EVENT_ID> YOUR_APPLICATION_ID : ApplicationID CUSTOM_EVENT_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
option | GATrackOptionDefault, GATrackOptionOnce, GATrackOptionCounterのいずれかを指定します。 |
option
項目名 | 詳細 |
---|---|
GATrackOptionDefault | デフォルト値。特に何もしません。 |
GATrackOptionOnce | このオプションを指定した場合、このイベントは最初の1度しか取得されません。(例えば、インストールイベントなどで使用します。) |
GATrackOptionCounter | このオプションを指定した場合、自動でcounterといプロパティが付与され、イベントを呼び出した回数をインクリメントして保持していきます。 |
イベント名と任意のMapの送信とイベント取得回数オプションの送信
- (void)track:(NSString *)name properties:(NSDictionary *)properties option:(GATrackOption)option;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Event:<YOUR_APPLICATION_ID>:Custom:<CUSTOM_EVENT_ID> YOUR_APPLICATION_ID : ApplicationID CUSTOM_EVENT_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
properties | カスタムイベントに持たせる任意のMap |
option | GATrackOptionDefault, GATrackOptionOnce, GATrackOptionCounterのいずれかを指定します。 |
option
項目名 | 詳細 |
---|---|
GATrackOptionDefault | デフォルト値。特に何もしません。 |
GATrackOptionOnce | このオプションを指定した場合、このイベントは最初の1度しか取得されません。(例えば、インストールイベントなどで使用します。) |
GATrackOptionCounter | このオプションを指定した場合、自動でcounterといプロパティが付与され、イベントを呼び出した回数をインクリメントして保持していきます。 |
カスタムタグ送信
タグの送信
- (void)tag:(NSString *)name;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Tag:<YOUR_APPLICATION_ID>:Custom:<LAST_ID> YOUR_APPLICATION_ID : ApplicationID LAST_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
タグと任意の値を送信
- (void)tag:(NSString *)name value:(NSString *)value;
パラメータ
項目名 | 詳細 |
---|---|
name | フォーマット:Tag:<YOUR_APPLICATION_ID>:Custom:<LAST_ID> YOUR_APPLICATION_ID : ApplicationID LAST_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
value | カスタムタグに持たせる任意のValue |
フルカスタマイズなイベントの送信
特定のネームスペース、イベントIDを設定していただくことが可能です。
- (void)track:(NSString *)_namespace name:(NSString *)name properties:(NSDictionary *)properties option:(GATrackOption)option completion:(void(^)(GAClientEvent * clientEvent))completion;
パラメータ
項目名 | 詳細 |
---|---|
_namespace | ネームスペース |
name | フォーマット:Event:<YOUR_APPLICATION_ID>:Custom:<CUSTOM_EVENT_ID> YOUR_APPLICATION_ID : ApplicationID CUSTOM_EVENT_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
properties | イベントに持たせる任意のMap |
option | GATrackOptionDefault, GATrackOptionOnce, GATrackOptionCounterのいずれかを指定します。 |
completion | イベント作成後のコールバック |
option
項目名 | 詳細 |
---|---|
GATrackOptionDefault | デフォルト値。特に何もしません。 |
GATrackOptionOnce | このオプションを指定した場合、このイベントは最初の1度しか取得されません。(例えば、インストールイベントなどで使用します。) |
GATrackOptionCounter | このオプションを指定した場合、自動でcounterといプロパティが付与され、イベントを呼び出した回数をインクリメントして保持していきます。 |
フルカスタマイズなタグの送信
特定のネームスペース、タグIDを設定していただくことが可能です。
- (void)tag:(NSString *)_namespace name:(NSString *)name value:(NSString *)value completion:(void(^)(GAClientTag * clientTag))completion;
パラメータ
項目名 | 詳細 |
---|---|
_namespace | ネームスペース |
name | フォーマット:Tag:<YOUR_APPLICATION_ID>:Custom:<LAST_ID> YOUR_APPLICATION_ID : ApplicationID LAST_ID : 英数字[a-zA-Z0-9]で任意の識別子を指定してください |
value | タグに持たせる任意のValue |
completion | タグ作成後のコールバック |
Growth Push API
GrowthPushインスタンスの取得
GrowthPushインスタンスを取得します。
+ (instancetype)sharedInstance;
デバイストークンの取得・送信
デバイストークンの取得
- (void)requestDeviceTokenWithEnvironment:(GPEnvironment)newEnvironment;
このメソッドを実行すると、アプリ初回起動時に、プッシュ通知の許可ダイアログが表示されます。
デバイストークンの送信
- (void)setDeviceToken:(id)deviceToken;
AppDelegateクラス
- (void) application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
のメソッドで上記を必ず実装してください。
プッシュ通知の有効・無効を判定
- (BOOL)enableNotification;
基本タグの送信
Device, OS, Language, Time Zone, Version, Buildが含まれます。
- (void)setDeviceTags;
イベントの送信(Push専用)
イベントの送信(Push専用)
- (void)trackEvent:(NSString *)name;
パラメータ
項目名 | 詳細 |
---|---|
name | イベント名 |
イベントと任意の値の送信(Push専用)
- (void)trackEvent:(NSString *)name value:(NSString *)value;
パラメータ
項目名 | 詳細 |
---|---|
name | イベント名 |
value | イベントに持たせる値 |
タグの送信(Push専用)
タグの送信(Push専用)
- (void)setTag:(NSString *)name;
パラメータ
項目名 | 詳細 |
---|---|
name | タグ名 |
タグと任意の値の送信(Push専用)
- (void)setTag:(NSString *)name value:(NSString *)value;
パラメータ
項目名 | 詳細 |
---|---|
name | タグ名 |
value | タグに持たせる値 |
バッチクリア
配信時に、バッチにチェックマークを付けた場合、バッチをクリアするためのメソッドです。 iOSのみ利用できます。
- (void)clearBadge;
Growth Message API
GrowthMessageインスタンスの取得
GrowthMessageインスタンスを取得します。
+ (instancetype)sharedInstance;
Growth Link API
GrowthLinkインスタンスの取得
GrowthLinkインスタンスを取得します。
+ (instancetype)sharedInstance;
Growth Linkの初期化
Growthbeatへデバイス登録・認証を行います。
- (void)initializeWithApplicationId:(NSString *)applicationId APPLICATION_ID:(NSString *)credentialId;
パラメータ
項目名 | 詳細 |
---|---|
applicationId | アプリケーションID |
credentialId | クレデンシャルキー |