Küldj egyéni metaadatokat a hibajelentésekkel

Updated May 22, 2026

A Yaplet automatikusan rögzíti a böngésző- és eszközmetaadatokat minden hibajelentéssel. De a leghasznosabb hibakeresési kontextus gyakran az alkalmazásodra specifikus: melyik felhasználó volt bejelentkezve, milyen csomagban van, milyen A/B-kísérletben volt, hogyan nézett ki a kosara. Ezek az adatok nem léteznek a DOM-ban — saját magadnak kell beküldened az SDK-n keresztül.

Csatolj kulcs-érték párokat

Használd a Yaplet.attachCustomData() metódust egy objektum beolvasztásához az egyéni adatokba, amelyek minden hibajelentéssel és tickettel elküldésre kerülnek ettől a látogatótól:

Yaplet.attachCustomData({
  userId: "u_abc123",
  plan: "pro",
  experiment: "checkout-v2",
  cartValue: 149.99
});

Hívd ezt meg a Yaplet.initialize() után és minden releváns állapotváltozáskor (például miután egy felhasználó bejelentkezik vagy frissíti a csomagját).

Egyetlen érték beállítása vagy frissítése

Yaplet.setCustomData("cartValue", 149.99);
Yaplet.setCustomData("lastVisitedPage", "/dashboard/billing");

Egy adott kulcs eltávolítása

Yaplet.removeCustomData("experiment");

Minden egyéni adat törlése

Hívd ezt kijelentkezéskor, hogy elkerüld az előző felhasználó adatainak elküldését a következő felhasználó jelentéseivel:

Yaplet.clearCustomData();

Ticket-specifikus attribútumok beállítása

A Yaplet.setTicketAttribute() hasonló, de az értéket ticket-attribútumként jelöli meg az egyéni adatok helyett — hasznos strukturált mezőkre, amelyektől a support-munkafolyamatod függ:

Yaplet.setTicketAttribute("orderId", "ORD-78234");
Yaplet.setTicketAttribute("region", "eu-west-1");

Csendes összeomlásjelentés küldése programatikusan

Az error boundary által elkapott JavaScript-kivételekre felhasználói beavatkozás nélkül küldhetsz jelentést:

try {
  // kockázatos művelet
} catch (err) {
  Yaplet.sendSilentCrashReport(err.message, "HIGH", {
    screenshot: false,
    replays: false
  });
}

A harmadik excludeData paraméter lehetővé teszi egyes rögzítési típusok kihagyását — hasznos, ha az összeomlás kontextusa teljesen szerveroldali, és egy képernyőkép nem adna hozzá értéket. A prioritás lehet "LOW", "MEDIUM" vagy "HIGH". A csendes jelentések sebessége másodpercenként legfeljebb egyire van korlátozva.

Hol jelennek meg az egyéni adatok

A táblán lévő hibajelentés ticketjében az egyéni adatok szakasz listázza az összes csatolt kulcs-érték párt. A ticket részletei panelén a képernyőkép, a konzolnaplók és az eszközmetaadatok mellett szerepel.

Did this article answer your question?