DokumentationAdobe Brand Visibility

Cloudflare (BYOCDN)

Letzte Aktualisierung: 7. August 2026

Erstellt für:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

Diese Konfiguration leitet den Agent-basierten Traffic (Anfragen von KI-Bots und LLM-Benutzer-Agents) an den Backend-Service von Edge Optimize (live.edgeoptimize.net) weiter. Menschliche Besuchende und SEO-Bots werden weiterhin wie gewohnt von Ihrem Ursprung aus unterstützt. Um die Konfiguration zu testen, suchen Sie nach Abschluss der Einrichtung in der Antwort nach dem x-edgeoptimize-request-id-Header.

Voraussetzungen

Bevor Sie die Routing-Regeln für Cloudflare-Worker einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Ein Cloudflare-Konto mit für Ihre Domain aktiviertem Workers.
  • Zugriff auf die DNS-Einstellungen Ihrer Domain in Cloudflare.
  • Einen Edge Optimize-API-Schlüssel, der von der Adobe Brand Visibility-Benutzeroberfläche abgerufen wurde. Die einzelnen Schritte finden Sie unter Abrufen Ihrer API-Schlüssel.
  • (Optional) Weitere Informationen zum Staging-Routing finden Sie unter Staging-API-Schlüssel.

Funktionsweise von Routing

Bei korrekter Konfiguration wird eine Anfrage an Ihre Domain (z. B. www.example.com/page.html) von einem Agent-basierten Benutzer-Agent durch den Cloudflare Worker abgefangen und an das Edge Optimize-Backend weitergeleitet. Die Backend-Anfrage enthält die erforderlichen Header.

Testen der Backend-Anfrage

Sie können das Routing überprüfen, indem Sie eine direkte Anfrage an das Backend von Edge Optimize stellen.

curl -svo /dev/null https://live.edgeoptimize.net/page.html \
  -H 'x-forwarded-host: www.example.com' \
  -H 'x-edgeoptimize-url: /page.html' \
  -H 'x-edgeoptimize-api-key: $EDGE_OPTIMIZE_API_KEY' \
  -H 'x-edgeoptimize-config: LLMCLIENT=TRUE;'

Erforderliche Kopfzeilen

Bei Anfragen an das Backend von Edge Optimize müssen die folgenden Header festgelegt werden:

Kopfzeile
Beschreibung
Beispiel
x-forwarded-host
Der ursprüngliche Host der Anfrage. Erforderlich zum Identifizieren der Sitedomain.
www.example.com
x-edgeoptimize-url
Der ursprüngliche URL-Pfad und die Abfragezeichenfolge der Anfrage.
/page.html oder /products?id=123
x-edgeoptimize-api-key
Der von Adobe für Ihre Domain bereitgestellte API-Schlüssel.
your-api-key-here
x-edgeoptimize-config
Konfigurationszeichenfolge zur Unterscheidung von Cache-Schlüsseln.
LLMCLIENT=TRUE;

Einrichtungsoptionen

Es gibt zwei Möglichkeiten, Cloudflare für „Optimieren“ bei Edge zu konfigurieren:

  • Option 1: Geführte Einrichtung in Adobe Brand Visibility (empfohlen) - Verwendet Adobe Brand Visibility zum Bereitstellen des Sekundärs, Hinzufügen der Route und Überprüfen der Konfiguration.
  • Option 2: Manuelles Setup - Bietet schrittweise Anweisungen zum Erstellen und Konfigurieren des Sekundärs selbst. Verwenden Sie diese Option, wenn Sie bereits über einen Cloudflare-Worker für die Domain verfügen und den Edge Optimize-Code zusammenführen müssen oder wenn Sie die vollständige Kontrolle über die Bereitstellung bevorzugen.

Für die manuelle Einrichtung müssen Sie den Worker manuell mit Ihrer Domain verknüpfen. Siehe Hinzufügen einer Route zu Ihrer Domain.

Option 1: Geführte Einrichtung in Adobe Brand Visibility

  1. Öffnen Sie CDN-) für die URL, die Sie konfigurieren möchten.
  2. Wählen unter „Optimierungen für KI Agenten bereitstellen bei die Option Aktivieren“ aus.
  3. Wählen Sie Routing in Cloudflare bereitstellen aus.
  4. Wählen Sie Verbindung mit Cloudflare OAuth herstellen aus. Melden Sie sich mit einem Cloudflare-Benutzer an, der Worker- und Worker-Routen verwalten und dann den Zugriff auf das richtige Konto und die richtige Zone genehmigen kann. Sie müssen in Adobe Brand Visibility kein API-Token eingeben.
  5. Wählen Sie die Cloudflare-Zone für die Site aus. Stellen Sie sicher, dass der Ziel-Host-Name über einen Proxy-DNS-Eintrag verfügt und nicht von einem vorhandenen benutzerdefinierten Worker oder sich überschneidenden Worker-Routen verarbeitet wird.
  6. Befolgen Sie die Anweisungen zum Bereitstellen des dedizierten Sekundärs, Hinzufügen der Route und Überprüfen der Konfiguration.

Routing in Cloudflare von Adobe Brand Visibility bereitstellen

NOTE
Geführte Setups sind als EARLY ACCESS-Funktion für geeignete Konten verfügbar. Unterstützung beim Onboarding erhalten Sie von Ihrem Adobe-Account-Team oder per E-Mail llmo-at-edge@adobe.com.

Option 2: Manuelle Einrichtung

Führen Sie diese Schritte aus, um den Worker manuell zu erstellen und zu konfigurieren.

Schritt 1: Erstellen des Cloudflare-Sekundärs

  1. Melden Sie sich bei Ihrem Cloudflare-Dashboard an.
  2. Navigieren Sie in der Seitenleiste zu Workers & Pages.
  3. Klicken Sie auf Create application (Anwendung erstellen) und dann auf Create Worker (Worker erstellen).
  4. Legen Sie einen Namen für Ihren Worker fest (z. B. edge-optimize-router).
  5. Klicken Sie auf Deploy (Bereitstellen), um den Worker mit dem Standard-Code zu erstellen.

Dashboard für Cloudflare Workers

Schritt 2: Worker-Code hinzufügen

Klicken Sie nach dem Erstellen des Sekundärs auf Code bearbeiten und ersetzen Sie den Standardcode durch den Code aus worker.js. Wenn Sie bereits über einen Cloudflare-Worker verfügen, führen Sie den Code mit Ihrem vorhandenen Worker-Code zusammen, anstatt ihn vollständig zu ersetzen.

Klicken Sie auf Save and deploy (Speichern und bereitstellen), um den Worker zu veröffentlichen.

Schritt 3: Konfigurieren von Umgebungsvariablen und Geheimnissen

Umgebungsvariablen speichern vertrauliche Konfigurationen wie Ihren API-Schlüssel auf sichere Weise.

  1. Navigieren Sie in den Einstellungen Ihres Workers zu Settings (Einstellungen) > Variables (Variablen).

  2. Klicken Sie unter Environment Variables (Umgebungsvariablen) auf Add variable (Variable hinzufügen).

  3. Fügen Sie die folgenden Variablen hinzu:

    table 0-row-3 1-row-3 2-row-3
    Variablenname Beschreibung Erforderlich
    EDGE_OPTIMIZE_API_KEY Ihr von Adobe bereitgestellter API-Schlüssel für Edge Optimize. Ja
    EDGE_OPTIMIZE_TARGET_HOST Der Ziel-Host für Edge Optimize-Anfragen (als x-forwarded-host-Header gesendet) und die Ursprungs-Domain für das Failover. Darf nur die Domain ohne Protokoll sein (z. B. www.example.com, nicht https://www.example.com). Ja

  4. Klicken Sie für den API-Schlüssel auf Encrypt (Verschlüsseln), um ihn sicher zu speichern.

  5. Klicken Sie auf Save and deploy (Speichern und bereitstellen).

Cloudflare-Umgebungsvariablen

Hinzufügen einer Route zu Ihrer Domain add-a-route-to-your-domain

Wenn Sie die manuelle Einrichtung verwendet haben, verknüpfen Sie den Worker manuell mit Ihrer Domain. Dieser Schritt aktiviert den Worker in Ihrem Traffic.

  1. Navigieren Sie zu Settings (Einstellungen) > Triggers (Auslöser) für Ihren Worker.
  2. Klicken Sie unter Routes (Routen) auf Add route (Route hinzufügen).
  3. Geben Sie Ihr Domain-Muster ein (z. B. www.example.com/* oder example.com/*).
  4. Wählen Sie im Dropdown-Menü eine Zone aus.
  5. Klicken Sie auf Speichern.

Alternativ können Sie Routen auf Zonenebene konfigurieren:

  1. Navigieren Sie zu Ihrer Domain in Cloudflare.
  2. Gehen Sie zu Workers Routes (Workers – Routen).
  3. Klicken Sie auf Add route (Route hinzufügen) und geben Sie das Muster und den Worker an.

Cloudflare Worker-Routen

Überprüfen des Failover-Verhaltens

Wenn Edge Optimize nicht verfügbar ist oder einen Fehler zurückgibt, führt der Worker automatisch ein Failover zu Ihrem Ursprung durch. Die Failover-Antworten enthalten den x-edgeoptimize-fo-Header:

< HTTP/2 200
< x-edgeoptimize-fo: 1

Sie können Failover-Ereignisse in den Cloudflare Workers-Protokollen überwachen, um Probleme zu beheben.

Verstehen der Worker-Logik

Der Cloudflare Worker implementiert die folgende Logik:

  1. Erkennung von Benutzer-Agents: Prüft, ob der Benutzer-Agent der eingehenden Anfrage mit einem der definierten Agent-basierten Bots übereinstimmt (keine Berücksichtigung der Groß-/Kleinschreibung).

  2. Pfad-Targeting: Filtert Anfragen optional nach Zielpfaden. Standardmäßig werden alle HTML-Seiten (URLs, die auf / enden, keine Erweiterung haben oder auf .html enden) weitergeleitet. Sie können bestimmte Pfade mithilfe des Arrays TARGETED_PATHS angeben.

  3. Schleifenschutz: Der x-edgeoptimize-request-Header verhindert Endlosschleifen. Wenn Edge Optimize Anfragen an Ihren Ursprung zurücksendet, wird dieser Header auf "1" festgelegt und der Worker übergibt die Anfrage, ohne sie an Edge Optimize zurückzuleiten.

  4. Header-Sicherheit: Bevor Sie Edge Optimize-Header festlegen, entfernt der Worker alle vorhandenen x-edgeoptimize-*-Header aus der eingehenden Anfrage, um Header-Injection-Angriffe zu verhindern.

  5. Header-Zuordnung: Der Worker legt die erforderlichen Header für Edge Optimize fest:

    • x-forwarded-host – Identifiziert die ursprüngliche Sitedomain.
    • x-edgeoptimize-url – Behält den ursprünglichen Anfragepfad und die Abfragezeichenfolge bei.
    • x-edgeoptimize-api-key – Authentifiziert die Anfrage bei Edge Optimize.
    • x-edgeoptimize-config – Stellt die Konfiguration des Cache-Schlüssels bereit.

  6. Failover-Logik: Wenn Edge Optimize einen Fehlerstatus-Code (4XX-Client- oder 5XX-Server-Fehler) zurückgibt oder die Anfrage aufgrund eines Netzwerkfehlers fehlschlägt, erfolgt automatisch ein Failover des Workers zu Ihrem Ursprung mithilfe von EDGE_OPTIMIZE_TARGET_HOST. Die Failover-Antwort enthält den x-edgeoptimize-fo: 1-Header, um anzugeben, dass ein Failover stattgefunden hat.

  7. Umleitungshandhabung: Die Option redirect: "manual" stellt sicher, dass Umleitungsantworten von Edge Optimize an den Client weitergeleitet werden, ohne dass der Worker ihnen folgt.

Anpassen der Konfiguration

Sie können das Worker-Verhalten anpassen, indem Sie die Konfigurationskonstanten oben im Code ändern:

Agent-Bot-Liste

Ändern Sie das Array AGENTIC_BOTS, um Benutzer-Agents hinzuzufügen oder zu entfernen:

const AGENTIC_BOTS = [
  'AdobeEdgeOptimize-AI',
  'ChatGPT-User',
  'GPTBot',
  'OAI-SearchBot',
  'PerplexityBot',
  'Perplexity-User',
  'ClaudeBot',
  'Claude-User',
  'Claude-SearchBot',
  // Add additional user agents as needed
];

Zielpfade

Standardmäßig werden alle HTML-Seiten an Edge Optimize weitergeleitet. Um das Routing auf bestimmte Pfade zu beschränken, ändern Sie das Array TARGETED_PATHS:

// Route all HTML pages (default)
const TARGETED_PATHS = null;

// Or specify exact paths to route
const TARGETED_PATHS = ['/', '/page.html', '/products', '/about-us'];

Failover-Konfiguration

Standardmäßig erfolgt ein Failover des Workers bei einem 4XX- oder 5XX-Fehler von Edge Optimize. Passen Sie dieses Verhalten an:

// Default: failover on any 4XX or 5XX error
const FAILOVER_ON_4XX = true;
const FAILOVER_ON_5XX = true;

// Failover only on 5XX server errors (not 4XX client errors)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = true;

// Disable automatic failover (not recommended)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = false;

Wichtige Überlegungen

  • Failover-Verhalten: Der Worker führt automatisch ein Failover zu Ihrem Ursprung durch, wenn Edge Optimize einen Fehler zurückgibt (4XX- oder 5XX-Status-Code) oder wenn die Anfrage aufgrund eines Netzwerkfehlers fehlschlägt. Bei einem Failover wird EDGE_OPTIMIZE_TARGET_HOST als Ursprungs-Domain verwendet (ähnlich wie bei F_Default_Origin von Fastly oder Default_Origin von CloudFront). Failover-Antworten enthalten den x-edgeoptimize-fo: 1-Header, den Sie für Monitoring und Debugging verwenden können.

  • Caching: Cloudflare speichert Antworten standardmäßig basierend auf der URL zwischen. Da der Agent-basierten Traffic andere Inhalte erhält als menschlicher Traffic, müssen Sie sicherstellen, dass dies bei Ihrer Cache-Konfiguration berücksichtigt wird. Erwägen Sie die Verwendung der Cache-API oder von Cache-Headern, um zwischengespeicherte Inhalte zu unterscheiden. Der x-edgeoptimize-config-Header sollte in Ihrem Cache-Schlüssel enthalten sein.

  • Ratenbegrenzung: Überwachen Sie die Nutzung von Edge Optimize und erwägen Sie bei Bedarf die Implementierung einer Ratenbegrenzung für Agent-basierten Traffic.

  • Testen: Testen Sie die Konfiguration immer in einer Staging-Umgebung, bevor Sie sie in der Produktionsumgebung bereitstellen. Vergewissern Sie sich, dass sich Agent-basierter Traffic und menschlicher Traffic erwartungsgemäß verhalten. Testen Sie das Failover-Verhalten durch Simulation von Edge Optimize-Fehlern.

  • Protokollierung: Aktivieren Sie die Cloudflare Workers-Protokollierung, um Anfragen zu überwachen und Probleme zu beheben. Navigieren Sie zu Workers > Ihr Worker > Logs (Protokolle), um Echtzeitprotokolle anzuzeigen. Der Worker protokolliert Failover-Ereignisse zu Debugging-Zwecken.

Fehlerbehebung

Problem
Mögliche Ursache
Lösung
Kein x-edgeoptimize-request-id-Header in Antwort
Worker-Route nicht zugeordnet oder Benutzer-Agent nicht in der Liste der Agent-basierten Bots.
Überprüfen Sie, ob Ihr Routenmuster mit der Anfrage-URL übereinstimmt. Prüfen Sie, ob sich der Benutzer-Agent im Array AGENTIC_BOTS befindet.
401- oder 403-Fehler von Edge Optimize
Ungültiger oder fehlender API-Schlüssel.
Überprüfen Sie, ob EDGE_OPTIMIZE_API_KEY in Umgebungsvariablen und Geheimnissen korrekt festgelegt ist. Wenden Sie sich an Adobe, um zu bestätigen, dass Ihr API-Schlüssel aktiv ist.
Unendliche Weiterleitungen oder Schleifen
Schleifenschutz-Header ist nicht korrekt festgelegt oder wird nicht richtig überprüft.
Stellen Sie sicher, dass die Überprüfung des x-edgeoptimize-request-Headers eingerichtet ist.
Betroffener menschlicher Traffic
Routing-Logik für Worker ist zu breit angelegt.
Überprüfen Sie, ob die Zuordnungslogik des Benutzer-Agents korrekt ist und nicht zwischen Groß- und Kleinschreibung unterschieden wird. Überprüfen Sie, ob TARGETED_PATHS richtig konfiguriert ist.
Langsame Antwortzeiten
Netzwerklatenz zum Edge Optimize-Backend.
Dies ist für die erste Anfrage zu erwarten. Nachfolgende Anfragen werden bei Edge Optimize zwischengespeichert.
x-edgeoptimize-fo: 1-Header in Antwort
Edge Optimize hat einen Fehler zurückgegeben und es hat ein Failover zum Ursprung stattgefunden.
Überprüfen Sie die Cloudflare Workers-Protokolle auf den spezifischen Fehler-Code. Informieren Sie sich bei Adobe über den Dienststatus von Edge Optimize.
Failover funktioniert nicht
Failover-Flags deaktiviert oder Fehler in der Failover-Logik.
Überprüfen Sie, ob FAILOVER_ON_4XX und FAILOVER_ON_5XX auf true festgelegt sind. Prüfen Sie die Worker-Protokolle auf Fehlermeldungen.
Bestimmte Pfade werden nicht optimiert
Pfad stimmt nicht mit den Zielpfaden oder dem HTML-Seitenmuster überein.
Überprüfen Sie, ob sich der Pfad in TARGETED_PATHS befindet (falls angegeben) und mit dem Regex-Muster der HTML-Seite übereinstimmt.
Anfragen schlagen aufgrund eines ungültigen Hosts fehl
EDGE_OPTIMIZE_TARGET_HOST enthält Protokoll (zum Beispiel https://).
Verwenden Sie nur den Domain-Namen ohne Protokoll (zum Beispiel example.com, nicht https://example.com).
530-Fehler beim Failover
Cloudflare kann keine Verbindung zum Ursprung herstellen oder die Failover-Anfrage hat ungültige Header.
Stellen Sie sicher, dass die Failover-Funktion Edge Optimize-Header entfernt. Stellen Sie sicher, dass auf Ihren Ursprung zugegriffen werden kann und dass DNS korrekt konfiguriert ist.

Zulassen, dass bei Edge durch Firewall-Regeln optimiert wird (optional)

Wenn Ihr CDN einen WAF oder Bot Manager verwendet:

  • Zulassungsliste des *AdobeEdgeOptimize/1.0*-Benutzeragenten in WAF oder Bot-Manager, damit der Service „Optimieren unter Edge" Ihre Ursprungs-Inhalte abrufen kann.

  • Wenn Ihre Firewall eine zusätzliche Überprüfung über den Benutzeragenten hinaus erfordert, generieren Sie ein Geheimnis (z. B. openssl rand -hex 32) und:

    • Fügen Sie x-edgeoptimize-fetcher-key mit dem Geheimnis in Ihren Routing-Regeln zusammen mit den anderen x-edgeoptimize-* Kopfzeilen hinzu.
    • Fügen Sie eine WAF- oder Bot-Manager-Regel hinzu, um Anfragen zuzulassen, bei denen x-edgeoptimize-fetcher-key mit demselben Geheimnis übereinstimmt.

  • Bei Edge optimieren leitet diese Kopfzeile unverändert weiter - Sie besitzen den gesamten Schlüssellebenszyklus.

Überprüfen des Setups

Stellen Sie nach Abschluss des Setups sicher, dass Bot-Traffic an Edge Optimize weitergeleitet wird und dass der menschliche Traffic nicht betroffen ist.

1. Testen des Bot-Traffics (sollte optimiert werden)

Simulieren Sie eine KI-Bot-Anfrage mithilfe eines Agent-basierten Benutzer-Agents:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

Eine erfolgreiche Antwort enthält den x-edgeoptimize-request-id-Header, der bestätigt, dass die Anfrage über Edge Optimize weitergeleitet wurde:

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. Testen des menschlichen Traffics (sollte NICHT betroffen sein)

Simulieren Sie eine normale menschliche Browser-Anfrage:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

Die Antwort sollte nicht den x-edgeoptimize-request-id-Header enthalten. Der Seiteninhalt und die Antwortzeit sollten nach der Aktivierung von „Optimize at Edge“ unverändert bleiben.

3. So lassen sich die beiden Szenarien voneinander unterscheiden

Kopfzeile
Bot-Traffic (optimiert)
Menschlicher Traffic (nicht betroffen)
x-edgeoptimize-request-id
Vorhanden – enthält eine eindeutige Anfrage-ID
Abwesend
x-edgeoptimize-fo
Nur vorhanden, wenn Failover stattgefunden hat (Wert: 1)
Abwesend

Der Status des Traffic-Routings kann auch in der Adobe Brand Visibility-Benutzeroberfläche überprüft werden. Navigieren Sie zu Kundenkonfiguration und wählen Sie die Registerkarte CDN-Konfiguration aus.

Optimierungen für AI Agents bereitstellen – abgeschlossen

Weitere Informationen zu „Optimieren bei Edge", einschließlich verfügbarer Opportunitys, Workflows für die automatische Optimierung und häufig gestellte Fragen, finden Sie unter "​ bei Edge - Überblick.

recommendation-more-help
brand-visibility-help-main-toc