Ordine

Un ordine è una conferma di una transazione (una ricevuta) che può contenere più elementi pubblicitari, ognuno rappresentato da un'offerta accettata dal cliente.

Casi d'uso

Ordine di base

Esempio minimo per un ordine

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Order",
  "merchant": {
    "@type": "Organization",
    "name": "Amazon.com"
  },
  "orderNumber": "123-4567890-1234567",
  "priceCurrency": "USD",
  "price": "29.99",
  "acceptedOffer": {
    "@type": "Offer",
    "itemOffered": {
      "@type": "Product",
      "name": "Google Chromecast"
    },
    "price": "29.99",
    "priceCurrency": "USD",
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "value": "1"
    }
  }
}
</script>

Microdati

<div itemscope itemtype="http://schema.org/Order">
  <div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
    <meta itemprop="name" content="Amazon.com"/>
  </div>
  <meta itemprop="orderNumber" content="123-4567890-1234567"/>
  <meta itemprop="priceCurrency" content="USD"/>
  <meta itemprop="price" content="29.99"/>
  <div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
    <div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
      <meta itemprop="name" content="Google Chromecast"/>
    </div>
    <meta itemprop="price" content="29.99"/>
    <meta itemprop="priceCurrency" content="USD"/>
    <div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
      <meta itemprop="value" content="1"/>
    </div>
  </div>
</div>

Azione Visualizza ordine

Puoi aggiungere un pulsante View Order ai tuoi ordini impostando la proprietà url. Per collegarti direttamente a un'applicazione mobile, aggiungi anche un ViewAction:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Order",
  "merchant": {
    "@type": "Organization",
    "name": "Amazon.com"
  },
  "orderNumber": "123-4567890-1234567",
  "orderStatus": "http://schema.org/OrderProcessing",
  "priceCurrency": "USD",
  "price": "29.99",
  "priceSpecification": {
    "@type": "PriceSpecification",
    "validFrom": "2027-12-07T23:30:00-08:00"
  },
  "acceptedOffer": {
    "@type": "Offer",
    "itemOffered": {
      "@type": "Product",
      "name": "Google Chromecast",
      "sku": "B00DR0PDNE",
      "url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
      "image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
    },
    "price": "29.99",
    "priceCurrency": "USD",
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "value": "1"
    }
  },
  "url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
  "potentialAction": {
    "@type": "ViewAction",
    "url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
  }
}
</script>

Microdati

<div itemscope itemtype="http://schema.org/Order">
  <div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
    <meta itemprop="name" content="Amazon.com"/>
  </div>
  <link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
  <meta itemprop="orderNumber" content="123-4567890-1234567"/>
  <meta itemprop="priceCurrency" content="USD"/>
  <meta itemprop="price" content="29.99"/>
  <div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
    <div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
      <meta itemprop="name" content="Google Chromecast"/>
      <link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
      <link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
      <meta itemprop="sku" content="B00DR0PDNE"/>
    </div>
    <meta itemprop="price" content="29.99"/>
    <meta itemprop="priceCurrency" content="USD"/>
    <div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
      <meta itemprop="value" content="1"/>
    </div>
  </div>
  <link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
  </div>
  <div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
    <meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
  </div>
</div>

Ordine con dettagli di fatturazione

Esempio di ordine con dati di fatturazione dettagliati

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Order",
  "merchant": {
    "@type": "Organization",
    "name": "Amazon.com"
  },
  "orderNumber": "123-4567890-1234567",
  "priceCurrency": "USD",
  "price": "539.00",
  "priceSpecification": {
    "@type": "PriceSpecification",
    "validFrom": "2027-12-07T23:30:00-08:00"
  },
  "acceptedOffer": [
    {
      "@type": "Offer",
      "itemOffered": {
        "@type": "Product",
        "name": "Samsung Chromebook",
        "sku": "B009LL9VDG",
        "url": "http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/",
        "image": "http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"
      },
      "price": "249.99",
      "priceCurrency": "USD",
      "eligibleQuantity": {
        "@type": "QuantitativeValue",
        "value": "2"
      },
      "seller": {
        "@type": "Organization",
        "name": "Samsung Marketplace Store"
      }
    },
    {
      "@type": "Offer",
      "itemOffered": {
        "@type": "Product",
        "name": "Google Chromecast",
        "sku": "B00DR0PDNE",
        "url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
        "image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
      },
      "price": "29.99",
      "priceCurrency": "USD",
      "eligibleQuantity": {
        "@type": "QuantitativeValue",
        "value": "1"
      },
      "seller": {
        "@type": "Organization",
        "name": "Google Store @ Amazon"
      }
    }
  ],
  "url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
  "potentialAction": {
    "@type": "ViewAction",
    "url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
  },
  "orderStatus": "http://schema.org/OrderProcessing",
  "paymentMethod": {
    "@type": "PaymentMethod",
    "name": "http://schema.org/CreditCard"
  },
  "paymentMethodId": "**** **** **** 1234",
  "orderDate": "2027-11-07T23:30:00-08:00",
  "isGift": "false",
  "discount": "0.97",
  "discountCurrency": "USD",
  "customer": {
    "@type": "Person",
    "name": "John Smith"
  },
  "billingAddress": {
    "@type": "PostalAddress",
    "name": "Google",
    "streetAddress": "1600 Amphitheatre Pkwy",
    "addressLocality": "Mountain View",
    "addressRegion": "CA",
    "addressCountry": "USA"
  }
}
</script>

Microdati

<div itemscope itemtype="http://schema.org/Order">
  <div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
    <meta itemprop="name" content="Amazon.com"/>
  </div>
  <meta itemprop="orderNumber" content="123-4567890-1234567"/>
  <meta itemprop="priceCurrency" content="USD"/>
  <meta itemprop="price" content="539.00"/>
  <div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
    <div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
      <meta itemprop="name" content="Samsung Chromebook"/>
      <meta itemprop="sku" content="B009LL9VDG"/>
      <link itemprop="url" href="http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/"/>
      <link itemprop="image" href="http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"/>
    </div>
    <meta itemprop="price" content="249.99"/>
    <meta itemprop="priceCurrency" content="USD"/>
    <div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
      <meta itemprop="value" content="2"/>
    </div>
    <div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="Samsung Marketplace Store"/>
    </div>
  </div>
  <div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
    <div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
      <meta itemprop="name" content="Google Chromecast"/>
      <meta itemprop="sku" content="B00DR0PDNE"/>
      <link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
      <link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
    </div>
    <meta itemprop="price" content="29.99"/>
    <meta itemprop="priceCurrency" content="USD"/>
    <div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
      <meta itemprop="value" content="1"/>
    </div>
    <div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="Google Store @ Amazon"/>
    </div>
  </div>
  <link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
  </div>
  <link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
  <div itemprop="paymentMethod" itemscope itemtype="http://schema.org/PaymentMethod">
    <meta itemprop="name" content="http://schema.org/CreditCard"/>
  </div>
  <meta itemprop="paymentMethodId" content="**** **** **** 1234"/>
  <meta itemprop="orderDate" content="2027-11-07T23:30:00-08:00"/>
  <meta itemprop="isGift" content="false"/>
  <meta itemprop="discount" content="0.97"/>
  <meta itemprop="discountCurrency" content="USD"/>
  <div itemprop="customer" itemscope itemtype="http://schema.org/Person">
    <meta itemprop="name" content="John Smith"/>
  </div>
  <div itemprop="billingAddress" itemscope itemtype="http://schema.org/PostalAddress">
    <meta itemprop="name" content="Google"/>
    <meta itemprop="streetAddress" content="1600 Amphitheatre Pkwy"/>
    <meta itemprop="addressLocality" content="Mountain View"/>
    <meta itemprop="addressRegion" content="CA"/>
    <meta itemprop="addressCountry" content="USA"/>
  </div>
  <div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
    <meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
  </div>
</div>

Verifica il codice di markup

Puoi convalidare il markup utilizzando lo Strumento di test per il markup delle email. Incolla il codice di markup e fai clic sul pulsante Convalida per scansionare i contenuti e ricevere un report su eventuali errori presenti.

Specifica

La tabella seguente elenca tutte le proprietà disponibili per questo tipo:

Proprietà	Tipo	Descrizione
merchant	Organización o Persona	(obbligatorio) La parte che riceve l'ordine (ad es. Amazon.com è un commerciante per molti venditori). Accetta anche una stringa (ad es. "Amazon.com").
merchant.name	Text	(obbligatorio) Nome dell'organizzazione.
merchant.sameAs	URL	L'URL di Freebase per il commerciante.
orderNumber	Text	(obbligatorio) L'identificatore specifico del commerciante per la transazione.
priceCurrency	Text	(obbligatorio) La valuta (in formato ISO 4217 da 3 lettere) del prezzo dell'ordine.
price	Number o Text	(obbligatorio) Il prezzo totale dell'intera transazione.
acceptedOffer	Offer	(obbligatorio) Le offerte incluse nell'ordine. Accetta anche un array di oggetti.
acceptedOffer.itemOffered	Product o Reservation	(obbligatorio) L'articolo in vendita.
acceptedOffer.itemOffered.name	Text	(obbligatorio) Nome del prodotto.
acceptedOffer.itemOffered.sku	Text	(consigliato per le schede di conferma/risposte di ricerca) Il codice identificativo dell'articolo (SKU), ovvero un identificatore specifico del commerciante per un prodotto o servizio, o il prodotto a cui si riferisce l'offerta.
acceptedOffer.itemOffered.url	URL	(consigliato per le schede di conferma/risposte di ricerca) L'URL del prodotto, in genere la pagina di destinazione del prodotto sul sito web del commerciante.
acceptedOffer.itemOffered.image	URL	(consigliato per le schede di conferma/risposte di ricerca) L'URL di un'immagine del prodotto, in genere un'immagine sul sito web del commerciante.
acceptedOffer.itemOffered.color	Text	Il colore del prodotto.
acceptedOffer.price	Number o Text	(obbligatorio) Il prezzo unitario del prodotto.
acceptedOffer.priceCurrency	Text	(obbligatorio) La valuta (in formato ISO 4217 da 3 lettere) del prezzo.
acceptedOffer.eligibleQuantity	QuantitativeValue	(obbligatorio) L'intervallo e l'unità di misura delle quantità di ordinazione per cui l'offerta o la specifica del prezzo è valida.
acceptedOffer.eligibleQuantity.value	Number	(obbligatorio) Il valore della caratteristica del prodotto.
acceptedOffer.priceSpecification	PriceSpecification	Una o più specifiche di prezzo dettagliate, che indicano il prezzo unitario e le spese di consegna o di pagamento.
acceptedOffer.priceSpecification.price	Number o Text	Il prezzo totale dell'intera transazione.
acceptedOffer.priceSpecification.priceCurrency	Text	La valuta (in formato ISO 4217 da 3 lettere) del prezzo dell'ordine.
acceptedOffer.itemCondition	OfferItemCondition	Una descrizione testuale delle condizioni del prodotto o del servizio, o dei prodotti o servizi inclusi nell'offerta.
acceptedOffer.seller	Organización o Persona	La parte con cui è stato effettuato l'ordine. Accetta anche una stringa (ad es. "").
acceptedOffer.seller.name	Text	Nome dell'organizzazione.
priceSpecification	PriceSpecification	(consigliato per le schede di conferma/risposte di ricerca) Eventuali alternative più dettagliate a prezzo/priceCurrency. Utilizzato anche per specificare le imposte e le spese di consegna. Accetta anche un array di oggetti.
url	URL	(consigliato per le schede di conferma/risposte di ricerca) L'URL dell'ordine, in genere un link al sito web del commerciante in cui l'utente può recuperare ulteriori dettagli su un ordine.
orderStatus	OrderStatus	(consigliato per le schede di conferma/risposte di ricerca) Lo stato attuale dell'ordine.
paymentMethod	PaymentMethod	Il nome della carta di credito o di un altro metodo di pagamento per l'ordine.
paymentMethodId	Text	Un identificatore per il metodo di pagamento utilizzato (ad es. le ultime 4 cifre della carta di credito).
orderDate	DateTime	La data in cui è stato effettuato l'ordine.
isGift	Boolean	L'offerta è stata accettata come regalo per una persona diversa dall'acquirente?
discount	Number o Text	Eventuali sconti applicati.
discountCurrency	Text	La valuta (in formato ISO 4217 da 3 lettere) dello sconto.
customer	Persona u Organización	La parte che effettua l'ordine.
customer.name	Text	Nome della persona.
billingAddress	PostalAddress	L'indirizzo di fatturazione per l'ordine.
billingAddress.name	Text	Nome dell'indirizzo postale.
billingAddress.streetAddress	Text	La via. Ad esempio, 1600 Amphitheatre Pkwy.
billingAddress.addressLocality	Text	La località. Ad esempio, Mountain View.
billingAddress.addressRegion	Text	La regione. Ad esempio, CA.
billingAddress.addressCountry	Text o Country	Il paese. Ad esempio, USA. Puoi anche fornire il codice paese alpha-2 nel formato ISO 3166 a 2 lettere.