• 手引き
  • プラットフォーム
  • パートナー
  • English
  • TLC Tealium Learning Center Tealium Learning
    Community
  • Discussions & Ideas Dicussions & Ideas
  • Product Guides Product Guides
  • Knowledge Base Knowledge Base
  • Developer Docs Developer Docs
  • Education Education
  • TLC Blog TLC Blog
  • Support Desk Support Desk
  • CDH Customer Data Hub Customer Data Hub

目次

  • 要件
  • サポートされているプラットフォーム
  • インストール
    • CocoaPods
    • Carthage
  • 例
  • データレイヤー
  • APIリファレンス
    • init()
    • add()
    • remove()
    • disableRemoteCommands()
    • enableRemoteCommands()
    • disableRemoteHTTPCommand()
    • enableRemoteHTTPCommand()
  • リモートHTTPコマンド
IOS SWIFT/MODULE LIST

RemoteCommandsモジュール

拡張機能およびタグ配信ルールによって制御される、Tealium iQ Tag Management内のイベントによるネイティブコードブロックのトリガーを有効にします。

リモートコマンドの詳細については、こちらを参照してください。

要件

  • Tealium iQ Tag Managementモジュール。コンパイル時の依存関係ではありませんが、リモートコマンドはモジュールからのみトリガーされます。

サポートされているプラットフォーム

  • iOS

インストール

RemoteCommandsモジュールをCocoaPodsまたはCarthageによってインストールします。

CocoaPods

RemoteCommandsモジュールをCocoaPodsによってインストールするには、Podfileに以下のポッドを追加します。

pod 'tealium-swift/TealiumRemoteCommands'

フレームワークは自動でインスタンス化され、TealiumCoreポッドに依存しています。iOS向けCocoaPodsのインストールの詳細については、こちらを参照してください。

Carthage

RemoteCommandsモジュールをCarthageによってインストールするには、以下の手順に従います。

  1. Xcodeで対象アプリの[General]構成ページに移動します。

  2. 以下のフレームワークを[Embedded Binaries]セクションに追加します。

    TealiumRemoteCommands.framework
  3. RemoteCommands APIを対話的に操作する必要がある場合は、次の必須のインポートステートメントをプロジェクトに追加します。

    import TealiumRemoteCommands

フレームワークは自動でインスタンス化され、TealiumCoreに依存しています。追加のインポートステートメントは必要ありません。iOS向けCarthageのインストールの詳細については、こちらを参照してください。

例

Tealium IQでリモートコマンドタグが設定され、モジュールがアプリにインストールされたら、次の例に示すように、次の行を初期化に追加します。

class TealiumHelper {
	var tealium: Tealium?
	// ...
	private func initTealium() {
		let config = TealiumConfig(account: "ACCOUNT",
 	       		                 profile: "PROFILE",
        	   	                 environment: "ENVIRONMENT",
           		                 datasource: "DATASOURCE")
    	guard let remoteCommands = self?.tealium?.remoteCommands() else {
          return
        }
        let brazeCommand = BrazeCommand(brazeTracker: BrazeTracker())
        let brazeRemoteCommand = brazeCommand.remoteCommand()
        remoteCommands.add(brazeRemoteCommand)

		// ...
	}
}

データレイヤー

このモジュールによって導入される追加の変数はありません。

APIリファレンス

init()

addコマンドに渡すことができる新しいリモートコマンドオブジェクトを作成します。

パラメータ 説明 例
commandId リモートコマンドに必要な文字列識別子 "logger"
description リモートコマンドのオプションの文字列説明 "Log Response object to console"
queue コードブロックをトリガーするキュー DispatchQueue.main
completion トリガーするコードのブロック

以下は使用例です。

let customCommand = TealiumRemoteCommand(commandId: "logger",
                                        description: "Log Response object to console",
                                        queue: DispatchQueue.main)
                                        { (response) in
                                            // code to execute
                                            print("Custom command response: (response)")
                                        })

add()

1.6.5の時点では、TealiumConfigのaddRemoteCommand()メソッドを使用してリモートコマンドを追加することを推奨します。

後でトリガーするために、指定したリモートコマンドをTealiumに登録します。新しいリモートコマンドを追加する前に、Tealiumを初期化しておく必要があります。

add(remoteCommand: TealiumRemoteCommand)

以下は使用例です。

var tealium: Tealium?
let customCommand = TealiumRemoteCommand(commandId: "logger",
    description: nil,
    queue: DispatchQueue.main)
    { response in
        // code to execute
        print("Custom command response: (response)")
    })
if let remoteCommands = self.tealium?.remoteCommands() {
        remoteCommands.add(customCommand)
} else {
print("Remote commands not available")
}

remove()

以前に登録したリモートコマンドを削除して、再度トリガーされないようにします。

remove(commandWithId: String)
// assumes "tealium" previously instantiated
tealium?.remoteCommands()?.remove(commandWithId: "logger")

disableRemoteCommands()

RemoteCommandsモジュールを無効にします。

disableRemoteCommands()

以下は使用例です。

// assumes "tealium" previously instantiated
tealium?.remoteCommands()?.disableRemoteCommands()

enableRemoteCommands()

RemoteCommandsモジュールを有効にします(以前に無効にした場合のみ必要、デフォルトでは有効)。

enabledRemoteCommands()

以下は使用例です。

// assumes "tealium" previously instantiated
tealium?.remoteCommands()?.enableRemoteCommands()

disableRemoteHTTPCommand()

ビルトインリモートHTTPコマンドを無効にしますが、他のコマンド用にRemoteCommandsモジュールは有効のままにします。

disableRemoteHTTPCommand()

以下は使用例です。

// assumes "tealium" previously instantiated
tealium?.remoteCommands()?.disableRemoteHTTPCommand()

enableRemoteHTTPCommand()

ビルトインリモートHTTPコマンドを有効にします(以前に無効にした場合のみ必要、デフォルトでは有効)。

enableRemoteHTTPCommand()`

以下は使用例です。

// assumes "tealium" previously instantiated
tealium?.remoteCommands()?.enableRemoteHTTPCommand()

リモートHTTPコマンド

これは識別子_httpを持つ予約済み内部コマンドであり、ネイティブコードからのHTTPリクエストをトリガーし、その応答をTealium iQウェブビューに返します。これは、ウェブブラウザで適用される場合があるCORS制限をバイパスするために、状況に応じて使用されます。このコマンドを使用するには、特定のマッピング名を使用する必要があります。

Mapping Name 説明
url (必須)トリガーするリクエストのURL。
method (必須)呼び出すHTTPメソッド。現在サポートされているメソッドは、PUT、GET、POSTのみです。
headers (オプション)リクエストとともに渡すヘッダーのキーと値のペアを含むJavaScriptオブジェクト(JSON)。例:{"Content-Type": "application/json"})。
callback_function (オプション)コマンドの完了時に呼び出すJavaScript関数。このコールバック関数には、2つのパラメータが渡されます。HTTP応答コード(404、200など)であるcodeと、リクエストからの応答本体であるbodyです。

コールバック関数の例を示します。

var my_callback = function(code, body) {
   // assuming the response body was a JSON object, this logs a variable called my_response_variable to the console in the web view
	console.log(body.my_response_variable);
}

実際の例については、Adobe Analyticsによるアプリダウンロードのトラッキングに関する記事を参照してください。

PersistentDataモジュール
TagManagementモジュール

 
  • モバイル
  • 始める
    • 概要
    • モバイルの概念
    • クライアントサイド
    • サーバーサイド
    • データレイヤー
    • 同意管理
    • イベントバッチ処理
    • ユーザーの位置情報とジオフェンシング
    • 機能比較
    • トラブルシューティング
  • Remote Commands
    • 概要
    • 仕組み
    • リモートコマンド
      • リモートコマンド:AppsFlyer
      • リモートコマンド:Braze
      • リモートコマンド:Contentsquare
      • リモートコマンド:Facebook
      • Firebase
      • リモートコマンド:Usabilla
  • Android (Java)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • 同意管理
    • モジュールのリスト
      • Ad Identifierモジュール
      • Crash Reporterモジュール
      • Install Referrerモジュール
      • Lifecycle Trackingモジュール
      • Locationモジュール
      • Optimizely X Trackingモジュール
    • Android TV
    • Android Wear
    • APIリファレンス
      • ConsentManager
      • DataSources
      • LifeCycle
      • Tealium
      • Tealium.Config
      • TealiumLocation
    • リリースノート
  • Cordova
    • 概要
    • インストール
    • トラッキング
    • データ管理
    • モジュールのリスト
      • Ad Identifierモジュール
      • Crash Reporterモジュール
      • Install Referrerモジュール
    • APIリファレンス
    • リリースノート
  • Flutter
    • 概要
    • インストール
    • トラッキング
    • 同意管理
    • データ管理
    • APIリファレンス
    • リリースノート
  • iOS (Objective-C)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • 同意管理
    • Tag Management
    • モジュールのリスト
      • Lifecycle Trackingモジュール
      • Optimizely X Trackingモジュール
    • tvOS
    • watchOS
    • APIリファレンス
    • リリースノート
  • iOS (Swift)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • アイデンティティの解決
    • アプリ拡張機能
    • 同意管理
    • モジュール
    • モジュールのリスト
      • AppDataモジュール
      • Attributionモジュール
      • AutoTrackingモジュール
      • Collectモジュール
      • Connectivityモジュール
      • CrashReporterモジュール
      • DataSourceモジュール
      • DefaultStorageモジュール
      • Delegateモジュール
      • DeviceDataモジュール
      • DispatchQueueモジュール
      • FileStorageモジュール
      • Lifecycleモジュール
      • Locationモジュール
      • Loggerモジュール
      • PersistentDataモジュール
      • RemoteCommandsモジュール
      • TagManagementモジュール
      • VisitorServiceモジュール
      • VolatileDataモジュール
    • Objective-Cとの連携
    • 機能比較
    • APIリファレンス
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManagerDelegate
      • TealiumConsentManager
      • TealiumInstanceManager
      • TealiumPersistentData
      • TealiumVolatileData
      • Tealium
    • リリースノート
  • React Native
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
    • リリースノート
  • Xamarin
    • 概要
    • インストール
    • トラッキング
    • データ管理
    • 同意管理
    • APIリファレンス
    • リリースノート
  • ウェブ
  • AMP
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
  • Angular
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • JavaScript (Web)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • ユニバーサルデータオブジェクト(utag_data)
    • ユニバーサルタグ(utag.js)
    • データレイヤーオブジェクト(b)
    • 単一ページアプリケーション
    • 設定
    • デバッグ
    • APIリファレンス
    • リリースノート
  • サーバーサイド
  • C#
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • APIリファレンス
    • リリースノート
  • HTTP API
    • 概要
    • エンドポイント
    • データレイヤー
  • Java
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
    • リリースノート
  • Node
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Python
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Roku
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Ruby
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Unity
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス

このページはお役にたちましたでしょうか?

最終更新日 :: 2022年March月2日       ご意見有難うございます。
  • 手引き
  • プラットフォーム
  • パートナー
  • モバイル
  • 始める
  • Remote Commands
  • Android (Java)
  • Cordova
  • Flutter
  • iOS (Objective-C)
  • iOS (Swift)
  • React Native
  • Xamarin
  • ウェブ
  • AMP
  • Angular
  • JavaScript (Web)
  • サーバーサイド
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby
  • Unity