# HubSpot-kiegészítő hibaelhárítása

> Mit tegyél, ha a HubSpot-kiegészítő csatlakozás gombja nem jelenik meg, vagy a HubSpot nem kapja meg a követő sütit.

## A csatlakozás gomb nem jelenik meg

Előfordulhat, hogy az **Űrlapok → Beállítások → HubSpot** oldalon nem jelenik meg a csatlakozás gomb, és így nem tudod hitelesíteni a kiegészítőt.

### Ok

A HubSpot API hozzáférési tokenje nem tud megújulni. A HubSpot hozzáférési tokenjei csak 30 percig érvényesek, és új token kéréséhez frissítő tokenre (refresh token) van szükség. Ha a HubSpot a hozzáférési token mellé nem ad frissítő tokent, ami a HubSpot oldalán átmeneti hiba miatt előfordulhat, a kiegészítő elveszíti a hitelesítés automatikus megújításának képességét.

Ilyenkor a HubSpot-kiegészítő naplójában ez az üzenet jelenik meg:

```
GF_HubSpot::initialize_api(): API access token failed to be refreshed; Refresh token must be provided.
```

### Megoldás

A kapcsolat helyreállításához elő kell hívnod a csatlakozás gombot, és újra kell csatlakoztatnod a kiegészítőt, hogy új hozzáférési és frissítő tokent kapjon.

1. Nyisd meg a WordPress adminban az **Űrlapok → Beállítások → HubSpot** oldalt.
2. Fűzd az oldal URL-jének végére a `&gf_display_connect_button=1` szöveget, és nyomd meg az Entert.
3. Megjelenik a csatlakozás gomb. Kattints rá a kiegészítő újracsatlakoztatásához.

Az újracsatlakozás után a kiegészítő érvényes hozzáférési és frissítő tokent kap, és a működése helyreáll.

## A HubSpot követő süti hiánya

Ez a rész arra az esetre szól, amikor a HubSpot konzoljában ez az üzenet látszik: „The cookie needed to link form submissions to existing contacts isn't being sent. You'll need to ask your developer to update the integration for this form.” A süti hiányában a beküldések nem kapcsolódnak a HubSpot meglévő kapcsolataihoz.

### 1. Ellenőrizd, hogy a HubSpot-szkript be van-e építve

A HubSpot követőszkriptje állítja be a `hubspotutk` sütit, amely összekapcsolja a beküldéseket a meglévő kapcsolatokkal.

1. Nyisd meg a böngészőben az űrlapot tartalmazó oldalt, kattints jobb gombbal, és válaszd az **Oldal forrásának megtekintése** menüpontot (vagy használd a `Ctrl+U` / `Cmd+U` billentyűt).
2. Keresd a HubSpot szkriptet a lábléc magasságában vagy utána. Az alábbihoz hasonlónak kell lennie, de kissé eltérhet, ha sablon vagy bővítmény építette be. A `{your_portal_id_here}` helyére a HubSpot portál azonosítója kerül.

```html
<!-- Start of Async HubSpot Analytics Code -->
<script type="text/javascript">
  (function(d,s,i,r) {
    if (d.getElementById(i)){return;}
    var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
    n.id=i;n.src='//js.hs-analytics.net/analytics/'+(Math.ceil(new Date()/r)*r)+'/{your_portal_id_here}.js';
    e.parentNode.insertBefore(n, e);
  })(document,"script","hs-analytics",300000);
</script>
<!-- End of Async HubSpot Analytics Code -->
```

3. Ha a szkript hiányzik, ellenőrizd, hogy nem használtad-e a `gform_hubspot_output_tracking_script` szűrőt, mert ez megakadályozhatja a szkript kimenetét.

### 2. Nézd meg, be van-e állítva a `hubspotutk` süti

A sütinek az oldal kirajzolásakor be kell lennie állítva, különben az integráció nem működik.

1. Nyisd meg a böngésző fejlesztői eszközeit.
2. Menj az **Application** lapra (egyes böngészőkben **Storage**).
3. Keresd a `hubspotutk` sütit a Cookies › a te tartományod alatt.

Ha a süti hiányzik, a következő lépésekkel derítsd ki az okot.

### 3. Teszteld a beküldést a hálózati eszközökkel

Így győződhetsz meg arról, hogy a `hubspotutk` süti elmegy a beküldéssel.

1. Nyisd meg a böngésző fejlesztői eszközeit, és válaszd a **Network** lapot.
2. Küldd be az űrlapot.
3. Nézd meg a beküldési kérést a Network lapon.
4. A kérés Cookies lapján szerepelnie kell a `hubspotutk` sütinek.

Ha a süti hiányzik, vagy be sem lett állítva, vagy nem került a beküldésbe.

### 4. Kapcsold be a HubSpot-kiegészítő naplózását

1. Nyisd meg a WordPress adminban az **Űrlapok → Beállítások → Naplózás** oldalt.
2. Kapcsold be a naplózást a HubSpot-kiegészítőhöz.
3. Küldd be újra az űrlapot, és nézd át a naplókat.
4. Keresd a `hutk` kulcsot a küldött adat `context` tömbjében. Ebben a `hubspotutk` süti értékének kell lennie.

Ha a `hutk` érték hiányzik, a sütit nem állították be vagy nem adták át helyesen.

## Gyakori okok és megoldások

| Probléma | Megoldás |
|---|---|
| Gyorsítótárazás és optimalizálás. A gyorsítótár-bővítmények és szolgáltatások (például WP Rocket, W3 Total Cache) és külső szolgáltatások, például a Cloudflare Rocket Loader megakadályozhatják a HubSpot-szkript futását, így a süti nem áll be. | Az űrlapot tartalmazó oldalakat zárd ki a gyorsítótárazásból és a szkriptoptimalizálásból. Részletek: [gyorsítótár és szkriptoptimalizáló](https://hub.hellowp.io/hu/plugins/gravityforms/hogyan-gyorsitotar-es-szkript-optimalizalo/). |
| Süti-hozzájárulási funkciók. A sütihozzájárulást kezelő sablonok és bővítmények (például GDPR-eszközök) blokkolhatják a HubSpot-szkriptet. | Teszteld kikapcsolt hozzájárulási funkcióval. Ha ez megoldja, fordulj a funkciót tartalmazó sablon vagy bővítmény fejlesztőjéhez, hogy a hozzájárulás után elinduljon a szkript. |
| Böngésző sütibeállításai. Egyes böngészők (például Brave, Firefox) alapból blokkolják a sütiket, vagy a felhasználó blokkolásra állította őket. | Teszteld másik böngészőben vagy módosított sütibeállítással, és kapcsold ki a hirdetésblokkoló böngészőbővítményeket. |

## A HubSpot-szkript indítása beküldéskor

Ha a `hubspotutk` süti nem áll be, megpróbálhatsz egy JavaScript-részletet használni, amely az űrlap beküldésekor elindítja a HubSpot-szkriptet. Ez beállítja a sütit, mielőtt az űrlapadat a HubSpotba megy. A `gform_submission_pre_submission` szkript-hook dokumentációjában a HubSpot követés indítása részben találod a mintakódot.