Messaggio Transaction (Property Data)

Panoramica

Il messaggio ARI Transaction (Property Data) definisce le informazioni sui tipi di camera e sui pacchetti (o piani tariffari) di ogni proprietà. I dati di ogni tipo di camera includono un identificatore univoco (RoomID), il nome localizzato, la descrizione e gli URL delle foto delle camere. Ogni dato del pacchetto include un identificatore univoco (PackageID), nome, descrizione, numero di persone e valore aggiunto localizzati.

Puoi utilizzare un messaggio Transaction per:

• Definisci i dati per una o più proprietà.
• Definisci le informazioni sui tipi di camera e sui pacchetti per ogni proprietà.
• Controllare le offerte dei prodotti.

Inoltre, puoi impostare azioni per:

• Aggiungi un tipo di camera e un pacchetto a una proprietà.

  Punto chiave: il tipo di camera ha un limite di 3000 per proprietà. Anche i pacchetti hanno un limite distinto di 3000 per proprietà. Puoi utilizzare il messaggio <Transaction> per rimuovere tipi di camere o pacchetti.

• Rimuovere un tipo di camera e un pacchetto da una proprietà.

• Aggiungi punti fedeltà, un programma fedeltà, a un pacchetto o a una proprietà.

Per esempi di messaggi Transaction, consulta la sezione Esempi di messaggi Transaction (Property Data).

Elementi obbligatori e facoltativi

La documentazione di riferimento XML fornisce descrizioni degli elementi obbligatori e facoltativi. Per informazioni dettagliate su attributi ed elementi secondari, consulta Elementi e attributi Transaction (Property Data).

Sintassi e schemi

Utilizza l'esempio di sintassi Transaction (Property Data) come riferimento quando crei il messaggio Transaction per assicurarti di seguire il formato corretto.

Puoi utilizzare uno strumento XML di terze parti come xmllint per convalidare i tuoi feed con gli schemi pubblicati prima di inviarli a Google. Per lo schema del messaggio Transaction, consulta la sezione Schemi di Hotel Ads.

Linee guida

Segui queste indicazioni per un messaggio Transaction:

Azioni:

delta: da utilizzare per aggiungere o aggiornare nuovi tipi di camere e pacchetti (prezzi).

overlay: da utilizzare per sostituire tutti i tipi di camera e i pacchetti di una proprietà con un nuovo insieme. Devono essere incluse informazioni su tutti i tipi di camere e i piani tariffari che vuoi ancora vendere.

Lingue supportate:

Specifica una o due lingue (inglese e una lingua locale per la proprietà, se necessario) per i campi Nome, Descrizione e Didascalia. Se necessario, puoi aggiungere più di due lingue.

Tipi di camere e pacchetti:

Quando aggiorni un tipo di camera o un pacchetto, devi inviare tutte le informazioni correlate al tipo di camera o al pacchetto. Ad esempio, quando aggiungi una foto, devi includere anche il nome e la descrizione.

<AllowablePackageIDs> e <AllowableRoomIDs> sono facoltativi e, se non impostati, è possibile creare qualsiasi combinazione di tipo di camera e piano tariffario. Devi comunque inviare la disponibilità e le tariffe con gli ID tipo di camera e piano tariffario. Questi elementi ti consentono di controllare i prodotti e di disattivare le combinazioni non più supportate dal tuo sistema.

Invia a Google un aggiornamento del messaggio Transaction ogni volta che si verifica una modifica dei tipi di camera o dei pacchetti o se devono essere aggiunti dettagli importanti su tipi di camera o pacchetti.

Nota: poiché Google memorizza i dati delle proprietà collegate a una proprietà "corrispondente", non può accettare questi dati finché la proprietà corrispondente non è stata "corrispondente" nel sistema. L'invio di tutte le proprietà nel feed elenco può contribuire a evitare errori o ritardi successivi.

Punti fedeltà:

Per includere o escludere il programma fedeltà nel pacchetto, configura una configurazione dei punti fedeltà con Google. Verranno visualizzati i punti guadagnati associati al pacchetto. Scopri di più sui punti fedeltà.

Utilizza l'elemento <MilesIncluded> per definire o aggiornare la campagna fedeltà. Per ulteriori informazioni, consulta Transaction(Property Data). I punti fedeltà possono essere inclusi con <PackageData>.

Esempio

Questa sezione fornisce un esempio di base di un messaggio Transaction ARI che utilizza elementi obbligatori e facoltativi. Per aggiungere o aggiornare tipi di camera e pacchetti, utilizza un'azione per delta per aggiungere o aggiornare tipi di camera e pacchetti oppure overlay per sostituire tutte le definizioni di tipi di camera e pacchetti (vengono eliminate le voci antiche).

Devi specificare una o due lingue (inglese e una lingua locale per la proprietà, se necessario) per i campi Nome, Descrizione e Testo alternativo. Aggiungi poi le informazioni relative ai dati della proprietà, inclusi i link alle foto.

Per <PropertyID> e <RoomID>, utilizza gli stessi ID che utilizzi nel tuo sistema per i piani tariffari e i tipi di camera. La coerenza con il tuo sistema è fondamentale per garantire che Google mostri correttamente i tuoi prezzi e i tuoi dati.

Nota: Google utilizza "ID" per l'identificatore del tipo di camera e del pacchetto (piano tariffario), mentre il file XML OTA utilizza "code". Devi utilizzare i tuoi ID, poiché Google non li genera. Per i dati della struttura, gli ID tipo di camera e piano tariffario devono essere univoci per ogni struttura.

Dopo aver preparato il file, devi inviarlo a Google tramite un messaggio POST al seguente endpoint: https://www.google.com/travel/hotels/uploads/property_data

Per scoprire di più su come inviare/pubblicare il messaggio, consulta Invio di messaggi push.

L'esempio seguente mostra come impostare il messaggio Transaction utilizzando un'azione delta:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Per altri esempi, ad esempio su come utilizzare l'azione overlay, aggiungere un tipo di camera e un pacchetto ai dati esistenti della struttura e rimuovere i tipi di camera e i pacchetti esistenti, consulta Esempi di messaggi Transaction (Property Data).

Procedure

Questa sezione fornisce soluzioni per gli scenari che potresti riscontrare durante l'invio di messaggi Transaction.

Scenario 1: come rimuovere i dati relativi al tipo di camera

Come faccio a rimuovere i dati esistenti relativi a tipi di camera e/o pacchetti?

Descrizione

Hai inviato più tipi di camere, tra cui camere matrimoniali e queen, per la proprietà. Durante una ristrutturazione, tutti i tipi di camere con letto queen non sono disponibili e al momento sono disponibili solo i tipi di camere con letto king.

Soluzione

• Non è necessario aggiornare la disponibilità, le tariffe o l'inventario giornaliero per gli ID tipo di camera e pacchetto che sono stati rimossi o disattivati.
• Se il tipo di camera o il pacchetto è stato rimosso o disattivato, invia un nuovo messaggio Transaction con action="overlay" che includa solo i tipi di camera e i pacchetti ancora attivi ed escluda il tipo di camera o il pacchetto rimosso.

Esempio

Questo snippet XML mostra come utilizzare l'azione overlay per rimuovere un tipo di camera.

Nota: anche se questo esempio riguarda il tipo di camera, puoi utilizzare la stessa azione anche per rimuovere i dati del pacchetto.

Ecco l'azione delta originale che include i tipi di camera King e Queen:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Puoi quindi impostare overlay per rimuovere il tipo di camera Queen e mantenere il tipo di camera King:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Scenario 2: come controllare i prodotti utilizzando AllowablePackageIDs

Come faccio a controllare i prodotti (combinazioni di tipi di camera e pacchetti) quando i pacchetti sono raggruppati per tipo di camera?

Nota: se i tipi di camera sono raggruppati per pacchetti, consulta lo Scenario 3.

Descrizione

Alcuni pacchetti sono disponibili solo per determinati tipi di camere. Ad esempio, se la tua struttura dispone di quattro tipi di camere (inclusa la suite presidenziale) e sei pacchetti diversi, ma solo alcuni sono idonei per la suite presidenziale, puoi specificare l'idoneità.

Soluzione

Invia un messaggio Transaction aggiornato che specifichi i prodotti inclusi nel pacchetto utilizzando <AllowablePackageIDs>.

Nota: utilizza <AllowablePackageIDs> o <AllowableRoomIDs>, ma non entrambi. L'elemento che utilizzi dipende dal fatto che il tuo sistema utilizzi la gerarchia camera>pacchetto o pacchetto>camera. Se nessuno di questi elementi è definito nel messaggio Transaction, i tipi di camera possono essere combinati con qualsiasi pacchetto.

Esempio

Questo snippet XML mostra come utilizzare <AllowablePackageIDs> per specificare i pacchetti utilizzati con un determinato tipo di camera. Qui, il tipo di camera Penthouse suite consente solo il pacchetto tutto incluso Penthouse o il pacchetto colazione inclusa, mentre il tipo di camera King suite consente solo il pacchetto tutto incluso King o il pacchetto Pet friendly.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Nota: se utilizzi <AllowablePackageIDs> o <AllowableRoomIDs> per disattivare una combinazione che potresti aver utilizzato in precedenza, ma che ora non è consentita nel tuo sistema, non è necessario inviare nuovamente l'ARI per tutte le date solo per rimuovere i dati precedenti.

Scenario 3: come controllare i prodotti utilizzando AllowableRoomIDs

Come faccio a controllare i prodotti (combinazioni di tipi di camera e pacchetti) quando i tipi di camera sono raggruppati per pacchetto?

Nota: se i pacchetti sono raggruppati per tipo di camera, consulta lo Scenario 2.

Descrizione

Una combinazione di tipo di camera e pacchetto non viene più venduta come prodotto o vuoi controllare cosa è incluso in un nuovo pacchetto. Ad esempio, vuoi specificare solo determinati tipi di camere, come le camere King e Queen con vista sull'oceano, con un pacchetto.

Soluzione

Invia un messaggio Transaction aggiornato che specifichi i prodotti esatti inclusi con il pacchetto utilizzando l'elemento <AllowableRoomIDs>.

Esempio

Questo snippet XML mostra come utilizzare <AllowableRoomID> per specificare i tipi di camera con vista sull'oceano con letto king e queen nel pacchetto.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>