[Beta]{class="badge informative"}
Adobe Target MCP Server Tools-Referenz target-mcp-tools-reference
Diese Seite ist eine vollständige Referenz für alle schreibgeschützten Tools, die vom Adobe Target MCP-Server bereitgestellt werden. Für jedes Tool finden Sie eine Beschreibung, Parameterdetails, einen Rückgabewert und eine Beispielaufforderung in natürlicher Sprache. Anweisungen zum Setup und Anwendungsfälle finden Sie unter Erste Schritte und Anwendungsfälle und exemplarische Vorgehensweisen.
Voraussetzungen tools-prerequisites
Ihre Adobe Target bestimmt, welche Tools Ihnen zur Verfügung stehen:
- Beobachterrolle oder höher: Zugriff auf alle 23 schreibgeschützten Tools
Vollständige Setup-Anweisungen finden Sie unter Erste Schritte.
Aktivitäts-Tools tools-activities
tool: list_target_activities
Auflisten Adobe Target Aktivitäten mit Server-seitiger Filterung und Sortierung.
Ruft eine paginierte Liste von Aktivitäten ab. Alle Filter werden Server-seitig von der Target Admin-API angewendet. Der Server gibt maximal 200 Aktivitäten pro Seite zurück.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
limit |
Ganzzahl | Nein | Maximale Anzahl an zurückzugebenden Aktivitäten (Server-Maximum: 200) |
offset |
Ganzzahl | Nein | Anzahl der für die Paginierung zu überspringenden Aktivitäten |
sort_by |
string | Nein | Feld zum Sortieren nach. Präfix mit - für absteigende Reihenfolge (z. B. -modifiedAt). Optionen: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId |
state |
string | Nein | Nach Aktivitätsstatus filtern: approved (live/aktiv), deactivated (inaktiv), paused, saved (Entwurf) |
activity_type |
string | Nein | Filtern nach Typ: ab (A/B-Test), xt (Experience Targeting), abt (Automated Personalization) |
name_contains |
string | Nein | Filtern Sie Aktivitäten, deren Name diese Zeichenfolge enthält (ignoriert Groß-/Kleinschreibung). |
starts_after |
string | Nein | ISO 8601-Datum — Aktivitäten, die nach diesem Datum beginnen |
starts_before |
string | Nein | ISO 8601-Datum — Aktivitäten, die vor diesem Datum beginnen |
modified_after |
string | Nein | ISO 8601-Datum — nach diesem Datum geänderte Aktivitäten |
ends_after |
string | Nein | ISO 8601-Datum — Aktivitäten, die nach diesem Datum enden |
ends_before |
string | Nein | ISO 8601-Datum - Aktivitäten, die vor diesem Datum enden |
workspace |
string | Nein | Nach Arbeitsbereich-ID filtern |
segment_id |
string | Nein | Nach Zielgruppensegment-ID filtern |
profile_attribute_id |
string | Nein | Nach Profilattribut-ID filtern |
priority |
Ganzzahl | Nein | Filtern nach exaktem Prioritätswert (0-999) |
mbox |
string | Nein | Nach Mbox-/Standortnamen filtern |
offer_id |
string | Nein | Nach Angebots-ID filtern |
view_id |
string | Nein | Nach SPA-Ansicht-ID filtern |
Gibt JSON-Objekt mit activities (Liste der Objekte einschließlich id, name, state, type, priority, modifiedAt, startsAt, endsAt) und total (Gesamtanzahl, kann die zurückgegebene Seitengröße überschreiten) zurück.
Beispielaufforderung: „Listet alle aktiven A/B-Tests auf, sortiert nach der letzten Änderung.“
tool: get_ab_activity
Detaillierte Informationen zu A/B-Aktivitäten.
Ruft die vollständige Konfiguration eines bestimmten A/B-Tests ab, einschließlich Erlebnissen, Standorten, Metriken und Zielgruppenbestimmungsregeln.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der A/B-Aktivität |
Rückgabe Vollständige Aktivitätsdetails einschließlich Metadaten (Name, Status, Priorität, Daten), Erlebnisse, Standorte und Angebote, Ziele und Metriken sowie Zielgruppenbestimmungsregeln.
Beispielaufforderung: „Details für A/B-12345 abrufen“
tool: get_xt_activity
Hier erhalten Sie detaillierte Informationen zu einer Experience Targeting(XT)-Aktivität.
Ruft die vollständige Konfiguration einer bestimmten XT-Aktivität ab, einschließlich Zielgruppen-Erlebnis-Mappings, Standorten und Metriken.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der XT-Aktivität |
Rückgabe Vollständige Aktivitätsdetails einschließlich Metadaten, Erlebnissen mit Zielgruppen-Mappings, Standorten und Angeboten sowie Zielen und Metriken.
Beispielaufforderung: „Abrufen von Details für Experience Targeting-12345“
tool: get_abt_activity
Erhalten Sie detaillierte Informationen zu einer Automated Personalization-Aktivität (AP).
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der AP-Aktivität |
Rückgabe Vollständige Aktivitätsdetails einschließlich Metadaten, Erlebnisse, Speicherorte und algorithmische Einstellungen.
Beispielaufforderung: „Abrufen von Details für automatische Personalization-12345“
Angebotswerkzeuge tools-offers
tool: list_target_offers
Auflisten aller Angebote in Ihrem Target.
Ruft eine paginierte Liste von Inhaltsangeboten mit optionaler Filterung ab.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
limit |
Ganzzahl | Nein | Maximale Anzahl an zurückzugebenden Angeboten |
offset |
Ganzzahl | Nein | Anzahl der für die Paginierung zu übersprungenen Angebote |
type |
string | Nein | Filtern nach Angebotstyp: content (HTML), json oder redirect |
name |
string | Nein | Nach Angebotsnamen filtern (teilweise Übereinstimmung) |
Gibt JSON-Objekt mit offers (Liste der Objekte einschließlich id, name, type, content, modifiedAt) und total zurück.
Beispielaufforderung: „Alle JSON-Angebote auflisten“
tool: get_target_offer
Erhalten Sie detaillierte Informationen zu einem bestimmten Angebot.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
offer_id |
Ganzzahl | Ja | Die eindeutige Kennung des Angebots |
Rückgabe Vollständige Angebotsdetails, einschließlich id, name, type, content, workspace und modifiedAt.
Beispiel-Eingabeaufforderung: „Abrufen von Details zur 67890“
Zielgruppen-Tools tools-audiences
tool: list_target_audiences
Auflisten aller Zielgruppen in Ihrem Target.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
limit |
Ganzzahl | Nein | Maximale Anzahl an zurückzugebenden Zielgruppen |
offset |
Ganzzahl | Nein | Anzahl der Zielgruppen, die für die Paginierung übersprungen werden sollen |
Gibt JSON-Objekt mit audiences (Liste der Objekte einschließlich id, name, description, origin, modifiedAt) und total zurück.
Beispielaufforderung: „Listen Sie alle Zielgruppen auf.“
tool: get_target_audience
Abrufen von Zielgruppendetails, einschließlich Zielgruppenbestimmungsregeln.
Ruft die vollständige Konfiguration einer bestimmten Zielgruppe ab, einschließlich ihrer Zielgruppenbestimmungsregeln und -bedingungen.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
audience_id |
Ganzzahl | Ja | Die eindeutige Kennung der Zielgruppe |
Rückgabe Vollständige Zielgruppendetails, einschließlich id, name, description, origin, Zielgruppenbestimmungsregeln und der Anzahl der zugehörigen Aktivitäten.
Beispielaufforderung: „Abrufen von Details für Zielgruppen-12345 und Anzeigen der Zielgruppenbestimmungsregeln.“
Mbox-Tools tools-mboxes
tool: list_target_mboxes
Auflisten aller Mboxes in Ihrem Target.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
limit |
Ganzzahl | Nein | Maximale Anzahl an zurückzugebenden Mboxes |
offset |
Ganzzahl | Nein | Anzahl der Mboxes, die für die Paginierung übersprungen werden sollen |
name |
string | Nein | Nach Mbox-Namen filtern (teilweise Übereinstimmung) |
status |
string | Nein | Filtern nach Status |
Gibt JSON-Objekt mit mboxes (Liste der Objekte einschließlich name, status, lastRequestTime) und total zurück.
Beispielaufforderung: „Alle Mboxes auflisten, die ‘Homepage’ enthalten.“
tool: get_target_mbox
Abrufen detaillierter Informationen zu einer bestimmten Mbox.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
mbox_name |
string | Ja | Der Name der Mbox |
Gibt Mbox-Details zurück, einschließlich name, status und Liste der Aktivitäten, die die Mbox verwenden.
Beispielaufforderung: „Details für mbox ‘homepage-hero’ abrufen“.
tool: list_target_mbox_profile_attributes
Listet alle für die Zielgruppenbestimmung verfügbaren Mbox-Profilattribute auf.
Keine Parameter erforderlich.
Gibt JSON-Array von Profilattributobjekten zurück.
Beispielaufforderung: „Welche Profilattribute sind für die Zielgruppenbestimmung verfügbar?“
Eigenschafts-Tools tools-properties
tool: list_target_properties
Listet alle Eigenschaften in Ihrem Target auf.
Eigenschaften organisieren Aktivitäten und steuern den Zugriff.
Keine Parameter erforderlich.
Gibt Liste der Eigenschaftenobjekte einschließlich id, name, description und channel zurück.
Beispielaufforderung: „Alle Target-Eigenschaften auflisten“.
Reporting-Tools tools-reporting
tool: get_ab_performance_report
Abrufen eines Leistungsberichts für eine A/B-Aktivität.
Ruft Konversionsraten, Steigerung und Konfidenzniveaus ab.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der A/B-Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht (z. B. last7days, last30days oder benutzerdefinierter Datumsbereich) |
Rückgaben: Metriken auf Erlebnisebene (Besucher, Konversionen, Konversionsrate), Steigerungsberechnungen, statistische Konfidenzniveaus und Umsatzmetriken (falls konfiguriert).
Beispielaufforderung: „Anzeigen des Leistungsberichts für A/B-Test-12345 der letzten 30 Tage“
tool: get_ab_orders_report
Abrufen eines Berichts zu Bestellungen/Umsatz für eine A/B-Aktivität.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der A/B-Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht |
Rückgabe: Anzahl der Bestellungen, Umsatz und durchschnittlicher Bestellwert nach Erlebnis.
Beispielaufforderung: „Bericht zu Bestellungen für 12345 abrufen“
tool: get_xt_performance_report
Abrufen eines Leistungsberichts für eine Experience Targeting-Aktivität.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der XT-Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht |
Gibt zurück Leistungsmetriken auf Erlebnisebene.
Beispielaufforderung: „Leistung für meine Experience Targeting-54321 anzeigen“
tool: get_xt_orders_report
Abrufen eines Berichts zu Bestellungen/Umsatz für eine Experience Targeting-Aktivität.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der XT-Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht |
Gibt zurück Sortiert Metriken nach Erlebnis.
Beispielaufforderung: „Abrufen von Auftragsdaten für XT-54321“.
tool: get_activity_report_by_name
Suchen Sie nach einer Aktivität anhand des Namens und rufen Sie ihren Leistungsbericht ab.
Nützlich, wenn Sie den Namen der Aktivität, aber nicht ihre ID kennen.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_name |
string | Ja | Name der zu suchenden Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht |
Gibt zurück Aktivitätsdetails und Leistungsmetriken.
Beispielaufforderung: „Abrufen des Leistungsberichts für meine Aktivität „Startseiten-Heldentest“.“
tool: get_a4t_report
Abrufen eines Analytics for Target-(A4T)-Berichts für eine Target.
Validiert die A4T-Konfiguration für die Aktivität und führt dann GraphQL-Abfragen für Adobe Analytics aus, um Analytics-seitige Metriken abzurufen. Nur für Aktivitäten verfügbar, für die A4T-Berichte konfiguriert sind.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die eindeutige Kennung der Target Aktivität |
report_interval |
string | Nein | Zeitraum für den Bericht (z. B. last7days, last30days oder benutzerdefinierter Datumsbereich) |
Gibt Analytics-seitige Metriken für die Aktivität zurück, einschließlich Besucherzahlen, Konversionen, Umsatz und Steigerung nach Erlebnis, die direkt aus Adobe Analytics bezogen werden.
Beispielaufforderung: „Ziehen Sie den A4T-Bericht für meinen Checkout-Optimierungstest ab und fassen Sie die Analytics-seitigen Konversionsdaten zusammen.“
Vorschau-Tools tools-preview
tool: preview_activity
Generieren von Vorschau-URLs für die Browser-QA für eine Target.
Erstellt anklickbare Vorschau-Links, die die Anzeige bestimmter Erlebnisse erzwingen, und umgeht dabei die Zielgruppen-Targeting-Regeln. Funktioniert für A/B-, XT- und Automated Personalization-Aktivitäten.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
activity_id |
Ganzzahl | Ja | Die Target Aktivitäts-ID für die Vorschau |
experience_index |
Ganzzahl | Nein | Auf 0 basierender Erlebnisindex. Wenn ausgelassen, werden URLs für alle Erlebnisse zurückgegeben. |
url |
string | Nein | Seiten-URL für die Vorschau. Erforderlich für formularbasierte Aktivitäten. Für VEC-Aktivitäten überschreibt den erstellten Speicherort, sofern angegeben |
Gibt Aktivitätsinformationen (Name, Typ, Status), Vorschau-URLs für jedes Erlebnis sowie Erlebnisnamen und -indizes zurück.
Beispielaufforderung: „Generieren Sie Vorschau-URLs für die 12345, damit ich jedes Erlebnis in meinem Browser testen kann.“
Antwort-Token-Tools tools-response-tokens
tool: list_target_response_tokens
Auflisten aller Antwort-Token in Ihrem Target.
Ruft alle konfigurierten Antwort-Token ab, sowohl integrierte als auch benutzerdefinierte.
Keine Parameter erforderlich.
Gibt JSON-Array von Antwort-Token-Objekten mit name-, type- und enabled zurück.
Beispielaufforderung: „Alle Antwort-Token auflisten“
Revisionswerkzeuge tools-revisions
tool: get_target_revisions
Auditprotokoll für einen Ressourcentyp abrufen.
Ruft Änderungen an Target Ressourcen mit optionaler Filterung nach Autor ab.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
revision_resource_type |
string | Ja | Ressourcentyp: activity, offer oder audience |
modified_by |
string | Nein | Nach Benutzer filtern, der Änderungen vorgenommen hat |
limit |
Ganzzahl | Nein | Maximale Anzahl an zurückzugebenden Revisionen |
offset |
Ganzzahl | Nein | Anzahl der Revisionen, die für die Paginierung übersprungen werden sollen |
Gibt: Revisionsverlauf mit Zeitstempeln, Benutzern und Änderungsbeschreibungen zurück.
Beispielaufforderung: „Administratorprotokoll für Aktivitätsänderungen anzeigen“
tool: get_target_entity_revisions
Ruft alle Revisionen einer bestimmten Entität nach ID ab.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parameter | Typ | Erforderlich | Beschreibung |
revision_resource_type |
string | Ja | Ressourcentyp: activity, offer oder audience |
entity_id |
Ganzzahl | Ja | Die eindeutige Kennung der Entität |
Gibt JSON-Array aller Revisionen für die angegebene Entität zurück.
Beispiel-Eingabeaufforderung: „Alle Änderungen anzeigen, die an Activity 12345 vorgenommen wurden.“
Vorlagenwerkzeuge tools-templates
tool: list_target_templates
Listen Sie die verfügbaren MCP-Ressourcen und Vorlagen für die Erstellung von Aktivitäten und Angeboten auf.
Keine Parameter erforderlich.
Gibt JSON-Objekt zurück, das die verfügbaren Vorlagen und Ressourcen auflistet.
Beispielaufforderung: „Welche Vorlagen sind für die Erstellung von Aktivitäten verfügbar?“
Tools-Zusammenfassung tools-summary
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activitylist_target_offers, get_target_offerlist_target_audiences, get_target_audiencelist_target_mboxes, get_target_mbox, list_target_mbox_profile_attributeslist_target_propertiesget_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_reportpreview_activitylist_target_response_tokensget_target_revisions, get_target_entity_revisionslist_target_templates