Připojení obchodu

Obchod posílá Emailitu dva druhy dat: katalog a objednávky ze svého backendu přes API a to, co návštěvníci dělají na webu, přes měřicí skript sledování událostí. Pro úplný obraz použijte obojí: API je spolehlivý záznam objednávek a skript přidává zobrazení produktů, košíky a návštěvníky, kteří přicházejí z vašich e-mailů.

Než začnete

• API klíč pro volání z backendu. Produkty, objednávky a košíky může posílat API klíč s oprávněním Events Only, stejný klíč, který posílá události z vašeho backendu. Nemůže nic načítat, takže jeho odpovědi obsahují jen object, id a external_id. Pokud chcete data také načítat, spravovat kupony nebo měnit nastavení, použijte klíč s oprávněním Full Access.
• Pro měřicí skript oprávnění přidat skript na stránky vašeho obchodu.

Posílejte data z backendu

Produkty

Katalog pošlete endpointem Hromadné vytvoření nebo úprava produktů a znovu pokaždé, když se produkty změní. Každý produkt je identifikovaný ID produktu ve vašem obchodě, takže když ho pošlete znovu, aktualizuje se.

curl https://api.emailit.com/v2/products/batch \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "id": "1234",
      "title": "Trail Runner GTX",
      "url": "https://shop.example.com/products/trail-runner",
      "image_url": "https://shop.example.com/images/trail-runner.jpg",
      "price": 139,
      "compare_at_price": 169,
      "currency": "EUR",
      "categories": ["Shoes", "Running"],
      "inventory_quantity": 40
    }]
  }'

Feedy produktů v e-mailech vynechávají archivované produkty a produkty se skladovou zásobou 0, takže status a inventory_quantity udržujte aktuální.

Objednávky

Když zákazník vytvoří objednávku, pošlete ji endpointem Vytvoření nebo úprava objednávky:

curl https://api.emailit.com/v2/orders \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1001",
    "email": "jane@example.com",
    "currency": "EUR",
    "total": 125,
    "shipping": 5,
    "coupon_codes": ["WLC-8K2M4P"],
    "cart_id": "cart_789",
    "items": [{ "product_id": "1234", "title": "Trail Runner GTX", "quantity": 1, "price": 120 }]
  }'

• id je číslo objednávky ve vašem obchodě. Když pošlete stejné id znovu, objednávka se aktualizuje a nepřidá se další.
• Emailit připíše objednávku e-mailu, na který kupující naposledy klikl, nebo který naposledy otevřel. Viz Jak se objednávky připisují.
• Kupující se stane kontaktem, pokud jím ještě není. Pokud ho chcete také přihlásit k odběru, například když v pokladně zaškrtl políčko pro odběr newsletteru, přidejte "accepts_marketing": true a audience_id. "create_contact": false vytvoření kontaktu přeskočí. Příkaz purchase měřicího skriptu kontakt nikdy nevytvoří ani nepřihlásí k odběru.
• cart_id označí daný košík jako převedený na objednávku.

Když je objednávka zaplacená, vyřízená nebo zrušená, nebo když za ni vracíte peníze, pošlete změnu endpointem Úprava objednávky, nebo objednávku pošlete znovu s novým status. Zrušené objednávky se do tržeb nezapočítávají a vrácené peníze se odečítají.

Starší objednávky

Historii objednávek naimportujte endpointem Hromadný import objednávek, až 1 000 objednávek na jeden požadavek. Importy jsou ve výchozím stavu historické: doplní historii nákupů, metriky a doporučení, ale nepřipisují se e-mailům a nespouštějí automatizace.

Měřicí skript

Měřicí skript zaznamenává, co návštěvníci dělají na vašem webu: zobrazení produktů, košík, nákupy a návštěvy. Rozpozná také návštěvníky, kteří přicházejí z vašich e-mailů, takže jejich aktivita patří k jejich kontaktu.

Přidejte skript

1. Vytvořte klíč pro měření. Na stránce Email API›Events otevřete kartu Tracking a vyberte Create tracking key. Do pole Allowed origins zadejte domény svého obchodu, například shop.example.com nebo *.example.com. Pokud pole necháte prázdné, klíč přijme jakýkoli web.

2. Přidejte úryvek na každou stránku, před </head>. Karta Tracking ho zobrazuje s vyplněným klíčem:

   HTML

   <script>window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};</script>
   <script async src="https://js.emailit.com/track/TRACKING_KEY/events.js"></script>

   Klíče pro měření jsou veřejné: mohou jen odesílat události, nikdy číst data. Pokud už je na stránce skript formulářů Emailitu, ponechte oba.

Pokud chcete zaznamenávat i zobrazení stránky na každé stránce, přidejte do tagu skriptu data-autotrack="pages". Zobrazení stránek aktualizují, kdy byl kontakt naposledy aktivní na vašem webu, a jeho časové pásmo; jako události se neukládají.

Zaznamenávejte aktivitu v obchodě

Volejte tyto příkazy tam, kde k aktivitě dochází:

// Product page
emailit("product", { id: "1234", title: "Trail Runner GTX", url: location.href,
  image_url: "https://shop.example.com/images/trail-runner.jpg", price: 139, currency: "EUR",
  categories: ["Shoes", "Running"] });

// Every time the cart changes
emailit("cart", { id: "cart_789", currency: "EUR", checkout_url: "https://shop.example.com/checkout",
  items: [{ product_id: "1234", title: "Trail Runner GTX", quantity: 1, price: 139 }] });

// Order confirmation page
emailit("purchase", { id: "1001", total: 125, currency: "EUR",
  items: [{ product_id: "1234", quantity: 1, price: 120 }], coupon_codes: ["WLC-8K2M4P"] });

Identifikujte návštěvníky

Aktivita se započítá kontaktu, jakmile skript ví, kdo návštěvník je:

• Z odkazu v e-mailu. Když kontakt klikne v e-mailu z kampaně nebo automatizace na odkaz, který vede na váš web, odkaz nese podepsaný parametr _eit. Skript ho uloží a odstraní z adresního řádku. Odkazy ho dostanou, když je zapnuté měření prokliků a odkaz vede na povolenou doménu některého klíče pro měření, nebo u klíčů bez povolených domén na vaši odesílací doménu.

• Když se přihlásí nebo dokončí objednávku, zavolejte identify s jeho e-mailovou adresou nebo ID kontaktu:

  JavaScript

  emailit("identify", { email: "jane@example.com" });

• Když se odhlásí, zavolejte emailit("reset"), aby ho skript v tomto prohlížeči zapomněl.

Zobrazení produktů a košíky z doby před identifikací návštěvníka se přesunou ke kontaktu. Skript také zaznamená časové pásmo prohlížeče, které používá odesílání v místním čase příjemce, a kdy byl kontakt naposledy aktivní na vašem webu.

emailit("debug", true) vypisuje do konzole prohlížeče, co skript odesílá.

Kde se aktivita zobrazí

Aktivita v obchodě se ukládá do stejného logu událostí jako vaše ostatní události. Ze zobrazení produktů se stanou události product.viewed, z nových nebo změněných košíků cart.updated a z nákupů order.placed. Uvidíte je na stránce Email API›Events a v aktivitě kontaktu a webhooky je mohou odebírat. product.viewed a cart.updated nejsou součástí All events, takže je odebírejte podle názvu. Viz Události e-commerce.

Ověřte, že vše funguje

• Email Marketing›Commerce ukazuje vaše produkty a objednávky a karta Carts ukazuje košíky ze skriptu.
• Email API›Events vypisuje události product.viewed, cart.updated a order.placed, jak návštěvníci prohlížejí a nakupují.
• Otevřete kontakt, který objednal: panel Purchases ukazuje jeho objednávky, celkovou útratu a nedávno zobrazené produkty.
• Po kampani se objednávky, které jí byly připsány, zobrazují na její kartě Revenue.

Související