Coinvolgimento in altri verticali dell'SDK: istruzioni per l'integrazione tecnica di terze parti

Google sta creando una piattaforma on-device che organizza le app degli utenti per verticali e consente una nuova esperienza immersiva per la scoperta e il consumo di contenuti personalizzati delle app. Questa esperienza a schermo intero offre agli sviluppatori partner l'opportunità di mostrare i loro migliori contenuti avanzati in un canale dedicato al di fuori della loro app.

Questo documento contiene istruzioni per gli sviluppatori partner per integrare nuovi contenuti come prenotazioni, eventi, alloggi, luoghi di interesse, persone e altri contenuti che potrebbero non appartenere a nessuna di queste categorie utilizzando l'SDK Engage per compilare questa nuova area.

Dettaglio dell'integrazione

Terminologia

Questa integrazione include i seguenti tre tipi di cluster: Consiglio, In evidenza e Continuazione.

• I cluster di consigli mostrano suggerimenti personalizzati di un singolo partner sviluppatore. Si tratta di una visualizzazione dell'interfaccia utente che contiene un gruppo di consigli dello stesso sviluppatore partner.

  • ArticleEntity: ArticleEntity che rappresenta un consiglio basato su testo per contenuti pertinenti a più categorie di contenuti. L'elemento ArticleEntity consente agli sviluppatori di fornire una varietà di contenuti di testo e immagini con più metadati per articolare le informazioni agli utenti rispetto a GenericFeaturedEntity. Esempio: contenuti di marketing, Snippet di notizie

    

    Figura 1: interfaccia utente che mostra una singola entità ArticleEntity all'interno del cluster Recommendations.

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

    

    Figura 2: interfaccia utente che mostra una singola entità Event nel cluster Recommendations.

  • LodgingEntity: LodgingEntity rappresenta una struttura, ad esempio un hotel, un appartamento, una casa vacanze per locazioni di breve e lunga durata.

    

    Figura 3: interfaccia utente che mostra una singola entità Lodging nel cluster Recommendations.

  • StoreEntity: rappresenta un negozio, un ristorante, un caffè e così via. Mette in evidenza i contenuti in cui un ristorante o un negozio è l'informazione fondamentale da trasmettere agli utenti.

    

    Figura 4: interfaccia utente che mostra una singola entità Store nel cluster Recommendations.

  • PointOfInterestEntity: PointOfInterestEntity rappresenta un punto d'interesse come una stazione di servizio, un luogo di eventi, un parco tematico, un museo, un'attrazione turistica, un sentiero escursionistico e così via. Mette in evidenza i contenuti in cui la posizione è un'informazione fondamentale che deve essere comunicata agli utenti. Non deve essere utilizzato per un alloggio, un negozio o un ristorante.

    

    Figura 5: UI che mostra un singolo PointOfinterestEntity all'interno del cluster Recommendations.

  • PersonEntity: PersonEntity rappresenta una persona. I consigli potrebbero essere finalizzati a mettere in evidenza una persona in categorie come salute e fitness, sport, appuntamenti e così via.

    

    Figura 5: UI che mostra una singola PersonEntity all'interno del cluster Recommendations.

• Il cluster Continuazione mostra i contenuti con cui gli utenti di più sviluppatori partner hanno interagito di recente in un unico raggruppamento dell'interfaccia utente. Ogni sviluppatore partner potrà trasmettere un massimo di 10 entità nel cluster di continuazione.

  I contenuti di continuazione possono avere la seguente struttura:

  • ArticleEntity: ArticleEntity che rappresenta un consiglio basato su testo per contenuti pertinenti a più categorie di contenuti. Questa entità può essere utilizzata per rappresentare articoli di notizie non completati o altri contenuti che l'utente vorrebbe continuare a consumare da dove li ha interrotti. Esempio: contenuti di marketing, snippet di notizie

    

    Figura 6. Interfaccia utente che mostra una singola entità ArticleEntity all'interno di un cluster di continuazione.

  • RestaurantReservationEntity: RestaurantReservationEntity rappresenta una prenotazione per un ristorante o una caffetteria e aiuta gli utenti a monitorare le prenotazioni di ristoranti imminenti o in corso.

    

    Figura 7. Interfaccia utente che mostra un singolo RestaurantReservationEntity all'interno di un cluster di continuazione.

  • EventReservationEntity: EventReservationEntity rappresenta una prenotazione per un evento e aiuta gli utenti a monitorare le prenotazioni di eventi imminenti o in corso. Gli eventi possono includere, a titolo esemplificativo:

    • Eventi sportivi come la prenotazione di una partita di calcio
    • Eventi di gioco come prenotazioni per gli eSport
    • Eventi di intrattenimento come la prenotazione di film al cinema, un concerto, un teatro,
    • Prenotazioni di viaggi o punti di interesse come tour guidati, biglietti di musei
    • Prenotazioni per eventi sociali, seminari e conferenze
    • Prenotazioni di sessioni di istruzione/formazione

    

    Figura 8. UI che mostra un singolo EventReservationEntity all'interno di un cluster Continuation.

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

    

    Figura 9. Interfaccia utente che mostra un singolo LodgingReservationEntity all'interno di un cluster di continuazione.

  • TransportationReservationEntity: rappresenta una prenotazione per qualsiasi mezzo di trasporto e aiuta gli utenti a monitorare le prenotazioni di voli, traghetti, treni, autobus, ride-hailing o crociere in programma o in corso.

    

    Figura 10. Interfaccia utente che mostra una singola entità TransportationReservationEntity all'interno di un cluster di continuazione.

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

    

    Figura 11. Interfaccia utente che mostra un singolo VehicleRentalReservationEntity all'interno di un cluster di continuazione.

• Il cluster In primo piano è una visualizzazione UI che mostra l'hero GenericFeaturedEntity scelto da molti sviluppatori partner in un unico raggruppamento della UI. Esiste un unico cluster in primo piano, visualizzato nella parte superiore dell'UI, con un posizionamento prioritario sopra tutti i cluster di consigli. Ogni sviluppatore partner è autorizzato a trasmettere una singola entità di un tipo supportato in In primo piano, con molte entità (potenzialmente di tipi diversi) di più sviluppatori di app nel cluster In primo piano.

  • GenericFeaturedEntity: GenericFeaturedEntity è diverso dall'elemento Recommendation in quanto l'elemento In primo piano deve essere utilizzato per un singolo contenuto di primo piano degli sviluppatori e deve rappresentare il singolo contenuto più importante che sarà interessante e pertinente per gli utenti.

    

    Figura 12: interfaccia utente che mostra una singola scheda di entità in primo piano GenericFeaturedEntity all'interno di un cluster in primo piano

Attività preliminare

Livello API minimo: 19

Aggiungi la raccolta 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.5.2'
}

Riepilogo

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

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

Tipo di cluster	Limiti del cluster	Limiti minimi di entità in un cluster	Limiti massimi di entità in un cluster
Cluster di consigli	Al massimo 5	Almeno 5	Massimo 25 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity, PointOfInterestEntity o PersonEntity)
Cluster di continuazione	Al massimo 1	Almeno 1	Al massimo 10 (ArticleEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity o VehicleRentalReservationEntity)
Cluster in primo piano	Al massimo 1	Almeno 1	Al massimo 10 (GenericFeaturedEntity)

Passaggio 1: fornisci i dati delle entità

L'SDK ha definito entità diverse per rappresentare ogni tipo di elemento. Supportiamo le seguenti entità per la categoria Altro:

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

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

GenericFeaturedEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Immagini poster	Obbligatorio	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi 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 per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni. Trattamento UX speciale sopra l'immagine o il video, ad esempio come overlay 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 Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta 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.

ArticleEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Origine - Titolo	Facoltativo	Il nome dell'autore, dell'organizzazione o dell'autore della segnalazione	Testo libero Dimensioni del testo consigliate: meno di 25 caratteri
Fonte - Immagine	Facoltativo	Un'immagine della fonte, ad esempio l'autore, l'organizzazione, il reporter	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni. Trattamento UX speciale sopra l'immagine o il video, ad esempio come overlay 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 Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
Ora di pubblicazione dei contenuti	Facoltativo	Si tratta del timestamp epoch in millisecondi relativo alla data e all'ora in cui i contenuti sono stati pubblicati/aggiornati nell'app.	Timestamp epoch in millisecondi
Durata ultimo coinvolgimento	Obbligatorio condizionalmente	Il timestamp dell'epoca in millisecondi durante l'ultima volta che l'utente ha interagito con questa entità. Nota: questo campo è obbligatorio se l'entità fa parte del cluster di continuazione.	Timestamp epoch in millisecondi
Percentuale di avanzamento	Obbligatorio condizionalmente	La percentuale dei contenuti completi consumati dall'utente fino ad oggi. Nota: questo campo è obbligatorio se l'entità fa parte del cluster di continuazione.	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.

EventEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio	Obbligatorio	Il timestamp dell'epoca in cui è previsto l'inizio dell'evento. Nota: questo valore verrà rappresentato in millisecondi.	Timestamp in millisecondi
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Immagini dei 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 di lasciare uno spazio sicuro di 24 dpi 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 valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato	Obbligatorio in modo condizionale	L'indirizzo o il nome del luogo in cui si svolgerà l'evento da mostrare all'utente. Nota: questo valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della sede in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui viene ospitato l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) della località in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Ora di fine	Facoltativo	Il timestamp epoch in cui è previsto il termine dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp in millisecondi
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
Prezzo - CurrentPrice	Obbligatorio condizionalmente	Il prezzo corrente del biglietto/del pass per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/del pass per l'evento.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare 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 (esempio: eSports) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga) TYPE_EDUCATION (esempio: Corso) TYPE_SPORTS (esempio: partita di calcio) TYPE_DATING (Esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.

LodgingEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Obbligatorio	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi 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 la struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova la struttura ricettiva.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Indirizzo visualizzato	Obbligatorie	L'indirizzo della struttura ricettiva che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova la struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
AvailabilityTimeWindow - Start Time	Facoltativo	Il timestamp dell'epoca in millisecondi in cui la struttura dovrebbe essere aperta/disponibile.	Timestamp epoch in millisecondi
AvailabilityTimeWindow - End Time	Facoltativo	Il timestamp epoch in millisecondi fino al quale la struttura dovrebbe essere aperta/disponibile.	Timestamp epoch in millisecondi
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
Classificazione - Valore corrente	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 la struttura. Nota: fornisci questo campo se la tua app controlla il modo in cui il conteggio viene visualizzato agli utenti. Utilizza una stringa concisa. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare un'abbreviazione come 1M in modo che il conteggio non venga troncato in caso di dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non gestisci personalmente la logica per l'abbreviazione del display. Se sono presenti sia Conteggio sia Valore conteggio, viene visualizzato Conteggio.	Lungo
Prezzo - CurrentPrice	Obbligatorio condizionalmente	Il prezzo corrente della struttura. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della struttura, barrato nell'UI.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)

StoreEntity

L'oggetto StoreEntity rappresenta un singolo negozio che gli sviluppatori partner vogliono pubblicare, ad esempio un ristorante o un negozio di alimentari.

Attributo	Requisito	Descrizione	Formato
Immagini poster	Obbligatorie	Devi specificare almeno un'immagine.	Per indicazioni, consulta le specifiche per le immagini.
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Facoltativo	Il nome del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Posizione	Facoltativo	La sede del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Callout	Facoltativo	Callout per mostrare 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 puntini di sospensione)
Clausole dei callout	Facoltativo	Testo in caratteri di testo in caratteri piccoli per il callout.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Descrizione	Facoltativo	Una descrizione del negozio.	Testo libero Dimensioni del testo consigliate: meno di 90 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati 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
Classificazione - Valore corrente	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 la struttura. Nota: fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione di visualizzazione. Se sono presenti sia Conteggio che Conteggio, utilizzeremo il valore di Conteggio per mostrarlo agli utenti	Lungo

PointOfInterestEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Obbligatorio	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta le Specifiche delle immagini.
Località - Paese	Obbligatorie	Il paese in cui si trova il punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova il punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Indirizzo visualizzato	Obbligatorie	L'indirizzo del punto d'interesse che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il punto di interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto d'interesse.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
AvailabilityTimeWindow - Start Time	Facoltativo	Il timestamp epoch in millisecondi in cui si prevede che il punto d'interesse sia aperto/disponibile.	Timestamp in millisecondi
AvailabilityTimeWindow - End Time	Facoltativo	Il timestamp epoch in millisecondi fino al quale il punto di interesse dovrebbe essere aperto/disponibile.	Timestamp epoch in millisecondi
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensione del testo consigliata 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
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per il punto d'interesse. Nota: fornisci questo campo se la tua app controlla il modo in cui il conteggio viene visualizzato agli utenti. Utilizza una stringa concisa. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare un'abbreviazione come 1 M, in modo che il conteggio non venga troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per il punto d'interesse. Nota:fornisci questo campo se non gestisci autonomamente la logica di visualizzazione dell'abbreviazione. Se sono presenti sia Conteggio che Valore conteggio, Conteggio viene visualizzato agli utenti	Lungo
Prezzo - CurrentPrice	Obbligatorio condizionalmente	Il prezzo corrente dei biglietti/dell'abbonamento per il punto di interesse. Deve essere fornito se viene indicato il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dei biglietti/dell'abbonamento per il punto d'interesse.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe essere visualizzato con 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: teatro) TYPE_MEDICAL (esempio: ospedale) TYPE_EDUCATION (esempio: scuola) TYPE_SPORTS (esempio: stadio) Per indicazioni, consulta la sezione Categoria di contenuti.

PersonEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Profilo - Nome	Obbligatorio	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel" e così via.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Profilo - Avatar	Obbligatorio	Immagine del profilo o dell'avatar dell'utente. Nota: deve essere un'immagine quadrata 1:1.	Per indicazioni, consulta le specifiche per le immagini.
Profilo - Testo aggiuntivo	Facoltativo	Testo libero, ad esempio l'handle del profilo.	Testo libero Dimensioni del testo consigliate: massimo 15 caratteri
Profilo - Immagine aggiuntiva	Facoltativo	Immagine piccola, ad esempio un badge di verifica.	Per indicazioni, consulta le Specifiche delle immagini.
Immagine intestazione	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 di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta le specifiche per le immagini.
Popolarità - Conteggio	Facoltativo	Indica il numero di follower o il valore di popolarità, ad esempio "3,7 M". Nota: se vengono forniti sia Conteggio che Valore di conteggio, verrà utilizzato Conteggio	Stringa Dimensione del testo consigliata: massimo 20 caratteri per conteggi e etichette combinati
Popolarità - Valore conteggio	Facoltativo	Il numero di follower o il valore della popolarità. Nota:fornisci un valore di conteggio se l'app non vuole gestire la logica di ottimizzazione di un numero elevato per dimensioni di display diverse. Se vengono forniti sia Conteggio sia Valore conteggio, verrà utilizzato Conteggio.	Lungo
Popolarità - Etichetta	Facoltativo	Indica l'etichetta della popolarità. Ad esempio, "Mi piace".	Stringa Dimensioni del testo consigliate: massimo 20 caratteri per conteggi e etichette combinati
Popolarità - Visivo	Facoltativo	Indica lo scopo dell'interazione. Ad esempio, immagine che mostra icona Mi piace, emoji. Puoi fornire più di un'immagine, anche se non tutte potrebbero essere mostrate su tutti i fattori di forma. Nota: deve essere un'immagine quadrata 1:1	Per indicazioni, consulta le Specifiche delle immagini.
Valutazione - Valore massimo	Obbligatorio	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore corrente della valutazione.	Numero >= 0,0
Valutazione - Valore corrente	Obbligatorio	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per l'entità. Nota: fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'entità. Nota: fornisci questo campo se non vuoi gestire autonomamente la logica di visualizzazione dell'abbreviazione. Se sono presenti sia Conteggio sia Valore conteggi utilizzeremo il Conteggio per la visualizzazione agli utenti	Lungo
Località - Paese	Facoltativo	Il paese in cui si trova la persona o in cui presta servizio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Facoltativo	La città in cui si trova la persona o in cui opera.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato	Facoltativo	L'indirizzo in cui si trova la persona o in cui si trova il servizio verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della persona o del luogo in cui si trova il servizio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato (se applicabile) in cui la persona si trova o presta servizio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) del luogo in cui si trova la persona o in cui si trova il servizio.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si trova la persona o in cui opera.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonei TYPE_HEALTH_AND_FITENESS (esempio: istruttore di yoga/fitness) TYPE_HOME_AND_AUTO (esempio: idraulico) TYPE_SPORTS (esempio: giocatore) DATA_TIPO Per indicazioni, consulta la sezione Categoria di contenuti.

RestaurantReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio della prenotazione	Obbligatorio	Il timestamp epoch in millisecondi dell'inizio previsto della prenotazione.	Timestamp in millisecondi
Località - Paese	Obbligatorio	Il paese in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Indirizzo visualizzato	Obbligatorio	L'indirizzo del pristorante che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) del ristorante.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini dei 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 per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Dimensioni della tabella	Facoltativo	Il numero di persone nel gruppo di prenotazione	Numero intero > 0

EventReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio	Obbligatorio	Il timestamp dell'epoca in cui è previsto l'inizio dell'evento. Nota: questo valore verrà rappresentato in millisecondi.	Timestamp in millisecondi
Modalità evento	Obbligatorio	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Località - Paese	Obbligatorio condizionalmente	Il paese in cui si svolge l'evento. Nota: questo valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Città	Obbligatorio condizionalmente	La città in cui si svolge l'evento. Nota: questo valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato	Obbligatorio in modo condizionale	L'indirizzo o il nome del luogo in cui si svolgerà l'evento da mostrare all'utente. Nota: questo valore è obbligatorio per gli eventi IN_PERSON o HYBRID	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della sede in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui viene ospitato l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) della località in cui si svolge l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si terrà l'evento.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini dei 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 di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.	Per indicazioni, consulta le Specifiche delle immagini.
Ora di fine	Facoltativo	Il timestamp epoch in cui è previsto il termine dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp epoch in millisecondi
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/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 delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo	Facoltativo	Titolo del badge Nota: per il badge è necessario un testo o un'immagine	Testo libero Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine	Facoltativo	Immagine piccola Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le specifiche per le immagini.
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione dell'evento.	Testo libero
Prezzo - CurrentPrice	Obbligatorio condizionalmente	Il prezzo corrente del biglietto/del pass per l'evento. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale del biglietto/del pass per l'evento.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare 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
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se viene fornito anche il valore massimo della valutazione.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota: fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione di visualizzazione. Se sono presenti sia Conteggio sia Valore conteggi utilizzeremo il Conteggio 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 (esempio: eSports) TYPE_MUSIC (esempio: concerto) TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival) TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga) TYPE_EDUCATION (esempio: Corso) TYPE_SPORTS (esempio: partita di calcio) TYPE_DATING (esempio: meetup) Per indicazioni, consulta la sezione Categoria di contenuti.

LodgingReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Il tuo soggiorno dal 12 dicembre" Dimensioni del testo consigliate: massimo 50 caratteri
Orario check-in	Obbligatorie	Il timestamp epoch in millisecondi che rappresenta l'ora di check-in per la prenotazione.	Timestamp epoch in millisecondi
Orario check-out	Obbligatorio	Il timestamp epoch in millisecondi che rappresenta l'ora di check-out per la prenotazione.	Timestamp epoch in millisecondi
Località - Paese	Obbligatorie	Il paese in cui si trova la struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Città	Obbligatorio	La città in cui si trova la struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Indirizzo visualizzato	Obbligatorie	L'indirizzo della struttura ricettiva che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova la struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località - CAP	Facoltativo	Il codice postale (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) della struttura.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Immagini dei poster	Facoltativo	Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9 Nota: se viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps sia nella parte superiore che nella parte inferiore dell'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione dell'alloggio.	Testo libero
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se viene fornito anche il valore corrente della valutazione.	Numero >= 0,0
Classificazione - Valore corrente	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 la struttura. Nota: fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire personalmente la logica dell'abbreviazione di visualizzazione. Se sono presenti sia Conteggio che Conteggio, utilizzeremo il valore di Conteggio per mostrarlo agli utenti	Lungo
Prezzo - CurrentPrice	Obbligatorio condizionalmente	Il prezzo corrente della struttura. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della struttura, barrato nell'UI.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)

TransportationReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Da SFO a SAN" Dimensioni del testo consigliate: massimo 50 caratteri
Tipo di trasporto	Obbligatorio	La modalità/il tipo di trasporto per la prenotazione.	Enum: FLIGHT, TRAIN, BUS o FERRY
Ora partenza	Obbligatorio	Il timestamp dell'epoca in millisecondi che rappresenta l'ora di partenza.	Timestamp in millisecondi
Ora di arrivo	Obbligatorie	Il timestamp dell'epoca in millisecondi che rappresenta l'ora di arrivo.	Timestamp in millisecondi
Località di partenza - Paese	Facoltativo	Il paese di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Città	Facoltativo	La città di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Stazione di partenza - Indirizzo visualizzato	Facoltativo	La stazione di partenza che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di partenza - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della stazione di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Stato	Facoltativo	Lo stato o la provincia (se applicabile) del luogo di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di partenza - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di partenza.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione di partenza - Quartiere	Facoltativo	Il quartiere (se applicabile) del luogo di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - Paese	Facoltativo	Il paese di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Città	Facoltativo	La città di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione di arrivo - Indirizzo visualizzato	Facoltativo	La stazione di arrivo che verrà mostrata all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Località di arrivo - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Posizione di arrivo - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di arrivo.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il fornitore di servizi è 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: il fornitore di servizi richiede testo o immagine.	Per indicazioni, consulta le specifiche per le immagini.
Immagini 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 per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione del trasporto.	Testo libero
Prezzo - CurrentPrice	Obbligatorio in modo condizionale	Il prezzo attuale della prenotazione. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che viene barrato nella UI.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Numero di trasporto	Obbligatorio	Il numero del volo, dell'autobus, del treno o della nave/crociera.	Testo libero
Orario di imbarco	Obbligatorio	Il timestamp epoch che rappresenta l'orario di imbarco per la prenotazione (se applicabile)	Timestamp in millisecondi

VehicleRentalReservationEntity

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del fornitore. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Obbligatorio	Titolo dell'entità.	Testo libero. Ad esempio, "Avis Union Square SF" Dimensioni del testo consigliate: massimo 50 caratteri
Orario di ritiro	Obbligatorie	Il timestamp epoch che rappresenta l'ora di ritiro della prenotazione.	Timestamp epoch in millisecondi
Orario di ritorno	Facoltativo	Il timestamp dell'epoca che rappresenta l'ora del check-out per la prenotazione.	Timestamp epoch in millisecondi
Indirizzo di ritiro - Paese	Facoltativo	Il paese del luogo di ritiro.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Città	Facoltativo	La città del punto di ritiro.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Indirizzo visualizzato	Facoltativo	Il luogo di ritiro che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritiro: via	Facoltativo	L'indirizzo (se applicabile) della stazione di ricarica.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di ritiro.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Codice postale	Facoltativo	Il codice postale (se applicabile) della stazione di ricarica.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritiro - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto di partenza della corsa.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di restituzione: paese	Facoltativo	Il paese della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di reso - Città	Facoltativo	La città della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di reso - Indirizzo visualizzato	Facoltativo	La posizione di ritorno che verrà mostrata all'utente.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di ritorno - Indirizzo	Facoltativo	L'indirizzo (se applicabile) della località di restituzione.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di reso - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritorno - Codice postale	Facoltativo	Il codice postale (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Indirizzo di restituzione - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di reso.	Testo libero Dimensione del testo consigliata: massimo 20 caratteri
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il fornitore di servizi è 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: il fornitore di servizi richiede testo o immagine.	Per indicazioni, consulta le Specifiche delle immagini.
Immagini 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 per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli	Facoltativo	Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
ID conferma	Facoltativo	L'ID di conferma per la prenotazione del noleggio del veicolo.	Testo libero
Prezzo - CurrentPrice	Obbligatorio in modo condizionale	Il prezzo attuale della prenotazione. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che viene barrato nella UI.	Testo libero
Callout prezzo	Facoltativo	Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)

Specifiche per le immagini

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

Proporzioni	Numero minimo di pixel	Risoluzione consigliata in pixel
Quadrato (1 x 1) Preferiti	300 x 300	1200 x 1200
Orizzontale (1,91 x 1)	600 x 314	1200 x 628
Ritratto (4 x 5)	480 x 600	960 x 1200

Per consentire a Google di accedervi, le immagini devono essere ospitate su CDN pubbliche.

Formati file

PNG, JPG, GIF statico, WebP

Dimensioni massime del file

5120 kB

Consigli aggiuntivi

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

Categoria di contenuti

La categoria dei contenuti consente alle app di pubblicare contenuti appartenenti a più categorie. I contenuti vengono associati ad 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 per consentire a Google di accedervi.

Linee guida per l'utilizzo delle categorie di contenuti

1. Alcune entità, come ArticleEntity e GenericFeaturedEntity, sono idonee all'utilizzo di qualsiasi categoria 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 compilare l'elenco.

2. Utilizza il tipo di entità specifico per alcune categorie di contenuti rispetto a una combinazione di entità Generic e ContentCategory:

   • TYPE_MOVIES_AND_TV_SHOWS: consulta le entità riportate nella 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: consulta le entità della guida all'integrazione di Google 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 sopra menzionate.

4. Nel caso in cui vengano fornite più categorie di contenuti, indicale in ordine di pertinenza rispetto ai contenuti con la categoria di contenuti più pertinente collocata 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 su base regolare o in base a un evento (ad esempio ogni volta che l'utente apre l'app o quando l'utente ha appena aggiunto un articolo al carrello).

AppEngagePublishClient è responsabile della pubblicazione dei cluster.

Esistono le seguenti API per pubblicare i cluster nel client:

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishContinuationCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteContinuationCluster
• 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.

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 delle app, le installazioni e le disinstallazioni. Garantendo controlli periodici dei job a un determinato intervallo di tempo, i dati possono essere pubblicati non appena il servizio diventa disponibile.

publishRecommendationClusters

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

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

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 e sostituiscono i contenuti esistenti. Non chiamare in seguito le API di eliminazione e pubblicazione per sostituire il contenuto, poiché 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 PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Quando il servizio riceve la richiesta, all'interno di una transazione vengono eseguite le seguenti azioni:

• 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.

publishContinuationCluster

Questa API viene utilizzata per pubblicare un oggetto ContinuationCluster.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Quando il servizio riceve la richiesta, all'interno di una transazione vengono eseguite le seguenti azioni:

• I dati ContinuationCluster esistenti del partner sviluppatore vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster di continuazione aggiornato.

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

publishUserAccountManagementRequest

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

I seguenti metadati fanno parte della scheda Accedi:

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

Importante: le API di pubblicazione sono API di upsert e sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

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 dello sviluppatore partner vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster aggiornato UserAccountManagementCluster.

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 è pubblicato, 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 trasmettere l'integrità e altre metriche dell'integrazione.
• Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non è in errore (STATUS == NOT_PUBLISHED), Google può evitare di attivare avvisi nelle dashboard di salute dell'app. Conferma che i contenuti non vengono pubblicati a causa di una situazione prevedibile dal punto di vista del fornitore.
• Aiuta gli sviluppatori a fornire informazioni su quando i dati vengono pubblicati o meno.
• Google potrebbe utilizzare i codici di stato per indurre l'utente a eseguire determinate azioni nell'app in modo da poter vedere i contenuti dell'app o superarli.

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

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

deleteRecommendationClusters

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteFeaturedCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ 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 a partire dalla versione 1.1.0.

deleteContinuationCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster di continuazione. 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 successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ 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 a partire dalla versione 1.1.0.

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 successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

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

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .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 che sia possibile eseguire 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 e la causa è inclusa sotto forma di 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, è esplicitamente disabilitato).
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, più del numero consentito di cluster).
6	SERVICE_CALL_INTERNAL	Si è verificato un errore sul lato del servizio.
7	SERVICE_CALL_RESOURCE_EXHAUSTED	La chiamata al servizio viene effettuata troppo di frequente.

Passaggio 3: gestisci gli intent di trasmissione

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

L'obiettivo degli intent di trasmissione è principalmente la riattivazione dell'app e la forzatura della sincronizzazione dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto di frequente. Viene attivato solo quando il servizio Google Engage stabilisce che i contenuti potrebbero essere inattivi (ad esempio, dopo una settimana). In questo modo, l'utente può avere maggiore fiducia di poter usufruire di contenuti aggiornati, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei due modi seguenti:

• Registra in modo dinamico un'istanza della classe BroadcastReceiver utilizzando Context.registerReceiver(). In questo modo, viene attivata la comunicazione da applicazioni che sono ancora attive in memoria.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

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 continuation cluster publish when PUBLISH_CONTINUATION 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));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}

• Dichiara in modo statico un'implementazione con il tag <receiver> nel AndroidManifest.xml file. In questo modo, l'applicazione può ricevere intent di trasmissione quando non è in esecuzione e pubblicare i contenuti.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      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.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

I seguenti intent vengono inviati dal servizio:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION È consigliabile avviare una chiamata publishRecommendationClusters quando si riceve questa intenzione.
• com.google.android.engage.action.PUBLISH_FEATURED Ti consigliamo di avviare una chiamata publishFeaturedCluster quando ricevi questo intent.
• com.google.android.engage.action.PUBLISH_CONTINUATION Ti consigliamo di avviare una chiamata publishContinuationCluster quando ricevi questo intent.

Flusso di lavoro di integrazione

Per una guida passo passo sulla verifica dell'integrazione al termine, consulta Flusso di lavoro di integrazione degli sviluppatori di Engage.

Domande frequenti

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

Contatto

Contatta [e-mail] in caso di domande durante la procedura di integrazione.

Passaggi successivi

Dopo aver completato questa integrazione, svolgi i seguenti passaggi:

• Invia un'email all'indirizzo [e-mail] e allega l'APK integrato pronto per i test da parte di Google.
• Google esegue una verifica e delle revisioni interne per assicurarsi che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatterà con tutti i dettagli necessari.
• Quando il test è stato completato e non sono necessarie modifiche, Google ti contatta per informarti che puoi iniziare a pubblicare l'APK aggiornato e integrato nel Play Store.
• Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i tuoi cluster Consiglio, In primo piano e Continuazione potrebbero essere pubblicati e visibili agli utenti.