Erfassen von Commerce-, Produkt- und Bestellinformationen

Letzte Aktualisierung: 2023-10-31
  • Themen:
  • Web SDK
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
    User
    Admin
    Leader

Wenn Ihr Unternehmen Produkte oder Dienstleistungen verkauft, können Sie diese Seite als Leitfaden zur Verfolgung dieser Produkte und Dienste verwenden.

Diese Seite verwendet das XDM Commerce-Schema Feldergruppe.

Diese Feldergruppe besteht aus zwei Hauptteilen:

  • Die commerce -Objekt. Mit diesem Objekt können Sie angeben, welche Aktionen bei der productListItems Array.
  • Die productListItems Array.
TIPP

Wenn Sie mit Adobe Analytics vertraut sind, wird die Variable commerce -Objekt enthält Daten, die Commerce-Ereignissen in der Variablen events -Variable. Die productListItems Objekt-Array enthält Daten, die dem products -Variable.

Die commerce Objekt

In diesem Abschnitt werden die in der Variablen commerce -Objekt.

TIPP

Eine Maßnahme umfasst zwei Bereiche: id und value. Meistens verwenden Sie nur die value -Feld (z. B. 'value':1). Die id -Feld können Sie eine eindeutige Kennung für das Tracking zum Zeitpunkt des Versands der Kennzahl festlegen. Siehe XDM-Dokumentation für Maßnahme für weitere Informationen.

Maßnahme Empfehlung Beschreibung
cartAbandons Optional Ein Warenkorb kann vom Nutzer nicht mehr aufgerufen oder gekauft werden.
checkouts Dringend empfohlen Ein Nutzer sucht nicht mehr nach Produkten, sondern kauft gerade ein Produkt.
productListAdds Dringend empfohlen Ein Produkt wird einer Liste hinzugefügt. Stellen Sie das Produkt gleichzeitig in productListItems ein.
productListOpens Optional Eine neue Produktliste wird erstellt. Beispielsweise wird ein neuer Warenkorb erstellt.
productListRemovals Dringend empfohlen Ein Produkt wird aus einer Produktliste entfernt.
productListReopens Optional Eine Produktliste wird vom Nutzer reaktiviert. Diese Aktion tritt oft bei Remarketing-Kampagnen auf.
productListViews Dringend empfohlen Eine Liste von Produkten wird angezeigt.
productViews Dringend empfohlen Eine Ansicht eines Produkts ist aufgetreten. Stellen Sie das angesehene Produkt in productListItems ein.
purchases Dringend empfohlen Eine Bestellung wird angenommen. Muss eine Produktliste haben.
saveForLaters Optional Ein Produkt wird für die zukünftige Verwendung gespeichert.

Commerce Objektbeispiele

Erweitern Sie den folgenden Abschnitt, um ein Beispiel für einen Web SDK-Befehl mit einem Feld aus dem commerce -Objekt.

 productViews

Grundlegendes Web-SDK sendEvent Aufrufeinstellung productViews -Feld zu 1:

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

Die order Objekt

Die commerce -Objekt enthält ein dediziertes Objekt zum Erfassen von Bestelldetails. Dies wird als order -Objekt.

In diesem Abschnitt werden alle Felder beschrieben, die von der order -Objekt.

Feld Option Empfehlung Beschreibung
currencyCode Die ISO 4217-Währung für die Bestellsumme.
payments[] Die Liste der Zahlungen für eine Bestellung. Ein paymentItem beinhaltet Folgendes.
currencyCode Optional Die ISO 4217-Währung für diese Zahlungsmethode.
paymentAmount Dringend empfohlen Der Wert der Zahlung im angegebenen Währungs-Code.
paymentType Dringend empfohlen Die Art der Zahlung (z. B. credit_card, gift_card, paypal). Weitere Informationen finden Sie in der Liste der bekannten Werte.
transactionID Optional Eine eindeutige Kennung für diesen Zahlungsvorgang.
priceTotal Dringend empfohlen Die Summe für diese Bestellung, nachdem alle Rabatte und Steuern berücksichtigt wurden.
purchaseID Dringend empfohlen Die eindeutige Kennung, die der Verkäufer diesem Kauf zugewiesen hat.
purchaseOrderNumber Optional Eine eindeutige Kennung, die der Käufer diesem Kauf zugewiesen hat.

Objektbeispiele sortieren

Erweitern Sie den folgenden Abschnitt, um ein Beispiel für einen Web SDK-Befehl mit dem commerce -Objekt.

 Order Objektbeispiel

Ein Web-SDK sendEvent Aufrufeinstellung order -Objekt, das für mehrere Produkte im productListItems array:

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

Das Produktlistenobjekt

Die Produktliste gibt an, welche Produkte mit der entsprechenden Aktion in Verbindung stehen. Es handelt sich um eine Liste von productListItems. Jedes Produkt verfügt über mehrere optionale Felder.

Feld Empfehlung Beschreibung
currencyCode Optional Die ISO 4217 Währung für das Produkt. Dieses Feld gilt normalerweise nur, wenn die Produktliste mehrere Produkte mit unterschiedlichen Währungs-Codes enthält.
priceTotal Dringend empfohlen Legen Sie dieses Feld nur fest, wenn zutreffend. So ist es beispielsweise möglicherweise nicht möglich, productView -Ereignis eintreten, da unterschiedliche Produktvarianten unterschiedliche Preise haben können, jedoch auf einer productListAdds -Ereignis.
product Dringend empfohlen Die XDM-ID für das Produkt.
productAddMethod Dringend empfohlen Die Methode, mit der der Besucher der Liste ein Produktelement hinzufügen konnte. Festlegen mit productListAdds Kennzahlen und nur verwendet, wenn ein Produkt der Liste hinzugefügt wird. Beispiele sind add to cart button, quick add und upsell.
productName Dringend empfohlen Der Anzeigename oder der für Menschen lesbare Name des Produkts.
quantity Dringend empfohlen Die Anzahl der Einheiten, die der Kunde vom Produkt benötigt. Sollte auf productListAdds, productListRemoves, purchases, saveForLaters usw. eingestellt werden.
SKU Dringend empfohlen Bestandseinheit. Dies ist die eindeutige Kennung für das Produkt.

Beispiele für Produktlisten

Erweitern Sie die folgenden Abschnitte, um Beispiele für Web SDK-Befehle mithilfe der productListItems -Objekt.

 productListItems example

Ein Web-SDK sendEvent Aufrufeinstellung productViews für mehrere Produkte in productListItems array:

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});
 productListAdds examplae

Ein Web-SDK sendEvent Aufrufeinstellung productListAdds -Ereignis für mehrere Produkte im productListItems array:

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productListAdds":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99,
        "productAddMethod":"Add to Cart Button"
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99,
        "productAddMethod":"Add-on"
      }
    ]
  }
});
 checkouts example

Ein Web-SDK sendEvent Aufrufeinstellung checkouts -Ereignis für mehrere Produkte im productListItems array:

alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "checkouts":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99
      }
    ]
  }
});

Auf dieser Seite