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 dell'app.Questa guida contiene istruzioni che aiutano gli sviluppatori partner a integrare i propri contenuti relativi agli incontri, utilizzando l'SDK Engage per completare questo nuovo in base all'area geografica.
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 per gli appuntamenti di un singolo sviluppatore partner. Questi consigli possono essere personalizzati per l'utente.
- Un cluster di suggerimenti può essere composto da
ArticleEntity
,PersonEntity
, oEventEntity
, ma non una combinazione di tipi di entità diversi.
I consigli hanno la seguente struttura:
Cluster dei suggerimenti:una visualizzazione UI che contiene un gruppo di contenuti consigliati dallo stesso partner di sviluppo.
Entità: un oggetto che rappresenta un singolo elemento in un cluster. Questo offre alcune entità che verrebbero scoperte utilizzando Cluster di suggerimenti:
ArticleEntity: ArticleEntity rappresenta una raccomandazione per contenuti testuali correlati agli incontri. Elemento ArticleEntity consente agli sviluppatori di fornire una varietà di contenuti di testo e immagini con più metadati per articolare le informazioni agli utenti.
PersonEntity: PersonEntity rappresenta una persona. La i consigli potrebbero essere quelli di mettere in evidenza una persona potenziali clienti.
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.
- Un cluster di suggerimenti può essere composto da
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 rappresenta una raccomandazione per contenuti testuali correlati agli incontri. Questa entità può essere utilizzata per rappresentare articoli da completare o altri contenuti che l'utente potrebbe continuare a consumare dal punto in cui l'aveva lasciata.
EventReservationEntity: EventReservationEntity rappresenta per un evento e aiuta gli utenti a monitorare quelli in programma o in corso prenotazioni di incontri e incontri.
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.
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 , 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 dell'entità
L'SDK ha definito diverse entità per rappresentare ogni tipo di elemento. Supportiamo le seguenti entità per la categoria Incontri:
GenericFeaturedEntity
ArticleEntity
PersonEntity
EventEntity
EventReservationEntity
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 24 ore di spazio di sicurezza. 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
|
|
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 speciale per l'esperienza utente sopra l'immagine o il video, ad esempio come badge sovrapposizione sull'immagine
|
|
Badge - Testo | Facoltativo | Titolo del badge Nota: per il badge è necessario un testo o un'immagine |
Testo libero Dimensioni del testo consigliate: massimo 15 caratteri |
Badge - Immagine | Facoltativo | Immagine piccola Trattamento 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. |
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 |
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 |
Per indicazioni, consulta le Specifiche delle immagini. |
Popolarità - Conteggio | Facoltativo |
Indica il numero di follower o il valore della popolarità, ad esempio: "3,7 M.". Nota: se sono forniti sia Conteggio che Valore di conteggio, Verrà utilizzato il conteggio |
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, Il conteggio viene mostrato agli utenti. |
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, ma 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
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
Consulta la sezione Categoria di contenuti per assistenza. |
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
Consulta la sezione Categoria di contenuti per assistenza. |
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 |
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 EventEntity, EventReservationEntity, PersonEntity, solo un sottoinsieme di queste categorie sono idonee. Consulta l'elenco delle categorie idonee 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 lo stato esistente.
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 lo stato esistente.
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, può 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
utilizzandoContext.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 tuoAndroidManifest.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 chiamatapublishRecommendationClusters
quando ricevi questo intent.com.google.android.engage.action.PUBLISH_FEATURED
È consigliabile avvia una chiamatapublishFeaturedCluster
quando ricevi questo intent.com.google.android.engage.action.PUBLISH_CONTINUATION
È consigliabile avvia una chiamatapublishContinuationCluster
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.
Contatto
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.