Adobe Visitor Serviceモジュール
React Native向けTealium Adobe Visitor Serviceモジュールのインストール方法について説明します。
Tealium for React Nativeを使用すると、React NativeアプリケーションでTealiumモバイルライブラリ(iOS、Android)を利用できます。
仕組み
Tealiumモバイルライブラリは、次のいずれかの方法でReact Nativeアプリケーションに統合できます。
- NPMパッケージ(推奨)
- GitHubを使用した手動インストール
要件
- ネイティブビルド環境へのアクセス
- Tealium for React Native 2.2.0以降
- React Native 0.63以降および必要なツールのインストール
- タグ管理モバイルプロファイル
- Android StudioまたはXcode
- Tealium for AndroidまたはTealium for iOS
インストール(NPM/YARN)
NPMを使用してReact Native向けTealium Adobe Visitorモジュールをインストールするには、次の手順を実行します。
メインの
tealium-react-nativeライブラリについて、こちらのインストール手順に従います。バージョン2.2.0以降がインストールされていることを確認してください。React Nativeプロジェクトのルートディレクトリに移動します。
次のコマンドを使用して、
tealium-react-native-adobe-visitorパッケージをダウンロードしてインストールします。yarn install tealium-react-native-adobe-visitor
JavaScript
関連するクラスをアプリにインポートするには、次のようにします。
import TealiumAdobeVisitor from 'tealium-react-native-adobe-visitor';
import { TealiumAdobeVisitorConfig } from 'tealium-react-native-adobe-visitor/common';
初期化
メインのTealium React Native統合を初期化する前に、Adobe Visitorモジュールを構成します。
let adobeVisitorConfig: TealiumAdobeVisitorConfig = {
adobeVisitorOrgId: "ADOBE-ORG-ID",
adobeVisitorRetries: 1,
adobeVisitorExistingEcid: "", // optional
}
TealiumAdobeVisitor.configure(adobeVisitorConfig);
adobeVisitorCustomVisitorId、adobeVisitorDataProviderId、adobeVisitorAuthStateプロパティは、アプリセッションの開始時に3つすべての値が判明している場合にのみ構成してください。adobeVisitorAuthStateは、adobeVisitorCustomVisitorIdも構成する場合にのみ構成します。初期化時に訪問IDが不明な場合(ログイン前など)は、これらのプロパティを省略し、IDが利用可能になった時点でlinkEcidToKnownIdentifierを呼び出します。
let adobeVisitorConfig: TealiumAdobeVisitorConfig = {
adobeVisitorOrgId: "ADOBE-ORG-ID",
adobeVisitorRetries: 1,
adobeVisitorExistingEcid: "",
adobeVisitorDataProviderId: "DATA-PROVIDER-ID",
adobeVisitorCustomVisitorId: "CUSTOM-VISITOR-ID",
adobeVisitorAuthState: AuthState.authenticated
}
TealiumAdobeVisitor.configure(adobeVisitorConfig);
APIリファレンス
Adobe VisitorモジュールとメインのTealium React Native統合の両方を初期化した後、既存のAdobe訪問をリンクできます。
linkEcidToKnownIdentifier(id, providerId, authState, callback)
既存のECIDを既知の識別子にリンクします。
TealiumAdobeVisitor.linkEcidToKnownIdentifier(id, providerId, authState, value => {
console.log("AdobeVisitor Data: " + JSON.stringify(value))
});
getAdobeVisitor(callback)
現在のAdobe訪問情報を取得します。
TealiumAdobeVisitor.getAdobeVisitor(value => {
console.log("Current Adobe Visitor: " + JSON.stringify(value))
});
decorateUrl(url, callback)
ECID訪問データをURLにエンリッチメントします。
TealiumAdobeVisitor.decorateUrl(("https://tealium.com", value => {
console.log("Decorated URL: " + value);
});
getUrlParameters(callback)
URLに追加するAdobe VisitorのURLパラメータを取得します。
TealiumAdobeVisitor.getUrlParameters(value => {
if (value === null || value === undefined) {
console.log("Adobe Visitor was null");
return;
} else {
for (var key of Object.keys(value)) {
// Result: key = adobe_mc
// value = MCMID=1234|MCORGID=12345@AdobeOrg|TS=1655826247
// Only for demonstration purposes; call some method in your app that decorates the URL and then launches your webview
console.log("Retrieved URL Parameters: ", key + "=" + value[key]);
break;
}
}
});
resetVisitor()
現在の訪問をリセットします。
TealiumAdobeVisitor.resetVisitor();
最終更新日 :: 2026年November月18日