リモートコマンド：AppsFlyer

要件

• AppsFlyer アプリ ID および デバイス キー
• これらのモバイル ライブラリのうちのいずれか:
  • Tealium for Android-Kotlin (1.0.0 以降)
  • Tealium for Android-Java (5.9.0 以降 (AppsFlyer 1.0.0 以降用) または 5.9.0 以前 (旧バージョン用))
  • Tealium for iOS-Swift
• これらのリモート コマンド統合のいずれか:
  • AppsFlyer Remote Command JSON File (Android-Kotlin 1.0.0 以降または iOS-Swift 2.1.0 以降が必要)
  • AppsFlyerリモート コマンド タグ (Tealium iQ タグ管理)

仕組み

AppsFlyer 統合は、これらのアイテムを使用します:

1. AppsFlyer ネイティブ SDK
2. AppsFlyer メソッドをラップするリモート コマンド モジュール
3. イベント トラッキングをネイティブ AppsFlyer コールに翻訳する、JSON 構成ファイルまたは Remote Command タグのいずれか

AppsFlyer リモート コマンド モジュールをアプリに追加すると、必要な AppsFlyer ライブラリが自動的にインストールされ、ビルドされます。この際、ベンダー固有のコードをアプリに追加する必要はありません。依存関係マネージャのインストールを使用している場合、AppsFlyer SDKを個別にインストールする必要はありません。

リモート コマンド オプションは、次の 2 つがあります: A JSON 構成ファイル、または、マッピングを構成するための iQ タグ管理の使用。A JSON 構成ファイルは、リモートでホスティングするか、またはアプリ内でローカルでホスティングするかのいずれでも、ベンダー統合の推奨オプションです。iQ タグ管理を使用する場合は、ベンダー統合用のリモート コマンド タグを追加します。ベンダー統合の詳細は、こちらから参照してください。

iOS：AppsFlyerバージョン4.8.11以降の場合、SDKはネイティブフレームワークAdSupport.frameworkおよびiAd.frameworkを自動的に追加します。詳細については、AppsFlyer iOS SDK統合に関するガイドを参照してください。

インストール

依存関係マネージャ

次の依存関係マネージャのいずれかをインストールに使用することをお勧めします。

pod "TealiumAppsFlyer"

'tealium-swift/Core'
'tealium-swift/RemoteCommands'
'tealium-swift/TagManagement'

`binary "https://raw.githubusercontent.com/AppsFlyerSDK/AppsFlyerFramework/master/AppsFlyerLib.json"`

github "tealium/tealium-ios-appsflyer-remote-command"

dependencies {
    implementation 'com.tealium.remotecommands:appsflyer:1.0.0'
}

手動による手順（iOS）

AppsFlyer リモート コマンドを手動でインストールするには、 Tealium for Swift ライブラリがインストールされている必要があります。iOSプロジェクトのAppsFlyerリモートコマンドをインストールするには：

1. AppsFlyer SDKをまだインストールしていない場合はインストールします。

2. Tealium iOS AppsFlyerリモートコマンドレポジトリをクローンして、Sourcesフォルダ内のファイルをプロジェクトにドラッグします。

3. remoteAPIEnabled 構成フラッグを trueに構成します

手動（Android）

AppsFlyer リモート コマンドを手動でインストールするには、 Tealium for Android (Kotlin) または Tealium for Android (Java) がインストールされている必要があります。AndroidプロジェクトのAppsFlyerリモートコマンドをインストールするには：

1. flatDirをプロジェクトのルートにあるbuild.gradleファイルに追加します。

allprojects {
      repositories {
         mavenCentral()
         flatDir {
             dirs 'libs'
         }
      }
}

2. tealium-appsflyer.aarを<PROJECT_ROOT>/<MODULE>/libsに追加します。

3. Tealiumライブラリの依存関係をbuild.gradleファイルに追加します。

dependencies {
      implementation(name:'tealium-appsflyer', ext:'aar')
}

初期化

すべてのTealiumライブラリについて、初期化時にAppsFlyerリモートコマンドを登録します。

Android (Kotlin)

Tealium の Android (Kotlin) ライブラリ用の JSON 構成ファイルまたはリモート コマンド タグを用いてリモート コマンドを初期化します。

// Sets up a config object and creates a Tealium instance
val config = TealiumConfig(application,
        "ACCOUNT",
        "PROFILE",
        Environment.DEV,
        dispatchers = mutableSetOf(Dispatchers.RemoteCommands));
var tealium = Tealium.create(TEALIUM_MAIN, config) {
    // New code to add the AppsFlyer Remote Command
    val appsFlyerRemoteCommand = AppsFlyerRemoteCommand(application,
                                      appsFlyerDevKey = devKey)
    // register the command
    remoteCommands?.add(appsFlyerRemoteCommand, filename = "appsflyer.json");
}

// Sets up a config object and creates a Tealium instance
val config = TealiumConfig(application,
        "ACCOUNT",
        "PROFILE",
        Environment.DEV,
        dispatchers = mutableSetOf(Dispatchers.RemoteCommands));
var tealium = Tealium.create(TEALIUM_MAIN, config) {
    // New code to add the AppsFlyer Remote Command
    val appsFlyer = AppsFlyerRemoteCommand(application,
                                      appsFlyerDevKey = devKey)
    // register the command
    remoteCommands?.add(appsFlyer);
}

Android (Java)

// Sets up a config object and creates a Tealium instance
Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");
Tealium teal = Tealium.createInstance(TEALIUM_MAIN, config);
    // New code to add the AppsFlyer Remote Command
AppsFlyerRemoteCommand appsFlyer = new AppsFlyerRemoteCommand(application, appsFlyerDevKey = devKey)
teal.addRemoteCommand(appsFlyer);

iOS (Swift)

Tealium の iOS (Swift) ライブラリ用の JSON 構成ファイルまたはリモート コマンド タグを用いてリモート コマンドを初期化します。

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE",
                           optionalData: nil)

config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

	let appsflyer = AppsFlyerRemoteCommand(type: .local(file: "appsflyer"))
	remoteCommands.add(appsflyer)
}

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE",
                           optionalData: nil)

config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

	let appsFlyer = AppsFlyerRemoteCommand()
	remoteCommands.add(appsFlyer)
}

プッシュメッセージトラッキング

Tealium Swiftライブラリには、Tealium と AppsFlyer リモート コマンドを介してプッシュ メッセージ トラッキングに対処するための TealiumRegistration プロトコルが含まれています。Tealium は ラッパー クラス AppsFlyerInstance でこのプロトコルに準拠し、プッシュ メッセージ認証イベントとプッシュ メッセージ オープン イベントの送信、およびトラッキングのアンインストールにこのプロトコルを使用しています。プッシュメッセージトラッキング機能を利用することをお勧めします。

iOSプロジェクトのプッシュメッセージトラッキングを統合するには、次の手順を実行します。

1. TealiumHelper.swiftファイルで、TealiumRegistrationプロトコルに準拠しているオブジェクトの空の配列を初期化します。例：

var pushMessagingTrackers = [TealiumRegistration]()

2. AppsFlyerRemoteCommandの前に AppsFlyerInstance を初期化します
3. 前述の配列に AppsFlyerInstance を追加します

以下は、プッシュメッセージトラッキング統合の例の全文です。

var pushMessagingTrackers = [TealiumRegistration]()
var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE",
                           optionalData: nil)
config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

	let appsflyerInstance = AppsFlyerInstance()
	let appsflyer = AppsFlyerRemoteCommand(appsflyerInstance: appsflyerInstance, type: .local(file: "appsflyer"))
	pushMessagingTrackers.append(appsflyerInstance)
	remoteCommands.add(appsflyer)
}

TealiumHelper.swiftファイル全体を表示するには、AppsFlyerリモートコマンドサンプルアプリを確認してください。ユーザーが通知の登録、プッシュメッセージのオープン、またはアプリのアンインストールを行った後でAppsFlyerにイベントを送信するには、ファイルAppDelegate.swiftを参照してください

AppsFlyerのプッシュメッセージ、およびトラッキング機能のアンインストールの詳細については、開発者向けiOS SDK統合に関するガイドを参照してください。

JSON テンプレート

JSON 構成ファイルを使用してリモート コマンドを構成しようとする場合は、まず、以下のテンプレートを参照します。テンプレートには、標準的な E コマースのインストールに用いられる共通マッピングが含まれます。必要に応じて、マッピングを編集します。

{
    "config": {
        "app_id": "YOUR_APP_ID",
        "app_dev_key": "YOUR_APPSFLYER_DEV_KEY",
        "settings": {
            "custom_data": {"custom_key": "custom_value"},
            "debug": true,
            "disable_ad_tracking": false,
            "disable_apple_ad_tracking": false,
            "time_between_sessions": 30,
            "anonymize_user": false,
            "collect_device_name": false
        }
    },
    "mappings": {
        "latitude": "af_lat",
        "longitude": "af_long",
        "customer_email": "customer_emails",
        "hash_type": "email_hash_type",
        "currency_code": "af_currency",
        "customer_id": "af_customer_user_id",
        "signup_method": "event.signup_method",
        "achievement_id": "event.achievement_id",
        "checkout_option": "event.checkout_option",
        "checkout_step": "event.checkout_step",
        "content": "event.content",
        "content_type": "event.content_type",
        "coupon": "event.coupon",
        "product_brand": "event.product_brand",
        "product_category": "event.product_category",
        "product_id": "event.af_content_id",
        "product_list": "event.product_list",
        "product_location_id": "event.product_location_id",
        "product_name": "event.product_name",
        "product_variant": "event.product_variant",
        "product_unit_price": "event.af_price",
        "product_quantity": "event.af_quantity",
        "current_level": "event.level",
        "score": "event.score",
        "search_keyword": "event.search_keyword",
        "order_shipping_amount": "event.order_shipping",
        "order_tax_amount": "event.order_tax",
        "order_id": "event.af_order_id",
        "order_total": "event.af_revenue",
        "currency_type": "event.currency_type",
    },
    "commands": {
        "launch": "initialize,launch",
        "geofence_entered": "tracklocation",
        "geofence_exited": "tracklocation",
        "user_login": "login",
        "user_register": "setuseremails,setcustomerid,completeregistration",
        "show_offers": "adclick",
        "cart_add": "addtocart",
        "wishlist_add": "addtowishlist",
        "payment": "addpaymentinfo",
        "unlock_achievement": "unlockachievement",
        "level_up": "achievelevel,customersegment",
        "email_signup": "subscribe",
        "product": "viewedcontent",
        "category": "listview",
        "share": "share",
        "search": "search",
        "checkout": "initiatecheckout",
        "order":"purchase"
    }
}

サポートされているメソッド

以下のAppsFlyerメソッドは、以下のTealiumコマンドを使用し、AppsFlyerリモートコマンドタグのデータマッピングを使用してトリガーできます。

標準イベント名

以下は、trackEventメソッドでサポートされている標準イベント名のリストです。以下のコマンド名のいずれかが送信された場合は、AppsFlyer SDKで自動的にトリガーされます。ここでは、その特定のイベントに対する必要なすべての変数のマッピングおよび定義も行われていることが前提となっています。アプリ内イベントの記録に関する詳細と、推奨される業種別アプリ内イベントのリストをご確認ください。

AppsFlyer SDKはTealium SDKとともにインストールされるので、対応するタグ構成があれば任意のネイティブAppsFlyer機能をトリガーできます。

SDKのセットアップ

初期化

AppsFlyer SDKは起動時に自動的に初期化されます。AppsFlyer APIキーはタグ構成で構成されます。

AppsFlyer開発者ガイド：SDKの初期セットアップ

• iOS

AppsFlyer リモート コマンド タグで構成できる構成オプションはいくつかあります。以下のいずれかが起動時に構成された場合は、初期化メソッドの実行中に送信されます。

構成オプション

AppsFlyer開発者ガイド：追加のAPI

• iOS
• Android

起動のトラッキング

ライフサイクルモジュールがインストールされている場合、このイベントはすべてのアプリ起動を自動的に送信します。

AppsFlyer開発者ガイド：SDKの初期化

• iOS
• Android

ロケーション

ロケーションのトラッキング

ロケーションモジュールがインストールされている場合は、緯度と経度がすべてのイベントで送信されます。

AppsFlyer APIリファレンス：ロケーショントラッキング

• iOS

その他のオプション

ホストの構成

AppsFlyer APIリファレンス：ホストの構成

• iOS

ユーザーのEメールの構成

暗号タイプリファレンス

AppsFlyer APIリファレンス：ユーザーのEメールの構成

• iOS

通貨コードの構成

AppsFlyer APIリファレンス：通貨コードの構成

• iOS

顧客IDの構成

• AppsFlyer追加のAPI：顧客IDの構成
• iOS
• Android

ディープリンクURLの解決

AppsFlyer APIリファレンス：ディープリンクURLの解決

• iOS
• Android

トラッキングの無効化

AppsFlyer追加のAPI：トラッキングの停止（オプトアウト）

• iOS
• Android