Singular iOS SDK | |
---|---|
ダウンロード | Singular iOS SDK version 9.2.8 |
互換性 | iOS 8+ |
サンプルアプリ | Review our sample app for an example of a complete SDK integration based on best practices. |
実装ガイド |
イベントトラッキング
キャンペーン成果の分析、KPI測定を行う為に、Singularを通じてアプリ内のイベントデータを収集する事が可能です。
例えば、ゲームアプリではユーザーログイン、会員登録、チュートリアル完了、レベルアップのようなデータを取集を望む場合もあります。
この場合、eventやeventWithArgsメソッドを使用しSingularにアプリ内イベントを送る事も可能です。
注意:
- 第三者パートナー及び外部分析ソリューションとの互換性の為にイベント名と属性には英語をご利用ください。
- イベント名は32文字以下のASCIIキャラクターにて制限されます。ASCIIキャラクターでは無い文字列はUTF-8に変換された場合に32 byte未満である必要があります。
- 属性の様な値は500字以下のASCIIキャラクターにて制限されます。
event メソッド |
|
---|---|
定義 | トラッキングの為にイベントを追加情報なしにSingularに転送 |
メソッド | +(void)event:(NSString *)name |
使用例 |
Objective-C:
Swift (requires bridging header):
|
eventWithArgs メソッド |
|
定義 | Send a user event to Singular for tracking, with additional information. |
メソッド | +(void)eventWithArgs:(NSString *)name, ... |
使用例 |
Objective-C:
Swift (requires bridging header):
|
event メソッド (NSDictionary 形式のアーギュメント含む) |
|
定義 | NSDictionary オブジェクト追加情報を含めイベントをSingularに転送 |
メソッド | + (void) event:(NSString *)name withArgs:(NSDictionary *)args; |
使用例 |
Objective-C:
|
収益トラッキング
キャンペーン成果及びROIを分析する為にSingularを通じてアプリ内の収益データを取集する事が可能です。取集する際にはSingularのレポート、ログ抽出、ポストバックを通じて該当データを確認出来ます。
Singularに収益イベントを送る際には iapComplete SDK メソッド使用をおすすめしており、この場合、Appleのアプリ内購入であるIAP収益イベントをSingularに送ります。ここには下記二つの項目が含まれます。
- 全てのトランザクション詳細事項: Singularがより詳細なレポートを提供する為に必要な様々な情報が含まれます。
- トランザクションレシート: Singularがバックエンドにて購入を検証する際に活用しフラウド防止にも使用可能です。
注意: 収益を様々な異なる通貨単位で送る場合にもデータの確認しにはSingularのアカウントに設定したお客様の通貨単位にて自動変換され表示されます。
iapComplete メソッド |
|
---|---|
定義 | トランザクションレシートを含みSingularに収益イベント転送 |
メソッド | (void)iapComplete:(id)transaction (void)iapComplete:(id)transaction withName:(NSString *)name; |
使用例 |
Objective-C:
|
他の方式にて収益イベントを転送
前に述べたiapCompleteにて収益イベントを転送する事がおすすめされるか、他の方式にて収益イベントを転送した場合、revenue又はcustomRevenueを使用する事も可能です。
次に説明するメソッドを使用する場合、トランザクション金額と通貨単位を手動で特定出来、詳細事項も選択的に転送出来ます。 customRevenueを使用するとカスタム収益イベント名も指定可能です。
但し、二つのメソッドともトランザクションレシートを転送しない為、Singularにてトランザクションを検証する事が出来ません。
revenue メソッド |
|
---|---|
定義 | 金額と通貨単位及び詳細情報を含めSingularに収益イベントを転送 |
メソッド | (void)revenue:(NSString *)currency amount:(double)amount; (void)revenue:(NSString *)currency amount:(double)amount productSKU:(NSString *)productSKU productName:(NSString *)productName productCategory:(NSString *)productCategory productQuantity:(int)productQuantity productPrice:(double)productPrice; 注意: 通貨(currency)は3文字となっているISO 4217通貨コードを使用します。例: “USD”, “EUR”, “JPY” |
Usage Example |
Objective-C:
|
customRevenue メソッド |
|
定義 | 金額と通貨単位及び詳細情報を含めてSingularにカスタム名にて収益イベントを転送 |
メソッド | (void)customRevenue:(NSString *)eventName currency:(NSString *)currency amount:(double)amount; (void)customRevenue:(NSString *)eventName currency:(NSString *)currency amount:(double)amount productSKU:(NSString *)productSKU productName:(NSString *)productName productCategory:(NSString *)productCategory productQuantity:(int)productQuantity productPrice:(double)productPrice; 注意: 通貨(currency)は3文字となっているISO 4217通貨コードを使用します。例: “USD”, “EUR”, “JPY” |
Usage Example |
Objective-C:
|