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 propri contenuti avanzati migliori in un canale dedicato al di fuori della loro app. Questa guida contiene le istruzioni per gli sviluppatori partner per integrare i propri contenuti relativi a salute e fitness, utilizzando l'SDK Engage per compilare 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 su salute e fitness di un singolo sviluppatore partner. Questi consigli possono essere personalizzati in base all'utente o essere generalizzati (ad esempio, tendenze per fitness e salute). Usali per mettere in evidenza articoli o persone correlati a salute e fitness.
- Un cluster di consigli può essere composto da
ArticleEntity
,PersonEntity
oEventEntity
, ma non da una combinazione di diversi tipi di entità.
I consigli hanno la seguente struttura:
Gruppo di consigli: una visualizzazione dell'interfaccia utente che contiene un gruppo di consigli dello stesso sviluppatore partner.
Entità: un oggetto che rappresenta un singolo elemento in un cluster. Questa integrazione offre alcune entità che verrebbero visualizzate utilizzando il cluster di consigli:
ArticleEntity: rappresenta un consiglio per contenuti basati su testo correlati a salute e fitness. Può essere utilizzato per articoli, post del blog, contenuti di marketing, snippet di notizie e così via.
PersonEntity: PersonEntity rappresenta una persona. I consigli potrebbero essere finalizzati a mettere in evidenza un allenatore o qualsiasi persona legata a salute e fitness e così via.
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. Questa entità potrebbe essere utilizzata per mostrare eventi come campi di donazione del sangue, sessioni di allenamento, palestra o corsi di yoga e così via, relativi a salute e fitness.
- Un cluster di consigli può essere composto da
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 continui possono avere la seguente struttura:
ArticleEntity: rappresenta un consiglio per contenuti basati su testo correlati a salute e fitness. Questa entità può essere utilizzata per rappresentare articoli di notizie incompleti o altri contenuti che l'utente vorrebbe continuare a consumare da dove li aveva interrotti. Esempio: snippet di notizie, snippet di post del blog su argomenti relativi a salute o fitness.
EventReservationEntity: EventReservationEntity rappresenta la prenotazione di un evento e aiuta gli utenti a monitorare le prenotazioni di eventi di fitness e salute imminenti o in corso. Esempio: sessioni di formazione
Il cluster In primo piano mostra una selezione di entità di più partner di sviluppatori in un raggruppamento di UI. Ci sarà un singolo cluster in primo piano, visualizzato nella parte superiore dell'interfaccia utente con un posizionamento prioritario sopra tutti i cluster dei suggerimenti. Ogni sviluppatore partner potrà trasmettere fino a 10 entità 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.
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 client 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 consigli | Al massimo 5 | Almeno 5 | Al massimo 25 (ArticleEntity , PersonEntity o
EventEntity ) |
Cluster di continuazione | Al massimo 1 | Almeno 1 | Al massimo 10 (ArticleEntity o
EventReservationEntity ) |
Cluster in primo piano | Al massimo 1 | Almeno 1 | Al massimo 10 (GenericFeaturedEntity ) |
Passaggio 1: fornisci i dati delle entità
L'SDK ha definito diverse entità per rappresentare ogni tipo di elemento. Supportiamo le seguenti entità per la categoria Salute e fitness:
GenericFeaturedEntity
ArticleEntity
PersonEntity
EventEntity
EventReservationEntity
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 dei 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 avere uno spazio sicuro di 24 dps sia nella parte superiore che nella parte 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, ognuno con una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi. |
Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 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/il video, ad esempio come overlay del badge sull'immagine
|
|
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 speciale per l'esperienza utente, ad esempio overlay del badge sulla miniatura dell'immagine o 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 | Obbligatorie | Titolo dell'entità. | Testo libero Dimensioni del testo consigliate: massimo 50 caratteri |
Immagini dei poster | Facoltativo | Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio di sicurezza di 24 dpi sia in alto che in basso nell'immagine. |
Per indicazioni, consulta le specifiche per le immagini. |
Origine - Titolo | Facoltativo | Il nome dell'autore, dell'organizzazione o dell'autore della segnalazione | Testo libero Dimensione del testo consigliata: meno di 25 caratteri |
Origine - 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, ognuno con una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi. |
Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 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/il video, ad esempio come overlay del badge sull'immagine
|
|
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 speciale per l'esperienza utente, ad esempio overlay del badge sulla miniatura dell'immagine o del video. 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 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 in modo condizionale | Il timestamp dell'epoca in millisecondi durante l'ultima volta che l'utente ha interagito con questa entità. Nota: questo campo è obbligatorio se questa entità fa parte del cluster di continuazione. |
Timestamp epoch in millisecondi |
Percentuale di avanzamento | Obbligatorio in modo condizionale | 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. |
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 questa domanda frequente |
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 | Obbligatorio |
Immagine del profilo o 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, 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 per le immagini. |
Immagine intestazione | Facoltativo | Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio di sicurezza di 24 dpi sia in alto che in basso nell'immagine. |
Per indicazioni, consulta le specifiche per le immagini. |
Popolarità - Conteggio | Facoltativo |
Indica il numero di follower o il valore della popolarità, ad esempio - "3,7 milioni". Nota: se vengono forniti sia Conteggio sia Valore conteggio, verrà utilizzato il 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 il valore di conteggio se la tua app non vuole gestire la logica su come ottimizzare un numero elevato per dimensioni di visualizzazione diverse. Se vengono forniti sia Conteggio che Valore di 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à - Immagini | Facoltativo |
Indica lo scopo dell'interazione. Ad esempio, immagine che mostra icona Mi piace, emoji. È possibile fornire più di un'immagine, ma non tutte potrebbero essere mostrate in tutti i fattori di forma. Nota: deve essere un'immagine quadrata 1:1 |
Per indicazioni, consulta le specifiche per le 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 controlla come il conteggio viene visualizzato dagli 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 per l'entità. Nota: fornisci questo campo se non gestisci autonomamente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio sia Valore conteggio, viene visualizzato Conteggio. |
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 Dimensione del testo consigliata: massimo 20 caratteri |
Posizione - Indirizzo | Facoltativo | L'indirizzo (se applicabile) in cui si trova la persona o viene servito il servizio. | Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa |
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) in cui si trova la persona o dove presta 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 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 Dimensione del testo consigliata: massimo 15 caratteri |
Badge - Immagine | Facoltativo | Immagine piccola Trattamento speciale per l'esperienza utente, ad esempio overlay del badge sulla miniatura dell'immagine o del video. 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: 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, ognuno con una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, 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
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 questa domanda frequente |
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 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 | Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: le immagini sono vivamente consigliate. Se viene fornito un badge, assicurati di lasciare uno spazio di sicurezza di 24 dpi sia in alto che in basso nell'immagine. |
Per indicazioni, consulta le Specifiche delle 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 |
Località - 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 condizionalmente | 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 Dimensione del testo consigliata: massimo 20 caratteri |
Posizione - Indirizzo | Facoltativo | L'indirizzo (se applicabile) della sede in cui si svolge l'evento. | Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa |
Località - Stato | Facoltativo | Lo stato o la provincia (se applicabile) in cui viene organizzato 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 verrà rappresentato in millisecondi. |
Timestamp epoch in millisecondi |
Descrizione | Facoltativo | Un singolo paragrafo di testo per descrivere l'entità. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi. |
Testo libero Dimensioni del testo consigliate: 180 caratteri |
Elenco dei sottotitoli | Facoltativo | Fino a 3 sottotitoli, ognuno con una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi. |
Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 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 Dimensione del testo consigliata: massimo 15 caratteri |
Badge - Immagine | Facoltativo | Immagine piccola Trattamento speciale per l'esperienza utente, ad esempio overlay del badge sulla miniatura dell'immagine o del video. Nota: per il badge è necessario un testo o un'immagine |
Per indicazioni, consulta le specifiche per le immagini. |
Prezzo - CurrentPrice | Obbligatorio condizionalmente |
L'attuale prezzo 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 del prezzo | Facoltativo | Apposito callout del prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile. | Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione) |
Categorie di contenuti | Facoltativo | Descrivi la categoria dei contenuti nell'entità. | Elenco di enum idonei
Per indicazioni, consulta la sezione Categoria di contenuti. |
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 | 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 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 |
Località - 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 condizionalmente | 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 Dimensione del testo consigliata: massimo 20 caratteri |
Posizione - Indirizzo | Facoltativo | L'indirizzo (se applicabile) della sede in cui si svolge l'evento. | Testo libero Dimensioni del testo consigliate: massimo 20 caratteri circa |
Località - Stato | Facoltativo | Lo stato o la provincia (se applicabile) in cui viene organizzato 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 poster | Facoltativo | Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9 Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio di sicurezza di 24 dpi sia in alto che in basso nell'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 verrà rappresentato 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 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, ognuno con una singola riga di testo. Nota: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi. |
Testo libero Dimensione del testo consigliata per ogni sottotitolo: massimo 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 Dimensione del testo consigliata: massimo 15 caratteri |
Badge - Immagine | Facoltativo | Immagine piccola Trattamento speciale per l'esperienza utente, ad esempio overlay del badge sulla miniatura dell'immagine o del video. 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 - CurrentPrice | Obbligatorio condizionalmente |
L'attuale prezzo 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 del prezzo | Facoltativo | Apposito callout del prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile. | Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare 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 |
Valutazione - 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 visualizzata 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 autonomamente la logica di visualizzazione dell'abbreviazione. 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
Per indicazioni, consulta la sezione Categoria di contenuti. |
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 |
300x300 | 1200 x 1200 |
Orizzontale (1,91 x 1) | 600 x 314 | 1200 x 628 |
Ritratto (4 x 5) | 480x600 | 960x1200 |
Le immagini devono essere ospitate su CDN pubbliche per consentire a Google di accedervi.
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
- Alcune entità, come ArticleEntity e GenericFeaturedEntity, sono idonee all'utilizzo di qualsiasi categoria di contenuti. Per altre entità come EventEntity, EventReservationEntity, PersonEntity, solo un sottoinsieme di queste categorie è idoneo. Controlla l'elenco delle categorie idonee per un tipo di entità prima di compilarlo.
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.
Il campo ContentCategory è facoltativo e deve essere lasciato vuoto se i contenuti non appartengono a nessuna delle categorie sopra menzionate.
Se vengono fornite più categorie di contenuti, forniscile nell'ordine di pertinenza per i contenuti, con la categoria più pertinente posizionata 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. } });
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, all'interno di una transazione vengono eseguite le seguenti azioni:
- I dati esistenti relativi a
RecommendationCluster
dello sviluppatore partner verranno rimossi. - I dati della richiesta vengono analizzati e archiviati nel cluster di consigli aggiornato.
In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.
publishFeaturedCluster
Questa API viene utilizzata per pubblicare un elenco di oggetti FeaturedCluster
.
Kotlin
client.publishFeaturedCluster( PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishFeaturedCluster( new PublishFeaturedClustersRequest.Builder() .addFeaturedCluster( new FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
Quando il servizio riceve la richiesta, vengono eseguite le seguenti azioni all'interno di una transazione:
- I dati
FeaturedCluster
esistenti del partner sviluppatore vengono rimossi. - I dati della richiesta vengono analizzati e archiviati nel cluster in primo piano aggiornato.
In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.
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 all'interno di una transazione:
- I dati esistenti relativi a
ContinuationCluster
dello sviluppatore partner verranno 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 di accesso . L'azione di accesso indirizza gli utenti alla pagina di accesso dell'app in modo che l'app possa pubblicare contenuti (o fornire contenuti più personalizzati).
I seguenti metadati fanno parte della scheda Accedi:
Attributo | Requisito | Descrizione |
---|---|---|
URI azione | Obbligatorio | Link diretto all'azione (ad es. alla pagina di accesso all'app) |
Immagine | (Facoltativo) Se non viene fornito, deve essere fornito il titolo |
Immagine mostrata sulla scheda Immagini con proporzioni 16 x 9 e 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 |
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 viene pubblicato, ti consigliamo vivamente di aggiornare lo stato di pubblicazione utilizzando l'API updatepublishStatus. Questo è importante perché:
- Fornire lo stato in tutti gli scenari, anche quando i contenuti vengono pubblicati (STATO == PUBBLICATO), è fondamentale per compilare le dashboard che usano questo stato esplicito per comunicare lo stato di integrità e altre metriche dell'integrazione.
- Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non è interrotto (STATUS == NOT_PUBLISHERED), Google può evitare di attivare avvisi nelle dashboard sullo stato 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.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
Quando il servizio riceve la richiesta, rimuove i dati esistenti dai gruppi di consigli. In caso di errore, l'intera richiesta viene rifiutata e viene mantenuto lo stato esistente.
deleteFeaturedCluster
Questa API viene utilizzata per eliminare i contenuti del cluster in primo piano.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster in primo piano. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.
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 dal cluster di continuazione. In caso di errore, l'intera richiesta viene rifiutata e viene mantenuto lo stato esistente.
deleteUserManagementCluster
Questa API viene utilizzata per eliminare i contenuti del cluster UserAccountManagement.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster UserAccountManagement. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.
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 i cluster corrispondenti ai tipi di cluster specificati. I client possono scegliere di passare uno o più tipi di cluster. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.
Gestione degli errori
Ti consigliamo vivamente di ascoltare il risultato dell'attività dalle API di pubblicazione in modo da poter intraprendere un'azione di follow-up per recuperare e inviare nuovamente un'attività riuscita.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(..) .build()) .addOnCompleteListener { task -> if (task.isSuccessful) { // do something } else { val exception = task.exception if (exception is AppEngageException) { @AppEngageErrorCode val errorCode = exception.errorCode if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } }
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(...) .build()) .addOnCompleteListener( task -> { if (task.isSuccessful()) { // do something } else { Exception exception = task.getException(); if (exception instanceof AppEngageException) { @AppEngageErrorCode int errorCode = ((AppEngageException) exception).getErrorCode(); if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } });
L'errore viene restituito come AppEngageException
e la causa è inclusa sotto forma di codice di errore.
Codice di errore | Nome dell'errore | Nota |
---|---|---|
1 |
SERVICE_NOT_FOUND |
Il servizio non è disponibile sul dispositivo specificato. |
2 |
SERVICE_NOT_AVAILABLE |
Il servizio è disponibile sul dispositivo specificato, ma non al momento della chiamata (ad esempio, è disattivato esplicitamente). |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
L'esecuzione dell'attività non è riuscita a causa di problemi di threading. In questo caso, è possibile eseguire nuovamente il tentativo. |
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.
Lo scopo degli intent di trasmissione è principalmente la riattivazione dell'app e l'applicazione forzata della sincronizzazione dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto di frequente. Viene attivata solo quando il servizio Engage determina che i contenuti potrebbero essere obsoleti (ad esempio, risalenti a una settimana prima). In questo modo, è più sicura che l'utente possa usufruire di una nuova esperienza con i contenuti, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.
BroadcastReceiver
deve essere configurato nei seguenti due modi:
- Registra in modo dinamico un'istanza della classe
BroadcastReceiver
utilizzandoContext.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)); }
- Dichiarare in modo statico un'implementazione con il tag
<receiver>
nel fileAndroidManifest.xml
. 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 chiamatapublishRecommendationClusters
quando si riceve questa intenzione.com.google.android.engage.action.PUBLISH_FEATURED
Ti consigliamo di avviare una chiamatapublishFeaturedCluster
quando ricevi questo intent.com.google.android.engage.action.PUBLISH_CONTINUATION
Ti consigliamo di avviare una chiamatapublishContinuationCluster
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 approfondire.
Contatto
Contatta engage-developers@google.com in caso di domande durante la procedura di integrazione.
Passaggi successivi
Dopo aver completato l'integrazione, i passaggi successivi sono i seguenti:
- Invia un'email all'indirizzo engagement-developers@google.com 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 contatta fornendoti i dettagli necessari.
- Al termine del test, se non sono necessarie modifiche, Google ti contatta per informarti che puoi iniziare a pubblicare l'APK aggiornato e integrato sul Play Store.
- Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i cluster Consiglio, In evidenza e Continuazione potrebbero essere pubblicati e visibili agli utenti.