ユーザー招待の計測

ユーザー招待の計測は無料で全てのアカウントプランでご利用いただけます。

ユーザー招待の計測についての概要

ユーザー招待の計測はどのように役立ちますか？

• 最もよくアプリを紹介するユーザーの情報を取得しましょう：
  友達にアプリを紹介するユーザーは、価値が高いユーザーです。これらのユーザーを保持、リターゲティング、インセンティブを付与するのが効果的です。
• 紹介したユーザー情報を使用して、新規ユーザーの初めてのアプリ体験をパーソナライズできます：
  一般的なウェルカムメッセージに代わり、パーソナライズされたメッセージを作成して新規ユーザーをさらに引き付けましょう。例：「さとしさん、ようこそ！チュートリアルを完了したら、お友達のよう子さんと一緒に壮大な戦いに参加しましょう！」
• ユーザー招待のコストとROIを把握して最適化しましょう：
  ユーザー招待のマーケティング費用はゼロではありません。ユーザー招待には、広告収益を生み出す可能性があるアプリ広告の「土地」が使用されます。他の方法と比較して、ユーザー招待のほうがROIが向上しますか？これはケースバイケースで、向上する場合も、そうでない場合もあります。

AppsFlyerのコストパラメーターを使用して、代替案に基づいてユーザー招待インストールにコストを割り当てることができます。

収益レポートのアプリ内イベントと組み合わせると、どのユーザー招待キャンペーンがどういった結果をもたらし、どの招待チャネルが目的に最適であるかを確認できます。

ユーザー招待の計測はどのように行われますか？

招待リンクに紐づくインストールは、管理画面のメディアソース af_app_invites下に表示されます。

招待の送信に使用されるチャネル（メール、SMS、Facebookなど）は、メディアソース af_app_invites下のChannelグループの下に表示されます。

メディアソース 'af_app_invites' を選択し、チャネル別にグループ化すると、GmailとFacebookを経由したユーザー招待からのクリックとインストールが表示されます。

ディベロッパー向けガイド

OneLinkの設定

招待の計測はOneLinkを使用して、招待されたユーザーを関連するアプリストアにリダイレクトします。OneLinkでは、ディファードディープリンクを使用することもできます。ディファードディープリンクは、ユーザーがアプリを起動したときにアプリ内の特定のアクティビティを開きます。また、カスタマイズされたコンテンツを設定して、招待後のインストールのコンテキストでユーザーのリテンションを維持します。

アプリにOneLinkを正しく設定してください。

• OneLinkのリダイレクトを設定してください。
• ディファードディープリンク実装ガイドを参照してください。ディファードディープリンクを設定すると、プログラムでユーザーを特定のアクティビティに遷移されたり、招待した／されたユーザーへ報酬を与えたりするために必要なデータを取得できます。
• [オプション] OneLinkディープリンクを設定してください。OneLinkディープリンクを設定する必要はありませんが、特定のシナリオで役立つ場合があります。
  例：
  • ユーザーが友だちを招待してアプリをインストールするキャンペーンを設定します。どちらもアプリで使用するクレジットポイントを獲得できます。招待者がアプリをインストールすると、招待したユーザは50クレジットポイント、招待されたユーザは100クレジットポイントを獲得します。招待されたユーザが既にアプリをインストールしている場合、招待したユーザは25クレジットポイント、招待されたユーザは50クレジットポイントを獲得します。2つのケースを区別するには、最初のディファードディープリンクと2番目のディープリンクを使用します。

OneLinkが正常に設定されたら、関連するOneLink IDを取得します。

アプリで start を呼び出す前に、OneLink ID（以下の例では OPSz）に基づいて呼び出されるOneLinkを設定します。

AppsFlyerLib.getInstance().setAppInviteOneLink("ymod");

[AppsFlyerLib shared].appInviteOneLinkID = @"ymod";

AppsFlyerLib.shared().appInviteOneLinkID = "ymod"

AppsFlyer.setAppInviteOneLinkID("ymod");

リンクの生成

Androidでは、次のライブラリを必ずインポートしてください。

import com.appsflyer.share.ShareInviteHelper;
import com.appsflyer.share.LinkGenerator;

LinkGeneratorクラスは、クリックで追加情報を渡すことができるさまざまなセッターメソッドに従って招待URLを作成します。この情報は、新規ユーザーが招待に同意しアプリをインストールした際に、onConversionDataSuccess を介して利用できます。さらに、キャンペーンとチャネルのパラメーターはAppsFlyer管理画面に表示されます。

SDKが生成する招待リンクのTTLは720日です。

LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(MainActivity.this);
linkGenerator.setChannel("Gmail");
linkGenerator.addParameter("af_cost_value","2.5");
linkGenerator.addParameter("af_cost_currency","USD");
// optional - set a brand domain to the user invite link
linkGenerator.setBrandDomain("brand.domain.com");
CreateOneLinkHttpTask.ResponseListener listener = new CreateOneLinkHttpTask.ResponseListener() {
	@Override
	public void onResponse(String s) {
		Log.d("Invite Link", s);
    // write logic to let user share the invite link
	}

	@Override
	public void onResponseError(String s) {
		// handle response error
	}
};
linkGenerator.generateLink(MainActivity.this, listener);

[AppsFlyerShareInviteHelper generateInviteUrlWithLinkGenerator:^AppsFlyerLinkGenerator * _Nonnull(AppsFlyerLinkGenerator * _Nonnull generator) {
   [generator setChannel:@"channel_name"];
   [generator setReferrerName:@"referrer_name"];
   [generator addParameterValue:@"2.5" forKey: @"af_cost_value"];
   // optional - set a brand domain to the user invite link
   [generator setBrandDomain:@"brand.domain.com"];
   return generator;
 } completionHandler:^(NSURL * _Nullable url) {
   NSLog(@"%@", url);
   // write logic to let the user share the invite link
 }];

AppsFlyerShareInviteHelper.generateInviteUrl(linkGenerator:
 {(_ generator: AppsFlyerLinkGenerator) -> AppsFlyerLinkGenerator in
  generator.setChannel("channel_name") 
  generator.setReferrerName("referrer_name")
  generator.addParameterValue("2.5", forKey: "af_cost_value") 
  // optional - set a brand domain to the user invite link
	generator.brandDomain = "brand.domain.com"
  return generator }, 
completionHandler: {(_ url: URL?) -> Void in // write logic to let the user share the invite link })

Dictionary<string,string> inviteDicionary = new Dictionary<string,string>();
inviteDicionary.Add("channel","channel_name");
inviteDicionary.Add("referrerName","referrer_name");

AppsFlyer.generateUserInviteLink(inviteDicionary, "customCallbackObject", "onSuccessMethodName", "onFailedMethodName");

Dictionary<string,string> inviteDicionary = new Dictionary<string,string>();
inviteDicionary.Add("channel","channel_name");
inviteDicionary.Add("referrerName","referrer_name");

AppsFlyer.generateUserInviteLink(inviteDicionary,null, null, null);
// Any value can be set instead of null, but the iOS callback will always 
//return to the AppsFlyerTrackerCallbacks object -> onInviteLinkGenerated callback method.

全てのリンクジェネレータセッター

送信者の招待を記録する

送信者の観点から招待を記録するために、招待が送信された後にアプリ内イベントを生成することをお勧めします。これにより、友達を招待する傾向が最も強いユーザーと、それらのユーザーを獲得するメディアソースを見つけることができます。

通常のアプリ内イベント、または logInvite メソッドを代わりに使用できます。logInvite は、使いやすくするためにAPIにカプセル化された既製のアプリ内イベントです。

ShareInviteHelper.logInvite(context, channel, additionalParametersForTheEvent_optional);

NSDictionary *optional_params = @{@"key": @"value"};
[AppsFlyerShareInviteHelper logInvite:@"your_channel" parameters:optional_params];

招待されたユーザーのインストール後に計測データを取得する

リンクジェネレーターで渡された全てのパラメーターは、onConversionDataSuccess を呼び出すことで使用できます。これにより、関連するパラメーター（招待したユーザ名やアバターURLなど）を取得し、新規ユーザーの初回エクスペリエンスをパーソナライズできます。以下は、onConversionDataSuccess によって返された計測データの例です。

{
	"attribute": "is_first_launch" = "true"
	"attribute": "click_time" = "2019-04-04 08:33:05.668"
	"attribute": "af_referrer_customer_id" = "CUSTOMER_USER_ID"
	"attribute": "shortlink" = "12a3b456"
	"attribute": "af_referrer_uid" = "1234567890123-4567890123456789012"
	"attribute": "af_siteid" = "com.company.app"
	"attribute": "install_time" = "2019-04-04 08:33:45.286"
	"attribute": "cost_cents_USD" = "0"
	"attribute": "campaign" = "None"
	"attribute": "af_click_lookback" = "7d"
	"attribute": "orig_cost" = "0.0"
	"attribute": "af_status" = "Non-organic"
	"attribute": "iscache" = "true"
	"attribute": "media_source" = "af_app_invites"
}

コンバージョンデータの使用に関する詳細： iOS / Android

リエンゲージメント目的でのユーザー招待リンクの使用

リエンゲージメントのためにユーザー招待リンクを使用できます。ただし、招待されたユーザーがアプリをインストールしていることを確認する必要があります。アプリを持っていないユーザーがユーザー招待リンクを取得してアプリをインストールすると、クリックはリターゲティング管理画面に表示されますが、インストールはオーバービュー管理画面に表示されます。

リエンゲージメント目的でユーザー招待リンクを使用するには、パラメーター is_retargeting を追加し、addParameter メソッドを使用してこの値を true に設定します。

AppsFlyerLib.getInstance().addParameter("is_retargeting", "true");

[generator addParameterValue: @"true" forKey: @"is_retargeting"];

generator.addParameterValue("true" forKey: "is_retargeting")

inviteDictionary.Add("is_retagerting", "true");

ユーザー招待への報酬

友達を招待してアプリをインストールさせたユーザーに報酬を与えることができます。報酬を与えることで、ユーザーに友達を招待するように勧めます。これは、ユーザーベースを拡大し、収益を高めるための優れた方法です。

いつ報酬を与えるか

友達が招待された後にアプリをインストールした場合、招待したユーザーに報酬を与えることができます。また、友達がアプリ内購入など特定のアプリ内イベントを実行した場合に報酬を与えることもできます。

カスタムダッシュボードビュー

以下は、ユーザー招待の情報を示すカスタムダッシュボードの使用可能なビューです。

制限事項