マーケター向けのトラブルシューティング:ワークフローと配信に関する 5 つの一般的なエラー
- 適用対象:
- Campaign Standard
作成対象:
- 初心者
- 中級
- 経験者
- ユーザー
著者:Suraj Patra、シニアコンサルタント、Meijer
過去 5 年間にわたり、Adobe Experience Cloudのシニアエンジニアおよびカスタマーエキスパートとして、1934 年に設立されたアメリカのスーパーセンターチェーンである Meijer のビジネスユーザーが、ACS で複雑なマーケティングおよびトランザクションキャンペーンを実行できるようにしています。 私が取り組んでいるプロジェクトには、パーソナライゼーションのためのオファーや注文の詳細の保存、Adobe Audience Managerとの統合、セグメント取り込みのためのカスタマーインサイトを行うためのカスタマイズされたキャンペーンなどがあります。
ACS を使用している間にエラーが発生しました。これは、解決に時間がかかり、フラストレーションを伴う可能性があります。 最も一般的なエラーを把握することで、問題解決の迅速化と生産性の向上に役立ちます。 同様のエラーが発生した場合に効果的に解決するのに役立つ、トラブルシューティングのヒントを以下に示します。
データタイプ不一致エラー
エラーコード:PGS-220000 PostgreSQL error: ERROR: operator does not exist: character varying = bigint
原因:
これらのタイプのエラーは、異なるデータタイプのフィールドを使用して紐付けしようとしたときにワークフローに表示されます。 例えば、「文字列」フィールドを持つ「ファイルを読み込み」を使用してファイルをアップロードし、文字列フィールドを、データタイプが int のプロファイルフィールドと紐付けしようとした場合です。
解決策:
「ファイルを読み込み」アクティビティのフィールドのデータタイプを、一致するデータタイプに変更します。 「ファイルを読み込み」アクティビティを開きます。 「列定義」タブに移動し、目的のフィールドのデータタイプを変更します。
配信Personalization エラー
エラーコード:The schema for profiles specified in the transition ('') is not compatible with the schema defined in the delivery template ('nms:recipient'). They should be identical.
原因:
このエラーは、メールをアドレスに送信しているとき、メールやその他の識別子がプロファイルと紐付けされない場合に表示されます。 メール通信を送信するには、メールまたは識別子が常にプロファイルにリンクされている必要があります。
解決策:
読み込んだファイルから、受信者テーブルに共通の ID が存在する必要があります。 この共通キーは、紐付けアクティビティ内の受信者テーブルに読み込みファイルを結合します。 受信者テーブルに存在しないレコードにはメールが送信されない場合があります。この場合、ワークフロー内でこの紐付けステップが必要になります。 その際に、受信した読み込みファイル アクティビティを、プロファイルのメール ID などの識別子と紐付けます。 nms:recipient
スキーマはプロファイルテーブルを参照し、受信レコードをプロファイルと紐付けすると、メールの準備中に使用できるようになります。
以下に示すように、紐付けアクティビティのスクリーンショットを参照します。
詳しくは、 紐付けを参照してください。
共通フィールドデータセットエラー
エラーコード:The document types of inbound events (''and'') are incompatible (step 'Exclusion'). Unable to perform the operation.
原因:
この問題は、ACS ワークフローで 除外アクティビティ を使用しているとき、ID に基づいて除外を実行するとき、プライマリセットと除外セットが同じフィールド名を持っていないときに発生します。
解決策:
このエラーを解決する方法は 2 つあります。
-
プライマリと除外の両方で同じフィールド名を使用し、そのフィールドを ID として使用します。
あるいは
-
JOINS 除外メソッドを使用して、レコードを除外するフィールドを選択します。
フィールド名のドロップエラー
エラーコード:XTK-170036 Unable to parse expression 'i__name'
原因:
エラーポイントは、エンリッチメントアクティビティ で発生する場合があります。 最も一般的なものの 1 つを以下に示します。
これは、アクティビティの式名を手動で編集したときに発生します。 この画像は、式が name
から i__name
に変更されたことを示しています。
解決策:
このエラーは次の 3 つの方法で解決できます。
-
名前を元の式に戻します。
-
新しい名前を使用する場合は、エンリッチメントアクティビティ の値を変更します。
-
何が変更されたかを覚えていない場合は、アクティビティを再作成することをお勧めします。
一時テーブルの削除エラー
エラーコード:XTK-170024 The temporary schema "temp:deliveryEmail1" is not defined in the current context.
原因:
これは、エンリッチメントやその他のアクティビティを含む複雑なワークフローで発生する一般的なエラーです。 ワークフローに対して複数の変更を行う際に、一部のアクティビティワークフローが正しく保存されないことがあります。
解決策:
このエラーが発生する可能性がある方法は多数あるので、単純な修正はありません。 単純なワークフローの場合は、アクティビティを再設定する方が良いでしょう。 複雑なワークフローでは、ワークフローアクティビティを新しいワークフローにコピーし、保存して再実行する方が効率的です。