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

AppsFlyerとの単一連携。

  • 更新

概要: 

iterable-af-logo.png

はじめに

ESP (Email Service Providers) は、セグメント化されたユーザートラフィックを獲得するための有効な手段です。

ESPは、独自のESPクリック記録ドメインでディープリンクURLを加工します。

前提条件

iOS Android
  • AppsFlyer iOS SDK バージョン 4.9.0 

ステップ1:

 

ステップ2:

ステップ2:

AASA (iOS)

ResponsysでiOSユニバーサルリンクをサポートするには、AASAファイルが必要です。次の手順をご参照ください。

ユニバーサルリンクでOneLinkを設定すると、OneLinkにAASAが関連付けられます。AASA を入手するには:

  1. OneLink URLの末尾に/.well-known/apple-app-site-associationを追加します。
  2. OneLinkをブラウザのアドレスバーに貼り付けて、Enterを押します。例: <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association.これを行うと、AASAファイルがコンピューターにダウンロードされます。シンプルテキストエディタを使用して開くことができます。
  3. 詳細はこちらを参照してください。
  4. このファイルの詳細と内容の詳細については、こちらのガイドを参照してください。

Android 用アセットリンク

アプリリンクでOneLinkを設定すると、OneLinkに関連付けられたアセットリンクファイルがすでにある状態になります。取得するには:

  1. OneLink URLの末尾に/.well-known/assetlinks.json を追加します。
  2. OneLinkをブラウザのアドレスバーに貼り付けて、Enterを押します。例: <OneLinkSubdomain>.onelink.me/.well-known/assetlinks.json.これを行うと、Asset Linksファイルがコンピューターにダウンロードされます。シンプルテキストエディタを使用して開くことができます。
  3. このファイルの詳細と内容の詳細については、こちらのガイドを参照してください。

アプリのセットアップ

ステップ1:Androidマニフェストのアクティビティにクリックドメインを追加します

Androidマニフェストで、ディープリンク先のアクティビティのアクティビティタグにクリックドメインホストとプレフィックスを追加します。

<activity android:name=".DeepLinkActivity">
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

ステップ2: クリックドメインを解決するアプリの設定

SDKは、キャンペーン詳細を取得するために、クリックドメインの背後にあるOneLinkを解決する必要があります。

クリックドメインを解決するには:

  1. SDK のバージョンが 4.9.0 以上であることを確認してください。
  2. このAPIを、SDK初期化の前に呼び出す必要があります。
     
    AppsFlyerLib.getInstance().setResolveDeepLinkURLs("click.example.com");

このセクションでは、ユニバーサルリンクをサポートするアプリの設定方法について説明します。

ステップ1:Xcodeでのクリックドメインの関連付け

  1. Xcodeでプロジェクトをクリックします。
  2. Associated Domain(関連付ドメイン)をオンにします。
  3. [+] 記号をクリックし、クリックドメインを追加します。例:applinks:click.example.com.

SDKは、キャンペーン詳細を取得するために、クリックドメインの背後にあるOneLinkを解決する必要があります。

クリックドメインを解決するには:

  1. SDK のバージョンが 4.9.0 以上であることを確認してください。
  2. このプロパティはSDK初期化前に設定する必要があります。
     
    AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");
    

SDKは、キャンペーン詳細を取得するために、クリックドメインの背後にあるOneLinkを解決する必要があります。

クリックドメインを解決するには:

  1. SDK のバージョンが 4.9.0 以上であることを確認してください。
  2. このプロパティはSDK初期化前に設定する必要があります。
     
    Objective-C Swift
    [AppsFlyerLib shared].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];
  3. 次のコードを追加して、SDK がクリック記録ドメインを解決できるようにします:
     
    Objective-C Swift

    このコードをAppDelgate.swiftに追加します

    - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
        if ([URL.host  isEqual: @"click.example.com"]) {
            return [NSDictionary dictionary];
        }
        else {
            return nil;
        }
    }

最初のEメールの送信

  1. リンク管理ページにて(または手動で)OneLink URLを作成してください。
  2. OneLink URLを作成する際は、必ずすべてのパラメータ値をURLエンコードしてください。
  3. 次のパラメータを使用することを強く推奨します:
    • pid (メディアソース) - メディアソースを示す値を設定してください(例:Email)。
    • c (キャンペーン) - 測定するキャンペーンの名前。
    • af_dp - ユーザーをディープリンクで遷移させたいディープリンクURIスキーム。
    • af_web_dp:デスクトップでクリックしたユーザーをリダイレクトしたい場所。
    • af_ios_url - iOS デバイスのリンクをクリックしてアプリを持っていないユーザーをリダイレクトする場所。
    • af_android_url - Android デバイスのリンクをクリックしてアプリを持っていないユーザーをリダイレクトする場所。
  4. Responsysで作成したメールにOneLink URLを配置します。例:

    <a href="greatapp.onelink.me/abcd/1234567">Download my great app!</a>

    この段階で、Responsysは前のステップで設定したクリックドメインで上記リンクをラップします。クリックドメインをクリックすると、OneLink計測リンクにリダイレクトされます。アプリがユーザーのデバイスにインストールされている場合、クリックドメインはアプリにディープリンクします。

例

この例では、読みやすくするために、URLパラメータはURLエンコードされていません。

https://greatapp.onelink.me/abcd?pid=Email&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content

リンクのテスト

上記の必要な手順をすべて実行し、適切なOneLink URLを作成し、メールに入れた後、テストメールを自分宛てに送信してください。

予想されること

アプリがインストールされている場合は、アプリを呼び出す必要があります。関連するAppsFlyer SDKのディープリンクAPIが実装されている場合は、関連するコンテンツにディープリンクする必要があります。
さらに、クリックは、提供されたメディアソースとキャンペーンに紐づくAppsFlyer管理画面と、Responsysデータの両方に表示されます。