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

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

API情報

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

API名：CJ API
APIエンドポイント：
- トレースなし（ライブエンドポイント）：https://tracking.api.cj.com/graphql/
- トレースあり（テストエンドポイント）：https://tracking.api.cj.com/graphqltest/
ドキュメント：CJ API

バッチ制限

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

最大リクエスト数：10,000
最古のリクエストからの最大時間：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`	予約の状況。例：`confirmed`, `pending`など。
税後の予約価値	`bookingValuePostTax`	税後の予約価値。
税前の予約価値	`bookingValuePreTax`	税前の予約価値。
ブランド	`brand`	購入された商品または商品のブランド。
ブランドID	`brandId`	予約された商品のブランド識別子。
ビジネスユニット	`businessUnit`	顧客が購入したビジネスユニット。
キャンペーンID	`campaignId`	広告主固有のマーケティングキャンペーンID。
キャンペーン名	`campaignName`	広告主固有のマーケティングキャンペーン名。
カードカテゴリ	`cardCategory`	カードカテゴリの名前。
車オプション	`carOptions`	取引中に選択されたその他の車オプション。例：`insurance`。
キャッシュアドバンス料	`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`	クルーズのタイプ。例：`Alaskan`, `Caribbean`など。
顧客国	`customerCountry`	購入する顧客がいる国、ISO 3166-1 alpha 2国コードで。例：`US`, `UK`, `AU`, `FR`。
顧客セグメント	`customerSegment`	広告主固有の顧客セグメント。
顧客ステータス	`customerStatus`	顧客が新規か既存か。
顧客タイプ	`customerType`	顧客のタイプ。例：`company`, `individual consumer`, `business`, `leisure`。
配送	`delivery`	配送方法。
説明	`description`	商品またはカードの説明。
目的地市	`destinationCity`	目的地の市名。
目的地国	`destinationCountry`	サービスの目的地の国、ISO 3166-1 alpha 2国コードを使用してフォーマットされます。例：`US`, `UK`, `AU`, `FR`。
目的地ID	`destinationId`	サービスの目的地ID、通常は広告主が定義したコードで、目的地の市または目的地の州/県を表します。例：`728660`。
目的地州	`destinationState`	サービスの目的地の州/県、ISO 3166-2州コードを使用してフォーマットされます。
国内	`domestic`	顧客がアメリカ合衆国に居住しているかどうか。
Dropoff Iata	`dropoffIata`	空港での降車がある場合のIATAコード。
Dropoff ID	`dropoffId`	降車場所のユニークなレンタカー代理店ID。
Duration	`duration`	イベントやアイテムの期間（日数）、例えばホテル滞在の夜数やトライアルサブスクリプションの期間など。
End Date Time	`endDateTime`	チェックアウト日時、出発日時など。
Flight Fare Type	`flightFareType`	フライト運賃のタイプ。例えば `Gotta Get Away`。
Flight Options	`flightOptions`	フライトパッケージに選択されたその他のオプション。例えば、`wiki`。
Flight Type	`flightType`	フライトのタイプ。例えば、`direct`、`layover`、`overnight`。
Flyer Miles	`flyerMiles`	このフライトでフライヤーマイルが獲得されたか。
Funded Amount	`fundedAmount`	アカウント資金の金額。
Funded Currency	`fundedCurrency`	アカウントの初期資金の通貨。
Genre	`genre`	エンターテイメントのカテゴリーまたはジャンル。例えば、`books`、`movies`、`streaming`、`music`など。このパラメーターはトランザクションレベルのみです。
Guests	`guests`	ゲストの数。
Iata	`iata`	フライトスケジュールの各都市のコードをコンマ区切りリストで表記；コンマはURLエンコードする必要があります。
Introductory Apr	`introductoryApr`	購入のための導入APR。導入APRが全体のAPRと異ならない場合は、APRパラメーターを使用します。
Introductory Apr Time	`introductoryAprTime`	導入APR期間（月）。
Item ID	`itemId`	購入されたアイテムまたはアイテムのID。複数のアイテムがある場合、パラメーターはコンマ区切りリストを使用します。
Item Name	`itemName`	購入されたアイテムの名前。
Item Type	`itemType`	アイテムのタイプ。例えば、顧客がパーソナルキャッシュバッククレジットカードを申し込む場合: `service_type=cc&item_type=personal&category=cashback`。
Itinerary ID	`itineraryId`	予約の行程ID。
Lifestage	`lifestage`	カードの使用方法や理由を示す一般的な人口統計（例：新規移動者、学生、中小企業など）。
Location	`location`	店舗や訪問場所を特定するために使用できる広告主固有のIDまたは名前。
Loyalty Earned	`loyaltyEarned`	顧客のロイヤリティステータスのレベル。
Loyalty First Time Signup	`loyaltyFirstTimeSignup`	この注文が消費者がロイヤリティプログラムに参加する結果となったか。
Loyalty Level	`loyaltyLevel`	ロイヤリティポイントが使用されたか。
Loyalty Redeemed	`loyaltyRedeemed`	ロイヤリティポイントが獲得されたか。
Loyalty Status	`loyaltyStatus`	顧客の会員ステータス。
Margin	`margin`	トランザクションの利益率を示す広告主のみの属性。
Marketing Channel	`marketingChannel`	マーケティングチャネル。
Minimum Balance	`minimumBalance`	アカウントの最小現金残高要件の値。
Minimum Deposit	`minimumDeposit`	最小預金額。
Minimum Stay Duration	`minimumStayDuration`	最小滞在期間（日数）。
No Cancellation	`noCancellation`	取引にキャンセル不可ポリシーが存在する場合、`yes`または`no`。
Order Subtotal	`orderSubtotal`	注文の小計。
Origin City	`originCity`	サービス発信都市名、例えばニューヨーク。
Origin Country	`originCountry`	サービス発信国コード、ISO 3166-1 alpha 2国コードを使用してフォーマット。例えば、`US`、`UK`、`AU`、`FR`。
Origin State	`originState`	サービス発信州/県、ISO 3166-2州コードを使用してフォーマット。
Paid at Booking Post Tax	`paidAtBookingPostTax`	税後の予約時に支払われた金額。
Paid at Booking Pre Tax	`paidAtBookingPreTax`	税前の予約時に支払われた金額。
Payment Model	`paymentMethod`	使用された支払いモデル。例えば、`advertiser-specific`。
Pickup Iata	`pickupIata`	空港ピックアップ場所のIATAコード。
Pickup ID	`pickupId`	ピックアップに使用されたユニークなレンタカー代理店の場所ID。
Platform ID	`platformId`	顧客が使用しているデバイス。例えば、`mobile`、`tablet`など。
Point of Sale	`pointOfSale`	顧客の販売地点。
Port	`port`	クルーズの出発港。
Preorder	`preorder`	顧客が販売可能になる前にアイテムを購入したか。
Prepaid	`prepaid`	顧客が取引を前払いしたか、`yes`または`no`。
Prequalify	`prequalify`	申請者がカードの事前資格を得たか。
Promotion	`promotion`	適用されたプロモーション。例えば: `summer sale`。
Promotion Amount	`promotionAmount`	プロモーションに関連する数値額。例えば、プロモーションが$500キャッシュバックの場合、この値は `promotion=dollars&promotion_amt=500`）
Promotion Condition Threshold	`promotionConditionThreshold`	割引を得るために必要な閾値。
Promotion Condition Type	`promotionConditionType`	プロモーション条件のタイプ。
Promotion Ends	`promotionEnds`	プロモーション終了日、ISO 8601標準を使用してフォーマット。例えば、`2022-12-25T15:30:50.111Z`。
Promotion Starts	`promotionStarts`	プロモーション開始日、ISO 8601標準を使用してフォーマット。例えば、`2022-12-25T15:30:50.111Z`。
Promotion Type	`promotionType`	プロモーションのタイプ。
Quantity	`quantity`	特定のSKUの数量、単純なアクションのみ。アイテムベースのアクションを使用している場合は、`QTYx`を使用します。
Rating	`rating`	予約または購入されたアイテムの星評価。
Room Type	`roomType`	ホテルまたはクルーズで予約された部屋のタイプ。
Rooms	`rooms`	予約された部屋の数。
Service Type	`serviceType`	顧客がサインアップまたは購入した金融サービスのタイプ。
Ship Name	`shipName`	クルーズ船の名前。
Start Date Time	`startDateTime`	チェックイン日時、到着日時、または予約または購入されたアイテムの開始時刻など。
State	`state`	店舗が位置する州または県を定義し、ISO 3166-2州コードを使用してフォーマットします。例えば、アラスカのコードは `US-AK`、バンコクは `TH-10`です。
Subscription Fee	`subscriptionFee`	無料トライアルにサインアップする際に提示されるサブスクリプション料金。
Subscription Length	`subscriptionLength`	製品の期間。例えば: `indefinite`, `1 month`, `3 months`, `6 months`）。
Tax Amount	`taxAmount`	税額。
Tax Type	`taxType`	税のタイプ。
Transfer Fee	`transferFee`	クレジットカードの振替手数料額。
Travel Type	`travelType`	予約される旅行のタイプ。例えば: `air`, `car`, `activities`, `cruise`, `events`, `hotel`, `package`, `restaurants`, `travel guides`, `vacation rental`, `other`。
Trip Type	`tripType`	予約または購入された旅行のタイプ。例えば: 片道、往復、複数都市、往復+ホテル。
Upsell	`upsell`	顧客がトライアルからサブスクリプションに変換したか。
CJ User		CJユーザーID。