Viant VDP変換APIコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：Viant API
APIバージョン：v1
APIエンドポイント：https://vdp-connect-api.viantinc.com
ドキュメント：Viant API

構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

クライアントID：必須。Viant VDP API認証用のクライアントID。
クライアントシークレット：必須。Viant VDP API認証用のクライアントシークレット。
アカウントID：必須。ViantのアカウントID。
広告主ID：必須。Viantの広告主ID。

アクション

アクション名	AudienceStream	EventStream
コンバージョンイベントの送信	✓	✓

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

コンバージョンイベントの送信

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：1,000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：10 MB

パラメータ

パラメータ	説明
コンバージョンイベントタイプ	PageView - ページビューイベント LandingPage - ランディングページイベント ItemView - アイテムビューイベント AddToCart - カートに追加イベント InitiateCheckout - チェックアウト開始イベント AddPaymentInfo - 支払情報追加イベント Purchase - 購入イベント Lead - リードイベント

売上データ

パラメータ	説明
トランザクションID	トランザクションの一意の識別子。自動マッピングが適用され、属性をオーバーライドしてマップします。
コンバージョンタイムスタンプ	コンバージョンのISO 8601タイムスタンプ。例：`2025-07-28T15:32:00Z`。自動マッピングが適用され、属性をオーバーライドしてマップします。
ストアID	ストアまたはロケーションの一意の識別子。
金額	総コンバージョンまたは取引金額。自動マッピングが適用され、属性をオーバーライドしてマップします。
通貨	通貨コード。例：`USD`, `EUR`。自動マッピングが適用され、属性をオーバーライドしてマップします。
販売チャンネル	販売チャンネル。例：`Online`, `In-store`。

識別子

パラメータ	説明
Email Apply SHA256	顧客のプレーンテキストのメールアドレス。コネクタは正規化を行い、SHA256ハッシュを適用します。
Email Already SHA256	SHA256ハッシュ化された顧客のメールアドレス。
Address Apply SHA256	顧客のプレーンテキストの住所。コネクタは正規化を行い、SHA256ハッシュを適用します。
Address Already SHA256	SHA256ハッシュ化された顧客の住所。
IPアドレス	顧客の`IP`アドレス。
モバイルID	顧客のモバイル`ID`。
Cookie	イベントのクッキー。

購入アイテム

パラメータ	説明
アイテムID	(アイテムが存在する場合は必須) 商品SKUの一意の識別子。
商品名	商品の人間が読める名前。
商品カテゴリ	商品のカテゴリ。
価格	(アイテムが存在する場合は必須) 単位あたりの価格。
数量	(アイテムが存在する場合は必須) 購入数量。
カスタムデータ	追加のコンテキスト用の最大10個のカスタムキー値メタデータペア。例：`キャンペーンID`, `ユーザーセグメント`。

コンバージョン場所

パラメータ	説明
コンバージョン国	コンバージョン場所の国。
コンバージョン州	コンバージョン場所の州。
コンバージョン市	コンバージョン場所の市。
自動マッピング無効	コネクタの自動マッピングを無効にします。