Hightouchは、企業がデータウェアハウスと分析、マーケティング、および運用に使用する他のさまざまなツールやプラットフォームとの間でデータを同期できるようにするデータ統合プラットフォームです。ユーザーは、複雑なETL（抽出、変換、ロード）プロセスやカスタムコーディングを行うことなく、データウェアハウスをCRM、マーケティングオートメーションプラットフォーム、カスタマーサポートシステムなどのツールに簡単に接続することができます。
HightouchとSingularの統合は、Singular Server-to-Server(S2S) REST APIを使用して、Hightouchソース（ウェアハウス）からモバイル（iOS/Android）イベントデータを送信します。これはHightouchプラットフォームでは「デスティネーション」と呼ばれます。以下の手順は、HightouchでSingular Destinationを設定する方法を示しています。
| エンジニアリングチーム向け要件ガイド |
|
この統合を使用するには、Singular Mobile SDKからの最後の既知のイベントに一致する、すべての必要なSingularデータポイントを持つHightouchソースを使用する必要があります。
この統合は非モバイルイベントデータとは互換性がありません。サーバーまたはウェブイベントはサポートされていません。
-
Hightouchがサポートする同期タイプ：イベント
HightouchはSingularへのアプリ内イベントの同期をサポートしています。
サポートされる同期モード：挿入のみ
- セッションイベント
- ウェブイベント
- モバイルデータポイントのないサーバーサイドイベント
HightouchインテグレーションはSingular SDKの代替ではありません。Singular SDKをHightouchと並行して使用する必要があります。これは、Singular発行のSDKを介したクライアント内と、同じデバイス/ユーザーのREST APIエンドポイントの両方からデータ収集が行われるハイブリッド統合です。HightouchからSingularに送信されたイベントはすべて、ユーザーの最終確認済みモバイルデバイスに関連付けられ、当該デバイスの最終確認済みキャンペーンデータにコホートされます。
はじめに
HightouchでSingular宛先のインスタンスを作成することから始めます。インスタンスを作成したら、認証のためにSingular SDKキーを入力する必要があります。
- Hightouchのナビゲーションメニューから、をクリックします：「セットアップ > デスティネーション」をクリックします。
- デスティネーションの追加」ボタンをクリックします。
- Singular」を検索し、「Continue」をクリックします。
- API Key」フィールドにSingular SDK Keyを入力します。続行をクリックします。
Singularダッシュボードの"デベロッパーツール > SDKインテグレーション > SDKキー "からSingularの"SDKキー "を入手してください。
- 保存先に名前を付け、"完了 "をクリックします。
重要： "Test Connection "ボタンをクリックすると、以下のエラーが表示される場合があります：
これはAPIが追加のデータポイントを必要とするためで、次のステップで設定します。
追加セットアップ
モデルを構成する
- Hightouchナビゲーションメニューから「モデル」を選択し、新しいモデルを追加します。
- データソースを選択し、「続行」をクリックします。
- モデルの名前を入力し、ドロップダウンから主キーを選択します。
同期が各イベントを送信するようにするには、イベントモデルが本当に一意の主キーを使用する必要があります。詳細については、イベントシンクのドキュメントを参照してください。
シンクを設定する
- Hightouchナビゲーションメニューから「Sync（同期）」と「Add Sync（同期の追加）」を選択します。
- Singular用に設定されたモデルを選択します。
- Singular Destinationを選択します。
- 必須：単一イベント名として使用するイベント名列をドロップダウンメニューから選択します。
- 必須：ドロップダウンメニューからタイムスタンプカラムを選択します。
- Singularに同期させたい他のカラムを選択します。
クエリー結果のカラムをデスティネーションのフィールドにマッピングする方法を設定します。Singularデスティネーションには、"プラットフォーム "フィールドに基づく条件付き必須フィールドがあることに注意してください。
必須の追加パラメータマッピング：
イベントにマッピングされるべきパラメータの詳細については、Singular S2S ReferenceHEREの必須イベントパラメータを参照してください。
IPフィールドをマッピングしない場合、Hightouchのサーバーからのものがデフォルトになります。
デバイス識別子について
Hightouchから送信されたイベントをSingularの既存のデバイスに正しく帰属させるには、一致するデバイス識別子を使用する必要があります。内部BIエンドポイントオプションが倉庫へのサインインイベントからデータをキャプチャするように設定されている場合、このイベントリクエストで同じ識別子を使用する必要があります。
iOS の場合、これは IDFA または IDFV になります。NULL "値やゼロの識別子を提供しないでください。もしSingular SDKが初期化されたときにIDFAがデバイス上で利用できなかった場合、SingularはIDFVの値を使用します。
Androidの場合、これはAIFA（別名GAID）またはASIDになります。NULL」値やゼロになった識別子を提供しないでください。Singular SDKが初期化されたときにAIFAがデバイス上になかった場合、SingularはASID値を使用します。デバイス上でAIFAもASIDも利用できない場合は、Android ID (ANDI)を指定してください。
- パラメータのマッピングが完了したら、"Test "ボタンを使ってイベントをテストできます。
テストで使用するソースデータからIdentifierをキャプチャし、Singular Testing Consoleを使用してリアルタイムで受信されるイベントを確認します。イベントのテスト方法についてはこちらをご覧ください。
例
マッピング
テスト
Singular テストコンソール - テストが成功したら、continueをクリックし、Schedule Typeを設定し、Finishをクリックします。
SkAdNetwork サポート
SingularのSkAdNetwork（SKAN）コンバージョンモデルでHightouchから送信されたイベントを使用するには、Singularアカウントで「ハイブリッドSKAN」機能を有効にする必要があります。CSMにご連絡いただくか、Singularサポートリクエストを送信して有効化してください。
イベント
ソースに追加されたレコードは新しいイベントとして扱われ、シンク実行時にSingularに送信されます。
カスタムマッピングを使用して、アプリケーションに関連するカスタムデータを添付することができます。
カスタムマッピングはAPIリクエストペイロードの"e " パラメータとして含まれます。
ヒントとトラブルシューティング
不一致
Server-to-Serverイベントリクエストで使用されるデバイス識別子がSingularで一致しない場合、不一致が発生します。以下の可能性に注意してください：
- イベントリクエストが、アプリセッションからSingular SDKがデバイス識別子を記録する「前」に受信された場合、そのイベントリクエストは未知のデバイスの「最初のセッション」とみなされ、Singularはそのデバイスをオーガニックアトリビューションとしてアトリビュートします。
- Singular SDKがデバイス識別子を記録したが、Singular SDKの識別子がServer-to-Server Eventリクエストで指定されたデバイス識別子と異なる場合、イベントの帰属は正しくありません。
一般的なエラー
エラーが発生した場合は、Singularの必須フィールドがすべて含まれていることを確認してください：「Platform"、"Package Name"、"OS Version"、そして該当するPlatformのデバイス識別子を入力してください。
ライブデバッガー
Hightouchは、各同期の実行中に行われたAPIコールを完全に可視化します。詳細については、デバッグのヒントとトリックの記事を読むことをお勧めします。
同期アラート
Hightouchは、Slack、PagerDuty、SMS、または電子メールを介して同期の問題を警告することができます。詳細については、アラートに関する記事をご覧ください。