ドキュメント
短いリファラーリンクの作成
注：この機能はSDKバージョン11.0.8以降で利用可能です。
createReferrerShortLinkメソッドを使用して、ユーザーが友達とアプリを共有するための短縮共有リンクを生成します。リンクの作成時に、アプリのコードで参照元ユーザーの詳細を定義します。これにより、レポートでリファラーの属性を追跡できます。
短いリンクを作成するには
- 定義されたディープリンクを使用して、アプリのダウンロードにつながるSingular Custom Source Linkを構築します（Singular Links FAQを参照してください）。このリンクは、以下のコードでベースリンクと呼ばれます。
- リンクに動的に追加する任意のキャンペーンオーバーライドパラメータ（オプションのリストについては、トラッキングリンクパラメータを参照してください）。
- リンクを共有したユーザーをさかのぼって新規アプリのインストールを追跡するための、参照元ユーザーの名前とID。
以下の例のように、createReferrerShortLinkメソッドを使用してショートリンクを生成します。
| createReferrerShortLink メソッド |
| 説明 |
createReferrerShortLinkメソッドを使用して、ユーザーがアプリを友人と共有するための短縮共有リンクを生成します。 |
| シグネチャ |
(void)createReferrerShortLink:(NSString *)baseLink referrerName:(NSString *)referrerName referrerId:(NSString *)referrerId passthroughParams:(NSDictionary *)passthroughParams completionHandler:(void(^)(NSString *, NSError *))completionHandler； |
| 使用例 |
// 1. Define variables for the referrer short link
// Define your Singular tracking link to be used as a base link:
let referrerBaseLink = "https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3";
// Add your Referrer ID and Name
let referrerID = referrerIDField.text;
let referrerName = referrerNameField.text;
// Customize any Passthrough Parameters
let passthroughParams = ["channel": "sms"]
// 2. Call ReferrerShortLink to get your shortlink to share on social media
Singular.createReferrerShortLink(referrerBaseLink,
referrerName: referrerName,
referrerId: referrerID,
passthroughParams: passthroughParams,
completionHandler: {(shortLink, error) in
if error != nil {
// Logic to retry/abort/modify the params passed to the function,
// based on the cause of the error
}
if (shortLink != nil || shortLink != "") {
// Add your share logic here:
//...
}
})
// 1. Define variables for the referrer short link
// Define your Singular tracking link to be used as a base link.
// Include any override parameters in the string as query string parameters.
NSString* referrerBaseLink = @"https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3";
// Add your Referrer ID and Name
NSString* referrerID = self.referrerIDField.text;
NSString* referrerName = self.referrerNameField.text;
// Customize any Passthrough Parameters
NSDictionary* passthroughParams = @{@"channel": @"sms"};
// 2. Call the ReferrerShortLink Method to get the shortlink to share on social media
[Singular createReferrerShortLink:referrerBaseLink
referrerName:referrerName
referrerId:referrerID
passthroughParams:passthroughParams
completionHandler:^(NSString *shortLink, NSError *error) {
if (error) {
// Logic to retry/abort/modify the params passed to the function,
// based on the cause of the error
}
if (shortLink) {
// Add your share logic here:
//...
}
}
];
|
