Adobe Analytics 2.0 APIへの移行 analytics-2-migration
Adobe Analytics 1.4 APIは提供終了に達しています。 Campaign インスタンスをAdobe AnalyticsにリンクするWeb Analytics コネクタ は、これらのAPIに依存しているため、新しいAnalytics 2.0 APIを使用するビルドにアップグレードして統合を実行する必要があります。
影響の有無 are-you-impacted
インスタンスが次のいずれかにWeb Analytics外部アカウントを使用している場合、影響を受けます。
- Adobe Analyticsに指標としてメールキャンペーンの指標と属性を送信する。
- Adobe Analyticsへの分類データの送信。
- リマーケティングフロー(キャンペーン後にコンバージョンしたコンタクトの特定)。
- 初めて設定する予定のWeb Analytics外部アカウント。
お客様に最適なツールをご提案します? 上記のテクニカルワークフローのうち、インスタンスでアクティブなものはどれかを確認し、管理/プラットフォーム/外部アカウント でWeb Analytics外部アカウント設定を確認します(Web Analytics外部アカウント を参照)。
移行方法 how-to-migrate
Adobeでホストされている インスタンスを使用している場合、Adobeは、アップグレードの一環としてSFTP プロビジョニング、IP許可リスト、キー設定を処理します。新しいビルドが公開されたら、ユースケースを検証する必要があります。
オンプレミスまたはハイブリッドのデプロイメントを利用している場合は、次の手順を実行します。
-
Campaign環境を、Adobe Analytics 2.0の変更点を含むビルドにアップグレードします。 実行しているビルドは、 ヘルプ/バージョン情報…から確認できます(Campaign バージョンの確認方法を参照)。
-
次のステップはインスタンスによって異なるため、上記のユースケースのうち、どのユースケースがインスタンスに適用されるかを確認します。
-
リマーケティングフローを使用する場合、webAnalyticsFindConverted ワークフローには、Adobe Analytics 2.0とデータを交換するための専用のSFTP チャネルが必要です。 これを次のように設定します。設定しない場合は、次の手順に進みます。
-
他の外部SFTP統合に適用するのと同じSFTP サーバーのベストプラクティス に従って、キーベースの認証を使用してインスタンスのSFTP サーバーをプロビジョニングします。 Adobeには、開始に役立つ サンプル SFTP セットアップ スクリプト が用意されています。
-
新しいビルドで配信されたスクリプトを実行して、そのサーバーの接続の詳細をAdobe Analyticsに登録します。
code language-none nlserver javascript -instance:<instance_name> -arg:host=<sftp_host_url>#user=<sftp_user> -file <path_to_the_file>/aaremarketingLocation.js例:
code language-none nlserver javascript -instance:test_mkt_stage2 -arg:host=test-mkt-stage1.campaign.adobe.com#user=test -file ./nl6/datakit/nms/eng/js/aaremarketingLocation.js -
リマーケティングの書き出しは、固定セットのAdobe Analytics IP範囲からのみ開始されるため、SFTP サーバーでAdobeを許可リストに登録します。
- 現在のAdobe Analytics Data Collection IP アドレス を検索し、SFTP サーバーの許可リストに追加します。 FTP ベースのAnalyticsの書き出し(データフィードを含む)は、ロンドン、オレゴン、シンガポールの各地域のIPv4 アドレスからのみ送信されます。
- Adobe Analyticsの公開鍵を取得し、SFTP サーバー上の
authorized_keysファイルに追加して、Analyticsが認証できるようにします。
-
-
Campaign エクスプローラーツリーの 管理 > プラットフォーム > オプション の下のxtkOptionでオプションの
longvalueを1に作成または設定して、インスタンスでFEATUREFLAG_USE_ANALYTICS_20_API機能フラグを有効にします。 この手順は、上記のどのユースケースが該当するかに関係なく必要です。 -
古い接続を廃止する前に、インスタンスに適用される各ユースケースを実行して移行を検証します(テストキャンペーンを送信し、指標がAnalyticsに表示されることを確認し、必要に応じてリマーケティングデータを確認します)。
新しいWeb Analytics外部アカウントの設定 setting-up-a-new-web-analytics-external-account
インスタンスがAdobe ホスト型かオンプレミス/ハイブリッド型かを問わず、次の条件が適用されます。
既存のアカウントを移行せずに、初めてWeb Analytics外部アカウントを設定する場合は、外部アカウントの設定手順と コネクタの開始ガイド に従ってください。
Analytics 2.0では新しい分類処理が導入されるので、外部アカウントがレポートスイートの分類データを取得する前に、Adobe Analyticsで分類セットを作成する必要もあります。 これは新しい手順です。コンバージョン変数と成功イベントを設定した後、Campaignで外部アカウントを設定する前に作成します。
分類セットを作成するには:
-
Adobe Analytics上部のメニューバーから、コンポーネント > 分類セットを選択し、新規をクリックします。
-
新しい分類セットを追加 ダイアログで、次の操作を行います。
- 分類セットの 名前 を入力します。
- Typeを プライマリ に設定します。
- ジョブ通知で、分類セットジョブの成功または失敗に関する通知を受け取るユーザーを選択し、対応する電子メールアドレスを指定します。
- サブスクリプションで、前の手順で内部キャンペーン名として作成したレポートスイートとコンバージョン変数を選択します。
-
「保存」をクリックします。
この分類セットは、次の手順で外部アカウントを設定すると、Campaignによって自動的に検出されます。 分類セットについて詳しくは、Adobe Analytics ドキュメント を参照してください。
お困りですか? need-help
移行中に問題が発生した場合は、Adobe カスタマーケア にお問い合わせください。