Erfassen von Commerce- und Produktinformationen

Wenn Sie Produkte auf Ihrer Site haben, ist dies ein Standardsatz, den Sie möglicherweise senden möchten, um die meisten Funktionen von Adobe zu aktivieren. Dies ist nur ein Vorschlag, Sie verfügen damit jedoch von Anfang an über einen sehr starken Datensatz.

Dieses Dokument verwendet die ExperienceEvent Commerce-Details Schemafeldgruppe. Die commerce Die Feldergruppe besteht aus zwei Teilen: die commerce -Objekt und productListItems Array. Mit dem commerce-Objekt können Sie angeben, welche Aktionen auf das productListItems-Array angewendet werden.

TIPP

Wenn Sie mit Adobe Analytics vertraut sind, ist commerce am ehesten mit der events-Variablen vergleichbar. productListItems ist eher mit der products-Variablen vergleichbar.

Aktionen im Zusammenhang mit Produkten

Nachstehend finden Sie eine Liste der Maßnahmen (measures), die im commerce-Objekt verfügbar sind.

TIPP

Eine Maßnahme umfasst zwei Bereiche: id und value. In den meisten Fällen verwenden Sie nur das value-Feld (z. B. 'value':1). Mit dem id-Feld können Sie eine eindeutige Kennung festlegen, mit der Sie verfolgen können, wann die Maßnahme gesendet wurde. Siehe XDM-Dokumentation für Maßnahme.

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. Dies geschieht häufig bei Remarketing-Kampagnen.
productListViews Dringend empfohlen Eine Liste von Produkten wird angezeigt.
productViews Dringend empfohlen Ein Produkt wurde angesehen. 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.

Hier ist ein Beispiel, wie Sie diese Maßnahmen (Measures) im SDK festlegen.

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

Das Commerce-Objekt verfügt auch über ein spezielles Feld zum Sammeln von Bestelldetails namens order.

Auftrag Option Empfehlung Beschreibung
currencyCode Die ISO 4217-Währung für die Bestellsumme.
payments[paymentItems] 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.

Hier ein Beispiel für einen typischen Kauf im SDK.

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

Produktlisten

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 eine Reihe optionaler Felder.

Feld Empfehlung Beschreibung
currencyCode Optional Die ISO 4217-Währung für das Produkt. Dies ist nur dann nützlich, wenn Sie Produkte mit unterschiedlichen Währungs-Codes haben können und wenn es anwendbar ist. Wenn es beispielsweise einen Kauf gibt oder eine Artikel zum Warenkorb hinzugefügt wird.
priceTotal Dringend empfohlen Sollte nur sofern zutreffend eingestellt werden. So ist es zum Beispiel u. U. nicht möglich, eine Einstellung auf productView vorzunehmen, weil unterschiedliche Produktvarianten auf productListAdds unterschiedliche Preise haben können.
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. Wird mit productListAdds-Maßnahmen eingestellt und sollte nur verwendet werden, wenn ein Produkt der Liste hinzugefügt wird. Beispiele sind add to cart button, quick add und upsell.
productName Dringend empfohlen Dies wird auf den Anzeigenamen oder den für Menschen lesbaren Namen des Produkts festgelegt.
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

productViews-Ereignis

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

productListAdds-Ereignis

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-Ereignis

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

order-Ereignis

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

Auf dieser Seite