Ordina

Un ordine è la conferma di una transazione (una ricevuta) che può contenere più elementi pubblicitari, ognuno dei quali è 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>

Visualizza azione ordine

Puoi aggiungere un pulsante View Order ai tuoi ordini impostando la proprietà url. Per creare un collegamento diretto 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 Test di 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.

Specifiche

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

Proprietà Tipo Descrizione
commerciante Organizzazione 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 Testo (obbligatorio) Il nome dell'organizzazione.
merchant.sameAs URL L'URL di Freebase per il commerciante.
numero ordine Testo (obbligatorio) L'identificatore specifico del commerciante per la transazione.
priceCurrency Testo (obbligatorio) La valuta (in formato ISO 4217 di tre lettere) del prezzo dell'ordine.
price Numero o testo (obbligatorio) Il prezzo totale dell'intera transazione.
acceptedOffer Offerta (obbligatorio) Le offerte incluse nell'ordine. Accetta anche un array di oggetti.
acceptedOffer.itemOffered Prodotto o Prenotazione (obbligatorio) L'articolo venduto.
acceptedOffer.itemOffered.name Testo (obbligatorio) Il nome del prodotto.
SKU acceptedOffer.itemOffered. Testo (consigliato per le schede di conferma/risposte di ricerca) ovvero lo SKU di magazzino, ovvero un identificatore specifico del commerciante per un prodotto o un servizio, o per il prodotto a cui si riferisce l'offerta.
acceptedOffer.itemOffered.url URL (consigliato per schede di conferma/risposte di ricerca) dell'URL del Prodotto, in genere la pagina di destinazione del prodotto sul sito web del commerciante.
acceptedOffer.itemOffered.immagine URL (consigliato per schede di conferma/risposte di ricerca) l'URL di un'immagine del Prodotto, in genere un'immagine sul sito web del commerciante.
acceptedOffer.itemOffered.colore Testo Il colore del prodotto.
acceptedOffer.prezzo Numero o testo (obbligatorio) il prezzo unitario del Prodotto.
acceptedOffer.priceCurrency Testo (obbligatorio) La valuta (in formato ISO 4217 di tre lettere) del prezzo.
acceptedOffer.AmountQuantità Valore quantitativo (obbligatorio) L'intervallo e l'unità di misura delle quantità ordinate per le quali l'offerta o la specifica del prezzo sono valide.
acceptedOffer.Eligiblequantity.value Numero (obbligatorio) Il valore della caratteristica del prodotto.
acceptedOffer.priceSpecification Specifica del prezzo Una o più specifiche dei prezzi dettagliate, che indichino il prezzo unitario e le spese di spedizione o pagamento.
acceptedOffer.priceSpecification.prezzo Numero o testo Il prezzo totale dell'intera transazione.
acceptedOffer.priceSpecification.priceCurrency Testo La valuta (in formato ISO 4217 di tre lettere) del prezzo dell'ordine.
acceptedOffer.itemCondition Condizione articolo dell'offerta Una descrizione testuale della condizione del prodotto o del servizio o dei prodotti o servizi inclusi nell'offerta.
acceptedOffer.venditore Organizzazione o Persona Parte con cui è stato effettuato l'ordine. Accetta anche una stringa (ad es. "").
acceptedOffer.seller.name Testo Nome dell'organizzazione.
Specifica del prezzo Specifica del prezzo (consigliato per le schede di conferma/risposte di ricerca). Alternative più dettagliate per prezzo/prezzo. Utilizzato anche per specificare le tasse e le spese di spedizione. Accetta anche un array di oggetti.
url URL (consigliato per schede di conferma/risposte di ricerca) dell'ordine, in genere un link al sito web del commerciante in cui l'utente può recuperare ulteriori dettagli su un ordine.
ordineOrdine Stato ordine (opzione consigliata per schede di conferma/risposte di ricerca). Lo stato attuale dell'ordine.
Metodo di pagamento Metodo di pagamento Il nome della carta di credito o un altro metodo di pagamento per l'ordine.
ID metodo pagamento Testo Un identificatore del metodo di pagamento utilizzato (ad es. le ultime 4 cifre della carta di credito).
ordineDate DateTime Data in cui è stato effettuato l'ordine.
IsGift Booleano L'offerta è stata accettata come regalo per un soggetto diverso dall'acquirente.
discount Numero o testo Eventuali sconti applicati.
scontoValuta Testo La valuta dello sconto (in formato ISO 4217 a tre lettere).
cliente Persona o Organizzazione Parte che effettua l'ordine.
customer.name (nome) Testo Nome della persona.
billingAddress Indirizzo postale L'indirizzo di fatturazione dell'ordine.
NomeIndirizzobilling. Testo Nome dell'indirizzo postale.
billingAddress.viaIndirizzo Testo L'indirizzo fisico. Ad esempio, 1600 Amphitheatre Parkway.
billingAddress.IndirizzoLocalizzazione Testo La località. Ad esempio, Mountain View.
billingAddress.IndirizzoRegione Testo L'area geografica. ad esempio CA.
billingAddress.indirizzoPaese Testo o Paese Il paese. Ad esempio, USA. Puoi anche fornire il codice paese alpha-2 nel formato ISO 2166-1 di due lettere.