> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/de/brand-pages/brand-page-retailer-integration-guide/tracking-attribution.md). # Tracking & Zuordnung ## So erstellen Sie eine Tracking-URL Die Antwort enthält drei Quellen zum Kombinieren: * Seitenebene `trackers.impression`: Zum Beispiel nutzt ein Seitenaufruf `type: "impression"` und `params` einschließlich `ts` und `iabConsentString`. * Gemeinsam genutzt `trackingTemplates`: Ein Satz von `client`(relativ) und `server` (absolut) URL-Vorlagen, die bereits Sitzungs- und Platzierungs-Abfrageparameter enthalten. * Pro Knoten `trackers.click` und/oder `trackers.addToCart` auf einem Modul, einer Zeile oder einem Galerie-Element: `type`+ `params` für dieses spezifische Ereignis (zum Beispiel `modId`, `rurl`, `productCode`). ### Welche Vorlage? Verwenden Sie die des Knotens `tracking.type` , um nachzuschlagen `trackingTypes.`. Dies definiert die gültigen `client.*` und `server.*` Schlüssel für diese Interaktion (zum Beispiel für link: `client.clickRedirect`, `client.clickEvent`, `server.clickEvent)`. ### Client vs. Server * Client (`trackingTemplates.client.*`): Werte sind relative Pfade (einschließlich Abfragestrings). Stellen Sie Ihre Reverse-Proxy-Basis-URL voran (`BASEURL`). * Server (`trackingTemplates.server.`): Werte sind absolute URL-Vorlagen auf dem Epsilon Tracking-Host. Erstellen Sie die finale URL auf dieselbe Weise wie C2S: Vorlage + `"&"` + `queryString(trackers.params)`. {% hint style="info" %} Ändern Sie nicht den Host oder Pfad der Vorlage und senden Sie keine S2S-Aufrufe durch Ihren Reverse-Proxy. {% endhint %} ### Ausgearbeitete Beispiele (Pseudocode) #### C2S-Klick für einen HERO-CTA ``` url = BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) ``` #### S2S-Seitenaufruf ``` url = trackingTemplates.server.impressionEvent + "&" + queryString(trackers.impression.params) ``` #### S2S-In-den-Warenkorb für eine Produktzeile ``` url = trackingTemplates.server.addToCartEvent + "&" + queryString(trackers.addToCart.params) ``` Makro-Ersetzung * Ersetzen Sie {TS} durch den aktuellen Millisekunden-Zeitstempel, {RURL} durch das URL-codierte Ziel und `{TCF}` vor dem Auslösen durch den aktuellen TCF v2-String aus Ihrer CMP. * Ersetzen Sie für In-den-Warenkorb auch {QTY} durch die absolute Menge dieser SKU im Warenkorb zum Zeitpunkt des Auslösens (keine Differenz) und {CONVERSION\_VALUE} durch den absoluten Geldwert dieser Artikel (Menge × Einzelpreis abzüglich angewendeter Rabatte). {% hint style="info" %} * Nur `trackingTemplates.client.impressionPixelUrls` sind echte Pixel (1×1 GIFs). * `clickRedirect` ist ein 302-Weiterleitungs-Endpunkt. * `clickEvent` und `addToCartEvent` sind Ereignis-Beacons, die 204 No Content zurückgeben. {% endhint %} {% hint style="danger" %} Lösen Sie nicht sowohl C2S als auch S2S für dasselbe logische Ereignis aus (senden Sie beispielsweise nicht sowohl ein C2S-Klick-Ereignis als auch eine S2S-Klick-Benachrichtigung für denselben Klick). {% endhint %} ## Tracking – Client‑to‑Server (C2S) C2S-Tracking wird im Browser mithilfe zusammengesetzter URLs implementiert. Stellen Sie `BASEURL` vor die Pfade in `trackingTemplates.client` und hängen Sie die entsprechende `trackers.params` an (siehe [So erstellen Sie eine Tracking-URL](#how-to-compose-a-tracking-url)). Nur `client.impressionPixelUrls` sind Pixel (1×1 GIF). Die anderen Client-Vorlagen sind keine Pixel: * `client.clickRedirect`302-Weiterleitungs-Endpunkt. Epsilon protokolliert den Klick und leitet den Browser zur decodierten rurl weiter. Verwenden Sie dies als Browser-Navigationsziel. * `client.clickEvent`**Ereignis-Beacon** gibt 204 No Content zurück). Auslösen mittels `navigator.sendBeacon` or `fetch({ keepalive: true })`. Nicht rendern als ``. * `client.addToCartEvent`: **Ereignis-Beacon** (gibt 204 zurück). Verwendet dasselbe Auslösemuster wie `clickEvent`. ### Implementierungsschritte 1. Rendern Sie den von der API zurückgegebenen Markenseiten-Inhalt. 2. Lösen Sie nach dem Rendern Impression-Pixel im Browser aus (alle Einträge in `trackingTemplates.client.impressionPixelUrls`als 1×1-Bilder). 3. Wenn ein Benutzer auf einen nachverfolgbaren Knoten klickt, entweder:\ (a) leiten Sie über die erstellte `client.clickRedirect` URL weiter, oder\ (b) lösen Sie die erstellte `client.clickEvent` URL als Ereignis-Beacon aus und navigieren Sie selbst zum Ziel.\ Verwenden Sie pro Klick die eine oder die andere Option, nicht beide. ### Impression-Pixel Nachdem die Markenseite gerendert wurde, lösen Sie jeden Pfad aus in `trackingTemplates.client.impressionPixelUrls` als 1×1-Bild (siehe[ So erstellen Sie eine Tracking-URL](#how-to-compose-a-tracking-url)). ```html ``` Schritte: 1. Für jede Zeichenfolge in `trackingTemplates.client.impressionPixelUrls`, stellen Sie Ihr `BASEURL` (zum Beispiel `https://www.retailer.com/epsilon`). 2. Fügen Sie `&` + `queryString(trackers.impression.params)`hinzu, wobei Sie `{TS}` durch den aktuellen Millisekunden-Zeitstempel und `{TCF}` durch die aktuelle Consent-Zeichenfolge aus Ihrer CMP ersetzen. 3. Rufen Sie als 1×1 `< img src="...">` im Browser auf (oder entsprechend). ### Klick-Tracking #### Option A: Klick-Weiterleitung (`client.clickRedirect`) Leiten Sie den Nutzer über die zusammengesetzte URL weiter. Epsilon protokolliert den Klick und antwortet mit **HTTP 302** auf die dekodierte `rurl`. Dieser Endpunkt ist **nur GET**, und `rurl` ist erforderlich; #### Option B: Klick-Event-Beacon (`client.clickEvent`) Als Beacon abfeuern und selbst navigieren. Akzeptiert GET oder POST, gibt 204 No Content zurück. Kein Bild; nicht rendern als``. ### Warenkorb-Hinzufügung (C2S) Feuern Sie `trackingTemplates.client.addToCartEvent` als Event-Beacon (nicht als Pixel) ab, wenn der Nutzer ein Produkt zum Warenkorb hinzufügt. Akzeptiert GET oder POST, gibt 204 No Content zurück. {% hint style="info" %} Kombinieren Sie C2S- und S2S-Warenkorb-Hinzufügungen nicht für dieselbe Warenkorb-Aktion. {% endhint %} ## Tracking – Server-to-Server (S2S) S2S-Tracking wird auf Ihrem Backend implementiert. Verfassen Sie URLs auf dieselbe Weise wie bei C2S: Beginnen Sie mit der entsprechenden `trackingTemplates.server` Zeichenfolge und fügen Sie dann `trackers.params`hinzu. Server-Vorlagen sind bereits absolut — es gibt kein `BASEURL`voranzustellen. (siehe [So erstellen Sie eine Tracking-URL](#how-to-compose-a-tracking-url)). {% hint style="info" %} Ändern Sie nicht den Host oder Pfad der Server-Vorlage und senden Sie keine S2S-Anfragen über Ihren Reverse-Proxy. {% endhint %} ### Wann S2S-Tracking verwendet werden sollte * Ihre Architektur erfordert das serverseitige Auslösen von Events. * Sie benötigen Tracking in Umgebungen, in denen clientseitige Pixel unzuverlässig sind. * Sie möchten Strategien mischen - z. B. C2S-Impressions + S2S-Warenkorb-Hinzufügungen. Dies wird unterstützt, aber feuern Sie niemals sowohl C2S als auch S2S für dasselbe Event ab. ### S2S-Impression-Benachrichtigung Nachdem die Markenseite gerendert wurde, sendet Ihr Server ein **GET** oder **POST** an die zusammengesetzte Impression-URL: `trackingTemplates.server.impressionEvent` + `trackers.impression.params` (ersetzen Sie `{TS}` und `{TCF}` vor dem Senden). ### S2S-Klick-Benachrichtigung Zusammensetzen: `trackingTemplates.server.clickEvent` + `trackers.click.params` (ersetzen Sie `{TS}`{RURL} und `{TCF}`) und dann GET oder POST ausführen. ### S2S-Warenkorb-Hinzufügungs-Benachrichtigung Zusammensetzen: `trackingTemplates.server.addToCartEvent` + `trackers.addToCart.params` (ersetzen Sie `{TS}`{QTY}, {CONVERSION\_VALUE} und `{TCF}`) und dann GET oder POST ausführen. ### S2S-Parameter | Parameter | Quelle | Hinweise | | ----------------------------------------------------------------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `catalogId`, `sessionId`, `customerId`, `dtmId`, `placementId`, `lsid`, `utcOffset` | `trackingTemplates` Query-Strings | Bewahren Sie diese Werte beim Ausführen der Anfrage unverändert auf. Entfernen oder ändern Sie sie nicht. | | `modId` | `trackers..params` | Inhaltsmodul- oder Zeilen-ID. | | `ts` | `trackers..params` | Ersetzen Sie `{TS}` vor dem Auslösen der Anfrage durch den aktuellen Zeitstempel in Millisekunden. | | `iabConsentString` | `trackers..params` | Ersetzen Sie `{TCF}` vor dem Auslösen der Anfrage durch die aktuelle TCF v2 Consent-Zeichenfolge aus der CMP. Wenn bereits ein Wert angegeben ist, verwenden Sie ihn wie besehen. | | `rurl` | `trackers..params` | URL-codiertes Weiterleitungsziel. Ersetzen Sie `{RURL}` falls vorhanden. | | `productCode`, `sellerId` | `trackers..params` | Werte, die aus Produktknoten abgeleitet wurden. | | `qty` | `trackers.addToCart.params` | Ersetzen Sie `{QTY}` durch die absolute Menge der SKU im Warenkorb zum Zeitpunkt des Auslösens der Anfrage. Verwenden Sie nicht die Mengendifferenz. | | `conVal` | `trackers.addToCart.params` | Ersetzen Sie `{CONVERSION_VALUE}` durch den Gesamtwert der Artikel in Geldwert (Menge × Einzelpreis abzüglich etwaiger Rabatte). | ## Makro-Referenz | Symbol | Beschreibung | Gefunden in | Ersetzen durch | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------- | | `BASEURL` (Ihr Präfix) | Die Basis-URL Ihrer Website mit Protokoll und Proxy-Pfad - jedem voranstellen `trackingTemplates.client.*` Pfad. | C2S-Tracking | `https://www.retailer.com/epsilon` | | `{TS}` | Timestamp für Cache-Busting (Millisekunden) | `trackers..params` | `1737485823910` | | `{RURL}` | URL-codiertes Weiterleitungsziel | `trackers..params.rurl` | `https%3A%2F%2Fwww.retailer.com%2Fprodukt%2F9221200653341` | | `{TCF}` | IAB TCF v2 Consent-String-Platzhalter. Vorhanden, wenn `regs.consent` bei der Anfrage weggelassen wurde. | `trackers..params.iabConsentString` | Aktueller TC-String aus Ihrer CMP, z. B. über `__tcfapi` `getTCData` → `tcString` | | `{QTY}` | Absolute Menge dieser SKU im Warenkorb zum Zeitpunkt des Auslösens (keine Differenz; z. B. wenn der Käufer 1 hatte und eine weitere hinzufügt, senden Sie `2`). | `trackers.addToCart.params.qty` | `2` | | `{CONVERSION_VALUE}` | Absoluter Geldwert dieser Artikel: Menge × Stückpreis abzüglich angewendeter Rabatte. | `trackers.addToCart.params.conVal` | `49.99` | | `{RURL_KID}` | Schlüssel-ID für die Weiterleitungssignierung. Vorhanden in `trackers.click.redirectParams` wenn die plattformseitige Weiterleitungssignierung aktiviert ist. | `trackers.click.redirectParams.rurlKid` | Signierungsschlüssel-ID, die vom Batch-Signatur-Endpunkt zurückgegeben wird | | `{RURL_SIG}` | Signatur für die Weiterleitungssignierung. Vorhanden in `trackers.click.redirectParams` wenn die plattformseitige Weiterleitungssignierung aktiviert ist. | `trackers.click.redirectParams.rurlSig` | Ed25519-Signatur (base64url), die vom Batch-Signatur-Endpunkt zurückgegeben wird | ### URL-Codierung Referenz Beim Codieren `{RURL}`, verwenden Sie die Standard-Prozent-Codierung: | Zeichen | Codieren als | | ------- | ------------ | | `:` | `%3A` | | `/` | `%2F` | | `?` | `%3F` | | `=` | `%3D` | | `&` | `%26` | ### redirectParams und Signierung von Weiterleitungen Wenn die Signierung von Plattforms-Weiterleitungen aktiviert ist, `trackers.click` kann ein `redirectParams`Objekt neben `params`enthalten. Die Schlüssel in `7`werden nur in `client.clickRedirect` URLs zusammengeführt — nicht in `clickEvent`oder eine beliebige Server-URL. Zwei Fälle: **Eingebettete Linkziele** (in die URL integriert `params.rurl`): Die Plattform signiert die Weiterleitung zum Bereitstellungszeitpunkt und gibt wörtliche `rurlKid`und `rurlSig`Werte in `redirectParams`aus. Hängen Sie diese unverändert an die `clickRedirect` URL. **Vom Händler gesteuerte Weiterleitungen** (`params.rurl` ist {RURL}): `redirectParams` enthält die Makros {RURL\_KID} und {RURL\_SIG}. Rufen Sie den Batch-Signatur-Endpunkt auf (`redirectSigning.url` aus der Antwort), um die Schlüssel-ID und Signatur für Ihre Ziel-URL zu erhalten, und ersetzen Sie diese vor dem Anfügen. Die oberste Ebene `redirectSigning`Objekt, falls vorhanden, stellt die Batch- `POST /ads/v3/redirect/sign` Endpunkt-URL und das `maxUrls`Batch-Limit bereit. Kontaktieren Sie Epsilon , um zu bestätigen, ob die Weiterleitungssignierung für Ihre Integration aktiviert ist. ### clickRedirect-Zusammensetzung mit redirectParams: ``` BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) + "&" + queryString(trackers.click.redirectParams) ```
## Styleguide Bevor Sie Brand Pages auf Ihrer Website aktivieren, müssen wir die visuelle Identität Ihrer Website erfassen. Füllen Sie die nachstehende Tabelle mit Ihren Designwerten aus. Unser Team wird diese verwenden, um das Brand Page-Vorschauerlebnis zu konfigurieren. #### Logo | Feld | Beschreibung | Ihr Wert | | -------- | ---------------------------------------- | -------- | | Logo-URL | URL zu Ihrem Website-Logo (SVG oder PNG) | | #### Farben | Feld | Beschreibung | Ihr Wert | | -------------------- | ------------------------------------------------ | -------- | | Primärfarbe | Hauptmarkenfarbe (Hex) | | | Hintergrundfarbe | Seitenhintergrundfarbe (Hex) | | | Oberflächenfarbe | Karten-/Abschnittshintergrundfarbe (Hex) | | | Primäre Textfarbe | Haupttextfarbe (Hex) | | | Sekundäre Textfarbe | Dezente Textfarbe (Hex) | | | Text auf Primärfarbe | Textfarbe auf primärfarbenen Hintergründen (Hex) | | | Rahmenfarbe | Standard-Rahmenfarbe (Hex) | | #### Typografie | Feld | Beschreibung | Ihr Wert | | -------------------------------- | -------------------------------------------------------------- | -------- | | Schriftfamilie für Überschriften | Schriftart für Überschriften (z. B. „Google Sans, sans-serif“) | | | Schriftfamilie für Fließtext | Schriftart für Fließtext (z. B. „Roboto, sans-serif“) | | | Basisschriftgröße | Standard-Schriftgröße für Fließtext (z. B. 16px) | | #### Schaltflächen | Feld | Beschreibung | Ihr Wert | | ------------------------------------ | ------------------------------------------------------------------------- | -------- | | Hintergrund für primäre Schaltfläche | Hintergrundfarbe für primäre Schaltflächen | | | Textfarbe für primäre Schaltfläche | Textfarbe für primäre Schaltflächen | | | Eckenradius für primäre Schaltfläche | Eckenabrundung (z. B. 8px) | | | Stil für sekundäre Schaltfläche | Darstellung der sekundären Schaltfläche beschreiben (Outline, Ghost usw.) | | ## Anforderungen an Modulinhalte Markenseiten bestehen aus Inhaltsmodulen. Geben Sie für jeden Modultyp die Inhaltsbeschränkungen an, die Ihre Website erfordert. Unser Team verwendet diese zur Konfiguration von Template-Validierungsregeln. ### BILD-Module | Anforderung | Beschreibung | Ihr Wert | | --------------------------------- | ----------------------------------------------------------------- | -------- | | Min. Breite | Mindestbildbreite in Pixeln (z. B. 1920) | | | Min. Höhe | Mindestbildhöhe in Pixeln (z. B. 500) | | | Max. Dateigröße | Maximale Dateigröße in MB (z. B. 10). Muss kleiner als 4 MB sein. | | | Akzeptierte Formate | Akzeptierte Bildformate (z. B. jpg, png, gif, svg) | | | Max. Zeichen für Bildunterschrift | Maximale Zeichenanzahl für Bildunterschrift, falls zutreffend | | | `alt`Optionalität des Tags | Ob `alt` bei Bildern erforderlich ist. | | ### TEXT-Module | Anforderung | Beschreibung | Ihr Wert | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | Variante | „headline“, „tagline“, „body“ oder „lines“. Bestimmt den Stil, in dem der Text angezeigt wird. | | | Ausrichtung | „left“, „center“ oder „right“. Bestimmt die horizontale Ausrichtung des Textes. | | | „Lines“-Konfiguration |

Konfiguration für mehrzeiligen Text (wenn Variante = lines). Geben Sie für jede Textzeile Folgendes an:

- Name des Textfelds
- „required“ oder „allowed“?
- Ob dies ein Hyperlink zu einer anderen URL sein soll

| | | Max. Zeichen für Überschrift | Maximale Zeichenanzahl für Überschriftentext | | | Max. Zeichen für Beschreibung | Maximale Zeichenanzahl für Beschreibungstext | | | Max. Zeichen für Fließtext/Fußzeile | Maximale Zeichenanzahl für Fließtext oder Fußzeilentext | | | CTA-Schaltfläche | Erforderlich, optional oder nicht benötigt? | | | Max. Zeichen für CTA-Text | Maximale Zeichenanzahl für die Beschriftung der CTA-Schaltfläche | | ### PRODUCT\_GRID-Module | Anforderung | Beschreibung | Ihr Wert | | ----------------------------------------------------- | ----------------------------------------------------- | -------- | | Min. Produkte | Mindestanzahl der anzuzeigenden Produkte (z. B. 4) | | | Max. Produkte | Maximale Anzahl der anzuzeigenden Produkte (z. B. 12) | | | Abschnittstitel | Erforderlich oder optional? | | | Max. Zeichen für Abschnittstitel | Maximale Zeichenanzahl für Abschnittstitel | | | Abschnittsbeschreibung | Erforderlich oder optional? | | | Maximale Zeichenanzahl für die Abschnittsbeschreibung | Maximale Zeichenanzahl für die Abschnittsbeschreibung | | | CTA-Schaltfläche | Erforderlich, optional oder nicht benötigt? | | ### IMAGE\_GALLERY-Module Das Image Gallery-Modul erbt dieselben Konfigurationseigenschaften wie das IMAGE-Modul. Zuverlässig akzeptiert es außerdem die folgenden galeriespezifischen Eigenschaften: | Anforderung | Beschreibung | Ihr Wert | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | Mindestanzahl an Bildern | Mindestanzahl an Galeriebildern (z. B. 2) | | | Maximale Anzahl an Bildern | Maximale Anzahl an Galeriebildern (z. B. 4) | | | Abschnittstitel | Ob der Abschnittstiteltext erforderlich oder optional ist. | | | Abschnittsbeschreibung | Ob der Abschnittsbeschreibungstext erforderlich oder optional ist. | | | `alt` Optionalität des Tags | Ob `alt` bei Bildern erforderlich ist. | | | Optionalität des Call-to-Action | Ob die Call-to-Action-Schaltfläche oder der Link erforderlich, zulässig oder deaktiviert ist. | | | Zusätzliche Textzeilen |

Geben Sie für jeden zusätzlichen Text, der jedem Bild in der Bildgalerie zugeordnet werden soll, Folgendes an:

- Name des Textfelds
- „required“ oder „allowed“?
– ob der Text als Hyperlink zu einer anderen URL fungieren soll

| | ### SPLIT\_LAYOUT-Module Das Split Layout-Modul ermöglicht die Nebeneinander-Darstellung von zwei Modulen. Derzeit werden nur Text- und Bild-Module unterstützt. Zusätzlich zu den einzelnen Konfigurationseinstellungen für die Text- und Bild-Module (in den obigen Abschnitten beschrieben) sind die folgenden zusätzlichen Eigenschaften erforderlich: | Anforderung | Beschreibung | Ihr Wert | | ----------------- | ------------------------------------------- | -------- | | Layout-Verhältnis | Spaltenverhältnis (50:50, 33:67 oder 67:33) | | ## Identität und Datenschutz ### Zulässige Identifikatoren * Session ID – Anonymer Sitzungsidentifikator (nicht-PII) * Customer ID – Händler-Kundenidentifikator (nicht-PII, z. B. Loyalty-ID-Hash) {% hint style="danger" %} Übergeben Sie keine gehashten E-Mail-Adressen, Telefonnummern oder sonstige PII in Parametern oder URLs. {% endhint %} ### Datenschutzanforderungen Händler müssen: * Mess-Tracking in ihrer Datenschutzerklärung offenlegen * Opt-out-Links bereitstellen: * NAI: * DAA: ### DSGVO / Einwilligung Übergeben Sie das `regs`Objekt auf `POST /ads/v3/brand-pages`: * `regs.gdpr`: `1` wenn die Anfrage der DSGVO unterliegt (EU/EWR/UK-Behandlung gemäß Ihrer Richtlinie); `0`andernfalls. * `regs.consent`: Wenn `gdpr` is `1`, übergeben Sie den aktuellen TCF v2-Consent-String von Ihrer CMP (derselbe Wert, den Sie anderen Werbepartnern bereitstellen würden). Erfinden oder hardcodieren Sie keinen String – verwenden Sie das, wozu der Browser / die App des Nutzers eingewilligt hat. * `iabConsentString`: Dies erscheint in den Params jedes Tracker-Slots, nicht in `trackingTemplates`. Wenn `regs.consent` bereitgestellt wurde, ist der Wert der wörtliche TC-String und es ist keine weitere Aktion erforderlich. * Wenn `regs.consent` weggelassen wurde, ist der Wert das `{TCF}`Makro – ersetzen Sie den aktuellen TCF v2-String von Ihrer CMP zum Zeitpunkt des Aufrufs, bevor Sie eine Tracking-Anfrage senden. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/de/brand-pages/brand-page-retailer-integration-guide/tracking-attribution.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.