Shop verbinden

Ein Shop sendet Emailit zwei Arten von Daten: den Katalog und die Bestellungen aus seinem Backend, per API, und das, was Besucher auf der Website tun, mit dem Tracking-Skript von Event-Tracking. Nutzen Sie beides für das vollständige Bild: Die API ist die verlässliche Quelle für Bestellungen, und das Skript ergänzt Produktaufrufe, Warenkörbe und Besucher, die über Ihre E-Mails kommen.

Voraussetzungen

• Ein API-Schlüssel für die Aufrufe aus dem Backend. Ein Schlüssel mit dem Scope Events Only kann Produkte, Bestellungen und Warenkörbe senden – derselbe Schlüssel, der Events aus Ihrem Backend sendet. Er kann nichts zurücklesen, daher enthalten seine Antworten nur object, id und external_id. Verwenden Sie einen Schlüssel mit Full Access, um auch Daten zu lesen, Gutscheine zu verwalten oder Einstellungen zu ändern.
• Für das Tracking-Skript die Berechtigung, den Seiten Ihres Shops ein Skript hinzuzufügen.

Daten aus Ihrem Backend senden

Produkte

Senden Sie Ihren Katalog mit Produkte gesammelt erstellen oder aktualisieren und erneut, sobald sich Produkte ändern. Jedes Produkt wird über die Produkt-ID Ihres Shops identifiziert, ein erneutes Senden aktualisiert es also.

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
    }]
  }'

Produkt-Feeds in E-Mails lassen archivierte Produkte und Produkte mit einem Lagerbestand von 0 aus, halten Sie status und inventory_quantity daher aktuell.

Bestellungen

Wenn eine Bestellung aufgegeben wird, senden Sie sie mit Bestellung erstellen oder aktualisieren:

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 ist die Bestellnummer Ihres Shops. Wenn Sie dieselbe id erneut senden, wird die Bestellung aktualisiert, statt eine weitere hinzuzufügen.
• Emailit ordnet die Bestellung der E-Mail zu, die der Käufer zuletzt geklickt oder geöffnet hat. Siehe Wie Bestellungen zugeordnet werden.
• Der Käufer wird zum Kontakt, falls er noch keiner ist. Fügen Sie "accepts_marketing": true und eine audience_id hinzu, um ihn auch anzumelden, zum Beispiel wenn er beim Checkout ein Newsletter-Kästchen angekreuzt hat. "create_contact": false überspringt das Erstellen eines Kontakts. Der Befehl purchase des Tracking-Skripts erstellt nie einen Kontakt und meldet nie einen an.
• cart_id markiert diesen Warenkorb als konvertiert.

Wenn die Bestellung bezahlt, versandt, storniert oder erstattet wird, senden Sie die Änderung mit Bestellung aktualisieren oder senden Sie die Bestellung mit ihrem neuen status erneut. Stornierte Bestellungen zählen nicht zum Umsatz, und Rückerstattungen werden abgezogen.

Frühere Bestellungen

Importieren Sie Ihre Bestellhistorie mit Bestellungen gesammelt importieren, bis zu 1.000 Bestellungen pro Anfrage. Importe sind standardmäßig historisch: Sie füllen Kaufhistorie, Kennzahlen und Empfehlungen, werden aber keinen E-Mails zugeordnet und starten keine Automatisierungen.

Das Tracking-Skript

Das Tracking-Skript erfasst, was Besucher auf Ihrer Website tun: Produktaufrufe, den Warenkorb, Käufe und Besuche. Außerdem erkennt es Besucher, die über Ihre E-Mails kommen, sodass ihre Aktivität zu ihrem Kontakt gehört.

Skript hinzufügen

1. Tracking-Schlüssel erstellen. Öffnen Sie Email API›Events, wechseln Sie zum Tab Tracking und wählen Sie Create tracking key. Tragen Sie unter Allowed origins die Domains Ihres Shops ein, zum Beispiel shop.example.com oder *.example.com. Lassen Sie das Feld leer, um jede Website zu akzeptieren.

2. Snippet auf jeder Seite einfügen, vor </head>. Der Tab Tracking zeigt es mit Ihrem bereits eingetragenen Schlüssel:

   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>

   Tracking-Schlüssel sind öffentlich: Sie können nur Events senden, nie Daten lesen. Wenn das Skript der Emailit-Formulare bereits auf der Seite ist, behalten Sie beide.

Um zusätzlich auf jeder Seite einen Seitenaufruf zu erfassen, fügen Sie dem Script-Tag data-autotrack="pages" hinzu. Seitenaufrufe aktualisieren, wann der Kontakt zuletzt auf Ihrer Website aktiv war, und seine Zeitzone; als Events werden sie nicht gespeichert.

Shop-Aktivität erfassen

Rufen Sie diese Befehle dort auf, wo die Aktion passiert:

// 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"] });

Besucher identifizieren

Aktivität zählt für einen Kontakt, sobald das Skript weiß, wer der Besucher ist:

• Über einen E-Mail-Link. Wenn ein Kontakt in einer Kampagnen- oder Automatisierungs-E-Mail auf einen Link klickt, der zu Ihrer Website führt, trägt der Link einen signierten Parameter _eit. Das Skript speichert ihn und entfernt ihn aus der Adressleiste. Links erhalten ihn, wenn das Klick-Tracking aktiviert ist und der Link zu einem erlaubten Ursprung (Allowed origins) eines Tracking-Schlüssels führt oder, bei Schlüsseln ohne erlaubte Ursprünge, zu Ihrer Versanddomain.

• Wenn sich Besucher in Ihrem Shop anmelden oder zur Kasse gehen, rufen Sie identify mit ihrer E-Mail-Adresse oder Kontakt-ID auf:

  JavaScript

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

• Wenn sie sich aus Ihrem Shop abmelden, rufen Sie emailit("reset") auf, damit dieser Browser sie vergisst.

Produktaufrufe und Warenkörbe aus der Zeit, bevor der Besucher identifiziert wurde, gehen auf den Kontakt über. Das Skript erfasst außerdem die Zeitzone des Browsers, die der Versand zur Ortszeit des Empfängers nutzt, und wann der Kontakt zuletzt auf Ihrer Website aktiv war.

emailit("debug", true) protokolliert in der Browserkonsole, was das Skript sendet.

Wo die Aktivität erscheint

Shop-Aktivität geht in dasselbe Event-Log wie Ihre anderen Events. Produktaufrufe werden zu Events vom Typ product.viewed, neue oder geänderte Warenkörbe zu cart.updated und Käufe zu order.placed. Sie sehen sie unter Email API›Events und in der Aktivität des Kontakts, und Webhooks können sie abonnieren. product.viewed und cart.updated gehören nicht zu All events, abonnieren Sie sie daher mit ihrem Namen. Siehe Commerce-Events.

Ergebnis prüfen

• Email Marketing›Commerce zeigt Ihre Produkte und Bestellungen, und Carts zeigt Warenkörbe aus dem Skript.
• Email API›Events listet Events vom Typ product.viewed, cart.updated und order.placed auf, während Besucher stöbern und kaufen.
• Öffnen Sie einen Kontakt, der bestellt hat: Die Karte Purchases zeigt seine Bestellungen, Gesamtausgaben und zuletzt angesehenen Produkte.
• Nach einer Kampagne erscheinen die ihr zugeordneten Bestellungen im Tab Revenue.

Siehe auch