Clinchコネクタ構成ガイド | サーバーサイドコネクター

API情報

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

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

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

アクション名	AudienceStream	EventStream
イベント送信	✗	✓

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

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

パラメータ	説明
`referrer`	イベントが発生したページのURL。
`timestamp`	イベントのタイムスタンプ（UTC）。
`tcf`	IAB（Interactive Advertising Bureau）を使用したGDPR同意文字列。
`user_ip`	ユーザーのIPアドレス。
`user_agent`	ユーザーエージェント。

イベントタイプを選択します。以下の値が利用可能です：

イベントタイプ	説明
`PageView`	ページビュー
`HomePage`	ホームページビュー
`Landing`	ランディングページビュー
`Search`	検索結果ページビュー
`Category`	カテゴリページビュー
`Details`	製品詳細ページビュー
`DetailsExit`	製品詳細ページからの退出ビュー
`AddToCart`	カートに追加
`RemFromCart`	カートから削除
`CartPage`	カートページビュー
`AddToWishList`	ほしい物リストに追加
`Checkout`	チェックアウトの開始またはチェックアウトの任意のステップ
`conv`	購入またはその他の明確なコンバージョンイベント
`Registration`	登録、コンバージョンとみなされることもある
`OfflineConv`	オフラインコンバージョン、例えば店舗での購入
`Other`	その他のイベント

パラメータ	説明
`stype`	イベントの二次タイプ（通常、コンバージョンイベントで提供される）。
`product`	イベントに製品またはカテゴリが含まれる場合の製品タイプ。例えば、`Ecommerce`, `Flight`, `Hotel`, `Package`, `Car`など。

パラメータ	説明
`clinch-sid`	Clinchとのクッキー同期を通じて取得されたClinchクッキーID、またはウェブサイトのファーストパーティクッキー`clinch-sid`から読み取られる。
`clinchClickId`	`clinchClickId_{client_enc_id}`に期待される値は、クッキー`clinchId_{client_enc_id}`のファーストパーティクッキー値です。
Email Address	(既にSHA256ハッシュ化されている) 既にSHA256ハッシュ化されたメールアドレスを提供します。
Email Address	(SHA256ハッシュを適用) プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
`atsEnvelop`	LiveRamp認証済みトラフィックソリューション（ATS）の封筒。
`uid2_0`	`UID2.0`識別子。
`did`	ADIDやIDFAなど、リセット可能なモバイル広告ID。

パラメータ	説明
`ids`	閲覧された製品IDのコンマ区切り文字列。これらのIDは製品フィードの製品IDと一致する必要があります。
`category`	製品カテゴリ。この値は製品フィードのカテゴリと一致する必要があります。
`recommended`	推奨される製品IDのコンマ区切り文字列。これらは、ユーザーが関与した製品ではなく、ウェブサイトまたはベンダーの推奨エンジンがユーザーに提案する可能性のある製品IDです。これらの値は製品フィードの製品IDと一致する必要があります。
`term`	検索イベントからの検索用語。

パラメータ	説明
`from`	出発地の都市または空港データコード。このコードは製品フィードの都市または空港コードと一致する必要があります。
`to`	目的地の都市または空港データコード。このコードは製品フィードの都市または空港コードと一致する必要があります。
`depart`	出発日を`ISO 8601`形式で。例えば、`2023-09-21`。
`return`	帰国日を`ISO 8601`形式で。例えば、`2023-09-21`。
`city`	ホテル製品の都市コード。このコードはホテルフィードの都市パラメータと一致する必要があります。
`ids`	ホテルIDのコンマ区切りリスト。

パラメータ	説明
`tcf_string`	GDPR TCF（透明性と同意フレームワーク）文字列。
`ccpa_string`	CCPAプライバシー文字列。このパラメータは廃止され、Global Privacy Platform（GPP）に置き換えられました。代わりに`gpp_string`を使用してください。
`gpp_string`	GPP同意文字列。

一つ以上の属性を選択します。コネクタはこれらの属性をコンマ区切りリストとしてClinchのユーザープロファイルに送信します。

以下の例の表は、オンラインストアのカテゴリページを閲覧するイベントのパラメータをリストしています。カテゴリはmens-shoesで、ユーザーは3つの製品を閲覧しました。イベントにはhemハッシュ化されたメール識別子が含まれています：

パラメータ	例の値
`cid`	`ter634`
`dsid`	`53ter45`
`product`	`ecommerce`
`type`	`Category`
`ids`	`111,222,333`
`timestamp`	`1664064000`
`hem`	`a64d47276a22f4eb7ee9e4203d2c627d`
`referrer`	`https://myonlinestore.com/category/mens-shoes`

以下の例の表は、ウェブサイトで車のページを閲覧するイベントのパラメータをリストしています。カテゴリはcarで、イベントにはhemハッシュ化されたメール識別子が含まれています：