API イントロダクション
Tangiblee APIは、カスタマイズされたTangiblee UXを可能にし、ウェブサイトに実装されている結果追跡を制御します。
デザイン原則
- 設置面積が小さい -スクリプトのサイズ、ダウンロード時間、実行時間を最小限に抑えます。
- スタンドアロン -Tangiblee は JavaScript ライブラリのような外部依存関係には依存していません。
- クロスブラウザ -APIは、クローム、サファリ、Firefox、IE、エッジ、オペラなどのすべての一般的なブラウザと、iOS、Windows、Androidなどのすべてのプラットフォームをサポートしています。
- 非同期ダウンロード -スクリプトは非同期でダウンロードされ、他のスクリプトのダウンロードやレンダリングをブロックしません。
- レイジーローディング -Tangiblee CDN が一時的に遅い場合でも、ブロックされません オンロード トリガーされてからサイトが応答するまでのイベント。
- イベントの保存 -使用されたイベントが、お客様のサイト上のイベントよりも優先されることはありません。影響は最小限です。
- 名前空間の汚染なし -Tangiblee は、既存の JavaScript と競合する可能性のあるグローバル変数を使用していません。
どうやって使うの？
PDP との有形統合は、Tangiblee API と、特定の PDP 構造に合わせて API を調整する mapper.js という 2 つの論理ブロックで構成されています。以下に、各ブロックの詳細な説明を示します。
1。タンジブルAPI
ウェブページで使用できる、Tangibleeのプラットフォームがサポートするすべてのフロントエンド機能および機能の抽象化レイヤー。Tangiblee をウェブページに統合するたびに、Tangiblee API を使用してタンジブリーのアクセス、CTA の読み込み、Tangiblee エクスペリエンスの起動が行われます。をラップするコード タンジブル API そしてそれをアクティブにすることを マッピングコード。
の場合 セルフサービス統合、クライアントのITチームが書くのは mapper.js それが呼ぶのは タンジブル API; ただし、以下の場合 マネージド・インテグレーション、 タンジブル API から呼び出されます マッピングコード それはTangibleeによって提供されています。
2. tangiblee-mapper.js
このレイヤーは Web ページまたは PDP をにバインドします タンジブル API ウェブページ上に存在する情報のマッパーとして行動し、それに合うようにその情報を再構築することで タンジブル API。ザの tangiblee-mapper.js は、特定の種類の PDP やクライアント Web サイトごとに異なります。
tangiblee-mapper.js クライアントまたは Tangiblee によって作成、保守、およびホストできます。PDP は時間とともに変化し進化し続けるため、維持管理は tangiblee-mapper.js Tangiblee プラットフォームをエラーなく実行できるようにするために重要です。
まとめ:
主なデータポイントは tangiblee-mapper.js ロジックはにバインドされます タンジブル API は:
- CTA コード: TangibleeをトリガーするCTAを操作し、次のようなアクションのロジックを定義します 作成、 表示/非表示、 削除する、および レンダリングする。
- SKU コード: 現在のSKUリストとアクティブなSKU/S情報をWebページからTangibleeプラットフォームにマッピングします。このパートは、Tangiblee バックエンドから正しいビジュアルアセットを読み込み、ユーザーに正しいエクスペリエンスを提供するために不可欠です。
高度な機能: ローカリゼーション、「カートに入れる」ボタンの表示/非表示、価格と通貨の表示/非表示、Google Analyticsトラッキングのカスタマイズ、注文、収益トラッキング
