Questa pagina è stata tradotta dall'API Cloud Translation.

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

Google sta creando una piattaforma sul dispositivo che organizza app per verticali e consente una nuova esperienza immersiva per la fruizione personalizzata dei contenuti delle app e scoperta. Questa esperienza a schermo intero offre ai partner sviluppatori l'opportunità di mostrare i migliori contenuti avanzati in un canale dedicato esterno della propria app.

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

Dettagli integrazione

Terminologia

Questa integrazione include i seguenti tre tipi di cluster: Recommendation, In primo piano e Continuazione.

I cluster di consigli mostrano suggerimenti personalizzati di una singola persona come sviluppatore partner. È una visualizzazione UI che contiene un gruppo di consigli dello stesso partner di sviluppo.
- ArticleEntity: ArticleEntity che rappresenta un indirizzo consiglio per contenuti pertinenti a più di una categoria di contenuti. L'elemento ArticleEntity consente agli sviluppatori di fornire di testo e immagini con più metadati per articolare le informazioni agli utenti rispetto a GenericFeatureEntity. Es.: contenuti di marketing, Snippet di Google News
  
  Figura 1: UI che mostra un singolo ArticleEntity all'interno di Recommendations in un cluster Kubernetes.
- EventEntity: EventEntity rappresenta un evento che si verifica nella per il futuro. L'ora di inizio dell'evento è un'informazione fondamentale che deve essere comunicato agli utenti.
  
  Figura 2: UI che mostra una singola EventEntity all'interno Cluster di suggerimenti.
- LodgingEntity: LodgingEntity rappresenta una struttura ricettiva, ad esempio come hotel, appartamento, casa vacanze a breve e lungo termine noleggio.
  
  Figura 3: UI che mostra un singolo LodgingEntity all'interno del cluster Recommendations.
- StoreEntity: StoreEntity rappresenta un negozio, un ristorante, una caffetteria e così via. Mette in evidenza i contenuti in cui una sala da pranzo o un negozio sono le informazioni più importanti che devono essere trasmesse utenti.
  
  Figura 4: UI che mostra una singola StoreEntity all'interno Cluster di suggerimenti.
- PointOfinterestEntity: PointOfinterestEntity rappresenta un luogo di interesse come, una stazione di servizio, una sede di eventi, un parco a tema, museo, attrazione turistica, sentiero ecc. Mette in evidenza i contenuti la posizione è un'informazione fondamentale che deve essere comunicate agli utenti. Non deve essere utilizzata per alloggi, negozi o una sala da pranzo.
  
  Figura 5: UI che mostra una singola PointOfinterestEntity all'interno del cluster Recommendations.
- PersonEntity: PersonEntity rappresenta una persona. I consigli può consistere nel mettere in evidenza una persona in categorie quali salute e fitness, sport, incontri ecc.
  
  Figura 5: UI che mostra una singola PersonEntity all'interno Cluster di suggerimenti.
Il cluster Continuazione mostra i contenuti recentemente coinvolti dagli utenti di più sviluppatori partner in un unico raggruppamento di UI. Ogni sviluppatore partner potranno trasmettere un massimo di 10 entità nella continua in un cluster Kubernetes.

I contenuti continui possono avere la seguente struttura:
- ArticleEntity: ArticleEntity che rappresenta un indirizzo consiglio per contenuti pertinenti a più di una categoria di contenuti. Questa entità può essere utilizzata per rappresentare notizie da finire articoli o altri contenuti che l'utente vuole continuare a consultare. da dove l'avevano lasciata. Esempio: contenuti di marketing, snippet di notizie
  
  Figura 6. UI che mostra un singolo ArticleEntity all'interno per un cluster di continuazione.
- RestaurantReservationEntity: RestaurantReservationEntity rappresenta una prenotazione per un ristorante o un bar e aiutano gli utenti a monitorare prenotazioni in corso al ristorante.
  
  Figura 7. UI che mostra una singola RestaurantReservationEntity all'interno di un cluster Continuation.
- EventReservationEntity: EventReservationEntity rappresenta un per un evento e aiuta gli utenti a monitorare quelli imminenti o in corso prenotazioni di eventi. Gli eventi possono includere, a titolo esemplificativo: seguenti:
  - Eventi sportivi come la prenotazione per una partita di calcio
  - Eventi di gioco come prenotazioni per gli eSport
  - Eventi di intrattenimento come la prenotazione di film al cinema concerto, teatro, firma di libri
  - Prenotazioni di viaggi o punti di interesse come tour guidati, musei ticket
  - Prenotazioni sociali / seminari / conferenze
  - Prenotazioni delle sessioni di istruzione / formazione
  Figura 8. UI che mostra una singola EventReservationEntity all'interno di un cluster Continuation.
- LodgingReservationEntity: LodgingEntityReservation rappresenta una prenotare un alloggio di viaggio e aiutare gli utenti a monitorare prenotazioni in corso di hotel o case vacanze.
  
  Figura 9. UI che mostra una singola LodgingReservationEntity all'interno di un cluster Continuation.
- TransportationReservationEntity: TransportationReservationEntity rappresenta una prenotazione per i trasporti in qualsiasi modalità e aiuta gli utenti monitorare le prenotazioni di voli, traghetto, treni, autobus in arrivo o in corso, ride hailing o crociera.
  
  Figura 10. UI che mostra una singola TransportationReservationEntity all'interno di un cluster Continuation.
- VeicoliRentalReservationEntity: VehicleRentalReservationEntity rappresenta una prenotazione di veicoli per il noleggio e aiuta gli utenti a monitorare o prenotazioni in corso di noleggio di veicoli.
  
  Figura 11. UI che mostra una singola VeicoloRentalReservationEntity all'interno di un cluster Continuation.
Il cluster In primo piano è una visualizzazione UI che mostra l'hero scelto GenericFeaturedEntity di molti sviluppatori partner in un unico raggruppamento della UI. È presente un singolo cluster in primo piano, che viene visualizzato vicino alla parte superiore UI, con un posizionamento prioritario sopra tutti i cluster dei suggerimenti. Ciascuna il partner di sviluppo è autorizzato a trasmettere una singola entità di un elemento supportato di digitare in In primo piano, con molte entità (potenzialmente di tipo diverso) da più sviluppatori di app nel cluster In primo piano.
- GenericFeatureEntity: GenericFeatureEntity è diverso da L'elemento consiglio in quell'elemento in primo piano deve essere utilizzato per un singolo i contenuti principali degli sviluppatori e dovrebbero rappresentare contenuti importanti che siano interessanti e pertinenti per gli utenti.
  
  Figura 12: UI che mostra un singolo hero Scheda GenericFeatureEntity 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

La progettazione si basa sull'implementazione di uno servizio associato.

I dati che un cliente può pubblicare sono soggetti ai seguenti limiti per 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 suggerimenti	Al massimo 5	Almeno 5	Al massimo 25 (`ArticleEntity`, `EventEntity`, `LodgingEntity` `StoreEntity` `PointOfInterestEntity` o `PersonEntity`)
Cluster di continuazione	Al massimo 1	Almeno 1	Al massimo 10 (`ArticleEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity`, oppure `VehicleRentalReservationEntity`)
Cluster in primo piano	Al massimo 1	Almeno 1	Al massimo 10 (`GenericFeaturedEntity`)

Passaggio 1: fornisci i dati dell'entità

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

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Immagini poster	Obbligatorie	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: se viene fornito un badge, assicurati di avere spazio sicuro per 24 dps nella parte superiore e inferiore dell'immagine	Per indicazioni, consulta le Specifiche delle 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: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni. Trattamento speciale per l'esperienza utente sopra l'immagine o il video, ad esempio come badge sovrapposizione 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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum Consulta la sezione Categoria di contenuti per assistenza.

`ArticleEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Testo libero Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se un badge è assicurati che uno spazio di sicurezza di 24 dps nella parte superiore e inferiore del immagine	Per indicazioni, consulta le Specifiche delle immagini.
Fonte - 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 giornalista	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni. Trattamento UX speciale sopra l'immagine o il video, ad esempio come badge sovrapposizione 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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Ora di pubblicazione dei contenuti	Facoltativo	Si tratta del timestamp dell'epoca in millisecondi relativo al momento in cui i contenuti sono stati pubblicate / aggiornate nell'app.	Timestamp in millisecondi
Durata ultimo coinvolgimento	Obbligatorio in modo condizionale	Il timestamp dell'epoca in millisecondi con cui l'utente ha interagito l'ultima volta. Nota: questo campo è obbligatorio se l'entità fa parte di nel cluster di continuazione.	Timestamp in millisecondi
Percentuale di avanzamento	Obbligatorio in modo condizionale	La percentuale dei contenuti totali consumati dall'utente fino a oggi. Nota: questo campo è obbligatorio se l'entità fa parte di nel 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 Consulta la sezione Categoria di contenuti per assistenza.

`EventEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio	Obbligatorie	Il timestamp dell'epoca in cui è previsto l'inizio dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp in millisecondi
Modalità evento	Obbligatorie	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Immagini poster	Obbligatorie	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se un badge è assicurati che uno spazio di sicurezza di 24 dps nella parte superiore e inferiore del immagine	Per indicazioni, consulta le Specifiche delle immagini.
Località - Paese	Obbligatorio in modo condizionale	Il paese in cui si svolge l'evento. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorio in modo condizionale	La città in cui si svolge l'evento. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Indirizzo visualizzato	Obbligatorio in modo condizionale	L'indirizzo o il nome della sede in cui si svolgerà l'evento che dovrebbe da mostrare all'utente. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	La via (se applicabile) del luogo in cui si svolge l'evento in fase di hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si tiene l'evento. in hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) del luogo in cui si tiene l'evento in hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si terrà l'evento.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Ora di fine	Facoltativo	Il timestamp dell'epoca in cui è prevista la fine dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp in millisecondi
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.
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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	L'attuale prezzo del biglietto/del pass per l'evento. Deve essere indicato se viene indicato un 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 (Testo troppo lungo può mostrare puntini di sospensione)
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonee TYPE_MovieS_AND_TV_SHOWS (esempio - Cinema) TYPE_DIGITAL_GAMES (Esempio - eSport) TYPE_MUSIC (Esempio: Concerto) TYPE_TRAVEL_AND_LOCAL (ad esempio: Tour, festival) TYPE_HEALTH_AND_FITENESS (Esempio: lezione di yoga) TYPE_EDUCATION (Esempio - Classe) TYPE_SPORTS (Esempio: partita di calcio) TYPE_DATING (Esempio: meetup) Consulta la sezione Categoria di contenuti per assistenza.

`LodgingEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Obbligatorie	Quando vengono fornite più immagini, viene mostrata una sola immagine. Consigliate le proporzioni sono 16:9 Nota: se viene fornito un badge, assicurati di avere spazio sicuro per 24 dps nella parte superiore e inferiore dell'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Località - Paese	Obbligatorie	Il paese in cui si trova la struttura ricettiva.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorie	La città in cui si trova la struttura ricettiva.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
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	La via (se applicabile) della struttura.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio. individuarlo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) della struttura ricettiva.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) della struttura.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.
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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
disponibilitàTimeWindow - Ora di inizio	Facoltativo	Il timestamp dell'epoca in millisecondi in cui è previsto che la struttura ricettiva aperto/disponibile.	Timestamp in millisecondi
Finestra disponibilità temporale - Ora di fine	Facoltativo	Il timestamp dell'epoca in millisecondi fino al quale è prevista la struttura ricettiva per essere aperti/disponibili.	Timestamp in millisecondi
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se la tua app controlla come il conteggio viene mostrato agli utenti. Usa una stringa concisa. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di usare un'abbreviazione ad esempio 1 M, in modo che il conteggio non venga troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non gestisci la logica delle abbreviazioni del display. Se sia il valore di conteggio che quello di conteggio se presenti, il conteggio viene mostrato agli utenti.	Lungo
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	Il prezzo corrente dell'alloggio. Deve essere indicato se viene indicato il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che viene specificato nei nell'interfaccia utente.	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 (Testo troppo lungo può mostrare puntini di sospensione)

`StoreEntity`

L'oggetto StoreEntity rappresenta un singolo negozio partner di sviluppatori che vuoi pubblicare, come un ristorante o un negozio di alimentari.

Attributo	Requisito	Descrizione	Formato
Immagini poster	Obbligatorie	Devi fornire almeno un'immagine.	Per indicazioni, consulta le Specifiche delle immagini.
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Facoltativo	Il nome del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (testo che troppo lungo possono mostrare puntini di sospensione)
Posizione	Facoltativo	La sede del negozio.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (testo che troppo lungo possono mostrare puntini di sospensione)
Callout	Facoltativo	Callout per mettere in evidenza una promozione, un evento o un aggiornamento per il negozio, se disponibili.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (testo che troppo lungo possono mostrare puntini di sospensione)
Clausole dei callout	Facoltativo	Testo in piccolo per il callout.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (testo che troppo lungo possono mostrare puntini di sospensione)
Descrizione	Facoltativo	Una descrizione del negozio.	Testo libero Dimensioni del testo consigliate: meno di 90 caratteri (testo che troppo lungo possono mostrare puntini di sospensione)
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se la tua app vuole controllare come questo viene mostrato agli utenti. Fornisci la stringa concisa che possono essere mostrati all'utente. Ad esempio, se il conteggio è 1.000.000, prendi in considerazione l'uso di abbreviazioni come 1 M, in modo che troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire la logica delle abbreviazioni del display. Se sia il valore di conteggio che quello di conteggio useremo Conteggio per mostrarlo agli utenti	Lungo

`PointOfInterestEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Immagini poster	Obbligatorie	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se un badge è assicurati che uno spazio di sicurezza di 24 dps nella parte superiore e inferiore del immagine	Per indicazioni, consulta le Specifiche delle immagini.
Località - Paese	Obbligatorie	Il paese in cui si trova il punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorie	La città in cui si trova il punto di interesse.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Indirizzo visualizzato	Obbligatorie	L'indirizzo del punto d'interesse che verrà mostrato al utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	L'indirizzo (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il punto d'interesse individuarlo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto d'interesse.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
disponibilitàTimeWindow - Ora di inizio	Facoltativo	Il timestamp dell'epoca in millisecondi quando il punto d'interesse è dovrebbe essere aperta/disponibile.	Timestamp in millisecondi
Finestra disponibilità temporale - Ora di fine	Facoltativo	Il timestamp dell'epoca in millisecondi fino al quale il punto d'interesse dovrebbe essere aperta/disponibile.	Timestamp in millisecondi
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.
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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per il punto d'interesse. Nota: fornisci questo campo se la tua app controlla come il conteggio viene mostrato agli utenti. Usa una stringa concisa. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di usare un'abbreviazione ad esempio 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 visualizzare personalmente la logica per le abbreviazioni. Se sia il valore di conteggio che quello di conteggio sono presenti, il conteggio viene mostrato agli utenti	Lungo
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	Il prezzo corrente dei biglietti/del pass d'ingresso per il punto di interesse. Deve essere indicato se viene indicato un prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dei biglietti/del pass di ingresso 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 mostra i puntini di sospensione)
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonee TYPE_TRAVEL_AND_LOCAL TYPE_MovieS_AND_TV_SHOWS (ad esempio: cinema) TYPE_MEDICAL (Esempio: ospedale) TYPE_EDUCATION (Esempio: scuola) TYPE_SPORTS (Esempio: stadio) Consulta la sezione Categoria di contenuti per assistenza.

`PersonEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Profilo - Nome	Obbligatorie	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel" e così via.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Profilo - Avatar	Obbligatorie	Immagine del profilo o immagine dell'avatar dell'utente. Nota: deve essere un'immagine quadrata 1:1.	Per indicazioni, consulta le Specifiche delle immagini.
Profilo - Testo aggiuntivo	Facoltativo	Testo libero come l'handle del profilo.	Testo libero Dimensioni del testo consigliate: massimo 15 caratteri
Profilo - Immagine aggiuntiva	Facoltativo	Immagine piccola come un badge di verifica.	Per indicazioni, consulta le Specifiche delle immagini.
Immagine intestazione	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se un badge è assicurati che uno spazio di sicurezza di 24 dps nella parte superiore e inferiore del immagine	Per indicazioni, consulta le Specifiche delle immagini.
Popolarità - Conteggio	Facoltativo	Rappresenta l'immagine intestazione. Deve essere diversa dall'immagine del profilo. Questa opzione può essere utilizzata se è presente un'immagine aggiuntiva per evidenziare a persone piace il loro lavoro. Nota: deve essere un'immagine in formato 16:9. Se viene fornito un badge, assicura uno spazio sicuro di 24 dps nella parte superiore e inferiore dell'immagine	Stringa Dimensioni del testo consigliate: massimo 20 caratteri per numero + etichetta combinato
Popolarità - Valore conteggio	Facoltativo	Il numero di follower o il valore della popolarità. Nota: indica un valore di conteggio se l'app non vuole gestire la logica di ottimizzazione di un numero elevato dimensioni del display diverse. Se vengono forniti sia il valore di conteggio che il valore di conteggio, Verrà utilizzato il conteggio.	Lungo
Popolarità - Etichetta	Facoltativo	Indica l'etichetta popolarità. Ad esempio: "Mi piace".	Stringa Dimensioni del testo consigliate: massimo 20 caratteri per numero + etichetta combinato
Popolarità - Immagini	Facoltativo	Indica il motivo dell'interazione. Esempio: immagine che mostra Icona Mi piace, Emoji. È possibile fornire più di un'immagine, anche se non tutte potrebbero non essere visualizzate in tutte e 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 è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Obbligatorio	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per l'entità. Nota: fornisci questo campo se la tua app vuole controllare come questo viene mostrato agli utenti. Fornisci la stringa concisa che possono essere mostrati all'utente. Ad esempio, se il conteggio è 1.000.000, prendi in considerazione l'uso di abbreviazioni come 1 M, in modo che troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'entità. Nota: fornisci questo campo se non vuoi gestire la logica delle abbreviazioni del display. Se sia il valore di conteggio che quello di conteggio useremo Conteggio per mostrarlo agli utenti	Lungo
Località - Paese	Facoltativo	Il paese in cui si trova la persona o in cui opera.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Facoltativo	La città in cui si trova la persona o in cui svolge il suo servizio.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Indirizzo visualizzato	Facoltativo	L'indirizzo in cui si trova la persona o in cui si trova il servizio verrà visualizzato da per l'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	La via (se applicabile) del luogo in cui si trova la persona o in fase di pubblicazione.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato (se applicabile) in cui si trova la persona o in cui si trova il servizio.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
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 Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si trova la persona o in cui opera.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.
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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonee TYPE_HEALTH_AND_FITENESS (Esempio - Istruttore di yoga/fitness) TYPE_HOME_AND_AUTO (Esempio - Idraulico) TYPE_SPORTS (Esempio - Giocatore) DATA_TIPO Consulta la sezione Categoria di contenuti per assistenza.

`RestaurantReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio della prenotazione	Obbligatorie	Il timestamp dell'epoca in millisecondi in cui è previsto che la prenotazione per iniziare.	Timestamp in millisecondi
Località - Paese	Obbligatorie	Il paese in cui si trova il ristorante.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorie	La città in cui si trova il ristorante.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Indirizzo visualizzato	Obbligatorie	L'indirizzo del pristorante che verrà mostrato all' utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	La via (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova il ristorante individuarlo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) del ristorante.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Consigliate le proporzioni sono 16:9	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Dimensione tabella	Facoltativo	Il numero di persone nel gruppo di prenotazione	Numero intero > 0

`EventReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Stringa Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio	Obbligatorie	Il timestamp dell'epoca in cui è previsto l'inizio dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp in millisecondi
Modalità evento	Obbligatorie	Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.	Enum: VIRTUAL, IN_PERSON o HYBRID
Località - Paese	Obbligatorio in modo condizionale	Il paese in cui si svolge l'evento. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorio in modo condizionale	La città in cui si svolge l'evento. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Indirizzo visualizzato	Obbligatorio in modo condizionale	L'indirizzo o il nome della sede in cui si svolgerà l'evento che dovrebbe da mostrare all'utente. Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o IBRIDO	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Indirizzo	Facoltativo	La via (se applicabile) del luogo in cui si svolge l'evento in fase di hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si tiene l'evento. in hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) del luogo in cui si tiene l'evento in hosting.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) in cui si terrà l'evento.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se un badge è assicurati che uno spazio di sicurezza di 24 dps nella parte superiore e inferiore del immagine	Per indicazioni, consulta le Specifiche delle immagini.
Ora di fine	Facoltativo	Il timestamp dell'epoca in cui è prevista la fine dell'evento. Nota: questo valore è espresso in millisecondi.	Timestamp in millisecondi
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o immagine o il provider di servizi di terze parti.	Testo libero. Ad esempio, il nome dell'organizzatore/tour dell'evento
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o immagine o il provider di servizi di terze parti.	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
Badge	Facoltativo	Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.
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 speciale per l'esperienza utente, ad esempio overlay del badge sull'immagine o sul video miniatura. Nota: per il badge è necessario un testo o un'immagine	Per indicazioni, consulta le Specifiche delle immagini.
ID prenotazione	Facoltativo	L'ID prenotazione per la prenotazione dell'evento.	Testo libero
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	L'attuale prezzo del biglietto/del pass per l'evento. Deve essere indicato se viene indicato un 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 (Testo troppo lungo può mostrare puntini di sospensione)
Valutazione - Valore massimo	Facoltativo	Il valore massimo della scala di valutazione. Deve essere fornito se è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota: fornisci questo campo se la tua app vuole controllare come questo viene mostrato agli utenti. Fornisci la stringa concisa che possono essere mostrati all'utente. Ad esempio, se il conteggio è 1.000.000, prendi in considerazione l'uso di abbreviazioni come 1 M, in modo che troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'evento. Nota: fornisci questo campo se non vuoi gestire la logica delle abbreviazioni del display. Se sia il valore di conteggio che quello di conteggio useremo Conteggio per mostrarlo agli utenti	Lungo
Categorie di contenuti	Facoltativo	Descrivi la categoria dei contenuti nell'entità.	Elenco di enum idonee TYPE_MovieS_AND_TV_SHOWS (esempio - Cinema) TYPE_DIGITAL_GAMES (Esempio - eSport) TYPE_MUSIC (Esempio: Concerto) TYPE_TRAVEL_AND_LOCAL (ad esempio: Tour, festival) TYPE_HEALTH_AND_FITENESS (Esempio: lezione di yoga) TYPE_EDUCATION (Esempio - Classe) TYPE_SPORTS (Esempio: partita di calcio) TYPE_DATING (Esempio: meetup) Consulta la sezione Categoria di contenuti per assistenza.

`LodgingReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Testo libero. Ad esempio, "Il tuo soggiorno dal 12 dic" Dimensioni del testo consigliate: massimo 50 caratteri
Orario check-in	Obbligatorie	Il timestamp dell'epoca in millisecondi che rappresenta l'ora di controllo per la prenotazione.	Timestamp in millisecondi
Orario check-out	Obbligatorie	Il timestamp dell'epoca in millisecondi che rappresenta l'ora del pagamento per la prenotazione.	Timestamp in millisecondi
Località - Paese	Obbligatorie	Il paese in cui si trova la struttura.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Città	Obbligatorie	Città in cui si trova l'alloggio.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
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	La via (se applicabile) della struttura.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - Stato	Facoltativo	Lo stato o la provincia (se applicabile) in cui si trova l'alloggio. individuarlo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località - CAP	Facoltativo	Il codice postale (se applicabile) della struttura ricettiva.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Posizione - Quartiere	Facoltativo	Il quartiere (se applicabile) della struttura.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Consigliate le proporzioni sono 16:9 Nota: se viene fornito un badge, assicurati di avere 24 ore di spazio di sicurezza. dps nella parte superiore e inferiore dell'immagine	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a 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 è anche il valore corrente della valutazione forniti.	Numero >= 0,0
Classificazione - Valore corrente	Facoltativo	Il valore attuale della scala di valutazione. Deve essere fornito se anche il valore massimo della valutazione è forniti.	Numero >= 0,0
Valutazione - Conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se la tua app vuole controllare come questo viene mostrato agli utenti. Fornisci la stringa concisa che possono essere mostrati all'utente. Ad esempio, se il conteggio è 1.000.000, prendi in considerazione l'uso di abbreviazioni come 1 M, in modo che troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni della struttura ricettiva. Nota: fornisci questo campo se non vuoi gestire la logica delle abbreviazioni del display. Se sia il valore di conteggio che quello di conteggio useremo Conteggio per mostrarlo agli utenti	Lungo
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	Il prezzo corrente dell'alloggio. Deve essere indicato se viene indicato il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale dell'alloggio, che viene specificato nei nell'interfaccia utente.	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 (Testo troppo lungo può mostrare puntini di sospensione)

`TransportationReservationEntity`

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Testo libero. Ad esempio, "Da SFO a SAN" Dimensioni del testo consigliate: massimo 50 caratteri
Tipo di trasporto	Obbligatorie	La modalità/il tipo di trasporto per la prenotazione.	Enum: VOLO, TRAIN, BUS o FERRY
Ora partenza	Obbligatorie	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
Luogo di partenza - Paese	Facoltativo	Il paese di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo di partenza - Città	Facoltativo	La città di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo di partenza - Indirizzo visualizzato	Facoltativo	Il luogo di partenza che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo di partenza - Indirizzo	Facoltativo	L'indirizzo (se applicabile) del luogo di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo di partenza - Stato	Facoltativo	Lo stato o la provincia (se applicabile) del luogo di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo di partenza - CAP	Facoltativo	Il codice postale (se applicabile) del luogo di partenza.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Luogo 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 Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - Città	Facoltativo	La città di arrivo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - Indirizzo visualizzato	Facoltativo	Il luogo di arrivo che verrà mostrato all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo: via	Facoltativo	La via (se applicabile) del luogo di arrivo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - Stato	Facoltativo	Lo stato o la provincia (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - CAP	Facoltativo	Il codice postale (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Località di arrivo - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di arrivo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o immagine o il provider di servizi di terze parti.	Testo libero. Ad esempio, Nome della compagnia aerea
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o un'immagine o il provider di servizi di terze parti.	Per indicazioni, consulta le Specifiche delle immagini.
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Consigliate le proporzioni sono 16:9	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a 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 - Prezzo attuale	Obbligatorio in modo condizionale	Il prezzo attuale della prenotazione. Deve essere indicato se viene indicato il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che deve essere barrato nei nell'interfaccia utente.	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 (Testo troppo lungo può mostrare puntini di sospensione)
Numero di trasporto	Obbligatorio	Il numero del volo, dell'autobus, del treno o del traghetto/della crociera.	Testo libero
Orario di imbarco	Obbligatorio	Il timestamp dell'epoca 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 provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Fai riferimento a queste domande frequenti	URI
Titolo	Obbligatorie	Titolo dell'entità.	Testo libero. Ad esempio, "Avis Union Square SF" Dimensioni del testo consigliate: massimo 50 caratteri
Orario di ritiro	Obbligatorie	Il timestamp dell'epoca che rappresenta l'orario di ritiro per la prenotazione.	Timestamp in millisecondi
Orario di ritorno	Facoltativo	Il timestamp dell'epoca che rappresenta l'ora del check-out per la prenotazione.	Timestamp in millisecondi
Indirizzo di ritiro: paese	Facoltativo	Il paese del punto di prelievo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritiro: città	Facoltativo	La città del punto di prelievo.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
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	La via (se applicabile) del punto di ritiro.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritiro - Stato	Facoltativo	Lo stato o la provincia (se applicabile) del punto di ritiro.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritiro - CAP	Facoltativo	Il codice postale (se applicabile) del punto di ritiro.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di ritiro - Quartiere	Facoltativo	Il quartiere (se applicabile) del punto di partenza della corsa.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione: paese	Facoltativo	Il paese della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione - Città	Facoltativo	La città della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione: indirizzo visualizzato	Facoltativo	La località di ritorno che verrà mostrata all'utente.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione: via	Facoltativo	La via (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione - 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 restituzione - CAP	Facoltativo	Il codice postale (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Indirizzo di restituzione - Quartiere	Facoltativo	Il quartiere (se applicabile) della località di reso.	Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa
Fornitore di servizi - Nome	Facoltativo	Il nome del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o immagine o il provider di servizi di terze parti.	Testo libero. Ad esempio, "Noleggio auto Avis"
Fornitore di servizi - Immagine	Facoltativo	Il logo/l'immagine del fornitore di servizi. Nota: per il servizio è necessario aggiungere testo o immagine o il provider di servizi di terze parti.	Per indicazioni, consulta le Specifiche delle immagini.
Immagini poster	Facoltativo	Quando vengono fornite più immagini, viene mostrata una sola immagine. Consigliate le proporzioni sono 16:9	Per indicazioni, consulta le Specifiche delle immagini.
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere l'entità. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco sottotitoli	Facoltativo	Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: la descrizione o l'elenco di sottotitoli verranno visualizzati mostrati all'utente, non a entrambi.	Testo libero Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri
ID conferma	Facoltativo	L'ID di conferma della prenotazione del noleggio del veicolo.	Testo libero
Prezzo - Prezzo attuale	Obbligatorio in modo condizionale	Il prezzo attuale della prenotazione. Deve essere indicato se viene indicato il prezzo barrato.	Testo libero
Prezzo - StrikethroughPrice	Facoltativo	Il prezzo originale della prenotazione, che deve essere barrato nei nell'interfaccia utente.	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 (Testo troppo lungo può mostrare puntini di sospensione)

Specifiche per le immagini

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

Proporzioni	Numero minimo di pixel	Pixel consigliati
Quadrato (1 x 1) Preferita	300x300	1200x1200
Orizzontale (1,91 x 1)	600x314	1200x628
Verticale (4 x 5)	480x600	960x1200

Proporzioni

Numero minimo di pixel

Pixel consigliati

Quadrato (1 x 1)

Preferita

300x300

1200x1200

Orizzontale (1,91 x 1)

600x314

1200x628

Verticale (4 x 5)

480x600

960x1200

Le immagini devono essere ospitate su CDN pubbliche per consentire a Google di accedervi che li rappresentano.

Formati file

PNG, JPG, GIF statica, WebP

Dimensioni massime del file

5120 kB

Consigli aggiuntivi

Area di sicurezza dell'immagine:inserisci i contenuti importanti al centro dell'80% della sezione dell'immagine.
Utilizza uno sfondo trasparente per consentire una corretta visualizzazione dell'immagine Impostazioni tema scuro e chiaro.

Categoria di contenuti

La categoria di contenuti consente alle app di pubblicare contenuti appartenenti a più categorie 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 per consentire a Google di accedervi che li rappresentano.

Linee guida per l'utilizzo delle categorie di contenuti

Alcune entità come ArticleEntity e GenericFeatureEntity sono idonei all'utilizzo di una qualsiasi delle categorie di contenuti. Per altre entità come Solo EventEntity, EventReservationEntity, PointOfInterestEntity un sottoinsieme di queste categorie è idoneo. Consultare l'elenco delle categorie idoneo per un tipo di entità prima di compilare l'elenco.
Utilizzare il tipo di entità specifico per alcune categorie di contenuti rispetto a una combinazione delle entità Generic e ContentCategory:
- TYPE_MovieS_AND_TV_SHOWS. Controlla le entità di Guarda la guida all'integrazione prima di utilizzare il o entità generiche.
- TYPE_BOOKS - Consulta EbookEntity prima di utilizzare o entità generiche.
- TYPE_AUDIOBOOKS - Pagamento AudiobookEntity prima del giorno utilizzando le entità generiche.
- TYPE_SHOPPING - Pagamento ShoppingEntity prima del giorno utilizzando le entità generiche.
- TYPE_FOOD_AND_DRINK - Controlla le entità di Guida all'integrazione alimentare prima di utilizzare la o entità generiche.
Il campo ContentCategory è facoltativo e deve essere lasciato vuoto se i contenuti non appartengono a nessuna delle categorie menzionate in precedenza.
Nel caso in cui vengano fornite più categorie di contenuti, indicale nell'ordine indicato della pertinenza rispetto ai contenuti con la categoria di contenuti più pertinente per primo 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 pianificato con cadenza regolare o evento (ad esempio, ogni volta l'utente apre l'app o quando ha appena aggiunto qualcosa al carrello).

AppEngagePublishClient è responsabile della pubblicazione dei cluster.

Esistono le API seguenti 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.
    }
});

`publishRecommendationClusters`

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

Kotlin

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

Java

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

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

I dati esistenti relativi a RecommendationCluster dello sviluppatore partner verranno rimossi.
I dati della richiesta vengono analizzati e archiviati nel suggerimento aggiornato di un cluster Kubernetes.

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

`publishFeaturedCluster`

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

Kotlin

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

Java

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

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

I dati esistenti relativi a FeaturedCluster dello sviluppatore partner verranno 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 viene mantenuta.

`publishContinuationCluster`

Questa API viene utilizzata per pubblicare un oggetto ContinuationCluster.

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, vengono eseguite le seguenti azioni: una transazione:

I dati esistenti relativi a ContinuationCluster dello sviluppatore partner verranno rimossi.
I dati della richiesta vengono analizzati e archiviati nella continuazione aggiornata di un cluster Kubernetes.

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

`publishUserAccountManagementRequest`

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

I seguenti metadati fanno parte della scheda di accesso:

Attributo	Requisito	Descrizione
URI azione	Obbligatorio	Link diretto all'azione (ad esempio, per passare 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	Titolo sulla scheda
Testo dell'azione	Facoltativo	Testo mostrato sull'invito all'azione (ad es. Accedi)
Sottotitolo	Facoltativo	Sottotitolo facoltativo sulla scheda

Kotlin

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

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

Java

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

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

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

I dati di UserAccountManagementCluster esistenti dallo sviluppatore partner sono rimosso.
I dati della richiesta vengono analizzati e archiviati nel Cluster UserAccountManagementCluster.

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

`updatePublishStatus`

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

Indicare lo stato in tutti gli scenari, anche quando i contenuti vengono pubblicati (STATO == PUBBLICATO), è fondamentale per compilare le dashboard che utilizzano questo stato esplicito per comunicare lo stato di integrità e altre metriche della tua integrazione.
Se non sono stati pubblicati contenuti, ma lo stato dell'integrazione non funziona (STATUS == NOT_PUBLISHERED), Google può evitare di attivare avvisi nell'app dashboard dell'integrità. Conferma che i contenuti non sono stati pubblicati a causa di un situazione prevista dal punto di vista del provider.
Consente agli sviluppatori di capire quando i dati vengono pubblicati e quando .
Google potrebbe utilizzare i codici di stato per sollecitare l'utente a eseguire determinate azioni in dell'app in modo da poter vedere o risolvere i contenuti dell'app.

Ecco un elenco di codici di stato idonei per la pubblicazione :

// 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, consigliamo di pubblicare la scheda di accesso. Se, per qualsiasi motivo, i fornitori non riescono per pubblicare la scheda di accesso, ti consigliamo di chiamare il API updatePubblicaStatus con il codice di stato NOT_PUBLISHERED_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 dei suggerimenti.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteContinuationCluster`

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

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

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteClusters`

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

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_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 corrispondenti ai tipi di cluster specificati. I clienti possono scegliere di superare uno o per molti tipi di cluster. In caso di errore, l'intera richiesta viene rifiutata e viene mantenuto.

Gestione degli errori

Ti consigliamo vivamente di ascoltare il risultato dell'attività dalle API di pubblicazione, ad esempio che è 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 con la causa inclusa come un codice di errore.

Codice di errore	Nota
`SERVICE_NOT_FOUND`	Il servizio non è disponibile sul dispositivo specificato.
`SERVICE_NOT_AVAILABLE`	Il servizio è disponibile sul dispositivo specificato, ma non lo è al momento della chiamata (ad esempio, è esplicitamente disabilitata).
`SERVICE_CALL_EXECUTION_FAILURE`	Esecuzione dell'attività non riuscita a causa di problemi di thread. In questo caso, da riprovare.
`SERVICE_CALL_PERMISSION_DENIED`	Il chiamante non è autorizzato a effettuare la chiamata di servizio.
`SERVICE_CALL_INVALID_ARGUMENT`	La richiesta contiene dati non validi (ad esempio, più del numero consentito di cluster).
`SERVICE_CALL_INTERNAL`	Si è verificato un errore sul lato del servizio.
`SERVICE_CALL_RESOURCE_EXHAUSTED`	La chiamata all'assistenza viene effettuata troppo spesso.

Passaggio 3: gestisci gli intent di trasmissione

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

L'obiettivo degli intent di trasmissione è principalmente la riattivazione dell'app e l'applicazione forzata dei dati sincronizzare. Gli intent di trasmissione non sono progettati per essere inviati molto spesso. È solo attivata quando il servizio Engage stabilisce che i contenuti potrebbero essere obsoleti (ad esempio, una settimana fa). In questo modo, l'utente può avere una maggiore sicurezza nuova esperienza con i contenuti, anche se l'applicazione non è stata eseguita per per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei due modi seguenti:

Registra dinamicamente un'istanza della classe BroadcastReceiver utilizzando Context.registerReceiver(). Ciò consente la comunicazione dalle applicazioni ancora 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));

}

Dichiarare in modo statico un'implementazione con il tag <receiver> nel tuo AndroidManifest.xml file. Ciò consente all'applicazione di ricevere annunci quando non è in esecuzione e consente inoltre all'applicazione di pubblicare dei 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 servizio:

com.google.android.engage.action.PUBLISH_RECOMMENDATION È consigliato per avviare una chiamata publishRecommendationClusters quando ricevi questo intent.
com.google.android.engage.action.PUBLISH_FEATURED È consigliabile avvia una chiamata publishFeaturedCluster quando ricevi questo intent.
com.google.android.engage.action.PUBLISH_CONTINUATION È consigliabile avvia una chiamata publishContinuationCluster quando ricevi questo intent.

Flusso di lavoro di integrazione

Per una guida passo passo sulla verifica dell'integrazione dopo il suo completamento, consulta Flusso di lavoro per l'integrazione degli sviluppatori del coinvolgimento.

Domande frequenti

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

Contact

Contatto engagement-developers@google.com se ci sono a eventuali domande durante il processo di integrazione.

Passaggi successivi

Dopo aver completato l'integrazione, i passaggi successivi sono i seguenti:

Invia un'email a engagement-developers@google.com e Allega l'APK integrato pronto per i test da parte di Google.
Google esegue una verifica ed esamina internamente per assicurarsi che che funzioni come previsto. Se sono necessarie modifiche, Google ti contatta con tutti i dettagli necessari.
Quando il test è stato completato e non sono necessarie modifiche, Google ti contatta per ti comunicherà che puoi iniziare a pubblicare l'APK aggiornato e integrato per dal Play Store.
Dopo che Google avrà confermato la pubblicazione dell'APK aggiornato su Play Store, il tuo Consiglio, In primo piano e Continuazione possono essere pubblicati ed essere visibili agli utenti.