Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Engage SDK Travel: istruzioni per l'integrazione tecnica di terze parti

Aumenta il coinvolgimento nell'app raggiungendo gli utenti ovunque si trovino. Integra l'SDK Engage per fornire consigli personalizzati e contenuti di continuazione direttamente agli utenti su più piattaforme on-device, come Raccolte, Entertainment Space e il Play Store. L'integrazione aggiunge meno di 50 KB (compressi) all'APK medio e richiede alla maggior parte delle app circa una settimana di tempo per lo sviluppatore. Scopri di più sul nostro sito aziendale.

Questa guida contiene istruzioni per i partner sviluppatori per pubblicare contenuti di viaggi ed eventi sulle piattaforme di contenuti di Engage.

Dettaglio integrazione

Terminologia

Questa integrazione include i seguenti tipi di cluster: Suggerimento, In evidenza, Prenotazione e Continua ricerca.

I cluster di consigli mostrano suggerimenti personalizzati per viaggi ed eventi di un singolo partner sviluppatore. Questi consigli possono essere personalizzati per l'utente o generalizzati (ad esempio, gli articoli di tendenza). Utilizzali per visualizzare consigli su articoli, eventi, alloggi o luoghi di interesse.
- Un cluster di consigli può essere composto da schede ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity o StoreEntity, ma non da un mix di diversi tipi di entità.
I consigli hanno la seguente struttura:
- Cluster di suggerimenti:una visualizzazione dell'interfaccia utente che contiene un gruppo di suggerimenti dello stesso partner sviluppatore.
- Entità:un oggetto che rappresenta un singolo elemento in un cluster. Questa integrazione offre alcune entità che verrebbero visualizzate utilizzando il cluster di consigli:
  - ArticleEntity: ArticleEntity rappresenta un consiglio per contenuti basati su testo relativi a viaggi ed eventi. Può essere utilizzato per articoli, post di blog, contenuti di marketing, snippet di notizie e così via.
    
    Figura 1: UI che mostra una singola ArticleEntity all'interno del cluster Suggerimenti.
  - EventEntity: EventEntity rappresenta un evento che si svolgerà in futuro. L'ora di inizio dell'evento è un'informazione fondamentale che deve essere comunicata agli utenti.
    
    Figura 2: UI che mostra una singola EventEntity all'interno del cluster Suggerimenti.
  - LodgingEntity: LodgingEntity rappresenta una sistemazione, ad esempio un hotel, un appartamento o una casa vacanze per affitti a breve e lungo termine.
    
    Figura 3: UI che mostra una singola LodgingEntity all'interno del cluster Suggerimenti.
  - StoreEntity: StoreEntity rappresenta un negozio, un ristorante, un bar ecc. Mette in evidenza i contenuti in cui un ristorante o un negozio è l'informazione fondamentale da comunicare agli utenti.
    
    Figura 4: UI che mostra una singola StoreEntity all'interno del cluster Suggerimenti.
  - PointOfInterestEntity: PointOfInterestEntity rappresenta un luogo di interesse come una stazione di servizio, un luogo per eventi, un parco a tema, un museo, un'attrazione turistica, un sentiero escursionistico e così via. Evidenzia i contenuti in cui la posizione è un'informazione fondamentale che deve essere comunicata agli utenti. Non deve essere utilizzato per alloggi, negozi o ristoranti.
    
    Figura 5: UI che mostra una singola PointOfInterestEntity all'interno del cluster Consigli.
Il cluster Prenotazione mostra i contenuti con cui gli utenti hanno interagito di recente in un unico raggruppamento dell'interfaccia utente. A ogni partner sviluppatore sarà consentito trasmettere un massimo di 10 entità nel cluster Prenotazione.

I contenuti della prenotazione possono avere la seguente struttura:
- RestaurantReservationEntity: RestaurantReservationEntity rappresenta una prenotazione per un ristorante o un bar e aiuta gli utenti a monitorare le prenotazioni di ristoranti imminenti o in corso.
  
  Figura 6. UI che mostra una singola RestaurantReservationEntity all'interno di un cluster Reservation.
- EventReservationEntity: EventReservationEntity rappresenta una prenotazione per un evento e aiuta gli utenti a monitorare le prenotazioni di eventi imminenti o in corso. Gli eventi potrebbero includere, a titolo esemplificativo:
  - Eventi sportivi come la prenotazione per una partita di calcio
  - Eventi di gioco come la prenotazione per gli eSport
  - Eventi di intrattenimento come prenotazioni per film al cinema, concerti, spettacoli teatrali, presentazioni di libri
  - Prenotazioni di viaggi o punti d'interesse come tour guidati, biglietti per musei
  - Prenotazioni di eventi sociali / seminari / conferenze
  - Prenotazioni di sessioni di istruzione / formazione
  Figura 7. UI che mostra una singola EventReservationEntity all'interno di un cluster Reservation.
- LodgingReservationEntity: LodgingEntityReservation rappresenta una prenotazione per un alloggio di viaggio e aiuta gli utenti a monitorare le prenotazioni imminenti o in corso di hotel o case vacanze.
  
  Figura 8. UI che mostra una singola LodgingReservationEntity all'interno di un cluster Reservation.
- TransportationReservationEntity: TransportationReservationEntity rappresenta la prenotazione di un trasporto con qualsiasi modalità e aiuta gli utenti a monitorare le prenotazioni di voli, traghetti, treni, autobus, servizi di trasporto con conducente o crociere imminenti o in corso.
  
  Figura 9. UI che mostra una singola TransportationReservationEntity all'interno di un cluster Reservation.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity rappresenta la prenotazione di noleggio di un veicolo e aiuta gli utenti a monitorare le prenotazioni di noleggio di veicoli imminenti o in corso.
  
  Figura 10. UI che mostra una singola VehicleRentalReservationEntity all'interno di un cluster Reservation.
Il cluster In evidenza mostra una selezione di entità di più partner di sviluppo in un unico raggruppamento dell'interfaccia utente. Verrà visualizzato un singolo cluster In primo piano, posizionato nella parte superiore della UI con un posizionamento prioritario sopra tutti i cluster di consigli. A ogni partner sviluppatore sarà consentito trasmettere fino a 10 entità nel cluster In primo piano.
- GenericFeaturedEntity: GenericFeaturedEntity è diverso da Recommendation item in quanto Featured item deve essere utilizzato per un singolo contenuto principale degli sviluppatori e deve rappresentare il contenuto più importante che sarà interessante e pertinente per gli utenti.
  
  Figura 11: UI che mostra un FeaturedCluster con un elenco di GenericFeaturedEntity
Il cluster Continua ricerca aiuta gli utenti a riprendere il percorso di ricerca di viaggi precedente mostrando un elenco di query di ricerca che l'utente ha cercato di recente in tutte le sue app di viaggi. Il cluster verrà bloccato in seconda posizione, dopo le prenotazioni e prima dei cluster in evidenza e consigliati. A ogni partner sviluppatore sarà consentito trasmettere fino a tre entità nel cluster Continua la ricerca.
- PointOfInterestEntity:PointOfInterestEntity rappresenta un luogo di interesse come una stazione di servizio, un luogo per eventi, un parco a tema, un museo, un'attrazione turistica, un sentiero escursionistico e così via. Mette in evidenza i contenuti che l'utente ha cercato in precedenza.

Preparazione

Livello API minimo: 19

Aggiungi la libreria com.google.android.engage:engage-core alla tua app:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.6.0'
}

Riepilogo

Il design si basa su un'implementazione di un servizio associato.

I dati che un cliente può pubblicare sono soggetti ai seguenti limiti per i diversi tipi di cluster:

Tipo di cluster	Limiti del cluster	Limiti minimi delle entità in un cluster	Limiti massimi delle entità in un cluster
Cluster di consigli	Al massimo 7	Almeno 1	Al massimo 50 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity` o `PointOfInterestEntity`)
Cluster di prenotazione	Al massimo 1	Almeno 1	Al massimo 20 (`RestaurantReservationEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` o `VehicleRentalReservationEntity`)
Cluster in primo piano	Al massimo 1	Almeno 1	Al massimo 20 (`GenericFeaturedEntity`)
Continua con Cerca cluster	Al massimo 1	Almeno 1	Al massimo 3 (`PointOfInterestEntity`)

Passaggio 1: fornisci i dati dell'entità

L'SDK ha definito entità diverse per rappresentare ogni tipo di articolo. Supportiamo le seguenti entità per la categoria Viaggi ed eventi:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

I grafici riportati di seguito illustrano gli attributi e i requisiti disponibili per ogni tipo.

`GenericFeaturedEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Immagini poster	Obbligatorio	Mostreremo una sola immagine quando ne vengono fornite più di una. Le proporzioni consigliate sono 16:9. Nota:se viene fornito un badge, assicurati che ci sia uno spazio sicuro di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Titolo	Facoltativo	Titolo dell'entità.	Testo libero Dimensione del testo consigliata: 50 caratteri
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine. Trattamento UX speciale sopra l'immagine/il video, ad esempio come overlay del badge sull'immagine "Aggiornamento live" Durata di lettura dell'articolo
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`ArticleEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero Dimensione del testo consigliata: massimo 50 caratteri
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Le proporzioni consigliate sono 16:9. Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati che lo spazio sicuro sia di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Origine - Titolo	Facoltativo	Il nome dell'autore, dell'organizzazione o del giornalista	Testo libero Dimensione del testo consigliata: meno di 25 caratteri
Origine - Immagine	Facoltativo	Un'immagine della fonte, ad esempio l'autore, l'organizzazione o il reporter	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine. Trattamento UX speciale sopra l'immagine/il video, ad esempio come overlay del badge sull'immagine "Aggiornamento live" Durata di lettura dell'articolo
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
Ora di pubblicazione dei contenuti	Facoltativo	Questo è il timestamp dell'epoca in millisecondi relativo alla data di pubblicazione / aggiornamento dei contenuti nell'app.	Timestamp Unix epoch in millisecondi
Ora dell'ultimo coinvolgimento	Facoltativo	Il timestamp dell'epoca in millisecondi dell'ultima interazione dell'utente con questa entità.	Timestamp Unix epoch in millisecondi
Percentuale di avanzamento	Facoltativo	La percentuale dei contenuti completi consumati dall'utente finora.	Un valore int compreso tra 0 e 100 inclusi.
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`EventEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensione del testo consigliata: massimo 50 caratteri
Ora di inizio localizzata - Timestamp	Obbligatorio	Il timestamp Unix in cui è previsto l'inizio dell'evento.	Joda-Time Instant
Ora di inizio localizzata - Fuso orario	Obbligatorio	Il fuso orario in cui è previsto l'inizio dell'evento.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enumerazione: VIRTUAL, IN_PERSON o HYBRID
Immagini poster	Obbligatorio	Mostreremo una sola immagine quando ne vengono fornite più di una. Le proporzioni consigliate sono 16:9. Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati che lo spazio sicuro sia di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si svolge l'evento. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio condizionalmente	L'indirizzo o il nome della sede in cui si svolgerà l'evento che deve essere mostrato all'utente. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo stradale (se applicabile) della sede in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) della località in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Ora di fine	Facoltativo	Il timestamp Unix in cui è previsto il termine dell'evento. Nota:questo valore sarà rappresentato in millisecondi.	Timestamp Unix epoch in millisecondi
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine.
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale del biglietto/abbonamento per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/abbonamento per l'evento.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di stringhe enum idonee TYPE_MOVIES_AND_TV_SHOWS (esempio: cinema) TYPE_DIGITAL_GAMES (esempio: eSport) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga) TYPE_EDUCATION (esempio: classe) TYPE_SPORTS (Esempio: partita di football) TYPE_DATING (esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`LodgingEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensione del testo consigliata: massimo 50 caratteri
Immagini poster	Obbligatorio	Mostreremo una sola immagine quando ne vengono fornite più di una. Proporzioni consigliate: 16:9 Nota:se viene fornito un badge, assicurati che ci sia uno spazio sicuro di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Località - Paese	Obbligatorio	Il paese in cui si svolge il soggiorno.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova l'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio	L'indirizzo che verrà mostrato all'utente. Ti consigliamo di includere il nome della città ed eventualmente lo stato o il paese per la maggior parte dei casi d'uso. Includi solo l'indirizzo o il quartiere se l'utente si trova nelle vicinanze, se conosce la località o se la città è inclusa nel titolo del cluster. Se includi l'indirizzo stradale, fornisci un indirizzo conciso, utilizzando abbreviazioni ove possibile (ad esempio, "Via" per "Via", "Viale" per "Viale").	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) della struttura ricettiva.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) della struttura ricettiva.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) dell'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine.
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
AvailabilityTimeWindow - Localized Start Time - Timestamp	Facoltativo	Il timestamp dell'epoca in cui è previsto che la struttura ricettiva sia aperta/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Facoltativo	Il fuso orario in cui è previsto che la struttura ricettiva sia aperta/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
AvailabilityTimeWindow - Localized End Time - Timestamp	Facoltativo	Il timestamp dell'epoca fino al quale è previsto che la struttura ricettiva sia aperta/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Facoltativo	Il fuso orario in cui è previsto che la struttura ricettiva sia aperta/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore attuale della classificazione.	Numero >= 0,0
Valutazione - Valore attuale	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1 M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Valore conteggio, utilizzeremo Conteggio per la visualizzazione agli utenti	Lungo
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale dell'alloggio. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che verrà barrato nell'interfaccia utente.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`StoreEntity`

L'oggetto StoreEntity rappresenta un singolo negozio che gli sviluppatori partner vogliono pubblicare, ad esempio un ristorante o un locale popolare che siano rilevanti per l'esperienza di viaggio.

Attributo	Requisito	Descrizione	Formato
Immagini poster	Obbligatorio	È necessario fornire almeno un'immagine.	Per indicazioni, consulta Specifiche per le immagini.
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Facoltativo	Il nome del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Località	Facoltativo	La sede del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Callout	Facoltativo	Callout per mettere in evidenza una promozione, un evento o un aggiornamento per lo store, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Clausole del callout	Facoltativo	Testo delle clausole per il callout.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Descrizione	Facoltativo	Una descrizione del negozio.	Testo libero Dimensioni del testo consigliate: meno di 90 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Categoria	Facoltativo	Categoria di un negozio. Nel contesto dei ristoranti, può essere una cucina come "francese", "new american", "ramen", "fine dining".	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore attuale della classificazione.	Numero >= 0,0
Valutazione - Valore attuale	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1 M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Valore conteggio, utilizzeremo Conteggio per la visualizzazione agli utenti	Lungo
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`PointOfInterestEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensione del testo consigliata: massimo 50 caratteri
Immagini poster	Obbligatorio condizionalmente	Mostreremo una sola immagine quando ne vengono fornite più di una. Le proporzioni consigliate sono 16:9. Nota:l'immagine è obbligatoria se l'entità fa parte di un cluster di consigli. Se viene fornito un badge, assicurati che lo spazio sicuro sia di 24 dps sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Ora dell'ultimo coinvolgimento	Obbligatorio condizionalmente	Il timestamp Unix dell'ultima interazione dell'utente con questa entità. Nota:questo campo è obbligatorio se l'entità fa parte di continua a cercare il cluster.	Joda-Time Instant
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si trova il punto d'interesse. Nota:questo campo è obbligatorio se l'entità fa parte di un cluster di consigli.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio condizionalmente	La città in cui si trova il punto d'interesse. Nota:questo campo è obbligatorio se l'entità fa parte di un cluster di consigli.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio condizionalmente	L'indirizzo che verrà mostrato all'utente. Fornisci un indirizzo conciso, utilizzando abbreviazioni ove possibile (ad esempio, "Via" per "Via", "Viale" per "Viale"). Questa stringa potrebbe essere troncata a seconda del dispositivo e delle impostazioni dell'utente. Includi il nome della città per un'identificazione chiara. Nota:questo campo è obbligatorio se l'entità fa parte di un cluster di consigli.	Testo libero Dimensione del testo consigliata: massimo 35 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
AvailabilityTimeWindow - Localized Start Time - Timestamp	Facoltativo	Il timestamp dell'epoca in cui il punto d'interesse dovrebbe essere aperto/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Facoltativo	Il fuso orario in cui il punto d'interesse dovrebbe essere aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
AvailabilityTimeWindow - Localized End Time - Timestamp	Facoltativo	Il timestamp in formato Unix fino al quale il punto d'interesse dovrebbe essere aperto/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Facoltativo	Il fuso orario in cui il punto d'interesse dovrebbe essere aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine.
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore attuale della classificazione.	Numero >= 0,0
Valutazione - Valore attuale	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per il punto d'interesse. Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1 M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per il punto d'interesse. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Valore conteggio, utilizzeremo Conteggio per la visualizzazione agli utenti	Lungo
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale dei biglietti/dell'abbonamento per il punto di interesse. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dei biglietti/ingressi per il punto d'interesse.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di stringhe enum idonee TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (esempio: cinema) TYPE_MEDICAL (esempio: ospedale) TYPE_EDUCATION (esempio: scuola) TYPE_SPORTS (esempio: stadio) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`RestaurantReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensione del testo consigliata: massimo 50 caratteri
Ora di inizio della prenotazione localizzata - Timestamp	Obbligatorio	Il timestamp Unix in cui è previsto l'inizio della prenotazione.	Joda-Time Instant
Ora di inizio della prenotazione localizzata - Fuso orario	Obbligatorio	Il fuso orario in cui è previsto l'inizio della prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Località - Paese	Obbligatorio	Il paese in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio	L'indirizzo del pre-ristorante che verrà mostrato all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Proporzioni consigliate: 16:9	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Dimensione tabella	Facoltativo	Il numero di persone nel gruppo di prenotazione	Numero intero > 0
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`EventReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensione del testo consigliata: massimo 50 caratteri
Ora di inizio localizzata - Timestamp	Obbligatorio	Il timestamp Unix in cui è previsto l'inizio dell'evento.	Joda-Time Instant
Ora di inizio localizzata - Fuso orario	Obbligatorio	Il fuso orario in cui è previsto l'inizio dell'evento.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enumerazione: VIRTUAL, IN_PERSON o HYBRID
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si svolge l'evento. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio condizionalmente	L'indirizzo o il nome della sede in cui si svolgerà l'evento che deve essere mostrato all'utente. Nota: questo è necessario per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo stradale (se applicabile) della sede in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) della località in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Le proporzioni consigliate sono 16:9. Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati che lo spazio sicuro sia di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Ora di fine localizzata - Timestamp	Facoltativo	Il timestamp Unix in cui è previsto il termine dell'evento.	Joda-Time Instant
Ora di fine localizzata - Fuso orario	Facoltativo	Il fuso orario in cui è previsto che l'evento termini.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Testo libero. Ad esempio, il nome dell'organizzatore dell'evento/del tour
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (max 15 caratteri) o una piccola immagine.
Badge - Text	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta Specifiche per le immagini.
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione dell'evento.	Testo libero
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale del biglietto/abbonamento per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/abbonamento per l'evento.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore attuale della classificazione.	Numero >= 0,0
Valutazione - Valore attuale	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1 M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Valore conteggio, utilizzeremo Conteggio per la visualizzazione agli utenti	Lungo
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di stringhe enum idonee TYPE_MOVIES_AND_TV_SHOWS (esempio: cinema) TYPE_DIGITAL_GAMES (esempio: eSport) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga) TYPE_EDUCATION (esempio: classe) TYPE_SPORTS (Esempio: partita di football) TYPE_DATING (esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`LodgingReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Il tuo soggiorno dal 12 dicembre" Dimensione del testo consigliata: massimo 50 caratteri
Orario del check-in localizzato - Timestamp	Obbligatorio	Il timestamp Unix che rappresenta l'ora di check-in per la prenotazione.	Joda-Time Instant
Orario di check-in localizzato - Fuso orario	Obbligatorio	Il fuso orario in cui esiste l'ora del check-in per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Orario di check-out localizzato - Timestamp	Obbligatorio	Il timestamp Unix che rappresenta l'orario di check-out per la prenotazione.	Joda-Time Instant
Orario di check-out localizzato - Fuso orario	Obbligatorio	Il fuso orario in cui esiste l'orario di check-out per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Località - Paese	Obbligatorio	Il paese in cui si trova l'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova l'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Mostra indirizzo	Obbligatorio	L'indirizzo che verrà mostrato all'utente. Fornisci un indirizzo conciso, utilizzando abbreviazioni ove possibile (ad esempio, "Via" per "Via", "Viale" per "Viale"). Questa stringa potrebbe essere troncata a seconda del dispositivo e delle impostazioni dell'utente. Includi il nome della città per un'identificazione chiara.	Testo libero Dimensione del testo consigliata: massimo 35 caratteri
Sede - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) della struttura ricettiva.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Codice postale	Facoltativo	Il codice postale (se applicabile) della struttura ricettiva.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) dell'alloggio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Proporzioni consigliate: 16:9 Nota:se viene fornito un badge, assicurati che ci sia uno spazio sicuro di 24 dp sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione dell'alloggio.	Testo libero
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore attuale della classificazione.	Numero >= 0,0
Valutazione - Valore attuale	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1 M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Valore conteggio, utilizzeremo Conteggio per la visualizzazione agli utenti	Lungo
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale dell'alloggio. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che verrà barrato nell'interfaccia utente.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`TransportationReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "SFO to SAN" Dimensione del testo consigliata: massimo 50 caratteri
Tipo di trasporto	Obbligatorio	La modalità/il tipo di trasporto per la prenotazione.	Enum: FLIGHT, TRAIN, BUS o FERRY
Ora di partenza localizzata - Timestamp	Obbligatorio	Il timestamp Unix che rappresenta l'orario di partenza.	Joda-Time Instant
Orario di partenza localizzato - Fuso orario	Obbligatorio	Il fuso orario dell'orario di partenza.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Ora di arrivo localizzata - Timestamp	Obbligatorio	Il timestamp Unix che rappresenta l'ora di arrivo.	Joda-Time Instant
Orario di arrivo localizzato - Fuso orario	Obbligatorio	Il fuso orario dell'ora di arrivo.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Numero di trasporto	Obbligatorio	Il numero del volo, dell'autobus, del treno o del traghetto/della crociera.	Testo libero
Orario di imbarco localizzato - Timestamp	Obbligatorio	Il timestamp dell'epoca che rappresenta l'orario di imbarco per la prenotazione (se applicabile)	Joda-Time Instant
Orario di imbarco localizzato - Fuso orario	Obbligatorio	Il fuso orario dell'ora di imbarco per la prenotazione (se applicabile)	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Luogo di partenza - Paese	Facoltativo	Il paese di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Città	Facoltativo	La città di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Mostra indirizzo	Facoltativo	La località di partenza che verrà mostrata all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Luogo di partenza - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) della località di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Luogo di partenza - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Luogo di partenza - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Paese	Facoltativo	Il paese di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Città	Facoltativo	La città di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Mostra indirizzo	Facoltativo	La posizione di arrivo che verrà mostrata all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Luogo di arrivo - Indirizzo	Facoltativo	L'indirizzo fisico (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Luogo di arrivo - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Testo libero. Ad esempio, Nome compagnia aerea
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Proporzioni consigliate: 16:9	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione del trasporto.	Testo libero
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale della prenotazione. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che verrà barrato nell'interfaccia utente.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

`VehicleRentalReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app per fornitori. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Avis Union Square SF" Dimensione del testo consigliata: massimo 50 caratteri
Localized Pickup Time - Timestamp	Obbligatorio	Il timestamp Unix che rappresenta l'orario di ritiro della prenotazione.	Joda-Time Instant
Ora di ritiro localizzata - Fuso orario	Obbligatorio	Il fuso orario dell'ora di ritiro per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Ora di ritorno localizzata - Timestamp	Facoltativo	Il timestamp Unix che rappresenta l'orario di check-out per la prenotazione.	Joda-Time Instant
Ora di ritorno localizzata - Fuso orario	Facoltativo	Il fuso orario dell'ora di check-out per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche del fuso orario.
Indirizzo di ritiro - Paese	Facoltativo	Il paese del punto di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Città	Facoltativo	La città del punto di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Mostra indirizzo	Facoltativo	Il luogo di ritiro che verrà mostrato all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Indirizzo	Facoltativo	L'indirizzo (se applicabile) del luogo di ritiro.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Stato	Facoltativo	Lo stato o la provincia (se applicabile) del luogo di ritiro.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Codice postale	Facoltativo	Il codice postale (se applicabile) del punto di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Paese	Facoltativo	Il paese della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Città	Facoltativo	La città della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Indirizzo visualizzato	Facoltativo	La località di reso che verrà mostrata all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo per il reso - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di restituzione - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Testo libero. Ad esempio, "Avis Car Rental"
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota:per il fornitore di servizi è richiesto il testo o l'immagine.	Per indicazioni, consulta Specifiche per le immagini.
Immagini poster	Facoltativo	Mostreremo una sola immagine quando ne vengono fornite più di una. Proporzioni consigliate: 16:9	Per indicazioni, consulta Specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensione del testo consigliata: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno con una sola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID di conferma	Facoltativo	L'ID di conferma della prenotazione del noleggio auto.	Testo libero
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale della prenotazione. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che verrà barrato nell'interfaccia utente.	Testo libero
Callout prezzo	Facoltativo	Callout di prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare i puntini di sospensione)
DisplayTimeWindow (facoltativo) - Imposta un intervallo di tempo per la visualizzazione dei contenuti sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi
Timestamp finale	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più visualizzati sulla superficie. Se non è impostato, i contenuti sono idonei a essere visualizzati sulla piattaforma.	Timestamp Unix epoch in millisecondi

Specifiche per le immagini

Le specifiche richieste per gli asset immagine sono elencate in questa tabella:

Proporzioni	Numero minimo di pixel	Numero consigliato di pixel
Quadrato (1 x 1) Preferito	300x300	1200x1200
Orizzontale (1,91 x 1)	600x314	1200x628
Verticale (4x5)	480x600	960x1200

Proporzioni

Numero minimo di pixel

Numero consigliato di pixel

Quadrato (1 x 1)

Preferito

300x300

1200x1200

Orizzontale (1,91 x 1)

600x314

1200x628

Verticale (4x5)

480x600

960x1200

Le immagini devono essere ospitate su CDN pubbliche in modo che Google possa accedervi.

Formati file

PNG, JPG, GIF statico, WebP

Dimensioni massime del file

5120 kB

Altri consigli

Area di sicurezza dell'immagine: inserisci i contenuti importanti al centro dell'immagine in modo da occuparne l'80%.
Utilizza uno sfondo trasparente in modo che l'immagine possa essere visualizzata correttamente nelle impostazioni del tema scuro e chiaro.

Specifiche del fuso orario

Preferisci l'ID (ad es. "America/Los_Angeles") all'offset (ad es. "-07:00").

Esempio di utilizzo: DateTimeZone.forID("America/Los_Angeles")

Categoria di contenuti

La categoria di contenuti consente alle app di pubblicare contenuti appartenenti a più categorie. In questo modo, i contenuti vengono mappati con alcune delle categorie predefinite, ovvero:

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

Le immagini devono essere ospitate su CDN pubbliche in modo che Google possa accedervi.

Linee guida per l'utilizzo delle categorie di contenuti

Alcune entità come ArticleEntity e GenericFeaturedEntity sono idonee all'utilizzo di una qualsiasi delle categorie di contenuti. Per altre entità come EventEntity, EventReservationEntity, PointOfInterestEntity, solo un sottoinsieme di queste categorie è idoneo. Controlla l'elenco delle categorie idonee per un tipo di entità prima di compilare l'elenco.
Utilizza il tipo di entità specifico per alcune categorie di contenuti anziché una combinazione di entità generiche e ContentCategory:
- TYPE_MOVIES_AND_TV_SHOWS: consulta le entità della Guida all'integrazione di Watch prima di utilizzare le entità generiche.
- TYPE_BOOKS: consulta EbookEntity prima di utilizzare le entità generiche.
- TYPE_AUDIOBOOKS: consulta AudiobookEntity prima di utilizzare le entità generiche.
- TYPE_SHOPPING - Check out ShoppingEntity prima di utilizzare le entità generiche.
- TYPE_FOOD_AND_DRINK: consulta le entità della guida all'integrazione di Food prima di utilizzare le entità generiche.
Il campo ContentCategory è facoltativo e deve essere lasciato vuoto se i contenuti non appartengono a nessuna delle categorie menzionate in precedenza.
Se vengono fornite più categorie di contenuti, elencale in ordine di pertinenza per i contenuti, con la categoria di contenuti più pertinente al primo posto nell'elenco.

Passaggio 2: fornisci i dati del cluster

Ti consigliamo di eseguire il job di pubblicazione dei contenuti in background (ad esempio, utilizzando WorkManager) e pianificarlo regolarmente o in base a un evento (ad esempio, ogni volta che l'utente apre l'app o quando ha appena aggiunto qualcosa al carrello).

AppEngageTravelClient è responsabile della pubblicazione dei cluster.

Esistono le seguenti API per pubblicare i cluster nel client:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

Questa API viene utilizzata per verificare se il servizio è disponibile per l'integrazione e se i contenuti possono essere presentati sul dispositivo.

Per l'SDK Engage v1.6.0 e versioni successive (consigliato)

Puoi controllare la disponibilità del servizio per ogni tipo di cluster che intendi pubblicare. L'API isServiceAvailable accetta un oggetto richiesta, ServiceAvailabilityRequest, che contiene i tipi di cluster per i quali è necessario verificare la disponibilità del servizio. Puoi trovare i valori enum ClusterType richiesti per ServiceAvailabilityRequest nella tabella seguente.

Tipo di cluster	Costante del tipo di cluster	Valore intero
Sconosciuto	`TYPE_UNKNOWN`	0
Cluster di consigli	`TYPE_RECOMMENDATION`	1
Cluster in primo piano	`TYPE_FEATURED`	2
Continuation Cluster	`TYPE_CONTINUATION`	3
Cluster di gestione utenti	`TYPE_ENGAGEMENT`	8
Cluster di abbonamenti	`TYPE_SUBSCRIPTION`	12
Continua con Cerca cluster	`TYPE_CONTINUE_SEARCH`	13
Cluster di prenotazione	`TYPE_RESERVATION`	14

Kotlin

val request = ServiceAvailabilityRequest.Builder()
    .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
    .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
    .build()

client.isServiceAvailable(request).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val availabilityMap = task.result
        if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
            // Proceed with publishing continuation content
        }
        if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
}

Java

ServiceAvailabilityRequest request =
    new ServiceAvailabilityRequest.Builder()
        .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
        .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
        .build();

client.isServiceAvailable(request).addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        Map<Integer, Boolean> availabilityMap = task.getResult();
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
            // Proceed with publishing continuation content
        }
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
});

Funzionalità di disponibilità condizionata del servizio

Alcune app integrate richiedono una configurazione speciale che attiva e disattiva il servizio Engage in modo intermittente per ridurre i costi di pubblicazione. Questa strategia di importazione intermittente dei contenuti, sebbene possibile, influisce negativamente sull'utente e sul prodotto: i contenuti obsoleti non verranno presentati e alcune piattaforme non verranno pubblicate.

A partire dalla versione 1.6.0, l'SDK Engage consente di verificare la disponibilità di tipi di cluster specifici. Ciò offre maggiore flessibilità, in modo che se la strategia di contenuti intermittente è stata adottata da una determinata applicazione, alcuni tipi di cluster possono seguire questa strategia intermittente, mentre altri tipi di cluster sono sempre attivi (ad es. i cluster di continuazione).

Se il servizio Engage non deve essere attivato "continuamente" su tutti i dispositivi supportati per qualsiasi motivo ed è configurato per l'importazione intermittente per qualsiasi insieme di dispositivi, tutte le pubblicazioni dei cluster di continuazione (ad es. Prenotazione e Continua ricerca) saranno comunque attivate dalla configurazione predefinita e gli altri tipi di cluster verranno attivati e disattivati in modo intermittente. Se l'importazione intermittente si applica al tuo caso, ma questa configurazione predefinita non è adatta alle tue esigenze, contatta engage-developers@google.com.

Per le versioni dell'SDK precedenti alla 1.6.0 (deprecate)

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

`publishRecommendationClusters`

Questa API viene utilizzata per pubblicare un elenco di oggetti RecommendationCluster.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni in una transazione:

I dati RecommendationCluster esistenti del partner sviluppatore vengono rimossi.
I dati della richiesta vengono analizzati e archiviati nel cluster di consigli aggiornato.

In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`publishFeaturedCluster`

Questa API viene utilizzata per pubblicare un elenco di oggetti FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni in una transazione:

I dati FeaturedCluster esistenti del partner sviluppatore vengono rimossi.
I dati della richiesta vengono analizzati e archiviati nel cluster in primo piano aggiornato.

In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`publishReservationCluster`

Questa API viene utilizzata per pubblicare un oggetto ReservationCluster.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni in una transazione:

I dati ReservationCluster esistenti del partner sviluppatore vengono rimossi.
I dati della richiesta vengono analizzati e archiviati nel cluster di prenotazione aggiornato.

In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`publishContinueSearchCluster`

Questa API viene utilizzata per pubblicare un elenco di oggetti ContinueSearchCluster.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni in una transazione:

I dati ContinueSearchCluster esistenti del partner sviluppatore vengono rimossi.
I dati della richiesta vengono analizzati e archiviati nel cluster Continua la ricerca aggiornato.

In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`publishUserAccountManagementRequest`

Questa API viene utilizzata per pubblicare una scheda Accedi . L'azione di accesso indirizza gli utenti alla pagina di accesso dell'app, in modo che l'app possa pubblicare contenuti (o fornire contenuti più personalizzati).

I seguenti metadati fanno parte della scheda di accesso:

Attributo	Requisito	Descrizione
URI azione	Obbligatorio	Link diretto all'azione (ad es. alla pagina di accesso all'app)
Immagine	Facoltativo. Se non viene fornito, è necessario fornire il titolo.	Immagine mostrata sulla scheda Immagini con proporzioni 16:9 e risoluzione 1264 x 712
Titolo	Facoltativo: se non viene fornita, l'immagine è obbligatoria	Titolo sulla scheda
Testo di azione	Facoltativo	Testo visualizzato nella CTA (ad es. Accedi)
Sottotitolo	Facoltativo	Sottotitolo facoltativo sulla scheda

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni in una transazione:

I dati UserAccountManagementCluster esistenti del partner sviluppatore vengono rimossi.
I dati della richiesta vengono analizzati e archiviati nel cluster UserAccountManagementCluster aggiornato.

In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`updatePublishStatus`

Se per qualsiasi motivo aziendale interno nessuno dei cluster viene pubblicato, ti consigliamo vivamente di aggiornare lo stato di pubblicazione utilizzando l'API updatePublishStatus. Questo è importante perché :

Fornire lo stato in tutti gli scenari, anche quando i contenuti vengono pubblicati (STATUS == PUBLISHED), è fondamentale per compilare le dashboard che utilizzano questo stato esplicito per comunicare l'integrità e altre metriche della tua integrazione.
Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non è interrotto (STATUS == NOT_PUBLISHED), Google può evitare di attivare avvisi nei dashboard sull'integrità dell'app. Conferma che i contenuti non vengono pubblicati a causa di una situazione prevista dal punto di vista del fornitore.
Aiuta gli sviluppatori a fornire informazioni su quando i dati vengono pubblicati e quando no.
Google potrebbe utilizzare i codici di stato per invitare l'utente a eseguire determinate azioni nell'app in modo che possa visualizzare i contenuti dell'app o superare il problema.

L'elenco dei codici di stato di pubblicazione idonei è il seguente :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Se i contenuti non vengono pubblicati perché un utente non ha eseguito l'accesso, Google consiglia di pubblicare la scheda di accesso. Se per qualsiasi motivo i fornitori non sono in grado di pubblicare la scheda di accesso, ti consigliamo di chiamare l'API updatePublishStatus con il codice di stato NOT_PUBLISHED_REQUIRES_SIGN_IN

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

`deleteRecommendationClusters`

Questa API viene utilizzata per eliminare i contenuti dei cluster di consigli.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dai cluster di consigli. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`deleteFeaturedCluster`

Questa API viene utilizzata per eliminare i contenuti del cluster in primo piano.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster in primo piano. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`deleteReservationCluster`

Questa API viene utilizzata per eliminare i contenuti del cluster di prenotazione.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster di prenotazione. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`deleteUserManagementCluster`

Questa API viene utilizzata per eliminare i contenuti del cluster UserAccountManagement.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster UserAccountManagement. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`deleteContinueSearchCluster`

Questa API viene utilizzata per eliminare i contenuti del cluster Continua la ricerca.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster Continua la ricerca. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

`deleteClusters`

Questa API viene utilizzata per eliminare i contenuti di un determinato tipo di cluster.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .build());

Quando il servizio riceve la richiesta, rimuove i dati esistenti da tutti i cluster che corrispondono ai tipi di cluster specificati. I clienti possono scegliere di trasmettere uno o più tipi di cluster. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

Gestione degli errori

È consigliabile ascoltare il risultato dell'attività dalle API di pubblicazione in modo da poter intraprendere un'azione di follow-up per recuperare e inviare nuovamente un'attività riuscita.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

L'errore viene restituito come AppEngageException con la causa inclusa come codice di errore.

Codice di errore	Nome dell'errore	Nota
`1`	`SERVICE_NOT_FOUND`	Il servizio non è disponibile sul dispositivo specificato.
`2`	`SERVICE_NOT_AVAILABLE`	Il servizio è disponibile sul dispositivo specificato, ma non al momento della chiamata (ad esempio, è disattivato esplicitamente).
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	L'esecuzione dell'attività non è riuscita a causa di problemi di threading. In questo caso, può essere riprovato.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Il chiamante non è autorizzato a effettuare la chiamata di servizio.
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	La richiesta contiene dati non validi (ad esempio, più cluster del numero consentito).
`6`	`SERVICE_CALL_INTERNAL`	Si è verificato un errore lato servizio.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	La chiamata di servizio viene effettuata troppo spesso.

Passaggio 3: gestisci gli intent di trasmissione

Oltre a effettuare chiamate API per la pubblicazione di contenuti tramite un job, è anche necessario configurare un BroadcastReceiver per ricevere la richiesta di pubblicazione di contenuti.

Lo scopo degli intent di trasmissione è principalmente la riattivazione dell'app e la sincronizzazione forzata dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto spesso. Viene attivato solo quando il servizio Engage determina che i contenuti potrebbero essere obsoleti (ad esempio, una settimana). In questo modo, l'utente può avere maggiore fiducia di poter usufruire di un'esperienza con contenuti nuovi, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei due modi seguenti:

Registra dinamicamente un'istanza della classe BroadcastReceiver utilizzando Context.registerReceiver(). Ciò consente la comunicazione dalle applicazioni ancora attive in memoria.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

Dichiara staticamente un'implementazione con il tag <receiver> nel file AndroidManifest.xml. Ciò consente all'applicazione di ricevere intent di trasmissione quando non è in esecuzione e di pubblicare i contenuti.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

I seguenti intent vengono inviati dal servizio:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Ti consigliamo di avviare una chiamata publishRecommendationClusters quando ricevi questo intent.
com.google.android.engage.action.PUBLISH_FEATURED Ti consigliamo di avviare una chiamata publishFeaturedCluster quando ricevi questo intent.
com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH È consigliabile avviare una chiamata publishContinueSearchCluster quando ricevi questo intent.
com.google.android.engage.action.travel.PUBLISH_RESERVATION È consigliabile avviare una chiamata publishReservationCluster quando ricevi questo intent.

Workflow di integrazione

Per una guida passo passo su come verificare l'integrazione una volta completata, consulta Flusso di lavoro di integrazione per sviluppatori di Engage.

Domande frequenti

Consulta le Domande frequenti sull'SDK Engage per le domande frequenti.

Contatto

Contatta engage-developers@google.com in caso di domande durante la procedura di integrazione.

Passaggi successivi

Dopo aver completato questa integrazione, i passaggi successivi sono i seguenti:

Invia un'email a engage-developers@google.com e allega l'APK integrato pronto per il test da parte di Google.
Google esegue una verifica e un controllo interni per assicurarsi che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatterà con i dettagli necessari.
Al termine del test e se non sono necessarie modifiche, Google ti contatta per comunicarti che puoi iniziare a pubblicare l'APK aggiornato e integrato su Play Store.
Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i cluster Consigli, In evidenza, Prenotazione e Continua ricerca potrebbero essere pubblicati e visibili agli utenti.

Engage SDK Travel: istruzioni per l'integrazione tecnica di terze parti Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Dettaglio integrazione

Terminologia

Preparazione

Riepilogo

Passaggio 1: fornisci i dati dell'entità

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Specifiche per le immagini

Specifiche del fuso orario

Categoria di contenuti

Passaggio 2: fornisci i dati del cluster

isServiceAvailable

Per l'SDK Engage v1.6.0 e versioni successive (consigliato)

Kotlin

Java

Funzionalità di disponibilità condizionata del servizio

Per le versioni dell'SDK precedenti alla 1.6.0 (deprecate)

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteReservationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteContinueSearchCluster

Kotlin

Java

deleteClusters

Kotlin

Java

Gestione degli errori

Kotlin

Java

Passaggio 3: gestisci gli intent di trasmissione

Kotlin

Java

Workflow di integrazione

Domande frequenti

Contatto

Passaggi successivi

Engage SDK Travel: istruzioni per l'integrazione tecnica di terze parti

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishReservationCluster`

`publishContinueSearchCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`