どのようにお手伝いできますか?

KahunaとAppsFlyerの連携

  • 更新

概要:AppsFlyerの連携済みパートナーであるKahunaは、モバイル時代における企業の成長と発展を支援しています。 Web、メール、モバイル、ソーシャルなど、顧客が利用するさまざまなチャネルで、一人ひとりに合ったコミュニケーションを大規模に展開し、ブランドと顧客の関係を深めます。ビッグデータと機械学習を活用し、適切なメッセージを、適切なチャネルで、適切なタイミングに届けることで、すべての顧客に満足度の高い体験を提供します。

 重要

一部のメディアソースは、第三者へのデータ共有を制限しています。 そのため、制限対象のイベントのポストバックは、送信設定にかかわらず、このパートナーには送信されません。

以下の手順でKahunaとの連携を設定します。

1. AppsFlyer SDKの最低要件:

  • Android:V2.3.1.18以降
  • iOS:V3.3.3以降

2. Kahunaと連携するには、KahunaのDevice ID(Kahunaでユーザーを一意に識別するID)をAppsFlyer SDKに設定する必要があります。このパラメータはすべてのポストバックに含まれ、ユーザーの識別に使用されます。アプリのコードに、以下のコードを追加してください。

重要な注意事項

コードは、Kahuna SDKの起動後、appsflyer.sendtracking(Android)/trackAppLaunch(iOS)メソッドの呼び出し前に追加してください。

Androidの場合iOSの場合
HashMap<String, Object> customData = new HashMap<String,Object>();
String deviceId = Kahuna.getInstance().getKahunaDeviceId();
customData .put("customData", deviceId);
AppsFlyerLib.setAdditionalData(customData);

Kahunaの設定

前提条件:パートナーのアカウントが必要です。アカウントがない場合は、連携を設定する前にパートナーに連絡し、アカウントを開設してください。

新しく連携を設定するには、以下の手順を実施します。

  1. AppsFlyerで、[連携>パートナー連携>マーケットプレイス]タブに移動します。
    (既存の連携を編集する場合:[連携>パートナー連携>有効な連携]タブに移動します。)
  2. 対象のアプリを選択します。 
  3. パートナーを検索し、[連携する]を選択します。
  4. [連携]タブで、[パートナーを有効化]をオンにします。 
    注意:パートナーとの連携を利用している間は、このトグルをオン(有効)にしておく必要があります。詳しく見る
  5. 以下の説明に従い、該当するタブで設定を完了します。詳しくは、パートナー連携を参照してください。

Kahunaの設定で使用するのは、[連携]タブのみです。

連携タブ

[連携]タブは、以下のセクションで構成されています。

パートナーを有効化

初めてこの画面を開いたときは、下にあるトグルをオンにする必要があります。[パートナーを有効化]をオンにすると、[連携]タブのパラメータを設定できるようになります。パートナーとの連携を利用している間は、このトグルをオンにしておく必要があります。
パートナーの有効化について詳しくは、こちらを参照してください。

一般設定

Kahunaのシークレットキー、ステージング環境、本番環境

KahunaとAppsFlyerの接続には、固有のシークレットキーを使用します。まだ取得していない場合は、連携の設定を進める前にKahunaから取得するか、以下の手順で取得してください。

Kahunaのシークレットキーの取得

1. Kahunaアカウントにログインします。

2. 管理画面の右上にあるユーザーアイコンをクリックし、Settingsを選択します。

3. Kahunaのシークレットキーをコピーします。

4. APIs & Integrationsを選択します。このページでパラメータを確認できます。

  • Kahunaコンソールから取得したKahuna Master Keyを入力します(セクション3を参照)。
  • Kahunaのサンドボックス環境にイベントを送信する場合は、Staging欄にSと入力します(「Kahunaのサンドボックスでのテスト」を参照)。
  • 本番環境を使用する場合は、production欄にPと入力します。
  • 両方を入力した場合は、本番環境にイベントが送信されます。
  • [保存]をクリックします。

デフォルトポストバック

AppsFlyerは、ユーザーのインストール後にKahunaへポストバックを自動送信できます。このセクションで、ポストバックの送信を設定します。

Swrve_msc_new_4.png

アプリをダウンロードしたすべてのユーザーのポストバックをKahunaに送信するには、[すべてのパートナーまたはオーガニックのイベント]を選択します。

[保存]をクリックします。

設定を保存すると、AppsFlyerは、オーガニックと非オーガニックの各インストールについて、以下のデータをKahunaに送信します。

  • Kahuna Dev_ID
  • メディアソース
  • 国コード
  • OSバージョン

計測リンクタブ

Kahunaでは、計測リンクは利用できません。

コストタブ

このパートナーとの連携では、コストデータには対応していません。

広告収益タブ

このパートナーとの連携では、広告収益データには対応していません。

権限タブ

Kahunaでは、権限の設定は利用できません。

Kahunaでユーザーのアトリビューションデータを確認する

インストールイベントは、KahunaのメインダッシュボードでNewbiesとして確認できます。

特定のユーザーを検索するか、左側のナビゲーションからTop Peopleに移動します。

ユーザーを選択するとMini Profileが開き、Top Eventsセクションにインストールイベント「af_install」が表示されます。

サンドボックスでのテスト

アプリをまだアプリストアで公開しておらず、Kahunaのサンドボックス環境で連携をテストしたい場合は、次の手順に従ってください。

1. AppsFlyerでKahunaを設定する際に、Stagingのテキストボックスに「s」と入力してください。

2. 前述の手順に従い、AppsFlyer SDKとKahuna SDKを連携するコードをアプリに追加したことを確認します。

3. テストデバイスの広告IDを取得します。デバイスにアプリをインストールし、ログを確認すると取得できます。

4. 広告IDを許可リストに登録するよう、AppsFlyerに依頼します。

5. デバイスからアプリをアンインストールします。

6. 以下のURLに、アプリのパッケージ名、広告ID、キャンペーン名などの情報を設定します。角括弧は含めないでください。https://app.appsflyer.com/[APP PACKAGE NAME]?pid=[SOMETHING]&advertising_id=[DEVICE’S ADVERTISING ID]

7. URLにアクセスすると、以下のような画面が表示される場合があります。

8. デバイスにアプリをインストールします。

9. Kahuna管理画面でユーザーを検索します。Kahunaのデバッグを有効にしてログを確認すると、そのユーザーのKahuna固有のデバイスIDである 「dev_id」を取得できます。また、アプリでログインが必要で、認証情報をKahunaに渡している場合は、その情報でも検索できます。ユーザーが見つかったら、そのユーザーの「af_install」イベントが表示されていることを確認します。