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

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.

<!-- 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ó.
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.