データコネクトでレシピを作成する

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アプリと関連アクションをエラーモニタリングステップでラップすることをお勧めします。

   レシピのエラーハンドリングを構成するために、Step 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 data sourceから情報を入力します。

   • 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に送信するデータを表すdatapill(s)を選択します。Recipe dataスライドアウトからバッチデータを挿入することができます。

   • Visitor ID Value - 訪問IDの値のためのdatapillを選択します。

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

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

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

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

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

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

       デバッグ目的でtealium_trace_idを使用する場合、一度に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ハッシングを適用したい場合は、Workatoのencode_sha256関数をVisitor ID Valueフィールドで使用します。

ステップ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に戻します。