Data Connectでレシピを作成する

Data Connectを有効にしてレシピの作成と管理を開始するには、Tealiumのカスタマーサクセスマネージャーに連絡してください。

レシピを作成するには、以下の手順を完了してください：

1. DataConnect > Integrationsに移動します。

2. Integrations画面で、Create > Recipeをクリックします。

3. My new recipeスライドアウトで、レシピの名前を入力し、レシピに関連付けられたプロファイルを選択します。

4. Pick a starting pointの下で、Workatoでアプリをトリガーする方法を選択します。

   • ビジネスケースに合わせてスケジュールで実行されるレシピを構築するには、Run on a scheduleを選択します。
   • 定期的にソースシステムから新しいデータをポーリングするレシピを構築するには、Trigger from an Appを選択します。

     Workatoトリガーについての詳細は、Workato Recipe ComponentsのドキュメントのTriggers記事を参照してください。アプリに利用可能なトリガーを確認するには、Pre-built Connectorsのドキュメントでアプリ固有のドキュメントを読んでください。

5. Start buildingをクリックします。

レシピを構築する

これで、Workatoでレシピの構築を開始できます。一般的に、レシピは特定のワークフローに従います：

1. トリガーを選択する。
2. アクションを構成する。
3. エラー処理を構成する。

ステップ1: トリガーを選択する

アプリベースのトリガー
Tealiumに統合したいアプリを検索します。スケジュールベースのレシピの場合、トリガーは構成したスケジュールです。

1. Triggerステップで、ビジネスケースに合ったトリガーを選択します。

   可能な場合はバッチ処理を使用して、レシピごとのタスク数を減らします。

2. Connectionステップで、アプリに接続します。接続名を入力し、構成を完了してConnectをクリックします。

3. Setupステップで、このアプリトリガーに追加の構成を追加します。より具体的なトリガーを構成したい場合は、トリガー条件を構成します。

ステップ2: アクションを構成する

1. Actionsの下で**+**をクリックします。

2. What happens next?でHandle errorsを選択します。 エラーモニタリングステップでTealium Eventsアプリと関連アクションをラップすることをお勧めします。

   ステップ3を完了して、レシピのエラー処理の構成を完了してください。ステップ3で説明されているようにレシピを停止しない場合、自動エラー通知は機能しません。

3. Tealiumにインポートするデータを準備するために必要なアプリを選択します。たとえば、Amazon S3に保存されている暗号化されたCSVデータを準備するために、Download file contents in Amazon S3、Decrypt and verify data、およびParse CSVアプリを一緒に使用します。

4. (オプション) データペイロードのサイズが500レコードを超える場合は、Tealium Eventsアプリでデータをより小さなペイロードサイズに分割するためにRepeat actionループを使用します。 このループを使用するには：

   1. **+**をクリックしてアクションのリストを表示します。
   2. Repeat actionをクリックします。
   3. ループのRepeat modeをBatch of itemsに構成します。
   4. Batch sizeをアプリの最大バッチサイズに構成します。

5. Select an app and actionの下で、Tealium Events V2アプリを選択します。

6. Tealium Connectデータソースからの情報を入力します。

   • Tealium Connect API Domain - Tealium Connectデータソースで使用されている地域のTealium Collect APIドメインを入力します。
   • Data Source Key - Tealium Connectデータソースからデータソースキーを入力します。
   • Tealium Account NameおよびTealium Profile Name - 対応するフィールドにTealiumアカウント名とプロファイル名を入力します。

     単一のアカウントには複数の対応するプロファイルがあります。このレシピからイベントを送信するTealiumプロファイルを指定してください。

7. Source Dataセクションで、アプリにソースデータを追加します。

   • Source Data source list - Recipe dataスライドアウトからデータをTealiumに送信するためのデータピルを選択します。Recipe dataスライドアウトからバッチ処理されたデータを挿入できます。

   • Visitor ID Value - 訪問ID値のデータピルを選択します。

     • 既知のユーザー識別子を使用して訪問ID属性でスティッチングする場合：レシピ内でユーザー識別子の値を含むデータピルを選択します。Visitor Attribute IDフィールドに対応する訪問属性IDを入力します。レシピからのイベントに構成される訪問ID属性を構成するために、任意の訪問ID属性のエンリッチメントを構成する必要があります。詳細については、Visitor ID attribute enrichment for Tealium Connectを参照してください。
     • 匿名識別子に基づいてデータをインポートする場合：レシピ内で匿名識別子を含むデータピルを選択します。Visitor Attribute IDフィールドを空のままにします。この値は直接tealium_visitor_idを構成します。

   • Visitor Attribute ID - この数値は、既存の訪問ID属性にtealium_visitor_idをマッチングするのに役立ちます。たとえば_{Account}_{Profile}_{Visitor Attribute ID}_{Visitor ID Value}_です。

     • 既知のユーザー識別子を使用して訪問ID属性でスティッチングする場合：訪問属性IDを入力します。AudienceStream > Visitor/Visit Attributesに移動し、使用したい訪問属性を選択し、属性IDをTealium Eventsアプリにコピーします。詳細については、Attribute IDsを参照してください。
     • 匿名識別子に基づいてデータをインポートする場合：このフィールドを空のままにします。

   • Attributes to add - Attributes to addセクションを展開します。WorkatoがTealiumに送信するイベントの各イベント属性のキーと値を指定します。

     Attributes to addには、大文字小文字を無視して一意の名前を持つフィールドが含まれていることを確認してください。
     Tealiumはすべてのイベントフィールド名を小文字で処理します。

     • ここに追加しないレシピのデータはTealiumに送信されません。
     • キーについては、Text入力を使用してイベント属性名を入力します。
     • 値については、Text入力を使用してイベント属性値をハードコードするか、データピルから値を作成します。
     • この機能を使用して、既存のTealium構成に合わせてキー名を編集し、新しい属性、エンリッチメント、および/またはルールの追加作業を最小限に抑えます。
     • イベント仕様を作成するには、このセクションにtealium_event値を追加します。
     • (オプション) アプリからではなく、Tealiumに送信したい追加の属性を追加します。たとえば、tealium_event、tealium_trace_id、または_dc_ttl_などです。これは訪問がどれくらい続くかを説明します。

       tealium_trace_idをデバッグ目的で使用する場合、1バッチで5イベント以上を送信することはできません。

8. (オプション) Hash Visitor IDを有効にするかどうかを選択します。訪問IDのハッシュ化が必要なユースケースの場合、Show optional fieldsをクリックし、Hash Visitor IDを有効にします。

   • 以前にVisitor Attribute IDを定義した場合、構築されたtealium_visitor_idにSHA-256ハッシュを適用する場合はYesを選択します。ほとんどの目的では、この値をNoに構成します。
   • スティッチングしている訪問ID属性の値にSHA-256ハッシュを適用する場合は、Visitor ID ValueフィールドでWorkatoのencode_sha256関数を使用します。

ステップ3: エラーハンドリングの構成

1. On Error ステップをクリックします。
2. Retry actions in Monitor block? で、アクションのリトライを選択します。
3. ジョブレポートにログメッセージを追加します。
   1. エラー発生時に追加アクションを追加するため + をクリックします。
   2. Action in an app をクリックし、Logger by Workato アプリを選択します。
   3. ログのメッセージを構成します。
4. レシピを停止します。
   1. エラー発生時に追加アクションを追加するため + をクリックします。
   2. Action in an app をクリックし、ReceipeOps by Workato アプリを選択します。
   3. Stop a recipe アクションを選択します。
   4. Whose account are you managing? で My account を選択します。
   5. Connect をクリックします。
   6. Setup ステップで、Recipe ドロップダウンリストから現在のレシピ名を選択します。
   7. Force stop ドロップダウンリストから Yes を選択します。
5. 現在のジョブを停止します。
   1. レシピの最後の + をクリックして、エラー発生時に追加アクションを追加します。
   2. Stop job をクリックします。
   3. In job report, mark stopped job as で、ドロップダウンリストから Failed を選択します。
   4. Reason for failure に Error と入力します。
6. Save をクリックします。
7. Test をクリックして、レシピの構成をテストします。

エラーハンドリングをテストするために、一時的に Tealium Events V2 アプリの Tealium Connect API Domain 構成を存在しないドメインに変更します。例えば、ドメインを xcollect-eu-west-1.tealiumiq.com に変更してエラーハンドリングをテストし、テストが完了したらドメインを collect-eu-west-1.tealiumiq.com に戻します。