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

Aumenta il coinvolgimento con l'app raggiungendo i tuoi utenti ovunque si trovino. Integra l'SDK Engage per fornire suggerimenti personalizzati e contenuti in continuità 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 circa una settimana di lavoro per gli sviluppatori della maggior parte delle app. Scopri di più sul nostro sito aziendale.

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

Supporto delle categorie e piattaforme

L'idoneità alla piattaforma dell'SDK Engage si basa sulla categoria di contenuti della tua app. Utilizza la tabella seguente per determinare la tua idoneità per piattaforme specifiche:

Stato	Categoria di contenuti o caso d'uso	Piattaforme supportate
Supportato (Idoneo su tutte le piattaforme)	Tutte le app Viaggi e informazioni locali (ad eccezione delle sottocategorie non supportate elencate in questa tabella) Eventi (tutte le sottocategorie) Attività, monitoraggio, pet sitting, pet walking	Raccolte Scheda App Play Store Scheda Tu del Play Store Pagina della scheda del Play Store
Non supportato	Monitoraggio voli

Competenze Android

Visualizza su GitHub

Integra l'SDK Engage

Utilizza la competenza Android dell'SDK Engage per integrare, eseguire il debug e risolvere i problemi di implementazione.

Per installare lo skill dalla CLI Android, esegui:

android skills add engage-sdk-integration

Dettaglio dell'integrazione

Questa sezione descrive in dettaglio i passaggi, i modelli di dati e la terminologia necessari per l'integrazione con l'SDK Engage per i contenuti di viaggi ed eventi.

Terminologia

Questa integrazione include i seguenti tipi di cluster: Contenuti consigliati, In primo piano, Prenotazione e Continua la 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, articoli di tendenza). Utilizzali per mostrare articoli, eventi, alloggi o consigli su luoghi di interesse.

  • Un cluster di consigli può essere composto da schede ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity o StoreEntity, ma non da un mix di tipi di entità diversi.

  I suggerimenti hanno la seguente struttura:

  • Cluster di contenuti consigliati:una visualizzazione dell'interfaccia utente che contiene un gruppo di contenuti consigliati dello stesso partner sviluppatore.

  • Entità: un oggetto che rappresenta un singolo elemento in un cluster. Questa integrazione offre alcune entità che verrebbero mostrate utilizzando il cluster di suggerimenti:

    • ArticleEntity: ArticleEntity rappresenta un consiglio per contenuti basati su testo relativi a viaggi ed eventi. Può essere utilizzato per articoli, post del blog, contenuti di marketing, snippet di notizie e così via.

      

      Figura 1: UI che mostra un singolo ArticleEntity all'interno del cluster di contenuti consigliati.

    • EventEntity: EventEntity rappresenta un evento che si verificherà in futuro. L'ora di inizio dell'evento è un'informazione fondamentale che deve essere comunicata agli utenti.

      

      Figura 2: UI che mostra un singolo EventEntity all'interno del cluster di contenuti consigliati.

    • LodgingEntity: LodgingEntity rappresenta un alloggio, come 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 di contenuti consigliati.

    • StoreEntity: StoreEntity rappresenta un negozio, un ristorante, un bar e così via. Evidenzia i contenuti in cui un locale o un negozio è l'informazione fondamentale che deve essere comunicata agli utenti.

      

      Figura 4: UI che mostra un singolo StoreEntity all'interno del cluster dei contenuti consigliati.

    • PointOfInterestEntity: PointOfInterestEntity rappresenta un luogo di interesse, ad esempio 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 un singolo PointOfInterestEntity all'interno del cluster Contenuti consigliati.

• Il cluster Prenotazione mostra i contenuti con cui gli utenti hanno interagito di recente da più partner sviluppatori in un unico raggruppamento dell'interfaccia utente. Ogni partner sviluppatore potrà 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 un singolo RestaurantReservationEntity all'interno di un cluster di prenotazioni.

  • 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 in un cinema, concerti, teatro, autografi
    • Prenotazioni di viaggi o punti di interesse, come tour guidati, biglietti per musei
    • Prenotazioni per eventi sociali / seminari / conferenze
    • Prenotazioni di sessioni di istruzione / formazione

    

    Figura 7. UI che mostra una singola EventReservationEntity all'interno di un cluster di prenotazioni.

  • LodgingReservationEntity: LodgingEntityReservation rappresenta una prenotazione di un alloggio per un viaggio e aiuta gli utenti a monitorare le prenotazioni di hotel o case vacanze imminenti o in corso.

    

    Figura 8. UI che mostra una singola entità LodgingReservationEntity all'interno di un cluster di prenotazioni.

  • TransportationReservationEntity: TransportationReservationEntity rappresenta la prenotazione di un trasporto con qualsiasi mezzo e aiuta gli utenti a monitorare le prenotazioni di voli, traghetti, treni, autobus, servizi di trasporto o crociere imminenti o in corso.

    

    Figura 9. UI che mostra una singola TransportationReservationEntity all'interno di un cluster di prenotazioni.

  • VehicleRentalReservationEntity: VehicleRentalReservationEntity rappresenta la prenotazione di un noleggio auto e aiuta gli utenti a monitorare le prenotazioni di noleggio auto imminenti o in corso.

    

    Figura 10. UI che mostra una singola entità VehicleRentalReservationEntity all'interno di un cluster di prenotazioni.

• Il cluster In primo piano mostra una selezione di entità di più partner sviluppatori in un unico raggruppamento dell'interfaccia utente. Ci sarà un unico cluster In evidenza, che viene visualizzato nella parte superiore della UI con un posizionamento prioritario sopra tutti i cluster di contenuti consigliati. Ogni partner sviluppatore potrà trasmettere fino a 10 entità nel cluster In evidenza.

  • GenericFeaturedEntity: GenericFeaturedEntity è diverso dall'elemento Recommendation in quanto l'elemento in primo piano deve essere utilizzato per un singolo contenuto principale degli sviluppatori e deve rappresentare il singolo 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 la ricerca aiuta gli utenti a riprendere il loro 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 viaggio. Il cluster verrà bloccato in seconda posizione, dopo le prenotazioni e prima dei cluster in primo piano e dei contenuti consigliati. Ogni partner sviluppatore potrà trasmettere fino a 3 entità nel cluster Continua la ricerca.

  • PointOfInterestEntity:PointOfInterestEntity rappresenta un luogo di interesse, ad esempio 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 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 sull'implementazione di un servizio associato.

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

Tipo di cluster	Limiti dei cluster	Limiti minimi delle entità in un cluster	Limiti massimi di entità in un cluster
Cluster di suggerimenti	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 il cluster di ricerca	Al massimo 1	Almeno 1	Al massimo 3 (PointOfInterestEntity)

Passaggio 1: fornisci i dati della persona giuridica

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

1. GenericFeaturedEntity
2. ArticleEntity
3. EventEntity
4. LodgingEntity
5. StoreEntity
6. PointOfInterestEntity
7. RestaurantReservationEntity
8. EventReservationEntity
9. LodgingReservationEntity
10. TransportationReservationEntity
11. VehicleRentalReservationEntity

I seguenti grafici illustrano gli attributi e i requisiti disponibili per ogni tipo.

GenericFeaturedEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Immagini del poster	Obbligatorio	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: 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 le specifiche per le immagini.
Titolo	Facoltativo	Titolo dell'entità.	Testo libero Dimensioni del testo consigliate: 50 caratteri
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine. Trattamento UX speciale sopra l'immagine/il video, ad esempio come overlay del badge sull'immagine "Aggiornamento in tempo reale" Durata della lettura dell'articolo
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

ArticleEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero Recommended text size: Max 50 chars
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo 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 le specifiche per le immagini.
Source - Title	Facoltativo	Il nome dell'autore, dell'organizzazione o del giornalista	Testo libero Dimensioni del testo consigliate: meno di 25 caratteri
Origine - Immagine	Facoltativo	Un'immagine della fonte, ad esempio l'autore, l'organizzazione, il giornalista	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine. Trattamento UX speciale sopra l'immagine/il video, ad esempio come overlay del badge sull'immagine "Aggiornamento in tempo reale" Durata della lettura dell'articolo
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le specifiche per le immagini.
Data/ora pubblicazione dei contenuti	Facoltativo	Questo è il timestamp dell'epoca in millisecondi relativo alla data di pubblicazione / aggiornamento dei contenuti nell'app.	Timestamp epoch in millisecondi
Last Engagement Time	Facoltativo	Il timestamp epoch in millisecondi dell'ultima interazione dell'utente con questa entità.	Timestamp epoch in millisecondi
Percentuale di avanzamento	Facoltativo	La percentuale dei contenuti completi consumati dall'utente fino ad oggi.	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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

EventEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Recommended text size: Max 50 chars
Ora di inizio localizzata - Timestamp	Obbligatorio	Il timestamp epoch 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 dei fusi orari.
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, di persona o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Immagini del poster	Obbligatorio	Se vengono fornite più immagini, ne mostreremo solo 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 le specifiche per le immagini.
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si svolge l'evento. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio condizionalmente	L'indirizzo o il nome della sede in cui si terrà l'evento che deve essere mostrato all'utente. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Via	Facoltativo	L'indirizzo (se applicabile) della sede in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) della località in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Ora di fine	Facoltativo	Il timestamp epoch in cui è prevista la fine dell'evento. Nota: questo valore verrà rappresentato in millisecondi.	Timestamp epoch in millisecondi
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine.
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le specifiche per le immagini.
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale del biglietto/pass per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Price - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/pass per l'evento.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 enum idonei TYPE_MOVIES_AND_TV_SHOWS (esempio: Cinema) TYPE_DIGITAL_GAMES (ad esempio, eSport) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (ad esempio, un corso di yoga) TYPE_EDUCATION (esempio: corso) TYPE_SPORTS (ad esempio, una partita di calcio) TYPE_DATING (esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo): imposta un intervallo di tempo per la visualizzazione di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

LodgingEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Recommended text size: Max 50 chars
Immagini del poster	Obbligatorio	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: 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 le specifiche per le immagini.
Località - Paese	Obbligatorio	Il paese in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Città	Obbligatorio	La città in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio	L'indirizzo che verrà mostrato all'utente. Per la maggior parte dei casi d'uso, ti consigliamo di includere il nome della città ed eventualmente dello stato o del paese. Includi la via o il quartiere solo se l'utente si trova nelle vicinanze della località, se la conosce o se la città è inclusa nel titolo del cluster. Se includi la via, fornisci un indirizzo sintetico, utilizzando abbreviazioni ove possibile (ad esempio, "St" per "Street", "Ave" per "Avenue").	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Via	Facoltativo	La via (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine.
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
AvailabilityTimeWindow - Localized Start Time - Timestamp	Facoltativo	Il timestamp epoch in cui è prevista l'apertura/la disponibilità dell'alloggio.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Facoltativo	Il fuso orario in cui l'alloggio dovrebbe essere aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
AvailabilityTimeWindow - Localized End Time - Timestamp	Facoltativo	Il timestamp dell'epoca fino al quale si prevede che l'alloggio sia aperto/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Facoltativo	Il fuso orario in cui l'alloggio dovrebbe essere aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore corrente della valutazione.	Numero >= 0,0
Rating - Current value	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 numero di valutazioni per l'alloggio. Nota:fornisci questo campo se la tua app vuole controllare il modo in cui viene visualizzato agli utenti. Fornisci la stringa concisa che può essere visualizzata per l'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su schermi di dimensioni ridotte.	Stringa
Rating - Count Value	Facoltativo	Il numero di valutazioni per l'alloggio. Nota: specifica questo campo se non vuoi gestire autonomamente la logica di abbreviazione della visualizzazione. Se sono presenti sia Count che Count Value, utilizzeremo Count 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
Price - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che viene barrato nell'interfaccia utente.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

StoreEntity

L'oggetto StoreEntity rappresenta un singolo negozio che i partner sviluppatori vogliono pubblicare, ad esempio un ristorante o un locale popolare pertinente all'esperienza di viaggio di una persona.

Attributo	Requisito	Descrizione	Formato
Immagini del poster	Obbligatorio	Devi fornire almeno un'immagine.	Per indicazioni, consulta le specifiche per le immagini.
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link 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 località 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 il negozio, 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 un tipo di cucina, ad esempio "francese", "nuova cucina americana", "ramen", "ristorazione di lusso".	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 corrente della valutazione.	Numero >= 0,0
Rating - Current value	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 numero di valutazioni per l'alloggio. Nota:fornisci questo campo se la tua app vuole controllare il modo in cui viene visualizzato agli utenti. Fornisci la stringa concisa che può essere visualizzata per l'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su schermi di dimensioni ridotte.	Stringa
Rating - Count Value	Facoltativo	Il numero di valutazioni per l'alloggio. Nota: specifica questo campo se non vuoi gestire autonomamente la logica di abbreviazione della visualizzazione. Se sono presenti sia Count che Count Value, utilizzeremo Count per la visualizzazione agli utenti	Lungo
DisplayTimeWindow (facoltativo): imposta un intervallo di tempo per la visualizzazione di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

PointOfInterestEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Recommended text size: Max 50 chars
Immagini del poster	Obbligatorio condizionalmente	Se vengono fornite più immagini, ne mostreremo solo 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 dp sia nella parte superiore che in quella inferiore dell'immagine	Per indicazioni, consulta le specifiche per le immagini.
Last Engagement Time	Obbligatorio condizionalmente	Il timestamp epoch dell'ultima interazione dell'utente con questa entità. Nota:questo campo è obbligatorio se l'entità fa parte del cluster di ricerca continua.	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 suggerimenti.	Testo libero Dimensioni del testo consigliate: 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 suggerimenti.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio condizionalmente	L'indirizzo che verrà mostrato all'utente. Fornisci un indirizzo sintetico, utilizzando le abbreviazioni ove possibile (ad esempio, "St" per "Street", "Ave" per "Avenue"). 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 suggerimenti.	Testo libero Dimensioni del testo consigliate: massimo ~35 caratteri
Località - Via	Facoltativo	La via (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il punto di interesse.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
AvailabilityTimeWindow - Localized Start Time - Timestamp	Facoltativo	Il timestamp epoch in cui è prevista l'apertura/disponibilità del punto di interesse.	Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone	Facoltativo	Il fuso orario in cui si prevede che il punto di interesse sia aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
AvailabilityTimeWindow - Localized End Time - Timestamp	Facoltativo	Il timestamp epoch fino al quale si prevede che il punto di interesse sia aperto/disponibile.	Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone	Facoltativo	Il fuso orario in cui si prevede che il punto di interesse sia aperto/disponibile.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine.
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore corrente della valutazione.	Numero >= 0,0
Rating - Current value	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 numero di valutazioni per il punto d'interesse. Nota:fornisci questo campo se la tua app vuole controllare il modo in cui viene visualizzato agli utenti. Fornisci la stringa concisa che può essere visualizzata per l'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su schermi di dimensioni ridotte.	Stringa
Rating - Count Value	Facoltativo	Il numero di valutazioni per il punto d'interesse. Nota: specifica questo campo se non vuoi gestire autonomamente la logica di abbreviazione della visualizzazione. Se sono presenti sia Count che Count Value, utilizzeremo Count per la visualizzazione agli utenti	Lungo
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale dei biglietti/pass di ingresso per il punto d'interesse. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Price - StrikethroughPrice	Facoltativo	Il prezzo originale dei biglietti/pass di ingresso per il punto d'interesse.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 enum idonei TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (esempio: cinema) TYPE_MEDICAL (ad esempio, ospedale) TYPE_EDUCATION (ad es. scuola) TYPE_SPORTS (ad esempio, stadio) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo): imposta un intervallo di tempo per la visualizzazione di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

RestaurantReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Recommended text size: Max 50 chars
Ora di inizio della prenotazione localizzata - Timestamp	Obbligatorio	Il timestamp epoch di inizio previsto della prenotazione.	Joda-Time Instant
Ora di inizio della prenotazione localizzata - Fuso orario	Obbligatorio	Il fuso orario in cui è prevista l'inizio della prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Località - Paese	Obbligatorio	Il paese in cui si trova il ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Città	Obbligatorio	La città in cui si trova il ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio	L'indirizzo del ristorante che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Via	Facoltativo	La via (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

EventReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Recommended text size: Max 50 chars
Ora di inizio localizzata - Timestamp	Obbligatorio	Il timestamp epoch 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 dei fusi orari.
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, di persona o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si svolge l'evento. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio condizionalmente	L'indirizzo o il nome della sede in cui si terrà l'evento che deve essere mostrato all'utente. Nota: questo campo è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Via	Facoltativo	L'indirizzo (se applicabile) della sede in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) della località in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si tiene l'evento.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo 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 le specifiche per le immagini.
Ora di fine localizzata - Timestamp	Facoltativo	Il timestamp epoch in cui è prevista la fine dell'evento.	Joda-Time Instant
Ora di fine localizzata - Fuso orario	Facoltativo	Il fuso orario in cui è prevista la fine dell'evento.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il fornitore di servizi è necessario il testo o l'immagine.	Testo libero. Ad esempio, il nome dell'organizzatore dell'evento o del tour
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota: per il fornitore di servizi è necessario il testo o l'immagine.	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
Badge	Facoltativo	Ogni badge è un testo libero (massimo 15 caratteri) o una piccola immagine.
Badge - Testo	Facoltativo	Titolo del badge Nota:per il badge è necessario un testo o un'immagine	Testo libero Dimensioni del testo consigliate: 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 le 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/pass per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Price - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/pass per l'evento.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 corrente della valutazione.	Numero >= 0,0
Rating - Current value	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 numero di valutazioni per l'evento. Nota:fornisci questo campo se la tua app vuole controllare il modo in cui viene visualizzato agli utenti. Fornisci la stringa concisa che può essere visualizzata per l'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su schermi di dimensioni ridotte.	Stringa
Rating - Count Value	Facoltativo	Il numero di valutazioni per l'evento. Nota: specifica questo campo se non vuoi gestire autonomamente la logica di abbreviazione della visualizzazione. Se sono presenti sia Count che Count Value, utilizzeremo Count per la visualizzazione agli utenti	Lungo
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonei TYPE_MOVIES_AND_TV_SHOWS (esempio: Cinema) TYPE_DIGITAL_GAMES (ad esempio, eSport) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (ad esempio, un corso di yoga) TYPE_EDUCATION (esempio: corso) TYPE_SPORTS (ad esempio, una partita di calcio) TYPE_DATING (esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.
DisplayTimeWindow (facoltativo): imposta un intervallo di tempo per la visualizzazione di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

LodgingReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Il tuo soggiorno dal 12 dicembre". Recommended text size: Max 50 chars
Localized Check-in Time - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'orario di check-in per la prenotazione.	Joda-Time Instant
Localized Check-in Time - Timezone	Obbligatorio	Il fuso orario in cui esiste l'orario di check-in per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Localized Check-out Time - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'ora di check-out della prenotazione.	Joda-Time Instant
Localized Check-out Time - Timezone	Obbligatorio	Il fuso orario in cui esiste l'orario di check-out per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Località - Paese	Obbligatorio	Il paese in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Città	Obbligatorio	La città in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Indirizzo visualizzato	Obbligatorio	L'indirizzo che verrà mostrato all'utente. Fornisci un indirizzo sintetico, utilizzando le abbreviazioni ove possibile (ad esempio, "St" per "Street", "Ave" per "Avenue"). 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 Dimensioni del testo consigliate: massimo ~35 caratteri
Località - Via	Facoltativo	La via (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Codice postale	Facoltativo	Il codice postale (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località - Quartiere	Facoltativo	Il quartiere (se applicabile) dell'alloggio.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: 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 le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 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 corrente della valutazione.	Numero >= 0,0
Rating - Current value	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 numero di valutazioni per l'alloggio. Nota:fornisci questo campo se la tua app vuole controllare il modo in cui viene visualizzato agli utenti. Fornisci la stringa concisa che può essere visualizzata per l'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su schermi di dimensioni ridotte.	Stringa
Rating - Count Value	Facoltativo	Il numero di valutazioni per l'alloggio. Nota: specifica questo campo se non vuoi gestire autonomamente la logica di abbreviazione della visualizzazione. Se sono presenti sia Count che Count Value, utilizzeremo Count 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
Price - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che viene barrato nell'interfaccia utente.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

TransportationReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "SFO to SAN" Recommended text size: Max 50 chars
Tipo di trasporto	Obbligatorio	La modalità/il tipo di trasporto per la prenotazione.	Enum: FLIGHT, TRAIN, BUS o FERRY
Localized Departure Time - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'orario di partenza.	Joda-Time Instant
Localized Departure Time - Timezone	Obbligatorio	Il fuso orario dell'orario di partenza.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Ora di arrivo localizzata - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'ora di arrivo.	Joda-Time Instant
Localized Arrival Time - Timezone	Obbligatorio	Il fuso orario dell'ora di arrivo.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Numero di trasporto	Obbligatorio	Il numero del volo, dell'autobus, del treno o del traghetto/della crociera.	Testo libero
Localized Boarding Time - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'orario di imbarco per la prenotazione (se applicabile)	Joda-Time Instant
Ora di imbarco localizzata - Fuso orario	Obbligatorio	Il fuso orario dell'orario di imbarco per la prenotazione (se applicabile)	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Località di partenza - Paese	Facoltativo	Il paese di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Città	Facoltativo	La città di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Indirizzo visualizzato	Facoltativo	La località di partenza che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Via	Facoltativo	La via (se applicabile) della località di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di partenza - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Paese	Facoltativo	Il paese di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Città	Facoltativo	La città di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Indirizzo visualizzato	Facoltativo	La località di arrivo che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Via	Facoltativo	La via (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Stato	Facoltativo	La provincia o lo stato (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Località di arrivo - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il fornitore di servizi è necessario il testo o l'immagine.	Testo libero. Ad esempio, nome della compagnia aerea
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota: per il fornitore di servizi è necessario il testo o l'immagine.	Per indicazioni, consulta le specifiche per le immagini.
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 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
Price - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che viene barrato nell'interfaccia utente.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

VehicleRentalReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Deep link all'entità nell'app del fornitore. Nota: puoi utilizzare i deep link per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Avis Union Square SF" Recommended text size: Max 50 chars
Localized Pickup Time - Timestamp	Obbligatorio	Il timestamp epoch che rappresenta l'orario di ritiro della prenotazione.	Joda-Time Instant
Localized Pickup Time - Timezone	Obbligatorio	Il fuso orario dell'orario di ritiro per la prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Ora di ritorno localizzata - Timestamp	Facoltativo	Il timestamp epoch che rappresenta l'orario di check-out della prenotazione.	Joda-Time Instant
Ora di ritorno localizzata - Fuso orario	Facoltativo	Il fuso orario dell'orario di check-out della prenotazione.	Joda-Time DateTimeZone Per indicazioni, consulta Specifiche dei fusi orari.
Pickup Address - Country	Facoltativo	Il paese del punto di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Città	Facoltativo	La città del punto di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Indirizzo visualizzato	Facoltativo	La località di ritiro che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Via	Facoltativo	La via (se applicabile) del punto di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Stato	Facoltativo	La provincia o lo stato (se applicabile) della località di ritiro.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Codice postale	Facoltativo	Il codice postale (se applicabile) del punto di ritiro.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di ritiro - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto di partenza.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Return Address - Country	Facoltativo	Il paese della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo per il reso - Città	Facoltativo	La città della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di reso - Indirizzo di visualizzazione	Facoltativo	La località di reso che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo per il reso - Via	Facoltativo	La via (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo di reso - Stato	Facoltativo	La provincia o lo stato (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo per il reso - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Indirizzo per il reso - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo ~20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il fornitore di servizi è necessario 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 è necessario il testo o l'immagine.	Per indicazioni, consulta le specifiche per le immagini.
Immagini del poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo che descrive l'entità. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno composto da una singola riga di testo. Nota: all'utente verrà mostrato l'elenco delle descrizioni o dei sottotitoli, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: massimo 50 caratteri
ID di conferma	Facoltativo	L'ID di conferma della prenotazione del noleggio del veicolo.	Testo libero
Price - CurrentPrice	Obbligatorio condizionalmente	Il prezzo attuale della prenotazione. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Price - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che viene barrato nell'interfaccia utente.	Testo libero
Callout di prezzo	Facoltativo	Callout del prezzo per mostrare una promozione, un evento o uno sconto per gli abbonati, 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 di un contenuto sulla piattaforma
Timestamp di inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Timestamp di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più mostrati sulla piattaforma. Se non viene impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

Specifiche per le immagini

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

Proporzioni	Numero minimo di pixel	Numero consigliato di pixel
Immagine quadrata (1 x 1). Preferred	300x300	1200x1200
Immagine 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 per l'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 dei temi scuro e chiaro.

Specifiche del fuso orario

Preferisci l'ID (ad esempio "America/Los_Angeles") all'offset (ad esempio "-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

1. Alcune entità come ArticleEntity e GenericFeaturedEntity sono idonee a utilizzare una qualsiasi delle categorie di contenuti. Per altre entità come EventEntity, EventReservationEntity, PointOfInterestEntity, è idoneo solo un sottoinsieme di queste categorie. Controlla l'elenco delle categorie idonee per un tipo di entità prima di compilarlo.

2. 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: consulta ShoppingEntity prima di utilizzare le entità generiche.
   • TYPE_FOOD_AND_DRINK: controlla le entità della guida all'integrazione di Food prima di utilizzare le entità generiche.

3. Il campo ContentCategory è facoltativo e deve essere lasciato vuoto se i contenuti non appartengono a nessuna delle categorie menzionate in precedenza.

4. Se vengono fornite più categorie di contenuti, forniscile in ordine di pertinenza rispetto ai contenuti, con la categoria di contenuti più pertinente posizionata per prima 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 di pianificarlo regolarmente o in base a un evento (ad esempio ogni volta che l'utente apre l'app o quando aggiunge un articolo al carrello).

AppEngageTravelClient è responsabile dei cluster publisher.

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)

Competenze Android

Visualizza su GitHub

Integrazione dell'SDK Engage

Per installare lo skill dalla CLI Android, esegui:

android skills add engage-sdk-integration

Se il tuo team utilizza strumenti di programmazione AI (come Gemini in Android Studio), puoi automatizzare questa migrazione chiedendo all'assistente AI:

Use the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.

Puoi verificare la disponibilità del servizio per ogni tipo di cluster che intendi pubblicare. L'API isServiceAvailable accetta un oggetto di richiesta, ServiceAvailabilityRequest, che contiene i tipi di cluster per i quali deve essere verificata 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 suggerimenti	TYPE_RECOMMENDATION	1
Cluster in primo piano	TYPE_FEATURED	2
Cluster di continuazione	TYPE_CONTINUATION	3
Cluster di gestione utenti	TYPE_ENGAGEMENT	8
Cluster di sottoscrizione	TYPE_SUBSCRIPTION	12
Continua il cluster di ricerca	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à del servizio condizionale

Alcune app integrate richiedono una configurazione speciale che attiva e disattiva il servizio Engage in modo intermittente per ridurre i costi di pubblicazione. Tuttavia, questa strategia di importazione di contenuti intermittente influisce negativamente sull'esperienza utente: 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. Se la tua app utilizza l'importazione intermittente:

• I cluster di continuazione (come Prenotazione e Continua la ricerca) rimangono attivi per impostazione predefinita su tutti i dispositivi supportati.
• Altri tipi di cluster (come i suggerimenti) vengono attivati e disattivati a intermittenza.

Se questa configurazione predefinita non è adatta alle tue esigenze, contatta [e-mail].

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

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.
    }
});

Nota: ti consigliamo vivamente di mantenere in esecuzione un job periodico per verificare se il servizio diventa disponibile in un secondo momento. La disponibilità del servizio potrebbe cambiare con gli upgrade della versione di Android, gli upgrade, le installazioni e le disinstallazioni delle app. Garantendo controlli periodici dei job a un determinato intervallo di tempo, i dati possono essere pubblicati una volta che il servizio diventa disponibile.

publishRecommendationClusters

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

Importante: le API di pubblicazione sono API di upsert, ovvero sostituiscono i contenuti esistenti. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, in quanto le API di pubblicazione lo fanno intrinsecamente.

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 all'interno di una transazione:

• I dati RecommendationCluster esistenti del partner sviluppatore vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster di suggerimenti 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.

Importante: le API di pubblicazione sono API di upsert, ovvero sostituiscono i contenuti esistenti. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, in quanto le API di pubblicazione lo fanno intrinsecamente.

Kotlin

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

Java

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

Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni all'interno di 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.

Importante: le API di pubblicazione sono API di upsert, ovvero sostituiscono i contenuti esistenti. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, in quanto le API di pubblicazione lo fanno intrinsecamente.

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 all'interno di 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.

Importante: le API di pubblicazione sostituiscono i contenuti esistenti. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, in quanto le API di pubblicazione lo fanno intrinsecamente.

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 all'interno di 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 tessera di accesso . 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 Accedi:

Attributo	Requisito	Descrizione
URI azione	Obbligatorio	Deep link all'azione (ad es. rimanda 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 di 1264 x 712
Titolo	Facoltativo. Se non viene fornito, è necessario fornire l'immagine	Titolo sulla scheda
Testo di azione	Facoltativo	Testo mostrato nella CTA (ad es. Accedi)
Sottotitolo	Facoltativo	Sottotitolo facoltativo sulla scheda

Importante: le API di pubblicazione sono API di upsert, ovvero sostituiscono i contenuti esistenti. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, in quanto le API di pubblicazione lo fanno intrinsecamente.

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 all'interno di 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 sono 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 nelle dashboard di 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 Accedi. Se per qualsiasi motivo i fornitori non sono in grado di pubblicare la scheda di accesso, 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());

deleteRecommendationsClusters

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

Kotlin

client.deleteRecommendationsClusters()

Java

client.deleteRecommendationsClusters();

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

Nota: questa API è disponibile dalla versione 1.1.0 in poi.

deleteFeaturedCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile dalla versione 1.1.0 in poi.

deleteReservationCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile dalla versione 1.1.0 in poi.

deleteUserManagementCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile dalla versione 1.1.0 in poi.

deleteContinueSearchCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile dalla versione 1.5.6 in poi.

deleteClusters

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare le API di eliminazione e pubblicazione successivamente per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta [e-mail] prima di utilizzare le API di eliminazione.

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 corrispondenti ai tipi di cluster specificati. I client possono scegliere di passare uno o più tipi di cluster. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

Gestione degli errori

Ti consigliamo vivamente di 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 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 è disponibile 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, è possibile riprovare.
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, un numero di cluster superiore a quello consentito).
6	SERVICE_CALL_INTERNAL	Si è verificato un errore lato servizio.
7	SERVICE_CALL_RESOURCE_EXHAUSTED	La chiamata di servizio viene effettuata troppo di frequente.

Passaggio 3: gestisci gli intent di trasmissione

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

L'obiettivo 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 di frequente. Viene attivato solo quando il servizio Engage determina che i contenuti potrebbero essere obsoleti (ad esempio, risalenti a una settimana prima). In questo modo, è più probabile che l'utente possa usufruire di un'esperienza con contenuti aggiornati, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei seguenti due modi:

• Registra dinamicamente un'istanza della classe BroadcastReceiver utilizzando Context.registerReceiver(). In questo modo, le applicazioni ancora attive in memoria possono comunicare.

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. In questo modo, l'applicazione può ricevere intent di trasmissione quando non è in esecuzione e può anche 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>

Il servizio invia i seguenti intent:

• 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 Ti consigliamo di avviare una chiamata publishContinueSearchCluster quando ricevi questo intent.
• com.google.android.engage.action.travel.PUBLISH_RESERVATION Ti consigliamo di avviare una chiamata publishReservationCluster quando ricevi questo intent.

Workflow di integrazione

Per una guida passo passo sulla verifica dell'integrazione una volta completata, consulta il flusso di lavoro di integrazione per gli sviluppatori di Engage.

Domande frequenti

Per le domande frequenti, consulta Domande frequenti sull'SDK Engage.

Contatto

Contatta [e-mail] in caso di domande durante il processo di integrazione.

Passaggi successivi

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

• Invia un'email all'indirizzo [e-mail] e allega l'APK integrato pronto per essere testato da Google.
• Google esegue una verifica e dei controlli interni per assicurarsi che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatterà con tutti i dettagli necessari.
• Al termine dei test, se non sono necessarie modifiche, Google ti contatta per comunicarti che puoi iniziare a pubblicare l'APK aggiornato e integrato sul Play Store.
• Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i cluster Contenuti consigliati, In primo piano, Prenotazione e Continua la ricerca potrebbero essere pubblicati e visibili agli utenti.