> 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/hu/brand-pages/brand-page-retailer-integration-guide/tracking-attribution.md). # Mérés és attribúció ## Hogyan állítható össze a nyomonkövetési URL A válasz három kombinálandó forrást biztosít: * Oldalszintű `trackers.impression`: például egy oldalmegjelenítés a következőt használja: `type: "impression"` és `params` beleértve a következőt: `ts` és `iabConsentString`. * Megosztott `trackingTemplates`: egy készletnyi `client`(relatív) és `server` (abszolút) URL-sablon, amely már tartalmazza a munkamenet és a elhelyezés lekérdezési paramétereit. * Csomópontonkénti `trackers.click` és/vagy `trackers.addToCart` egy modulon, soron vagy galériaelemen: `type`+ `params` az adott eseményre vonatkozóan (például: `modId`, `rurl`, `productCode`). ### Melyik sablon? Hassználja a csomópont `tracking.type` értékét a kikereséshez: `trackingTypes.`. Ez határozza meg az érvényes `client.*` és `server.*` kulcsokat az adott interakcióhoz (például hivatkozás esetén: `client.clickRedirect`, `client.clickEvent`, `server.clickEvent)`. ### Kliens vs Szerver * Kliens (`trackingTemplates.client.*`): Az értékek relatív útvonalak (beleértve a lekérdezési karaktersorozatokat is). Illessze elé a fordított proxy alapértelmezett URL-jét (`BASEURL`). * Szerver (`trackingTemplates.server.`): Az értékek abszolút URL-sablonok a következőkön: Epsilon nyomonkövetési gazdagép. Állítsa össze a végleges URL-t ugyanúgy, mint a C2S esetében: sablon + `"&"` + `queryString(trackers.params)`. {% hint style="info" %} Ne módosítsa a sablon gazdagépét vagy útvonalát, és ne küldjön S2S-hívásokat a fordított proxyn keresztül. {% endhint %} ### Kidolgozott példák (pszeudokód) #### C2S-kattintás egy HERO CTA esetében ``` url = BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) ``` #### S2S oldalmegjelenítés ``` url = trackingTemplates.server.impressionEvent + "&" + queryString(trackers.impression.params) ``` #### S2S kosárba helyezés egy terméksor esetében ``` url = trackingTemplates.server.addToCartEvent + "&" + queryString(trackers.addToCart.params) ``` Makróhelyettesítés * Cserélje ki a {TS} értéket a jelenlegi ezredmásodperc-időbélyegzőre, a {RURL} értéket az URL-kódolt célállomásra, és a következőt: `{TCF}` a CMP-ből származó jelenlegi TCF v2 karaktersorozattal a betöltés előtt. * A kosárba helyezésnél a {QTY} értéket is cserélje ki az adott SKU abszolút mennyiségére a kosárban a betöltés időpontjában (nem a változásra), a {CONVERSION\_VALUE} értéket pedig ezen elemek abszolút pénzbeli értékére (mennyiség × egységár, mínusz az alkalmazott kedvezmények). {% hint style="info" %} * Csak a következők `trackingTemplates.client.impressionPixelUrls` valódi pixelek (1×1 GIF-ek). * `clickRedirect` egy 302 átirányítási végpont. * `clickEvent` és `addToCartEvent` olyan eseményjelzők, amelyek 204 No Content választ adnak vissza. {% endhint %} {% hint style="danger" %} Ne indítson C2S és S2S hívást is ugyanarra a logikai eseményre (például ne küldjön C2S-kattintási eseményt és S2S-kattintási értesítést is ugyanarra a kattintásra). {% endhint %} ## Nyomon követés – Kliens–Szerver (C2S) A C2S nyomon követés a böngészőben történik összetett URL-ek használatával. Illessze elé a következőt: `BASEURL` az útvonalakhoz itt: `trackingTemplates.client` és fűzze hozzá a megfelelő következőt: `trackers.params` (lásd: [Hogyan állítható össze a nyomonkövetési URL](#how-to-compose-a-tracking-url)). Csak a következők `client.impressionPixelUrls` pixelek (1×1 GIF). A többi klienssablon nem pixel: * `client.clickRedirect`: 302 átirányítási végpont. Epsilon rögzíti a kattintást, és átirányítja a böngészőt a dekódolt rurl-re. Használja ezt böngészőnavigációs célként. * `client.clickEvent`: **Eseményjelző** 204 No Content választ ad vissza). Indítsa a következők használatával: `navigator.sendBeacon` or `fetch({ keepalive: true })`. Ne jelenítse meg a következőként: ``. * `client.addToCartEvent`: **Eseményjelző** (204-es választ ad vissza). Ugyanazt az indítási mintát használja, mint a következők: `clickEvent`. ### Megvalósítási lépések 1. Jelenítse meg az API által visszaadott márkaszelep-tartalmat. 2. A megjelenítés után indítsa el a megjelenítési pixeleket a böngészőben (minden bejegyzést itt: `trackingTemplates.client.impressionPixelUrls`, 1×1 képekként). 3. Amikor a felhasználó egy nyomon követhető csomópontra kattint, tegye a következők egyikét:\ (a) irányítsa át az összeállított következőkön keresztül: `client.clickRedirect` URL, vagy\ (b) indítsa el az összeállított következőt: `client.clickEvent` URL-t eseményjelzőként, és navigáljon a célállomásra önállóan.\ Kattintásonként az egyiket vagy a másikat használja, ne mindkettőt. ### Megjelenési pixel A márkagoldal megjelenítése után hívjon meg minden útvonalat itt: `trackingTemplates.client.impressionPixelUrls` 1×1-es képként, (lásd[ Hogyan állítható össze a nyomonkövetési URL](#how-to-compose-a-tracking-url)). ```html ``` Lépések: 1. Minden egyes karakterlánchoz itt: `trackingTemplates.client.impressionPixelUrls`, szúrja be elé a következőt: `BASEURL` (például: `https://www.retailer.com/epsilon`). 2. Fűzze hozzá a következőt: `&` + `queryString(trackers.impression.params)`, helyettesítve a következőt: `{TS}` a jelenlegi ezredmásodperces időbélyegzővel, és a következőt: `{TCF}` a CMP-ből származó jelenlegi hozzájárulási karakterlánccal. 3. Hívja meg 1×1-es `< img src="...">` képként a böngészőben (vagy azzal egyenértékű módon). ### Kattintáskövetés #### A lehetőség: Kattintási átirányítás (`client.clickRedirect`) Navigálja a felhasználót a összeállított URL-en keresztül. Epsilon naplózza a kattintást, és **HTTP 302** válasszal válaszol a dekódolt `rurl`részére. Ez a végpont **csak GET**, és `rurl` kötelező; #### B lehetőség: Kattintási esemény adatküldése (`client.clickEvent`) Hívja meg adatküldésként (beacon), és navigáljon önállóan. GET vagy POST kéréseket fogad el, és 204 No Content értéket ad vissza. Nem kép; ne jelenítse meg mint``. ### Kosárba helyezés (C2S) Hívja meg a következőt: `trackingTemplates.client.addToCartEvent` esemény-adatküldésként (nem pixelként), amikor a felhasználó egy terméket a kosárba helyez. GET vagy POST kéréseket fogad el, és 204 No Content értéket ad vissza. {% hint style="info" %} Ne kombinálja a C2S és S2S kosárba helyezést ugyanahhoz a kosárművelethez. {% endhint %} ## Követés – Szerverek közötti (S2S) Az S2S követés a háttérrendszeren van megvalósítva. Állítsa össze az URL-eket ugyanúgy, mint a C2S esetében: kezdje a megfelelő `trackingTemplates.server` karakterlánccal, majd fűzze hozzá a következőt: `trackers.params`. A szerversablonok már abszolútak — nincs szükség `BASEURL`előttük történő beszúrására. (lásd [Hogyan állítható össze a nyomonkövetési URL](#how-to-compose-a-tracking-url)). {% hint style="info" %} Ne változtassa meg a gazdagépet vagy az útvonalat a szerversablonhoz képest, és ne küldjön S2S kéréseket a fordított proxyn keresztül. {% endhint %} ### Mikor kell S2S követést használni * Az Ön architektúrája szerveroldali eseményhívást igényel. * Olyan környezetekben van szüksége követésre, ahol a kliensoldali pixelek nem megbízhatóak. * Stratégiákat szeretne kombinálni - pl. C2S megtekintések + S2S kosárba helyezés. Ez támogatott, de soha ne hívja meg mind a C2S-t, mind az S2S-t ugyanahhoz az eseményhez. ### S2S megtekintési értesítés A márkagoldal megjelenítése után a szervere egy **GET** vagy **POST** kérést küld az összeállított megtekintési URL-re: `trackingTemplates.server.impressionEvent` + `trackers.impression.params` (helyettesítse a következőt: `{TS}` és `{TCF}` a küldés előtt). ### S2S kattintási értesítés Állítsa össze: `trackingTemplates.server.clickEvent` + `trackers.click.params` (helyettesítse a következőt: `{TS}`, {RURL}, és `{TCF}`), majd küldjön GET vagy POST kérést. ### S2S kosárba helyezési értesítés Állítsa össze: `trackingTemplates.server.addToCartEvent` + `trackers.addToCart.params` (helyettesítse a következőt: `{TS}`, {QTY}, {CONVERSION\_VALUE}, és `{TCF}`), majd küldjön GET vagy POST kérést. ### S2S paraméterek | Paraméter | Forrás | Megjegyzések | | ----------------------------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `catalogId`, `sessionId`, `customerId`, `dtmId`, `placementId`, `lsid`, `utcOffset` | `trackingTemplates` lekérdezési karakterláncok | Őrizze meg ezeket az értékeket változatlanul a kérés meghívásakor. Ne távolítsa el és ne módosítsa őket. | | `modId` | `trackers..params` | Tartalommodul vagy sorazonosító. | | `ts` | `trackers..params` | Cserélje ki a következőt: `{TS}` a jelenlegi időbélyegzőre ezredmásodpercben a kérés meghívása előtt. | | `iabConsentString` | `trackers..params` | Cserélje ki a következőt: `{TCF}` a CMP-ből származó jelenlegi TCF v2 hozzájárulási karakterlánccal a kérés meghívása előtt. Ha már meg van adva egy érték, használja azt változatlanul. | | `rurl` | `trackers..params` | URL-kódolt átirányítási cél. Cserélje ki a következőt: `{RURL}` amikor jelen van. | | `productCode`, `sellerId` | `trackers..params` | Termékcsomópontokból származtatott értékek. | | `qty` | `trackers.addToCart.params` | Cserélje ki a következőt: `{QTY}` a SKU abszolút mennyiségével a kosárban a kérés meghívásának időpontjában. Ne a mennyiségi változást (delta) használja. | | `conVal` | `trackers.addToCart.params` | Cserélje ki a következőt: `{CONVERSION_VALUE}` a tételek teljes pénzbeli értékével (mennyiség × egységár, csökkentve az esetleges kedvezményekkel). | ## Makró-referencia | Szimbólum | Leírás | Itt található: | Helyettesítse a következővel: | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | `BASEURL` (az Ön előtagja) | Az Ön webhelyének alapértelmezett URL-címe protokollal és proxy-útvonallal – fűzze mindegyik elejére `trackingTemplates.client.*` útvonal. | C2S mérés | `https://www.retailer.com/epsilon` | | `{TS}` | Cache-busting időbélyeg (milliszekundumban) | `trackers..params` | `1737485823910` | | `{RURL}` | URL-en kódolt átirányítási cél | `trackers..params.rurl` | `https%3A%2F%2Fwww.retailer.com%2Fprodukt%2F9221200653341` | | `{TCF}` | IAB TCF v2 beleegyezési karaktersor helyőrzője. Jelen van, ha `regs.consent` ki lett hagyva a kérésből. | `trackers..params.iabConsentString` | Jelenlegi TC karaktersor az Ön CMP-jéből, pl. a következőkön keresztül: `__tcfapi` `getTCData` → `tcString` | | `{QTY}` | A SKU abszolút mennyisége a kosárban a beküldés időpontjában (nem változás; pl. ha a vásárlónak 1 volt, és hozzáad egy másikat, küldje a következőt: `2`). | `trackers.addToCart.params.qty` | `2` | | `{CONVERSION_VALUE}` | Ezen tételek abszolút pénzbeli értéke: mennyiség × egységár, mínusz a alkalmazott kedvezmények. | `trackers.addToCart.params.conVal` | `49.99` | | `{RURL_KID}` | Átirányítás-aláíró kulcsazonosító. Jelen van a következőben: `trackers.click.redirectParams` amikor a platform átirányítás-aláírása engedélyezve van. | `trackers.click.redirectParams.rurlKid` | A batch sign végpont által visszaadott aláírókulcs-azonosító | | `{RURL_SIG}` | Átirányítás-aláírási aláírás. Jelen van a következőben: `trackers.click.redirectParams` amikor a platform átirányítás-aláírása engedélyezve van. | `trackers.click.redirectParams.rurlSig` | A batch sign végpont által visszaadott Ed25519 aláírás (base64url) | ### URL-kódolási referencia Kódoláskor `{RURL}`, használjon standard százalékos kódolást: | Karakter | Kódolás mint | | -------- | ------------ | | `:` | `%3A` | | `/` | `%2F` | | `?` | `%3F` | | `=` | `%3D` | | `&` | `%26` | ### redirectParams és Átirányítás-aláírás Ha a platform átirányítás-aláírása engedélyezve van, `trackers.click` tartalmazhat egy `redirectParams`objektumot a következő mellett: `params`. A kulcsok a következőkben: `7`csak a következőbe kerülnek összefűzésre: `client.clickRedirect` URL-ek — a következőbe nem: `clickEvent`vagy bármilyen szerver URL-be. Két eset: **Beágyazott hivatkozási célok** (URL beégetve a következőbe: `params.rurl`): a platform kiszolgálási időben aláírja az átirányítást, és szó szerinti `rurlKid`és `rurlSig`értékeket ad ki a következőben: `redirectParams`. Ezeket változatlanul fűzze hozzá a következőhöz: `clickRedirect` URL. **Kereskedő által vezérelt átirányítások** (`params.rurl` értéke {RURL}): `redirectParams` tartalmazza a {RURL\_KID} és {RURL\_SIG} makrókat. Hívja meg a batch sign végpontot (`redirectSigning.url` a válaszból) a cél URL kulcsazonosítójának és aláírásának megszerzéséhez, majd helyettesítse a hozzáfűzés előtt. A legfelső szintű `redirectSigning`objektum, ha jelen van, biztosítja a köteg `POST /ads/v3/redirect/sign` végpont URL-jét és a következőt: `maxUrls`köteghatár. Lépjen kapcsolatba a következőkkel: Epsilon annak megerősítéséhez, hogy az átirányítás-aláírás engedélyezve van-e az Ön integrációjához. ### clickRedirect összetétel a következővel: redirectParams: ``` BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) + "&" + queryString(trackers.click.redirectParams) ```
## Stílusútmutató Mielőtt engedélyezné a Márkaoldalakat a webhelyén, rögzítenünk kell webhelye vizuális identitását. Töltse ki az alábbi táblázatot a tervezési értékeivel. Csapatunk ezt fogja használni a márkaoldal előnézeti élményének konfigurálásához. #### Logó | Mező | Leírás | Az Ön értéke | | ------------- | ------------------------------------------- | ------------ | | Logó URL-címe | A webhely logójának URL-címe (SVG vagy PNG) | | #### Színek | Mező | Leírás | Az Ön értéke | | --------------------------- | --------------------------------------------------- | ------------ | | Elsődleges szín | Fő márkaszín (hex) | | | Háttérszín | Oldal háttérszíne (hex) | | | Felületi szín | Kártya/szekció háttérszíne (hex) | | | Elsődleges szövegszín | Fő szövegszín (hex) | | | Másodlagos szövegszín | Kompakt/halványított szövegszín (hex) | | | Szöveg az elsődleges színen | Elsődleges színű háttéren használt szövegszín (hex) | | | Keretszín | Alapértelmezett keretszín (hex) | | #### Tipográfia | Mező | Leírás | Az Ön értéke | | ------------------------- | ---------------------------------------------------------------- | ------------ | | Címsor betűcsaládja | A címsorokhoz használt betűtípus (pl. "Google Sans, sans-serif") | | | Törzsszöveg betűcsaládja | A törzsszöveghez használt betűtípus (pl. "Roboto, sans-serif") | | | Alapértelmezett betűméret | Alapértelmezett törzsszöveg betűméret (pl. 16px) | | #### Gombok | Mező | Leírás | Az Ön értéke | | -------------------------------------- | ----------------------------------------------------------------- | ------------ | | Elsődleges gomb háttérszíne | Elsődleges gombok háttérszíne | | | Elsődleges gomb szövegszíne | Elsődleges gombok szövegszíne | | | Elsődleges gomb sarkainak lekerekítése | Sarkok lekerekítése (pl. 8px) | | | Másodlagos gomb stílusa | A másodlagos gomb megjelenésének leírása (körvonalas, ghost stb.) | | ## Modultartalomra vonatkozó követelmények A márkagoldalak tartalommodulokból állnak. Adja meg az Ön webhelye által megkövetelt tartalmi megkötéseket az egyes modultípusokhoz. Csapatunk ezek alapján állítja be a sablonérvényesítési szabályokat. ### IMAGE modulok | Követelmény | Leírás | Az Ön értéke | | ---------------------------------- | --------------------------------------------------------------------- | ------------ | | Minimális szélesség | Kép minimális szélessége képpontban (pl. 1920) | | | Minimális magasság | Kép minimális magassága képpontban (pl. 500) | | | Maximális fájlméret | Maximális fájlméret MB-ban (pl. 10). Kisebbnek kell lennie, mint 4MB. | | | Elfogadott formátumok | Elfogadott képformátumok (pl. jpg, png, gif, svg) | | | Képaláírás maximális karakterszáma | Képaláírás maximális karakterszáma, ha alkalmazható | | | `alt`címke opcionálissága | Hogy a(z) `alt` kötelező-e a képeken. | | ### TEXT modulok | Követelmény | Leírás | Az Ön értéke | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | Variáns | “headline”, “tagline”, “body” vagy “lines”. Meghatározza a szöveg megjelenítési stílusát. | | | Igazítás | “left”, “center” vagy “right”. Meghatározza a szöveg vízszintes igazítását. | | | “Lines” konfiguráció |

Többsoros szöveg konfigurációja (ha a variant = lines). A szöveg minden egyes sorához adja meg a következőket:

- a szövegmező neve
- “required” vagy “allowed”?
- egy másik URL-re mutató hivatkozásnak készült-e

| | | Címsor maximális karakterszáma | Címsorszöveg maximális karakterszáma | | | Leírás maximális karakterszáma | Leíró szöveg maximális karakterszáma | | | Törzsszöveg/Lábléc maximális karakterszáma | Törzsszöveg vagy láblécszöveg maximális karakterszáma | | | CTA gomb | Kötelező, opcionális vagy nem szükséges? | | | CTA szöveg maximális karakterszáma | CTA gomb feliratának maximális karakterszáma | | ### PRODUCT\_GRID modulok | Követelmény | Leírás | Az Ön értéke | | ------------------------------------------ | ------------------------------------------------ | ------------ | | Minimális termékszám | Megjelenítendő termékek minimális száma (pl. 4) | | | Maximális termékszám | Megjelenítendő termékek maximális száma (pl. 12) | | | Szakasz címe | Kötelező vagy opcionális? | | | Szakasz címének maximális karakterszáma | Szakaszcím maximális karakterszáma | | | Szakasz leírása | Kötelező vagy opcionális? | | | Szakasz leírásának maximális karakterszáma | Szakasz leírásának maximális karakterszáma | | | CTA gomb | Kötelező, opcionális vagy nem szükséges? | | ### IMAGE\_GALLERY modulok Az Image Gallery modul ugyanazokat a konfigurációs tulajdonságokat örökli, mint az IMAGE modul. Ezenkívül a következő galériaspecifikus tulajdonságokat is elfogadja: | Követelmény | Leírás | Az Ön értéke | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | Minimális képszám | Galériaképek minimális száma (pl. 2) | | | Maximális képszám | Galériaképek maximális száma (pl. 4) | | | Szakasz címe | A szakaszcím szövege kötelező vagy opcionális-e. | | | Szakasz leírása | A szakasz leírásának szövege kötelező vagy opcionális-e. | | | `alt` címke opcionálissága | Hogy a(z) `alt` kötelező-e a képeken. | | | Cselekvésre ösztönzés (CTA) opcionálissága | A cselekvésre ösztönző gomb vagy hivatkozás kötelező, engedélyezett vagy letiltott-e. | | | További szövegsorok |

A képgaléria egyes képeihez társítandó minden további szöveghez adja meg a következőket:

- a szövegmező neve
- “required” vagy “allowed”?
– a szövegnek hiperhivatkozásként kell-e működnie egy másik URL-re

| | ### SPLIT\_LAYOUT modulok A Split Layout modul lehetővé teszi két modul egymás melletti megjelenítését. Jelenleg csak a Text és Image modulok támogatottak. A Text és Image modulok egyedi konfigurációs beállításain kívül (amelyeket a fenti szakaszok ismertetnek) a következő további tulajdonságok szükségesek: | Követelmény | Leírás | Az Ön értéke | | ----------------- | ------------------------------------- | ------------ | | Elrendezési arány | Oszloparány (50:50, 33:67 vagy 67:33) | | ## Azonosítás és adatvédelem ### Elfogadható azonosítók * Session ID – anonim munkamenet-azonosító (nem PII) * Customer ID – kereskedelmi ügyfél-azonosító (nem PII, pl. törzsvásárlói azonosító hash-e) {% hint style="danger" %} Ne adjon át hash-elt e-mail-címeket, telefonszámokat vagy bármilyen PII-t egyetlen paraméterben vagy URL-ben sem. {% endhint %} ### Adatvédelmi követelmények A kereskedőknek kötelességük: * Mérési nyomon követést közzétenni az adatvédelmi szabályzatukban * Opt-out hivatkozásokat biztosítani: * NAI: * DAA: ### GDPR / Hozzájárulás Adja át a(z) `regs`objektumot itt: `POST /ads/v3/brand-pages`: * `regs.gdpr`: `1` amikor a kérésre a GDPR vonatkozik (EU/EGT/UK kezelés a szabályzata szerint); `0`ellenkező esetben. * `regs.consent`: Amikor `gdpr` is `1`, adja át a CMP-jéből származó aktuális TCF v2 hozzájárulási karakterláncot (ugyanazt az értéket, amelyet más hirdetési partnerek felé megjelenítene). Ne találjon ki és ne kódoljon be manuálisan karakterláncot — használja azt, amihez a felhasználó böngészője / alkalmazása hozzájárult. * `iabConsentString`: Ez minden követőhely paramétereiben megjelenik, nem itt: `trackingTemplates`. Amikor `regs.consent` megadásra került, az érték a szó szerinti TC-karakterlánc, és nincs szükség további műveletre. * Amikor `regs.consent` hiányzott, az érték a(z) `{TCF}`makró — cserélje ki a CMP-jéből származó aktuális TCF v2 karakterláncra a beváltáskor, mielőtt bármilyen követési kérést elküldene. --- # 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/hu/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.