> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

> Kameleoon の Activation、Automation、Data、Product Recommendation の各 API の目的と関連ドキュメントへのリンクを含む概要。

Kameleoon プラットフォームでは、お客様がさまざまな用途で使用できる複数の API を提供しています。これらの API を使用することで、フロントエンドの A/B 実験の実施、データの取得と送信による Kameleoon の自社デジタルエコシステムへの統合、実験のプログラム的な作成や更新などの特定のタスクの自動化、Product Recommendation および Search Personalization アドオンを利用している場合は商品カタログのインポートまたは更新が可能になります。

Kameleoon には主に 4 つの API グループがあります。

* [Activation API](#activation-api)(JavaScript API)
* [Automation API](#automation-api)(REST API)
* [Data API](#data-api)(REST API)
* [Product Recommendation API](#product-recommendation-api)(REST API)

この記事では、これらの API の概要を高レベルで提供し、開発者が必要な API を素早く特定して関連ドキュメントへ移動できるようサポートします。

## Activation API

**Activation API** は、Kameleoon Web Experimentation を使用している場合や Feature Experimentation を [Hybrid モード](../feature-experimentation/targeting-and-segmentation/native-segmentation#ハイブリッド実験モード) で使用している場合に Web サイトにインストールされる Kameleoon アプリケーションファイル `engine.js`(旧名称 `kameleoon.js`)に付属する JavaScript API です。この API を使用すると、JavaScript を通じて直接メソッドを呼び出し、さまざまなデータ構造にアクセスできます。さらに、[AI Predictive Targeting](https://kameleoon.com/en/platform/personalization) アドオンで利用可能な、リアルタイムで顧客中心の傾向スコアである **Kameleoon Conversion Score (KCS)** も提供します。

この API には次のような用途があります。

* ちらつきのないフロントエンドの A/B テストバリエーションを実装するための[メソッド](/developer-docs/apis/activation-api-js/api-reference/api-reference#runwhenelementpresent)を提供します。これらのメソッドは、Kameleoon プラットフォームの適切な機能とアンチフリッカリング技術の活用に欠かせません。Kameleoon を扱うフロントエンド開発者は、これらに精通しておくべきです。

* コンバージョンデータや訪問者/[顧客の特性](/developer-docs/apis/activation-api-js/api-reference/api-reference#setcustomdata)など、Kameleoon にデータを送信するためのトラッキング[メソッド](/developer-docs/apis/activation-api-js/api-reference/api-reference#processconversion)を提供します。これらのメソッドは、Google Analytics などの分析ソリューションが提供するものと同様に機能します。HTML ページに埋め込まれた JavaScript から直接、または Google Tag Manager (GTM) などのタグマネージャーを通じて呼び出すことができます。[Kameleoon CommandQueue](./activation-api-js/api-reference/command-queue) に関するドキュメントの参照もおすすめします。

* 商品ビュー、購入、カートへの商品追加、自動商品レコメンデーションの取得、ソーシャルプルーフや緊急性のユースケースに使う商品固有の統計情報の取得など、商品関連イベントを追跡する[メソッド](/developer-docs/apis/activation-api-js/api-reference/api-reference#kameleoonapiproducts)を提供します。

* Kameleoon によって収集された有用な[リアルタイム情報](/developer-docs/apis/activation-api-js/api-reference/api-reference#visit)を提供します。たとえば、訪問者のページビューを追跡でき、データはすべての過去の訪問にわたって保存・アクセスできます。現在 5 回目の訪問中であっても、訪問者が最初の訪問でサイトに滞在した時間を判別できます。

* Kameleoon のデフォルトの割り当てバケッティングロジックを上書きする[エントリーポイント](/developer-docs/apis/activation-api-js/api-reference/api-reference#assignvariation)を提供します。たとえば、訪問者が初めて A/B 実験に割り当てられたとき、そのバリエーションはランダムに決定されます。API を使用すると、[この割り当てを上書き](./activation-api-js/tutorials/managing-a-variations-allocation-according-to-specific-criteria)して、訪問者を特定のバリエーションに登録できます。

<Note>
  Activation API は完全に JavaScript ベースであるため、スケーラビリティを気にする必要はありません。ほぼすべてのメソッド(サーバー呼び出しを必要とするものを除く、例: [商品カタログ関連の関数](/developer-docs/apis/activation-api-js/api-reference/api-reference#obtainproductinteractions))は同期的に実行され、即座に返ります。この API には認証は必要なく、標準的なブラウザのアーキテクチャとセキュリティプロトコルにより、訪問者は自身のデータ(Local Storage に保存)のみにアクセスでき、他の訪問者のデータにはアクセスできません。
</Note>

[Activation API の完全なドキュメントはこちら](/developer-docs/apis/activation-api-js/api-reference/api-reference)です。[カスタム JavaScript Kameleoon イベント](./activation-api-js/api-reference/activation-api-events)に関する別途のガイドもあります。

## Automation API

**Automation API** は、Kameleoon App を通じて利用可能なほぼすべての操作をプログラム的にトリガーして実行できる REST API です。これにより、独自のソフトウェアを開発してプラットフォームと連携し、すべての機能や能力を活用できます。

たとえば、当社のクライアントの一部は、この API を使用して Kameleoon を Git リポジトリと統合し、バージョン管理システム内で直接 Kameleoon バリエーションコードを管理しています。カスタムダッシュボードを設計し、Kameleoon から直接[実験結果を取得する](./automation-api-rest/tutorials/experiments/retrieving-experiment-results-using-the-automation-api)こともできます。この API は使いやすく、Kameleoon と連携・操作するカスタムシステムを簡単に構築できます。

<Note>
  この API は REST 原則に従っており、任意の言語(Java、C#、NodeJS、Python など)の REST 対応フレームワークを使用して呼び出せます。REST 規約に従っているため、それに慣れている開発者は使いやすいでしょう。この API は大量の使用を意図したものではありません。当社のシステム上では、顧客/ユーザーアカウントごとに 1 分間に十数回の呼び出しに留めてください。1 分間に何百万回もの呼び出しに対応するようには設計されておらず、Web サイトのすべての訪問者ごとに呼び出すべきではありません。高ボリュームのデータアクセスが必要な場合は、[Data API](#data-api) を参照してください。
</Note>

<Note>
  当社の Automation API を利用する VS Code 拡張機能を提供しています。詳細については、[ドキュメント](../developer-tools/vs-code-extension)を参照してください。
</Note>

[Automation API の完全なドキュメントはこちら](./automation-api-rest/get-started/get-started)です。

## Data API

**Data API** は、訪問者のブラウザにローカルに保存されているのではなく、リモートサーバーに保存されているデータの取得と書き込みを可能にする REST API です。データがブラウザ側で即時利用可能な **Activation API** とは異なり、この API は外部データソース、リモートサーバー、または DMP との通信向けに設計されています。一方、**Automation API** とは異なり、1 分間に何百万回もの呼び出しを処理できるため、訪問者単位のリクエストに適しています。

たとえば、Data API は [クロスデバイス履歴調整](../cross-device-experimentation) に使用されます。これは、ユニーク訪問者のあらゆるデバイスにわたる完全なアクション履歴を自動的に同期する強力な Kameleoon の機能です。訪問者がスマートフォンで Web サイトを 2 回閲覧し、その後デスクトップコンピューターで再訪問した場合、Activation API データレイヤーでは正しくその訪問者の 3 回目の訪問として報告されます。その背後では、データ同期を確保するために、当社のサーバーが Data API へ呼び出しを行っています。

もう 1 つの一般的なユースケースは、Activation API を介して直接送信できない「遅延トランザクション」の登録です。たとえば、旅行パッケージを販売しており、最終的なトランザクションまたは確認がオンラインではなく実店舗で対面で発生する場合、この API を使用してそれらのトランザクションを記録できます。これは、Web/JavaScript ベースの API では不可能です。

Data API は REST 準拠の API であるため、Java、C#、NodeJS、Python などの任意の言語の REST 対応フレームワークを使用して呼び出すことができます。REST 規約に従っているため、それに慣れている開発者は簡単に使用できます。

[**Data API** の完全なドキュメントはこちら](./data-api-rest/overview)です。

## Product Recommendation API

**Product Recommendation API** は、商品カタログの効率的な管理と、パーソナライズされた商品および検索レコメンデーションの取得を可能にする RESTful API です。この API は、独自のバックエンドシステムやモバイルアプリケーション内でレコメンデーションロジックを処理したいクライアントに特に有用です。

この API には次のような用途があります。

#### 商品カタログ管理

商品カタログのインポートおよび更新には、次のエンドポイントを使用する必要があります。

* [Import Categories](./product-recommendation-api-rest/all-endpoints/Import/import-categories) – 商品カテゴリを Kameleoon にアップロードします。
* [Import Products](./product-recommendation-api-rest/all-endpoints/Import/import-product) – カタログに商品を追加または更新します。
* [Update Available Products](./product-recommendation-api-rest/all-endpoints/Import/update-products) – 商品の在庫状況をリアルタイムで同期します。
* [Remove Products](./product-recommendation-api-rest/all-endpoints/Import/update-products) – Kameleoon から商品を削除します。

#### 商品および検索レコメンデーション

* [Get Product Recommendations](./product-recommendation-api-rest/all-endpoints/Recommend/get-recommend) – 訪問者の行動に基づいて、パーソナライズされた商品提案を取得します。
* [Get Search Recommendations](./product-recommendation-api-rest/all-endpoints/Search/get-search) – ユーザークエリに合わせた検索レコメンデーションを取得します。