ブランドドメイン｜OneLinkを自社ドメイン化する方法

ブランドドメインの設定では、以下の図のように、DNSで設定した完全修飾ドメインをAppsFlyerのOneLinkサブドメインに関連付けます。

AppsFlyerサーバーを参照するブランドドメイン

始める前に：

• 使用する完全修飾ドメイン名を決定します。たとえば、app.abcdef.comです。
  abcdef.comは自社ブランドのドメインです。appなどのサブドメインも任意に設定できます
• DSN管理者にフルドメイン（ホスト）を作成するよう依頼します。 
• DNS管理者に、完全修飾ドメイン、つまりブランドドメインが指定されたURL、
  すなわちAppsFlyerホストを参照するよう、CNAMEレコードの設定を依頼します。
  この構成は、上の「AppsFlyerサーバーを参照するブランドドメイン」の図に示されています。

完全修飾ドメインをOneLinkサブドメインにマッピングする：

1. AppsFlyerで、エンゲージメント > ブランドドメインの順にクリックします。
2. ［＋新しいブランドドメイン］ をクリックします。
3. ［ブランドドメイン］フィールドに、DNSで設定した完全修飾ドメインを入力します。例：click.abcdef.com 注意：ドメインの末尾にピリオドを付けないでください。
4. 表示された一覧から、OneLinkサブドメインを選択します。一覧が表示されない場合は、
   OneLinkテンプレートを作成する必要があります。OneLinkテンプレートを作成すると、
   デフォルトのサブドメインが提供されます。
5. ［次へ］をクリックします。
6. CNAMEレコードを設定します：
   • ドメインがAppsFlyerのCNAME参照先を正しく参照している場合は、
     「AppsFlyerのCNAMEが見つかりました」と表示されます。

   • CNAMEが見つからない場合は、AppsFlyerのCNAME参照先をコピーしてDNS管理者に共有し、完全修飾ドメインがそのCNAME参照先にマッピングされていることを確認するよう依頼してください。DNS管理者は、完全修飾ドメインをAppsFlyerのCNAME参照先にマッピングする必要があります。マッピングされていない場合、ブランドドメイン自体は作成されますが、正常に動作しません。

     注意

     CNAMEレコードは、ブランドドメインの作成日から、確認ダイアログに表示される期日までの7日以内にマッピングする必要があります。
     指定された期日までにCNAMEレコードがマッピングされなかった場合は、
     7日間の設定期間を更新する必要があります。

7. ［完了］をクリックします。これで、ブランドドメインにマッピングされたOneLinkテンプレートを使用して、新しいリンクを作成できます。

   注意

   • ブランドドメインを設定する前に、同じOneLinkテンプレートを使用してリンクをすでに作成している場合でも、それらのリンクは引き続き正常に動作します。
   • 新しいブランドドメインが利用可能になるまで、最大24時間かかる場合があります。

CNAMEレコードのマッピング期限である7日間を更新する

ブランドドメインの作成から7日以内に、完全修飾ドメインのCNAMEレコードがAppsFlyerにマッピングされなかった場合、新しいブランドドメインは動作しません。

7日間の設定期間を更新するには、以下の手順を実行します：

1. AppsFlyer管理画面 左メニュー エンゲージメント > ブランドドメインへ移動します。
2. 警告アイコン（）が表示されている、AppsFlyerにまだマッピングされていないブランドドメインを開きます。
3. 更新アイコン（）をクリックして、7日間の設定期間を更新します。

カスタムSSL証明書（任意）

AppsFlyerが管理するSSLは、デフォルトかつ多くのお客様に推奨される設定です。AppsFlyerが証明書の発行と更新を自動的に行うため、追加の対応は必要ありません。特定のセキュリティ要件やコンプライアンス要件がある場合は、AppsFlyer管理のSSLではなく、自社で選択した認証局のSSL証明書、すなわちカスタムSSL証明書を使用できます。このオプションを選択した場合、証明書の発行、アップロード、管理、更新はお客様の責任で行う必要があります。証明書の有効期限が切れ、期限内に更新されなかった場合、サービスが中断する可能性があります。

カスタムSSL証明書を使用するには：

1. ブランドドメインを作成します。 

2. AppsFlyerで、 ［エンゲージメント］ > ［ブランドドメイン］に移動し、対象のドメインにカーソルを合わせて、カスタムSSL証明書アイコンを選択します。 
   

    

3. 証明書情報のフォームに必要事項を入力します。 
   

    

4. ［CSRをダウンロード］をクリックし、入力したフォームの内容に基づくCSRファイルをダウンロードします。
   
5. ダウンロードしたCSRファイルを、選択したSSL認証局に提出します。 
6. 認証局から新しいSSL証明書が発行されたら、その証明書をAppsFlyerにアップロードします。 

• 以下のSDKバージョンを使用してください： 
  • Android SDK V4.10.1以降
  • iOS SDK V4.10.1以降
  • ユーザー紹介機能を使用する場合は、iOSとAndroidの両方でSDK V5.2.0以降が必要 

ブランドドメインのSDK実装に関する考慮事項

• ブランドドメインを使用してディープリンクが行われた場合、AppsFlyer SDKは、インストールおよびディープリンクに関するコンバージョンデータを取得できません。
• この問題に対応するため、開発者はAndroidではsetOneLinkCustomDomain、iOSではoneLinkCustomDomainsのSDK APIを使用します。
• このAPIはブランドドメインに問い合わせ、マッピングされているOneLinkドメインを取得したうえで、OneLinkの処理を完了します。

public class AFApplication extends Application {

    @Override
    public void onCreate() {
    super.onCreate();
      
      // Set branded link domain. Don't include https:// as part of the domain. 
      AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com");
      AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
      AppsFlyerLib.getInstance().start(this, AF_DEV_KEY);

    }
}

AppsFlyerLib.getInstance().setOneLinkCustomDomain("promotion.greatapp.com", 
                                                        "click.greatapp.com", 
                                                        "deals.greatapp.com");

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    /** APPSFLYER INIT **/
    [AppsFlyerLib shared].appsFlyerDevKey = @"SED_DEV_KEY";
    [AppsFlyerLib shared].appleAppID = @"123456789";
    [AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com"];
    //...
    //...
  }

[AppsFlyerLib shared].oneLinkCustomDomains = @[@"promotion.greatapp.com", @"click.greatapp.com"];

   func application(_ application: UIApplication, didFinishLaunchingWithOptions 
        launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
          AppsFlyerLib.shared().appsFlyerDevKey = "6CQi4Be6Zs9oNLsCusPbUL"
          AppsFlyerLib.shared().appleAppID = "340954504"
          AppsFlyerLib.shared().oneLinkCustomDomains = ["example.com"]
          //...
          //...
   }

AppsFlyerLib.shared().oneLinkCustomDomains = ["promotion.greatapp.com", "click.greatapp.com"]

前提条件：

ブランドドメインを使用してテストする前に、ブランドドメインのワークフローに記載されている手順をすべて完了してください。 

ブランドドメインの作成とテスト方法：

1. ブランドドメインにマッピングされたOneLinkテンプレートを使用してOneLinkのカスタムリンクを作成してください。
2. カスタム計測リンクをテキストエディタにコピーします。

3. カスタム計測リンクは、OneLinkサブドメイン、OneLink ID、およびカスタムリンクID で構成されています。OneLinkサブドメインを、ブランドドメインの完全修飾ドメインに置き換えます。例：
    

   カスタム計測リンク	ブランドドメイン
   abcdef.onelink.me/A1bc/dc1234ef	click.abcdef.com/A1bc/dc1234ef

4. ブランドリンクを使用してインストールとディープリンクをテストします。
5. テストの一環としてローデータレポートを使用する場合、Original URLのフィールドにはブランドリンクが入力されます。 

ブランドドメインのマッピングを編集する：

既存の完全修飾ドメインのマッピング先を、別のOneLinkサブドメインに変更できます。この場合、CNAMEを再設定する必要はありません。

1. AppsFlyer管理画面 左メニュー エンゲージメント > ブランドドメインへ移動します。
2. 編集するブランドドメインに移動します。
3. 編集アイコン （） をクリックします。
4. 新しいOneLinkサブドメインを選択します。
5. 次へをクリックします。CNAME を設定する必要はありません。 
6. ［完了］をクリックします。

ブランドドメインのマッピングを検証する

ブランドドメインにマッピングされているOneLinkサブドメインを変更した後は、ブランドドメインが正しくマッピングされていることを確認してください。

1. AppsFlyer管理画面 左メニュー エンゲージメント > ブランドドメインへ移動します。
2. 検証するブランドドメインに移動します。
3. 確認アイコン（）をクリックします。

ドメインのCNAMEレコードがAppsFlyerを参照しなくなった場合：

CNAMEレコードを変更し、AppsFlyerを参照しない状態にすると、該当するブランドドメインはAppsFlyerから削除されます。

ブランドドメインのマッピングを削除する：

ブランドドメインを削除するには、AppsFlyerのCSMまたはhello@appsflyer.comまでお問い合わせください。