Hightouch

注記

mParticleとRoktは同じプラットフォームです。 mParticleはRoktの会社であり、両者は単一の製品です。Hightouchの統合ディレクトリでは、Roktにフィードする2つの宛先が表示されます：

mParticle by Rokt: コンバージョンイベントを送信するために使用されます（このガイドの最初の部分で説明されています）。
Rokt: オーディエンスを同期するために使用されます（このガイドの最後に説明されています）。

これらはHightouchが別々にリストしているための2つの宛先に過ぎません。2つの異なる統合や2つの異なるベンダーではありません。送信するデータに一致する宛先を選択してください。どちらも1つのアカウントで同じRoktプラットフォームに接続します。

時間が経つにつれて、Roktはすべてのデータインターフェースを基盤となるデータプラットフォームとしてmParticleに移行しています。今日オーディエンスに使用されているRokt宛先は最終的に廃止され、mParticle by Roktに統合されるため、今行う設定はその移行が進行する中でも引き続き機能します。

Hightouchは、データウェアハウスから下流ツールにデータを同期するカスタマーデータプラットフォームです。このガイドでは、HightouchをRoktに接続し、コンバージョンイベントを直接ウェアハウスから送信する方法を説明します。設定後は追加のエンジニアリングは不要です。

このガイドの終わりまでに、次のことができるようになります：

HightouchでmParticle by Roktの宛先を作成
ウェアハウスデータをRoktのEvents APIフィールドにマッピング
キャンペーンの帰属と最適化に使用できるコンバージョンイベントを送信

前提条件前提条件への直接リンク

始める前に：

接続されたデータソースを持つHightouchアカウント: データウェアハウス（例：Snowflake、BigQuery、Redshift）がすでにHightouchにソースとして接続されている必要があります。
Rokt API資格情報: APIキーとAPIシークレット。これらはRoktのアカウントマネージャーから提供されます。

ステップ1: Rokt API資格情報を取得ステップ1: Rokt API資格情報を取得への直接リンク

Roktのアカウントマネージャーに連絡して、APIキーとAPIシークレットをリクエストしてください。Hightouchで宛先を作成する際に両方が必要です。

ステップ2: mParticle by Roktの宛先を作成ステップ2: mParticle by Roktの宛先を作成への直接リンク

Hightouchで、ワークスペースを開きます。
Destinations → Add destinationに移動します。
mParticleを検索して選択します。
APIキーとAPIシークレットを入力します。
接続に名前を付け（例：Rokt）、Test connectionをクリックして動作を確認します。

ステップ 3: 同期を作成するステップ 3: 同期を作成するへの直接リンク

宛先が設定されたら、どのデータを送信し、どのようにマッピングするかを定義するために同期を作成します。

Syncs → Add sync に移動します。
データソースモデル（変換データを含むクエリまたはテーブル）を選択します。
宛先として mParticle by Rokt を選択します。
同期タイプを Custom Event に設定します。

ステップ 4: フィールドをマッピングするステップ 4: フィールドをマッピングするへの直接リンク

これは最も重要なステップです。Rokt の Events API は特定の形式のデータを期待しています。以下の表は、何をどこにマッピングするかを正確に示しています。

固定値（これらはマッパーで手動で設定します）固定値（これらはマッパーで手動で設定します）への直接リンク

これらのフィールドはデータウェアハウスから来るものではなく、Hightouch で直接固定値として設定します：

フィールド	値	理由
Environment	`production`	常に `production` に設定します。テスト中でも同様です。これは Rokt にデータフォーマットのバージョンを伝えます。
Event name	`conversion`	これは変換イベントであることを Rokt に伝えます。
Custom event type	`transaction`	Rokt Events API スキーマで必要です。

Hightouch standard event setup

1. ユーザー識別子1. ユーザー識別子への直接リンク

Rokt はイベントをユーザーに一致させるために少なくとも1つの識別子を必要とします。利用可能な限り多くの識別子をマッピングしてください。より多くの識別子はより良い一致率を意味します。

あなたのデータ	マップ先	メモ
メールアドレス	`user_identities.email`	小文字で、前後にスペースがないこと
SHA-256 ハッシュ化されたメール	`user_identities.other`	プレーンテキストのメールを送信できない場合に使用します
あなたの内部顧客ID	`user_identities.customerid`	Rokt が同じユーザーからのイベントを時間をかけてリンクするのに役立ちます
Rokt Click ID	`user_identities.other2`	取得された場合、これは変換をそれを駆動した Rokt 広告クリックに直接リンクします

Rokt Click ID とは？

ユーザーが Rokt 広告をクリックすると、Rokt は一意の Click ID を生成し、あなたのサイトに渡します（通常は URL パラメータとして）。あなたのデータウェアハウスがこの値を取得した場合、それを含めてください。これは帰属精度を大幅に向上させます。

データのハッシュ化

SHA-256 で値をハッシュ化する前に：すべてのテキストを 小文字 にし、空白を トリム し、電話番号を 5551234567 形式に 正規化 します（ダッシュ、スペース、国コードなし）。

Hightouch user identities mapping

あなたのデータ	マップ先	メモ
イベントが発生した時刻	`events[].data.timestamp_unixtime_ms`	ミリ秒単位のUnixタイムスタンプ。ほとんどのデータウェアハウスではエポックミリ秒として保存されます。秒単位で保存されている場合は、1000倍してください。
このイベントのユニークID	`events[].data.source_message_id`	注文ID、取引ID、または安定したユニークな値を使用してください。Roktはこれを使用してイベントを重複排除します。
顧客のIPアドレス	`ip`	任意。地理位置情報と不正検出に使用されます。

3. コンバージョン属性3. コンバージョン属性への直接リンク

これらのフィールドはユーザーの行動を説明し、Roktのレポートと最適化に直接使用されます。

あなたのデータ	マップ先	必須	メモ
コンバージョンの種類	`events[].data.custom_attributes.conversiontype`	はい	アクションの短いラベル: `purchase`, `signup`, `subscription` など。この値を定義し、イベント全体で一貫性を保ってください。
注文または確認番号	`events[].data.custom_attributes.confirmationref`	推奨	同じコンバージョンが複数回受信された場合に、Roktがイベントを重複排除するために使用されます。
取引額	`events[].data.custom_attributes.amount`	いいえ	文字列として送信: `"99.99"`
通貨	`events[].data.custom_attributes.currency`	いいえ	ISO 4217コード: `"USD"`, `"EUR"`, `"GBP"`

Hightouchカスタムイベント属性マッピング

4. ユーザー属性4. ユーザー属性への直接リンク

送信するユーザー属性が多いほど、Roktはより良いマッチングと最適化が可能になります。これらは必須ではありませんが、Roktはできるだけ多くの属性をマッピングすることを強く推奨します。

あなたのデータ	マップ先
名	`user_attributes.firstname`
名 (SHA-256)	`user_attributes.firstnamesha256`
姓	`user_attributes.lastname`
姓 (SHA-256)	`user_attributes.lastnamesha256`
携帯番号	`user_attributes.mobile`
携帯番号 (SHA-256)	`user_attributes.mobilesha256`
年齢	`user_attributes.age`
生年月日	`user_attributes.dob` (フォーマット: `yyyymmdd`)
性別	`user_attributes.gender` (例: `M`, `Female`)
市	`user_attributes.city`
州	`user_attributes.state`
郵便番号	`user_attributes.zip`
称号	`user_attributes.title` (例: `Mr`, `Ms`)
言語	`user_attributes.language`
顧客価値	`user_attributes.value`
予測生涯価値	`user_attributes.predictedltv`

Hightouchユーザー属性マッピング

上記に記載されていない追加のプロファイルフィールドがある場合は、Hightouchのカスタム属性マッピングを使用して user_attributes.<your_custom_key> にマッピングできます。

Hightouchカスタムユーザー属性マッピング

5. デバイス情報5. デバイス情報への直接リンク

デバイスレベルのデータが利用可能な場合は、ここにマッピングしてください。これにより、モバイルユーザーのマッチ率が向上します。絶対にこれらをユーザー属性に入れないでください。これらは device_info オブジェクトに属します。

あなたのデータ	マップ先
ブラウザまたはデバイスのユーザーエージェント	`device_info.http_header_user_agent`
iOS 広告 ID (IDFA)	`device_info.ios_advertising_id`
Android 広告 ID (AAID)	`device_info.android_advertising_id`

完全な例完全な例への直接リンク

Rokt に到達したときの完全にマッピングされたコンバージョンイベントの例は次のとおりです。

{
  "environment": "production",
  "ip": "203.0.113.42",
  "device_info": {
    "http_header_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)"
  },
  "user_identities": {
    "email": "jane.smith@example.com",
    "customerid": "cust_123456",
    "other2": "rokt-click-id-from-url-param"
  },
  "user_attributes": {
    "firstname": "Jane",
    "lastname": "Smith",
    "zip": "10001",
    "city": "New York",
    "state": "NY"
  },
  "events": [
    {
      "event_type": "custom_event",
      "data": {
        "event_name": "conversion",
        "custom_event_type": "transaction",
        "source_message_id": "order_789012",
        "timestamp_unixtime_ms": 1735689600000,
        "custom_attributes": {
          "conversiontype": "purchase",
          "confirmationref": "ORD-789012",
          "amount": "149.99",
          "currency": "USD"
        }
      }
    }
  ]
}

制限制限への直接リンク

リソース	制限
リクエストの合計サイズ	256 KB
秒あたりのバッチ数	270
イベント属性値の長さ	4096 文字
バッチあたりのユーザー属性	100
ユーザー属性値の長さ	4096 文字

エラーリファレンスエラーリファレンスへの直接リンク

同期が失敗した場合、Hightouch が報告するステータスコードを確認してください。

ステータス	意味	対処方法
`202 Accepted`	成功	対応不要
`400 Bad Request`	ペイロードが不正または必須フィールドが欠落	`event_name`、`custom_event_type`、および `conversiontype` がすべて設定されていることを確認
`401 Unauthorized`	API キーまたはシークレットが欠落	宛先設定で資格情報を再入力
`403 Forbidden`	API キーまたはシークレットが無効	Rokt アカウントマネージャーに連絡して資格情報を確認
`429 Too Many Requests`	レート制限を超過	同期頻度またはバッチサイズを減らす
`5xx Server Error`	Rokt 側の問題	再試行。通常、Hightouch が自動的に処理します

統合セットアップ（オーディエンス）統合セットアップ（オーディエンス）への直接リンク

オーディエンス同期には、Hightouch の Rokt 宛先を使用します。（Hightouch はこの同期タイプを UI で Segment とラベル付けしていますが、同じものです。）これは、上記のイベントで使用される mParticle by Rokt 宛先と同じ Rokt プラットフォームです。Hightouch はこれらを別々の宛先としてリストしています。オーディエンスは API キーのみで認証されます（App ID や App Secret は不要）。

Rokt が基盤となるデータプラットフォームとして mParticle に移行する一環として、オーディエンス同期も最終的には mParticle by Rokt 宛先に移行します。この変更が展開されるまで、Rokt 宛先がオーディエンス同期を設定するための適切な場所です。

認証認証への直接リンク

Rokt Audiences の宛先と認証するには、API キーが必要です。API キーを発行してもらうには、アカウントマネージャーに連絡してください。

Rokt 宛先（オーディエンス）の作成Rokt 宛先（オーディエンス）の作成への直接リンク

Hightouch アカウントにログインし、Rokt を接続したいワークスペースをクリックします。
左側のツールバーで Destinations をクリックし、次に Add Destination をクリックします。
Rokt を検索し、Rokt をクリックして Continue をクリックします。
ここに API キーを追加します。オーディエンス（セグメント）統合には、Account ID、App ID、および App Secret は必要ありません。
Continue をクリックします。
接続に名前を付けます。例: Rokt Integration。
Finish をクリックします。
Test Connection をクリックします。上記の手順を正しく完了した場合、成功メッセージが表示されます。
これで、Rokt を宛先として設定する作業が完了しました。