DocumentatieExperience PlatformHandleiding voor Web SDK

Verzamel handel, product, en ordeinformatie

Laatst bijgewerkt: 16 juli 2024
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Als uw organisatie producten of diensten verkoopt, kunt u deze pagina als gids voor gebruiken hoe te om die producten en de diensten te volgen.

Deze pagina gebruikt de XDM 🔗 gebiedsgroep van het Schema van Commerce 0} {.

Deze veldgroep bestaat uit twee hoofddelen:

  • Het commerce -object. Met dit object kunt u aangeven welke handelingen met de array productListItems worden uitgevoerd.
  • De array productListItems .
TIP
Als u bekend bent met Adobe Analytics, bevat het commerce -object gegevens die lijken op commercegebeurtenissen in de events -variabele. De objectarray productListItems bevat gegevens die vergelijkbaar zijn met de variabele products .

Het object commerce

In deze sectie worden de velden beschreven die beschikbaar zijn in het commerce -object.

TIP
Een maat heeft twee velden: id en value . Meestal gebruikt u alleen het veld value (bijvoorbeeld 'value':1 ). In het veld id kunt u een unieke id voor bijhouden instellen wanneer de maatregel is verzonden. Zie de documentatie XDM voor Maatregelvoor meer informatie.
Meetlat
Aanbeveling
Beschrijving
cartAbandons
Optioneel
Een winkelwagentje is niet meer toegankelijk of kan niet meer door de gebruiker worden aangeschaft.
checkouts
Zeer aanbevolen
Een gebruiker zoekt niet meer naar producten, maar is bezig een product te kopen.
productListAdds
Zeer aanbevolen
Er wordt een product aan een lijst toegevoegd. Zorg ervoor dat u het product tegelijkertijd instelt in de productListItems .
productListOpens
Optioneel
Er wordt een nieuwe productlijst gemaakt. Er wordt bijvoorbeeld een nieuw winkelwagentje gemaakt.
productListRemovals
Zeer aanbevolen
Een product wordt uit een productlijst verwijderd.
productListReopens
Optioneel
Een productlijst wordt opnieuw geactiveerd door de gebruiker. Dit gebeurt vaak bij hermarketingcampagnes.
productListViews
Zeer aanbevolen
Er wordt een lijst met producten weergegeven.
productViews
Zeer aanbevolen
Een beeld van een product gebeurde. Zorg ervoor dat u het product instelt dat wordt weergegeven in de productListItems .
purchases
Zeer aanbevolen
Een bestelling wordt geaccepteerd. Moet een productlijst hebben.
saveForLaters
Optioneel
Een product wordt opgeslagen voor toekomstig gebruik.

Commerce objectvoorbeelden

Vouw de onderstaande sectie uit om een voorbeeld van een Web SDK-opdracht te zien met behulp van een veld uit het commerce -object.

productViews

Een eenvoudige Web SDK-aanroep sendEvent die het productViews veld instelt op 1 :

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

Het object order

Het commerce -object bevat een speciaal object voor het verzamelen van ordergegevens. Dit wordt het order -object genoemd.

In deze sectie worden alle velden beschreven die door het object order worden ondersteund.

Veld
Optie
Aanbeveling
Beschrijving
currencyCode
De ISO 4217munt voor het ordertotaal.
payments[]
De lijst met betalingen op een bestelling. A paymentItemomvat het volgende.
currencyCode
Optioneel
De ISO 4217munt voor deze betalingsmethode.
paymentAmount
Zeer aanbevolen
De waarde van de betaling in de opgegeven valutacode.
paymentType
Zeer aanbevolen
Het type betaling (bijvoorbeeld credit_card , gift_card , paypal ). Zie de lijst van gekende waardenvoor details.
transactionID
Optioneel
Een unieke id voor deze betalingstransactie.
priceTotal
Zeer aanbevolen
Het totaal voor deze bestelling nadat alle kortingen en belastingen zijn toegepast.
purchaseID
Zeer aanbevolen
De unieke id die door de verkoper is toegewezen voor deze aankoop.
purchaseOrderNumber
Optioneel
Een unieke id die door de koper voor deze aankoop is toegewezen.

Voorbeelden van Order-objecten

Vouw de onderstaande sectie uit om een voorbeeld van een Web SDK-opdracht weer te geven met het commerce -object.

Order objectvoorbeeld

Een Web SDK sendEvent -aanroep die het order -object instelt dat van toepassing is op meerdere producten in de 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
      }
    ]
  }
});

Het object productlijst

De productlijst geeft aan welke producten gerelateerd zijn aan de corresponderende actie. Het is een lijst van productListItems. Elk product heeft verschillende optionele velden.

Veld
Aanbeveling
Beschrijving
currencyCode
Optioneel
De ISO 4217munt voor het product. Dit veld is doorgaans alleen van toepassing wanneer de productlijst meerdere producten bevat met verschillende valutacodes.
priceTotal
Zeer aanbevolen
Stel dit veld alleen in, indien van toepassing. Het is bijvoorbeeld mogelijk niet in te stellen op de gebeurtenis productView omdat verschillende variaties van het product verschillende prijzen kunnen hebben, maar op een gebeurtenis productListAdds .
product
Zeer aanbevolen
De XDM-id voor het product.
productAddMethod
Zeer aanbevolen
De methode die door de bezoeker is gebruikt om een product-item aan de lijst toe te voegen. Stel dit in met productListAdds maten en gebruik het alleen wanneer een product aan de lijst wordt toegevoegd. Voorbeelden zijn add to cart button , quick add en upsell .
productName
Zeer aanbevolen
De weergavenaam of de leesbare naam van het product.
quantity
Zeer aanbevolen
Het aantal eenheden dat de klant heeft aangegeven van het product te verlangen. Moet worden ingesteld op productListAdds , productListRemoves , purchases , saveForLaters , enzovoort.
SKU
Zeer aanbevolen
Bewaar de bewaareenheid. Het is de unieke id voor het product.

Voorbeelden van productlijsten

Vouw de onderstaande secties uit om voorbeelden van Web SDK-opdrachten weer te geven met behulp van het productListItems -object.

productListItems voorbeeld

Een Web SDK sendEvent -aanroep die de productViews voor meerdere producten in de productListItems -array instelt:

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

Een Web SDK sendEvent -aanroep die de productListAdds -gebeurtenis instelt voor meerdere producten in de 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 voorbeeld

Een Web SDK sendEvent -aanroep die de checkouts -gebeurtenis instelt voor meerdere producten in de 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
      }
    ]
  }
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636