Tajo は、ガバナンスの効いた同期ルールを通じて、ソースシステムから Brevo へデータを移動します。人が承認し、一方向で、スケジュールに従って実行され、最初から最後まで記録されます。この記事では、それが実際に何を意味し、何が含まれないのかを説明します。
はじめに確認 この記事は、Shopify と Brevo を接続し、同期ルールを 1 つ以上公開済みであることを前提としています。まだの場合は、Tajo と Shopify の接続から始めてください。
同期の構造
Tajo のすべての同期は 同期ルール、つまり「何がどのように移動するか」を確認・承認済みの定義です。ルールは 4 つの要素で構成され、コネクタ > 同期 のルールページで確認できます。
| 要素 | 役割 |
|---|---|
| フィールドマッピング | 各ソースフィールド、書き込み先の Brevo フィールド、その間に適用される変換 |
| フィルター式 | レコードごとに評価され、条件に一致しないレコードはスキップされます |
| カーソル | 同期の進行位置を追跡し、各実行が前回の続きから再開できるようにします |
| 実行履歴 | すべての実行と、その読み取り・書き込み・失敗レコード数、所要時間、ステータス |
データは 一方向、つまりソースから Brevo へ のみ流れます。Tajo が Shopify にデータを書き戻すことはありません。
データが同期されるタイミング
同期は スケジュールされたバッチ として実行されます。ルールのページから実行をトリガーすれば、オンデマンドでも実行できます。Tajo はリアルタイムパイプラインではありません。Shopify での変更は、数秒以内ではなく次回の実行時に Brevo に届きます。これは意図的な設計です。バッチ実行だからこそ、すべての書き込みが確認可能で、予算管理され、監査証跡の中で特定の実行に帰属させられるのです。
各実行は、カーソル以降の新規・変更レコードを読み取り、フィルターを適用し、フィールドをマッピングして Brevo に書き込みます。実行レコードには、読み取り・書き込み・失敗したレコード数が正確に表示されます。
ガバナンスの保証
同意はフェイルクローズド
同意ポリシーなしに同期ルールを公開することはできず、実行時に同意を証明できないレコードは書き込まれません。同意が確認できない場合、Tajo は推測せず書き込みを拒否します。失敗の方向は常に「慎重すぎる」側であり、「送りすぎる」側には決して倒れません。
実行は冪等
すべての書き込みには、ソースレコードから導出されたプロヴェナンスキー（個人情報を含まない形で生成）が付与されます。そのため、失敗後・一時停止後・手動での再実行でも、重複した書き込みは発生しません。ルールはいつ再実行しても安全です。
すべてが監査される
ルールの公開、すべての承認判断（記載された理由を含む）、すべての実行が監査証跡に記録されます。公開を許可した承認は、確認されたルールのバージョンそのものに紐づいており、ルールを編集すると承認は無効になります。つまり監査証跡は、実際に許可された内容を常に正確に反映します。
失敗が続くとルールは一時停止
実行が連続して失敗すると、サーキットブレーカーがルールを自動的に一時停止し、最後のエラーをルールのページに表示します。原因を修正してから再公開すると再開できます。部分的に失敗した実行は失敗件数を報告するため、何が書き込まれなかったのかを正確に把握できます。
配信停止の扱い
Tajo は メール同意の信頼できる情報源（source of truth）を Brevo としています。
- コンタクトが Brevo のメールフッターのリンクから配信停止すると、そのオプトアウトはコンタクトに記録され、Brevo は以降のキャンペーンからそのコンタクトを除外します。
- Brevo でブラックリストに登録されたコンタクトは除外されたままです。後続の送信によって復活することはありません。
- Tajo は配信停止ステータスを Shopify に書き戻すことは ありません。Shopify でもメール同意を収集している場合は、そちらで別途管理してください。2 つのシステムが互いをミラーリングしていると想定しないでください。
利用できるデータ
何が同期されるかは、ソースに用意されたテンプレートによって決まります。Shopify の場合、典型的には顧客レコード、つまり識別フィールドと、累計購入金額や注文数といった注文由来の属性が、セグメントやキャンペーンで使える Brevo のコンタクト属性にマッピングされます。ワークスペースでの正確なマッピングは説明文の中に隠れているわけではありません。同期ルールを開いてフィールドマッピングの表を読んでください。その表こそが「何が同期されるのか」への正式な答えです。
Tajo が現時点で行わないこと
長い機能リストよりも、境界を正確に示すことのほうが重要です。
- 双方向同期はありません。 配信停止も、タグも、エンゲージメントスコアも、Shopify には一切書き戻されません。
- リアルタイム同期はありません。 実行はスケジュールまたは手動トリガーのバッチであり、1 分未満のストリーミングではありません。
- 在庫トラッキングはありません。 商品の在庫レベルは監視されず、再入荷トリガーもありません。
これらの境界がユースケースの妨げになる場合は、チームにお知らせください。アーリーアクセスの優先順位は、まさにこうしたフィードバックによって決まります。
データの確認場所
- Tajo では：コネクタ > 同期 から同期ルールを開くと、実行履歴、カーソル位置、実行ごとの件数を確認できます。監査証跡には公開と承認が記録されます。
- Brevo では：コンタクト を開き、任意のコンタクトの属性を確認して、マッピングされたフィールドにデータが入っていることを確かめてください。それらの属性を使ってターゲティング用のセグメントを構築できます。
トラブルシューティング
- Brevo にコンタクトが表示されない：ルールの最新実行に失敗がないか、ステータスを確認してください（一時停止中のルールは実行されません）。Brevo にコンタクトが表示されないを参照してください。
- 実行が繰り返し失敗する：サーキットブレーカーがルールを一時停止し、最後のエラーを表示します。データが同期されないを参照してください。
- コンタクトが重複する：書き込みはソースレコード単位で冪等ですが、Brevo に元から存在していた重複はそのまま残ります。重複コンタクトを参照してください。
よくある質問
同期を速くできますか？ 同期ルールのページから、いつでもオンデマンドで実行をトリガーできます。リアルタイムモードはありません。
実行が途中で失敗したらどうなりますか？ 実行は失敗件数を報告し、カーソルは処理済みの範囲だけ進みます。次の実行が安全に残りをカバーし、冪等キーが重複を防ぎます。
同期内容を変更できますか？ はい。ルールのフィールドマッピングやフィルターを編集してください。編集すると新しいバージョンが作成され、有効になる前に再び公開承認を通す必要があります。
ルールが勝手に一時停止したのはなぜですか？ 実行の連続失敗でサーキットブレーカーが作動したためです。ルールのページに失敗回数と最後のエラーが表示されます。問題を修正して再公開してください。
関連記事
サポート
- ライブチャット：Tajo ダッシュボード（右下）から利用できます
- メールサポート：[email protected]
- ドキュメント：docs.tajo.io