Adobe Target MCP Server Tools-Referenz target-mcp-tools-reference

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.

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_activity

Hier erhalten Sie detaillierte Informationen zu Aktivitäten beliebigen Typs.

Ruft die vollständige Konfiguration einer bestimmten Aktivität ab und erkennt automatisch den Aktivitätstyp. Unterstützt A/B-Tests, Erlebnis-Targeting, Automated Personalization, automatische Zuordnung, Multivarianz-Tests und Recommendations-Aktivitäten.

Rückgabe Vollständige Aktivitätsdetails einschließlich Metadaten (Name, Status, Priorität, Daten), Erlebnisse, Standorte und Angebote, Ziele und Metriken sowie Zielgruppenbestimmungsregeln.

Beispiel-Eingabeaufforderung: „Abrufen von Details zur 12345“

tool: create_ab_activity

Erstellen Sie eine neue A/B-Test -Aktivität.

Erstellt einen neuen A/B-Test mit der angegebenen Konfiguration, einschließlich Erlebnissen, Angeboten und Targeting.

Gibt zurück Das erstellte Aktivitätsobjekt mit der zugewiesenen ID.

Beispielaufforderung: „Erstellen Sie einen A/B-Test namens „Homepage Hero Test“ mit zwei Erlebnissen, indem Sie verschiedene Hero-Bilder auf der homepage-hero mbox testen.“

tool: create_xt_activity

Erstellen Sie eine neue Experience Targeting-(XT)-Aktivität.

Erstellt eine XT-Aktivität, die basierend auf Targeting-Regeln verschiedene Erlebnisse für unterschiedliche Zielgruppen bereitstellt.

Gibt zurück Das erstellte Aktivitätsobjekt mit der zugewiesenen ID.

Beispielaufforderung: „Erstellen Sie eine Experience Targeting-Aktivität namens „Geo Personalization", die Besuchern aus verschiedenen Regionen unterschiedliche Inhalte anzeigt.“

tool: update_activity

Aktualisieren vorhandener A/B-Tests, Erlebnis-Targeting- oder Automated Personalization-Aktivitäten

Verwendet ein Lese-/Schreibmuster: ruft den aktuellen Status ab, führt Ihre Änderungen zusammen, validiert und sendet die Aktualisierung. Unterstützt A/B-Test-, Erlebnis-Targeting- und Automated Personalization-Aktivitäten; automatische Zuordnungs-, Multivarianz-Test- und Recommendations-Aktivitäten sind schreibgeschützt. Die strukturierten goal-, audience_ids- und additional_metrics werden nur für A/B-Tests und Experience Targeting unterstützt. Automated Personalization-Aktivitäten akzeptieren Aktualisierungen über die reine Feldzusammenführung.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispiel-Eingabeaufforderung: „Aktualisieren Sie die 12345, um die Traffic-Zuordnung auf 70/30 zu ändern.“

tool: update_activity_schedule

Start- und Enddatum der Aktivität aktualisieren

Aktualisiert den Zeitplan einer Aktivität ohne Änderung der anderen Einstellungen

Gibt zurück Bestätigung der Zeitplanaktualisierung.

Beispiel-Eingabeaufforderung: „Aktualisieren Sie den Zeitplan für die A/B-Aktivitäts-12345, die vom 1. Mai bis zum 31. Mai ausgeführt werden soll.“

tool: update_activity_state

Aktivitätsstatus ändern (aktivieren, deaktivieren oder pausieren).

Gibt zurück Der aktualisierte Aktivitätsstatus.

Beispielaufforderung: „Aktivitäts-12345 aktivieren“ oder „Homepage-Heldentest anhalten“.

tool: update_activity_name

Eine Aktivität umbenennen.

Aktualisiert nur den Namen, ohne die vollständige Konfiguration zu ändern.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Benennen Sie die Aktivität 12345 in „Heldentest der Sommerkampagne“ um.“

tool: update_activity_priority

Ändern der Aktivitätspriorität.

Aktivitäten mit höherer Priorität haben Vorrang, wenn mehrere Aktivitäten auf denselben Standort abzielen.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Legen Sie die Priorität der Aktivität 12345 auf 100 fest.“

tool: add_activity_variant

Hinzufügen eines neuen Erlebnisses/einer neuen Variante zu einer Aktivität.

Übernimmt die gesamte strukturelle Koordinierung, einschließlich der Erstellung von Optionen, der Zuordnung zu Standorten und der Neugewichtung des Traffics.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Fügen Sie 12345 mithilfe von 67890 eine neue Variante mit dem Namen „Feiertagsthema“ zur A/B-Aktivität hinzu.“

tool: update_traffic_split

Aktualisieren der Traffic-Zuordnung zu Varianten.

Die Prozentsätze müssen genau 100 betragen.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Ändern Sie die Traffic-Aufteilung für Aktivitäts-12345 in 70 % Kontrolle und 30 % Variante A.“

tool: update_variant_offer

Ändert das Angebot für eine bestimmte Variante.

Funktioniert sowohl für formularbasierte Aktivitäten (mit offer_id) als auch für VEC-Aktivitäten (mit modifications).

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Aktualisieren Sie das Erlebnis „Variante A“ in Activity 12345, um 99999 zu verwenden.“

tool: remove_activity_variant

Erlebnis/Variante aus einer Aktivität entfernen

Entfernt das Erlebnis, bereinigt verwaiste Optionen und gleicht den Traffic gleichmäßig über die verbleibenden Varianten aus.

Gibt zurück Das aktualisierte Aktivitätsobjekt.

Beispielaufforderung: „Entfernen des Erlebnisses „Testvariante“ aus der A/B-12345.“

tool: list_target_offers

Auflisten aller Angebote in Ihrem Target.

Ruft eine paginierte Liste von Inhaltsangeboten mit optionaler Filterung ab.

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.

Rückgabe Vollständige Angebotsdetails, einschließlich id, name, type, content, workspace und modifiedAt.

Beispiel-Eingabeaufforderung: „Abrufen von Details zur 67890“

tool: create_target_offer

Erstellen Sie ein neues HTML-Inhaltsangebot.

Gibt zurück Das erstellte Angebot mit der zugewiesenen ID.

Beispiel-Eingabeaufforderung: „Erstellen Sie ein HTML-Angebot mit dem Namen „Banner für den Sommerverkauf“ und einem Werbebanner.“

tool: create_target_json_offer

Erstellen Sie ein neues JSON-Angebot für die Bereitstellung strukturierter Daten.

Gibt zurück Das erstellte Angebot mit der zugewiesenen ID.

Beispielaufforderung: „Erstellen Sie ein JSON-Angebot mit dem Namen „Feature Flags Config“ und Umschalter für Funktionen.“

tool: update_target_offer

Vorhandenes Angebot aktualisieren.

Gibt zurück Das aktualisierte Angebotsobjekt.

Beispielaufforderung: „Aktualisieren der 67890 mit neuen Werbeinhalten.“

tool: list_target_audiences

Auflisten aller Zielgruppen in Ihrem Target.

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.

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.“

tool: create_target_audience

Erstellen Sie eine neue Audience mit Zielgruppenbestimmungsregeln.

Gibt zurück Die erstellte Zielgruppe mit der zugewiesenen ID.

Beispielaufforderung: „Erstellen Sie eine Zielgruppe namens „Mobile Besucher aus Kalifornien“, die auf mobile Benutzer in Kalifornien abzielt.“

tool: list_target_mboxes

Auflisten aller Mboxes in Ihrem Target.

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.

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?“

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“.

tool: get_activity_performance_report

Rufen Sie einen Leistungsbericht für eine Aktivität beliebigen Typs ab.

Ruft Konversionsraten, Steigerung und Konfidenzniveaus ab. Unterstützt A/B-Tests, Erlebnis-Targeting, Automated Personalization, automatische Zuordnung, Multivarianz-Tests und Recommendations-Aktivitäten.

Rückgaben: Metriken auf Erlebnisebene (Besucher, Konversionen, Konversionsrate), Steigerungsberechnungen, statistische Konfidenzniveaus und Umsatzmetriken (falls konfiguriert).

Beispielaufforderung: „Anzeigen des Leistungsberichts zur 12345 der letzten 30 Tage“

tool: get_activity_orders_report

Abrufen eines Berichts zu Bestellungen/Umsatz für eine Aktivität beliebigen Typs.

Unterstützt A/B-Tests, Erlebnis-Targeting, Automated Personalization, automatische Zuordnung, Multivarianz-Tests und Recommendations-Aktivitäten.

Rückgabe: Anzahl der Bestellungen, Umsatz und durchschnittlicher Bestellwert nach Erlebnis.

Beispielaufforderung: „Bericht zu Bestellungen für 12345 abrufen“

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.

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.

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.“

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.

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.“

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“

tool: create_target_response_token

Erstellen Sie ein neues benutzerdefiniertes Antwort-Token zum Erfassen zusätzlicher Daten in Target.

Gibt zurück Das erstellte Antwort-Token-Objekt.

Beispielaufforderung: „Erstellen Sie ein benutzerdefiniertes Antwort-Token namens „campaign_id“ vom Typ „ACTIVITY“.

tool: get_target_revisions

Auditprotokoll für einen Ressourcentyp abrufen.

Ruft Änderungen an Target Ressourcen mit optionaler Filterung nach Autor ab.

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.

Gibt JSON-Array aller Revisionen für die angegebene Entität zurück.

Beispiel-Eingabeaufforderung: „Alle Änderungen anzeigen, die an Activity 12345 vorgenommen wurden.“

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: list_target_criteria, get_target_criteria, list_target_criteria_by_type, get_target_criteria_by_type, create_target_criteria, update_target_criteria

Kriterien sind Regeln, die basierend auf einem vorab festgelegten Satz von Besucherverhalten bestimmen, welche Elemente empfohlen werden sollen. Die Kriterien sind in 9 Familien unterteilt: category, custom, item, cart, popularity, profileattribute, recent, sequence, userhistory.

list_target_criteria und get_target_criteria geben minimale Metadaten mit familienübergreifenden Kriterien zurück (id, name, criteriaTitle, criteriaGroup). Verwenden Sie list_target_criteria_by_type / get_target_criteria_by_type (oder create_target_criteria / update_target_criteria) mit einem criteria_type, um mit der vollständigen, typspezifischen Konfiguration zu arbeiten. Die Feldanforderungen sind je nach Familie unterschiedlich - siehe Adobe Recommendations-API-Referenz für das vollständige Schema pro Typ.

Gibt zurück Das Kriterienobjekt oder eine paginierte Liste mit offset, limit, total und list.

Beispielaufforderung: „Listet alle in diesem Konto konfigurierten Recommendations-Kriterien auf und fasst die verwendeten Algorithmustypen zusammen.“

Tools: list_target_collections, get_target_collection, create_target_collection, update_target_collection

Sammlungen gruppieren Katalogentitäten nach übereinstimmenden Regeln zur Verwendung in Kriterien und Promotions.

Gibt zurück Das Sammlungsobjekt, einschließlich id, name, description, rules und zuletzt geänderter Metadaten.

Beispielaufforderung: „Welche Sammlungen habe ich und nach welchen Katalogattributen filtern sie?“

Tools: list_target_designs, get_target_design, create_target_design, update_target_design

Designs sind Velocity- oder HTML-Vorlagen, die steuern, wie empfohlene Entitäten gerendert werden.

Gibt zurück Das Design-Objekt, einschließlich id, name, script und type.

Beispielaufforderung: „Welche Designs und Sammlungen habe ich für Recommendations konfiguriert?“

Tools: list_target_promotions, get_target_promotion, create_target_promotion, update_target_promotion

Promotions zwingen bestimmte Entitäten zu Recommendations-Ergebnissen, wobei sie den Kriterien und Backup-Recommendations vorgehen.

Gibt zurück Das Objekt der Promotion.

Beispiel-Eingabeaufforderung: „Erstellen Sie eine externe Promotion, die bis Ende August die Sammlung „Backpacking-Zelte“ enthält.“

Tools: list_target_exclusions, get_target_exclusion, create_target_exclusion, update_target_exclusion

Ausschlüsse entfernen übereinstimmende Entitäten aus den Empfehlungen. Ausschlüsse gelten kontenweit, für alle Kriterien und Aktivitäten.

Gibt zurück Das Ausschlussobjekt.

Beispielaufforderung: „Sind derzeit alle kontoweiten Ausschlüsse konfiguriert, und wornach werden sie gefiltert?“

Tools: get_target_entity, search_target_catalog

Schreibgeschützte Tools zur Überprüfung des Produkt-/Inhaltskatalogs für Recommendations. Es gibt kein Tool zum Erstellen, Aktualisieren oder Löschen von Katalogentitäten über den MCP-Server.

Gibt zurück: get_target_entity gibt die Katalogattribute der Entität zurück. search_target_catalog gibt Übereinstimmungen in einem entities Array zurück. Feldnamen in query müssen echte Katalogattribute sein, die für den Mandanten konfiguriert sind.

Beispielaufforderung: „Durchsuchen Sie den Katalog nach Produkten mit einem Bestand unter 1.000.“