Adobe Target MCP サーバーツール リファレンス target-mcp-tools-reference

ツール： list_target_activities

サーバーサイドのフィルタリングと並べ替えでAdobe Target アクティビティを一覧表示します。

ページ分割されたアクティビティのリストを取得します。 すべてのフィルターは、Target管理者APIによってサーバーサイドで適用されます。 サーバーは、1 ページにつき最大200個のアクティビティを返します。

は、​個のJSON オブジェクトをactivities （id、name、state、type、priority、modifiedAt、startsAt、endsAtを含むオブジェクトのリスト）およびtotalを返します（合計数、返されるページサイズを超える場合があります）。

プロンプトの例： 「最も最近変更された順に並べ替えられたすべてのアクティブなA/B テストを一覧表示する」

ツール： get_activity

あらゆるタイプのアクティビティに関する詳細情報を取得します。

特定のアクティビティの完全な設定を取得し、アクティビティタイプを自動的に検出します。 A/B テスト、エクスペリエンスのターゲット設定、Automated Personalization、自動割り当て、多変量テスト、Recommendations アクティビティをサポートしています。

戻り値： メタデータ（名前、状態、優先度、日付）、エクスペリエンス、場所とオファー、目標と指標、ターゲティングルールなど、アクティビティの詳細を表示します。

プロンプトの例： 「アクティビティの詳細を取得12345ます。」

ツール： create_ab_activity

新しいA/B テストアクティビティを作成します。

エクスペリエンス、オファー、ターゲティングなど、指定した設定で新しいA/B テストを作成します。

戻り値：​作成されたアクティビティ オブジェクトに、割り当てられたIDが含まれています。

プロンプトの例： 「ホームページヒーローテスト」と呼ばれるA/B テストを作成し、2つのエクスペリエンスでホームページヒーローイメージをホームページヒーローボックスでテストします。」

ツール： create_xt_activity

新しいエクスペリエンスのターゲット設定（XT）アクティビティを作成します。

ターゲティングルールに基づいて、異なるオーディエンスに異なるエクスペリエンスを配信するXT アクティビティを作成します。

戻り値：​作成されたアクティビティ オブジェクトに、割り当てられたIDが含まれています。

プロンプトの例： 「異なる地域の訪問者に異なるコンテンツを表示する、「Geo Personalization」というエクスペリエンスのターゲット設定アクティビティを作成します。」

ツール： update_activity

既存のA/B テスト、エクスペリエンスのターゲット設定、またはAutomated Personalization アクティビティを更新します。

読み取り/変更/書き込みパターンを使用：現在の状態を取得し、変更をマージして検証し、更新を送信します。 A/B テスト、エクスペリエンスのターゲット設定、Automated Personalization アクティビティをサポートします。自動割り当て、多変量テスト、Recommendations アクティビティは読み取り専用です。 構造化されたgoal、audience_idsおよびadditional_metrics パラメーターは、A/B テストおよびエクスペリエンスのターゲット設定でのみサポートされています。Automated Personalization アクティビティでは、プレーンフィールド結合の更新を受け付けます。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「アクティビティ 12345を更新して、トラフィックの割り当てを70/30に変更します」

ツール： update_activity_schedule

アクティビティの開始日と終了日を更新します。

他の設定を変更することなく、アクティビティのスケジュールを更新します。

スケジュール更新の確認を返します：。

プロンプトの例： 「A/B アクティビティ 12345のスケジュールを5月1日から5月31日まで更新します。」

ツール： update_activity_state

アクティビティの状態を変更します（アクティベート、非アクティベート、または一時停止）。

更新されたアクティビティ状態を返します：。

プロンプトの例： 「Activate activity 12345」または「Pause the Homepage Hero Test」

ツール： update_activity_name

アクティビティの名前を変更します。

完全な設定を変更せずに、名前のみを更新します。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「アクティビティ 12345の名前を「サマーキャンペーンヒーローテスト」に変更します。」

ツール： update_activity_priority

アクティビティの優先度を変更します。

複数のアクティビティが同じ場所をターゲットにしている場合は、優先度の高いアクティビティが優先されます。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「アクティビティ 12345の優先度を100に設定します。」

ツール： add_activity_variant

アクティビティに新しいエクスペリエンス/バリアントを追加します。

オプションの作成、場所へのマッピング、トラフィックのリバランスなど、あらゆる構造調整を処理します。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「オファーの67890を使用して、A/B アクティビティ 12345に「Holiday Theme」という新しいバリアントを追加します。」

ツール： update_traffic_split

バリエーションをまたいでトラフィック配分を更新。

パーセンテージは正確に100に合計する必要があります。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「アクティビティ 12345のトラフィックの分割を70% Controlと30% Variant Aに変更します。」

ツール： update_variant_offer

特定のバリエーションのオファーを変更する。

フォームベースのアクティビティ（offer_idを使用）とVEC アクティビティ（modificationsを使用）の両方で機能します。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「アクティビティ 12345ージの「バリアント A」エクスペリエンスを更新して、オファー99999を使用する」

ツール： remove_activity_variant

アクティビティからエクスペリエンス/バリアントを削除します。

エクスペリエンスを削除し、孤立したオプションをクリーンアップし、残りのバリエーションをまたいでトラフィックを均等に調整します。

戻り値：​更新されたアクティビティ オブジェクト。

プロンプトの例： 「A/B アクティビティ 12345ースから「テスト バリアント」エクスペリエンスを削除する」

ツール： list_target_offers

Target テナントのすべてのオファーを一覧表示します。

オプションのフィルタリングを使用して、ページ分割されたコンテンツオファーのリストを取得します。

次のJSON オブジェクトを返します：。offers （id、name、type、content、modifiedAt）およびtotalを含むオブジェクトのリスト。

プロンプトの例： 「すべてのJSON オファーを一覧表示する」

ツール： get_target_offer

特定のオファーに関する詳細情報を取得します。

返品：​完全なオファーの詳細（id、name、type、content、workspace、およびmodifiedAtなど）。

プロンプトの例： 「オファーの詳細を取得67890ます。」

ツール： create_target_offer

新しいHTML コンテンツオファーを作成します。

返品：​作成されたオファーに割り当てられたIDが含まれています。

プロンプトの例： 「プロモーションバナーを使用して、「サマーセールバナー」というHTML オファーを作成します。」

ツール： create_target_json_offer

構造化データを配信するための新しいJSON オファーを作成します。

返品：​作成されたオファーに割り当てられたIDが含まれています。

プロンプトの例： 「機能フラグ設定を使用して、「機能フラグ設定」という名前のJSON オファーを作成します。」

ツール： update_target_offer

既存のオファーを更新します。

返品：​更新されたオファーオブジェクト。

プロンプトの例： 「新しいプロモーションコンテンツを使用してオファー67890を更新する」

ツール： list_target_audiences

Target テナント内のすべてのオーディエンスを一覧表示します。

次のJSON オブジェクトを返します：。audiences （id、name、description、origin、modifiedAt）およびtotalを含むオブジェクトのリスト。

プロンプトの例： 「すべてのオーディエンスを一覧表示する」

ツール： get_target_audience

ターゲティングルールを含むオーディエンスの詳細。

ターゲティングルールと条件を含む、特定のオーディエンスの完全な設定を取得します。

返品：​完全なオーディエンスの詳細（id、name、description、origin、ターゲティングルール、関連するアクティビティ数など）。

プロンプトの例： 「オーディエンスの詳細を確認し、ターゲティングルールを12345認する」

ツール： create_target_audience

ターゲティングルールで新しいオーディエンスを作成します。

戻り値：​作成されたオーディエンスとその割り当てられたID。

プロンプトの例： 「カリフォルニア州のモバイルユーザーをターゲットとする、「カリフォルニア州からのモバイル訪問者」という名前のオーディエンスを作成します。」

ツール： list_target_mboxes

Target テナント内のすべてのmboxを一覧表示します。

次のJSON オブジェクトを返します：。mboxes （name、status、lastRequestTimeを含むオブジェクトのリスト）およびtotal。

プロンプトの例： 「「ホームページ」を含むすべてのmboxを一覧表示する」

ツール： get_target_mbox

特定のmboxに関する詳細情報を取得します。

Mboxを使用して、name、statusおよびアクティビティのリストを含む、​個のMboxの詳細を返します。

プロンプトの例： 「mbox 'homepage-hero’の詳細を取得する」

ツール： list_target_mbox_profile_attributes

ターゲティングに使用できるすべてのmbox プロファイル属性を一覧表示します。

パラメーターは不要です。

プロファイル属性オブジェクトのJSON配列​を返します。

プロンプト例： 「ターゲティングに使用できるプロファイル属性は何ですか？」

ツール： list_target_properties

Target テナントのすべてのプロパティを一覧表示します。

プロパティは、アクティビティを整理し、アクセスを制御します。

パラメーターは不要です。

戻り値： id、name、descriptionおよびchannelを含むプロパティ オブジェクトのリスト。

プロンプトの例： 「すべてのターゲットプロパティを一覧表示する」

ツール： get_activity_performance_report

あらゆるタイプのアクティビティのパフォーマンスレポートを取得します。

コンバージョン率、上昇率および信頼性レベルを取得します。 A/B テスト、エクスペリエンスのターゲット設定、Automated Personalization、自動割り当て、多変量テスト、Recommendations アクティビティをサポートしています。

戻り値： エクスペリエンスレベルの指標（訪問者、コンバージョン、コンバージョン率）、上昇率の計算、統計的な信頼性レベル、および収益指標（設定されている場合）。

プロンプトの例： 「過去30日間のアクティビティ 12345のパフォーマンス レポートを表示する」

ツール： get_activity_orders_report

あらゆるタイプのアクティビティの注文/収益レポートを取得します。

A/B テスト、エクスペリエンスのターゲット設定、Automated Personalization、自動割り当て、多変量テスト、Recommendations アクティビティをサポートしています。

返品数：​注文数、売上高、平均注文額（体験別）。

プロンプトの例： 「アクティビティ 12345の注文レポートを取得する」

ツール： get_activity_report_by_name

アクティビティを名前で検索し、そのパフォーマンスレポートを取得します。

アクティビティ名を知っていてもIDが分からない場合に便利です。

戻り値： アクティビティの詳細とパフォーマンス指標。

プロンプトの例： 「自分の「ホームページヒーローテスト」アクティビティのパフォーマンスレポートを取得する」

ツール： get_a4t_report

Target アクティビティのAnalytics for Target （A4T） レポートを取得します。

アクティビティのA4T設定を検証し、Adobe Analyticsに対してGraphQL クエリを実行して、Analytics側の指標を取得します。 A4T レポートが設定されているアクティビティでのみ使用できます。

訪問者の数、コンバージョン、収益、エクスペリエンスごとの上昇率など、アクティビティのAnalytics側の指標をAdobe Analyticsから直接取得して​返します。

プロンプトの例： 「チェックアウト最適化テスト用のA4T レポートを取得し、Analytics サイドのコンバージョンデータを要約する」

ツール： preview_activity

Target アクティビティのブラウザーQA プレビューURLを生成します。

オーディエンスのターゲティングルールを無視して、特定のエクスペリエンスを強制的に表示するクリック可能なプレビューリンクを作成します。 A/B、XTおよびAutomated Personalization アクティビティで機能します。

次の値を返します： アクティビティ情報（名前、タイプ、状態）、各エクスペリエンスのプレビューURL、エクスペリエンス名とインデックス。

プロンプトの例： 「アクティビティ 12345のプレビューURLを生成して、ブラウザーで各エクスペリエンスをテストできるようにします。」

ツール： list_target_response_tokens

Target テナント内のすべての応答トークンを一覧表示します。

設定されたすべての応答トークン（ビルトインとカスタムの両方）を取得します。

パラメーターは不要です。

応答トークンオブジェクトの JSON配列をname、type、enabledの状態で返します。

プロンプトの例： 「すべての応答トークンを一覧表示する」

ツール： create_target_response_token

Target回の応答で追加データを収集するための新しいカスタム応答トークンを作成します。

戻り値：​作成された応答トークンオブジェクト。

プロンプトの例： 「ACTIVITY タイプの’campaign_id’という名前のカスタム応答トークンを作成する」

ツール： get_target_revisions

リソースタイプの監査ログを取得します。

作成者によるオプションのフィルタリングを使用して、Target リソースに加えられた変更を取得します。

タイムスタンプ、ユーザー、変更説明を含むリビジョン履歴​を返します。

プロンプトの例： 「アクティビティの変更に関する監査ログを表示する」

ツール： get_target_entity_revisions

IDで特定のエンティティのすべてのリビジョンを取得します。

指定されたエンティティのすべてのリビジョンの JSON配列を返します。

プロンプトの例： 「アクティビティ 12345に加えられたすべての変更を表示する」

ツール： list_target_templates

アクティビティやオファーを作成するために利用できるMCP リソースとテンプレートを一覧表示します。

パラメーターは不要です。

使用可能なテンプレートとリソースを一覧表示する JSON オブジェクトを返します。

プロンプト例： 「アクティビティの作成に使用できるテンプレートは何ですか？」

ツール： list_target_criteria、get_target_criteria、list_target_criteria_by_type、get_target_criteria_by_type、create_target_criteria、update_target_criteria

基準とは、事前に決められた訪問者の行動セットにもとづいて、推奨する項目を決定するルールです。 条件は、次の9つのタイプのファミリにグループ化されます：category、custom、item、cart、popularity、profileattribute、recent、sequence、userhistory。

list_target_criteriaとget_target_criteriaは、ファミリー間の条件メタデータ （id、name、criteriaTitle、criteriaGroup）を最小限に抑えて返します。 list_target_criteria_by_type / get_target_criteria_by_type （またはcreate_target_criteria / update_target_criteria）をcriteria_typeと共に使用して、完全なタイプ固有の設定を操作します。 フィールドの要件はファミリーごとに異なります。タイプごとの完全なスキーマについては、Adobe Recommendations API Referenceを参照してください。

戻り値：​条件オブジェクト、またはoffset、limit、total、listのページ区切りリスト。

プロンプトの例： 「このアカウントで設定されたすべてのRecommendations条件を一覧表示し、使用中のアルゴリズムタイプを要約する」

ツール： list_target_collections、get_target_collection、create_target_collection、update_target_collection

コレクションは、条件やプロモーションで使用するために、一致するルールによってカタログエンティティをグループ化します。

戻り値： id、name、description、rulesおよび最終変更されたメタデータを含むコレクション オブジェクト。

プロンプトの例： 「自分が持っているコレクションと、フィルタリング対象のカタログ属性は何か？」

ツール： list_target_designs、get_target_design、create_target_design、update_target_design

デザインは、推奨されるエンティティのレンダリング方法を制御するVelocity テンプレートまたはHTML テンプレートです。

戻り値： id、name、scriptおよびtypeを含むデザインオブジェクト。

プロンプトの例： 「Recommendations用に設定したデザインとコレクションは何ですか？」

ツール： list_target_promotions、get_target_promotion、create_target_promotion、update_target_promotion

プロモーションでは、基準やバックアップのレコメンデーションよりも特定のエンティティをレコメンデーションの結果に強制的に優先します。

戻り値： プロモーションオブジェクト。

プロンプトの例： 「8月末までの「バックパッキングテント」コレクションを特徴とする外部プロモーションを作成します。」

ツール： list_target_exclusions、get_target_exclusion、create_target_exclusion、update_target_exclusion

除外は、レコメンデーション結果から一致するエンティティを削除します。 除外事項は、あらゆる基準とアクティビティにおいて、アカウント全体に適用されます。

次を返します：​除外オブジェクト。

プロンプトの例： 「アカウント全体の除外は現在設定されていますか。また、何をフィルタリングしますか？」

ツール： get_target_entity、search_target_catalog

Recommendations製品/コンテンツカタログを検査するための読み取り専用ツール。 MCP サーバーを介してカタログエンティティを作成、更新、または削除するツールはありません。

返品： get_target_entityは、エンティティのカタログ属性を返します。 search_target_catalogは、entities配列の一致を返します。 queryのフィールド名は、テナントに設定された実際のカタログ属性である必要があります。

プロンプトの例： 「在庫が1000未満の商品のカタログを検索します。」