CJトラッキングAPIコネクタの構成ガイド | サーバーサイドコネクタ

CJは、ウェブトラッキングイベントにおいてUniversal TagとトラッキングAPIを同時に使用することをお勧めします。それぞれがCJのオファリングをサポートまたはエンリッチメントします。トラッキングAPIを使用するには、CJ側でバックエンドの変更が必要であり、クライアント統合チームとの協力が必要です。詳細については、CJアカウントチームまたはsupport@cj.comにお問い合わせください。

API情報

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

API名：CJ API
APIエンドポイント：https://tracking.api.cj.com
ドキュメント：CJ API

バッチ制限

このコネクタは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：10000
最も古いリクエストからの経過時間の最大値：10分
リクエストの最大サイズ：100 MB

コネクタアクション

アクション名	AudienceStream	EventStream
注文データの送信	✗	✓

構成の構成

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

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

パーソナルアクセストークン
必須: CJトラッキングAPIのパーソナルアクセストークン。アカウントにログインして、CJパーソナルアクセストークンページに移動して、パーソナルアクセストークンを生成します。

コネクタの構成が完了したら、完了をクリックします。

アクション構成 — パラメータとオプション

続行をクリックして、コネクタアクションの構成を行います。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション — 注文データの送信

パラメータ

パラメータ	宛先	説明
エンタープライズID	enterpriseId	(必須) CJのクライアント統合チームによって割り当てられた一意のクライアントID。
アクショントラッカーID	actionTrackerId	(必須) アクションのためにCJのクライアント統合チームから与えられた静的な値。
CJイベント	ciEvent	(必須) CJで定義された関連イベントID（CJクリックIDとも呼ばれる）。
注文ID	orderId	(必須) クライアントで定義された注文識別子。
イベント時刻	eventTime	(必須) イベントのタイムスタンプ。
注文金額	amount	(必須) 注文の合計金額。
注文割引	discount	注文に適用される割引。
クーポンコード	coupon	注文に適用されるクーポンコード。
通貨	currency	注文で使用される通貨。
商品価格	unitPrice	注文内の各商品の単価の配列。
商品SKU	sku	注文内の各商品のSKUの配列。
商品数量	quantity	各商品の注文数量の配列。
商品割引	discount	商品の単価に適用される割引の金額の配列。
広告主の垂直		サポートされる値は次のとおりです：Retail、Finance、Travel、NetworkServices。
付随的な支出	ancillarySpend	トランザクションの付随的な支出金額（広告主専用属性）、
年会費	annualFee	この商品に関連する年会費。
申請ステータス	applicationStatus	トランザクションがCJに送信された時点での申請のステータスを識別します。
APR	apr	申請承認時のAPR。
APR転送	aprTransfer	転送用のAPR。
APR転送期間	aprTransferTime	APR転送期間（月単位）。
予約日	bookingDate	予約が行われた日付（形式：`YYYY-MM-DD`）。
予約ステータス	bookingStatus	予約のステータス（例：確定、保留中など）。
税抜き予約金額	bookingValuePostTax	税金を含まない予約の金額。
税込み予約金額	bookingValuePreTax	税金を含む予約の金額。
ブランド	brand	購入された商品のブランド。
ブランドID	brandId	予約された商品のブランド識別子。
ビジネスユニット	businessUnit	顧客が購入したビジネスユニット。
キャンペーンID	campaignId	広告主固有のマーケティングキャンペーンID。
キャンペーン名	campaignName	広告主固有のマーケティングキャンペーン名。
カードカテゴリ	cardCategory	カードカテゴリの名前。
カーオプション	carOptions	トランザクション中に選択されたその他のカーオプション（例：保険）。
キャッシュアドバンス手数料	cashAdvanceFee	この商品に関連するキャッシュアドバンス手数料。
カテゴリ	category	商品のカテゴリ（例：顧客がパーソナルキャッシュバッククレジットカードを申請する場合、`service_type=cc&item_type=personal&category=cashback`）。
都市	city	ホテルやイベントの場所の都市名。
クラス	class	予約または購入された商品のクラス評価。
確認番号	confirmationNumber	プロバイダーの確認番号（例：航空会社からのフライト確認番号）。
契約期間	contractLength	契約の期間（月単位）。
契約タイプ	contractType	契約の広告主固有の説明。
国コード	countryCode	トランザクションが発生した国。
クーポン割引	couponDiscount	使用されたクーポンから割引された金額。
クーポンタイプ	couponType	使用されたクーポンのタイプ。
クレジットライン	creditLine	顧客に与えられたクレジットの額。
クレジット品質	creditQuality	顧客のクレジットの品質。サポートされる値は次のとおりです：300-579=非常に低い、580-669=普通、670-739=良好、740-799=非常に良好、800-850=優れている。
クレジットレポート	creditReport	顧客がクレジットレポートを受け取ったか、購入したか、無料のレポートを受け取ったか、レポートサービスのトライアルを開始したかを示します。
クルーズタイプ	cruiseType	クルーズのタイプ（例：アラスカ、カリブ海など）。
顧客の国	customerCountry	購入する顧客の国。ISO 3166-1 alpha 2の国コードでフォーマットされます。例：`US`、`UK`、`AU`、`FR`。
顧客セグメント	customerSegment	広告主固有の顧客セグメント。
顧客ステータス	customerStatus	顧客が新規または既存かどうか。
顧客タイプ	customerType	顧客のタイプ（例：企業、個人消費者、ビジネス、レジャー）。
配送	delivery	配送方法。
説明	description	商品またはカードの説明。
目的地の都市	destinationCity	目的地の都市名。
目的地の国	destinationCountry	サービスの目的地の国。ISO 3166-1 alpha 2の国コードでフォーマットされます。例：`US`、`UK`、`AU`、`FR`。
目的地ID	destinationId	目的地のID。通常は、目的地の都市または目的地の州/州を表す広告主定義のコード（例：`728660`）です。
目的地の州	destinationState	ISO 3166-2の州コードを使用してフォーマットされたサービスの目的地の州/州。
国内	domestic	顧客がアメリカ合衆国に住んでいるかどうか。
降車場のIATAコード	dropoffIata	降車場所が空港の場合のIATAコード。
降車場のID	dropoffId	降車場所のユニークなレンタカー会社ID。
期間	duration	イベントまたは商品の期間（例：ホテル滞在の夜数、トライアルサブスクリプションの期間）。
終了日時	endDateTime	チェックアウト日時、出発日時などの終了日時）
フライト運賃タイプ	flightFareType	フライト運賃のタイプ（例：“Gotta Get Away”）。
フライトオプション	flightOptions	フライトパッケージの他の選択オプション（例：wiki）。
フライトタイプ	flightType	フライトのタイプ（例：直行、経由、泊まり）
フライヤーマイル	flyerMiles	このフライトで獲得したフライヤーマイル。
資金提供額	fundedAmount	アカウントの資金提供額。
資金提供通貨	fundedCurrency	アカウントの初期資金の通貨。
ジャンル	genre	エンターテイメントのカテゴリまたはジャンル（例：本、映画、ストリーミング、音楽など）；トランザクションレベルのみ。
ゲスト	guests	ゲストの数。
IATAコード	iata	フライトスケジュールの各都市のコードをカンマ区切りのリストで指定します。カンマはURLエンコードする必要があります。
導入APR	introductoryApr	購入のための導入APR。導入APRが全体のAPRと異ならない場合は、「APR」パラメータを使用します。
導入APR期間	introductoryAprTime	導入APRの期間（月単位）。
商品ID	itemId	購入された商品または商品のID。複数の商品の場合、パラメータはカンマ区切りのリストを使用します。
商品名	itemName	購入した商品の名前。
商品タイプ	itemType	商品のタイプ（例：顧客がパーソナルキャッシュバッククレジットカードを申請する場合、`service_type=cc&item_type=personal&category=cashback`）。
予約ID	itineraryId	予約の予約ID。
ライフステージ	lifestage	カードの使用方法と目的を示す一般的なデモグラフィック（例：新しい引っ越し、学生、小規模ビジネス）。
場所	location	店舗または場所を識別するために使用できる広告主固有のIDまたは名前。
ロイヤリティ獲得	loyaltyEarned	顧客のロイヤリティステータスのレベル。
ロイヤリティ初回サインアップ	loyaltyFirstTimeSignup	この注文によって消費者がロイヤリティプログラムに参加したかどうか。
ロイヤリティレベル	loyaltyLevel	ロイヤリティポイントが使用されたかどうか。
ロイヤリティ利用	loyaltyRedeemed	ロイヤリティポイントが獲得されたかどうか。
ロイヤリティステータス	loyaltyStatus	顧客のメンバーシップのステータス。
マージン	margin	トランザクションの利益率を示す広告主専用の属性。
マーケティングチャネル	marketingChannel
最低残高	minimumBalance	アカウントの最低現金残高要件の金額。
最低入金額	minimumDeposit	最低入金額。
最低滞在期間	minimumStayDuration	必要な最低滞在期間（日単位）。
キャンセル不可	noCancellation	トランザクションにキャンセル不可ポリシーが存在する場合は、`yes`または`no`。
注文小計	orderSubtotal
出発地の都市	originCity	サービスの出発地の都市名、例：ニューヨーク。
出発地の国	originCountry	サービスの出発地の国コード、ISO 3166-1 alpha 2の国コードでフォーマットされます。例：`US`、`UK`、`AU`、`FR`。
出発地の州	originState	ISO 3166-2の州コードを使用してフォーマットされたサービスの出発地の州/州。
予約時に支払った金額（税込み）	paidAtBookingPostTax	税金を含む予約時に支払われた金額。
予約時に支払った金額（税抜き）	paidAtBookingPreTax	税金を含まない予約時に支払われた金額。
支払い方法	paymentMethod	使用された支払い方法のモデル（例：広告主固有）。
ピックアップのIATAコード	pickupIata	空港のピックアップ場所のIATAコード。
ピックアップのID	pickupId	ピックアップのためのユニークなレンタカー会社の場所ID。
プラットフォームID	platformId	顧客が使用しているデバイス（例：モバイル、タブレットなど）。
販売地点	pointOfSale	顧客の販売地点。
港	port	クルーズの出発港。
予約可能かどうか	preorder	商品が販売開始前に購入されたかどうか。
前払い	prepaid	顧客がトランザクションを前払いしたかどうか、yesまたはno。
事前審査	prequalify	申請者がカードの事前審査を受けたかどうか。
プロモーション	promotion	適用されたプロモーション（例：サマーセール）。
プロモーション金額	promotionAmount	プロモーションに関連する数値金額（例：プロモーションが$500キャッシュバックの場合、この値は`promotion=dollars&promotion_amt=500`となります）
プロモーション条件の閾値	promotionConditionThreshold	割引を受けるために必要な閾値。
プロモーション条件のタイプ	promotionConditionType	プロモーション条件のタイプ。
プロモーション終了日	promotionEnds	プロモーションの終了日。ISO 8601の標準に従った形式で指定します。例：`2022-12-25T15:30:50.111Z`。
プロモーション開始日	promotionStarts	プロモーションの開始日。ISO 8601の標準に従った形式で指定します。例：`2022-12-25T15:30:50.111Z`。
プロモーションタイプ	promotionType	プロモーションのタイプ。
数量	quantity	SKUごとの数量、単純なアクションの場合にのみ使用します。アイテムベースのアクションを使用する場合は、QTYxを使用します。
評価	rating	予約または購入された商品のスターレーティング。
ルームタイプ	roomType	ホテルやクルーズの予約された部屋のタイプ。
部屋数	rooms	予約された部屋の数。
サービスタイプ	serviceType	顧客がサインアップまたは購入した金融サービスのタイプ。
船名	shipName	クルーズ船の名前。
開始日時	startDateTime	チェックイン日時、到着日時など、予約または購入した商品の開始時間。
州	state	店舗の所在地の州または州を定義します。ISO 3166-2の州コードを使用してフォーマットします。例えば、アラスカのコードは`US-AK`、バンコクは`TH-10`です。
サブスクリプション料金	subscriptionFee	無料トライアルにサインアップする際に表示されるサブスクリプション料金のコスト。
サブスクリプション期間	subscriptionLength	商品の期間（例：“無期限"または1ヶ月/3ヶ月/6ヶ月）。
税金額	taxAmount	税金の金額。
税金タイプ	taxType	税金のタイプ。
転送手数料	transferFee	転送手数料の金額（クレジットカードの場合）。
旅行タイプ	travelType	予約または購入される旅行のタイプ（例：航空、車、アクティビティ、クルーズ、イベント、ホテル、パッケージ、レストラン、旅行ガイド、バケーションレンタル、その他）。
旅行タイプ	tripType	予約または購入される旅行のタイプ（例：片道、往復、マルチシティ、往復+ホテル）。
アップセル	upsell	トライアルからサブスクリプションに変換されたかどうか。
CJユーザー		CJユーザーID。