パイプラインのトラブルシューティング

パイプライン化されたプロセスが失敗し、「No task corresponds to the mask pipelined@< instance >」（<インスタンス> でパイプライン化されたマスクに対応するタスクがありません）というエラーが表示される

お使いのバージョンの Adobe Campaign Classic はパイプラインをサポートしていません。

1. 設定ファイル内に pipelined 要素が存在するかどうかを確認します。存在しない場合は、パイプラインはサポートされていません。
2. Campaign 20.3 または Gold Standard 11 にアップグレードします。

[ {パイプライン化されたプロセスが失敗し、「aurait dû commencer par ou (iRc=16384)」と表示される

NmsPipeline_Config オプションが設定されていません。これは実際には JSON 解析エラーです。
JSON 設定を NmsPipeline_Config オプションで指定します。このページの「ルーティングオプション」を参照してください。

パイプライン化されたプロセスが失敗し、「the subject must be a valid organization or client」（件名は有効な組織またはクライアントにする必要があります）と表示される

組織識別子の設定が無効です。

1. IMSOrgId が serverConf.xml で設定されていることを確認します。
2. デフォルトを上書きできる空の IMSOrgId をインスタンス設定ファイル内で探します。該当する場合は、削除します。
3. IMSOrgId が Experience Cloud 内の顧客の IMSOrgId と一致することを確認します。

パイプライン化されたプロセスが失敗し、「invalid key」（キーが無効です）と表示される

インスタンス設定ファイルの @authPrivateKey パラメーターが正しくありません。

1. authPrivateKey が設定されていることを確認します。
2. authPrivateKey が @ から始まり、= で終わり、およそ 4000 文字の長さであることを確認します。
3. 元のキーを探します。元のキーが、RSA 形式で、4096 ビット長であり、「-----BEGIN RSA PRIVATE KEY-----」で始まることを確認します。
   
   必要に応じて、キーを再作成し、Adobe Analytics に登録します。
4. キーが pipelined と同じインスタンス内でエンコードされたことを確認します。
   必要に応じて、サンプルの JavaScript またはワークフローを使用してエンコードをやり直します。

パイプライン化されたプロセスが失敗し、「unable to read the token during authentication」（認証時にトークンを読み取れません）と表示される

秘密鍵の形式が無効です。

1. このページで鍵の暗号化の手順を実行します。
2. キーが同じインスタンスで暗号化されていることを確認します。
3. 設定ファイルの authPrivateKey が生成されたキーと一致することを確認します。
   必ず OpenSSL を使用してキーペアを生成してください。例えば、PuttyGen では適切な形式が生成されません。

トリガーが取得されない

pipelined プロセスが実行中で、トリガーが取得されない場合は、次の手順に従います。

1. トリガーが Analytics でアクティブで、イベントを生成していることを確認します。
2. pipelined プロセスが実行中であることを確認します。
3. pipelined ログでエラーを探します。
4. pipelined ステータスページでエラーを探します。trigger-discarted、trigger-failures は 0 でなければなりません。
5. トリガー名が NmsPipeline_Config オプションで設定されていることを確認します。疑わしい点がある場合は、ワイルドカードオプションを使用します。
6. Analytics がアクティブなトリガーを持ち、イベントを生成していることを確認します。設定が Analytics でおこなわれてから、設定が有効になるまでに数時間の遅延が生じる可能性があります。

イベントが顧客にリンクされていない

一部のイベントが顧客にリンクされていない場合は、次の手順に従います。

1. 紐付けワークフローが実行中であることを確認します（該当する場合）。
2. イベントに顧客 ID が含まれていることを確認します。
3. 顧客 ID を使用して顧客テーブルに対するクエリを作成します。
4. 顧客インポートの頻度を確認します。新規顧客は、ワークフローで Adobe Campaign にインポートされます。

イベント処理の遅延

Analytics のタイムスタンプが、Campaign でのイベントの作成日時よりはるかに古い場合。

一般に、トリガーでマーケティングキャンペーンが起動されるまでに 15～90 分かかることがあります。これは、データ収集の実装、パイプラインでの読み込み、定義済みトリガーのカスタム設定、Adobe Campaign 内のワークフローによって異なります。

1. pipelined プロセスが実行されているかどうかを確認します。
2. 再試行の原因となる可能性のあるエラーを pipelined.log で探します。該当する場合は、エラーを修正します。
3. pipelined ステータスページでキューのサイズを確認します。キューのサイズが大きい場合は、JS のパフォーマンスを向上させます。
4. ボリュームに伴って遅延が増加するようなので、メッセージを少なくして Analytics にトリガーを設定します。

既存の認証からAdobeI/O認証へのステージインスタンスのアップグレード

ステージインスタンスで統合認証を変更しても、実稼動インスタンスの設定には影響しません。 ステージインスタンスをアップグレードし、認証をAdobeI/Oに更新して、ステージインスタンスでトリガーをテストすることもできます。

実稼動インスタンスは引き続き従来の認証を使用し、この変更による影響は受けません。