Webáruház-integráció

Szerveroldali követés BigCommerce-hez

Adj a ROASaurusnak egy csak olvasható, webáruházszintű API-fiókot, és nyomd meg a Create webhook gombot. A kifizetett BigCommerce-rendelések ezután érkezésükkor a szerverről jutnak el a hirdetési platformokhoz.

A BigCommerce dióhéjban
A rendelések így érkeznekWebhookok (rendelés létrehozva, státusz frissítve) plusz lekérdezés 5 percenként
Webhook beállításaAutomatikus, a Create webhook gombbal
Hozzáférési adatokStore hash és egy hozzáférési token Orders: read-only jogosultsággal
Kifizetett rendelésekAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Köszönőoldali kódrészletScript az Order confirmation oldalon a {{checkout.order.id}} használatával

Hogyan csatlakozik a BigCommerce

  1. Storefront › Script Manager › Create a Script: location Footer, pages All pages, type Script, a ROASaurus scripttaggel.
  2. Hozz létre egy második scriptet az Order confirmation oldalhoz a köszönőoldali kódrészlettel.
  3. Settings › API › Store-level API accounts › Create API account Orders: read-only jogosultsággal. Add meg a ROASaurusban a store hash-t (az API-útvonalad /stores/ utáni részét) és a hozzáférési tokent.
  4. Mentsd, majd nyomd meg a Create webhook gombot.

Mit csinál a Create webhook

A ROASaurus két BigCommerce-webhookot regisztrál: egyet a rendelés létrehozására, egyet a rendelésstátusz frissítésére. Minden kézbesítés a webáruházadra egyedi titkos fejlécet hordoz, amelyet a ROASaurus ellenőriz. A webhook csak azt mondja meg, melyik rendelés változott, ezért a ROASaurus az API-ból lekéri a rendelést és a termékeit. A megváltozott rendeléseket 5 percenként is ellenőrzi, arra az esetre, ha egy kézbesítés elveszne.

Mely rendelések számítanak

Azok a rendelések, amelyek státusza azt jelzi, hogy a fizetés megtörtént: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped és Completed. A függőben lévő vagy elutasított rendeléseket nem küldi el. A ROASaurus kiolvassa az adót tartalmazó végösszeget, a számlázási e-mail-címet, telefonszámot, nevet és címet, az ügyfélazonosítót, az IP-címet, valamint minden terméket az adót tartalmazó árával.

A rendelések összekötése a hirdetési kattintásokkal

A rendelés-visszaigazolási oldal kódrészlete a {{checkout.order.id}} azonosítóval küldi el a ROASaurus vásárlást, ami a rendelést összeköti a látogatóval. Nélküle a ROASaurus megpróbál egy olyan e-mail-címet, amelyet a látogató korábban megadott az oldaladon, például egy felugró ablakban, majd a rendelés IP-címét, de csak akkor, ha a rendelés előtt 3 órától a rendelés után 15 percig pontosan egy látogatót láttak azon az IP-címen.

Korlátok

  • A BigCommerce-rendelések nem adnak a ROASaurusnak user agentet, ezért megosztott IP-címeken (irodák, mobilhálózatok) az IP-alapú tartalék gyakran nem tud dönteni. A kódrészlet ezt elkerüli.
  • A csatlakozó a platform hivatalos API-dokumentációja alapján készült. A hitelesítő adatok mentése után nyomd meg a Test connection gombot, majd adj le egy tesztrendelést, és nézd meg az Event logot.

Kapcsolódó

GYIK

Kérdések, válaszok

Milyen API-hozzáférés kell a ROASaurusnak?

Egy webáruházszintű API-fiók, az Orders jogosultság csak olvashatóra állítva. A ROASaurus ezzel olvassa a rendeléseket, és ezzel hozza létre a két rendelés-webhookját.

Mi van, ha egy webhook meghiúsul?

A ROASaurus 5 percenként, 30 perces átfedéssel a BigCommerce-et is lekérdezi. A már meglévő rendeléseket figyelmen kívül hagyja, így semmi sem megy el kétszer.

Mely BigCommerce-státuszok számítanak kifizetettnek?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped és Completed. A többi státuszt kihagyja, amíg a rendelés át nem kerül ezek egyikébe.

Minden eladás visszavezetve arra a hirdetésre, amelyik hozta

Szerveroldali követés, profit és ügyfél-élettartamérték egyetlen appban. 14 napos ingyenes próbaidőszak, bankkártya nélkül.

Indítsd el az ingyenes próbaidőszakot →