Coinvolgi SDK Health and Fitness: istruzioni per l'integrazione tecnica di terze parti

Google sta sviluppando una piattaforma sul dispositivo che organizza le app degli utenti per verticali e consente una nuova esperienza immersiva per la fruizione e la scoperta dei contenuti delle app personalizzate. Questa esperienza a schermo intero offre agli sviluppatori partner l'opportunità di mostrare i loro migliori contenuti avanzati in un canale dedicato al di fuori della loro app.Questa guida contiene istruzioni per gli sviluppatori partner per integrare i loro contenuti su 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 di salute e fitness di un singolo sviluppatore partner. Questi consigli possono essere personalizzati per l'utente o generalizzati (ad esempio, di tendenza relativi a fitness e salute). Usali per mettere in evidenza articoli o persone correlati a salute e fitness.

    • Un cluster di suggerimenti può essere creato come ArticleEntity, PersonEntity o EventEntity, ma non con una combinazione di tipi di entità diversi.

    I consigli hanno la seguente struttura:

    • Cluster di suggerimenti:una visualizzazione UI contenente un gruppo di suggerimenti dallo stesso partner di sviluppatori.

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

      • ArticleEntity: ArticleEntity rappresenta un consiglio per i contenuti testuali correlati a salute e fitness. Può essere usata per articoli, post di blog, contenuti di marketing, snippet di notizie e così via.

        Figura 1: UI che mostra un singolo ArticleEntity all'interno del cluster Recommendations.
      • PersonEntity: PersonEntity rappresenta una persona. I consigli potrebbero essere quelli di mettere in evidenza un coach o una persona correlata a salute e fitness e così via.

        Figura 2: UI che mostra una singola PersonEntity all'interno del cluster Recommendations.
      • EventEntity: EventEntity rappresenta un evento futuro. L'ora di inizio dell'evento è un'informazione fondamentale che deve essere comunicata agli utenti. Questa entità può essere utilizzata per mostrare eventi come campi di donazione del sangue, sessioni di allenamento, lezioni in palestra o yoga e così via relativi a salute e fitness.

        Figura 3: UI che mostra un singolo EventEntity all'interno del cluster Recommendations.
  • Il cluster Continuazione mostra i contenuti recentemente coinvolti dagli utenti di più sviluppatori partner 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: ArticleEntity rappresenta un consiglio per contenuti basati su testo correlati a salute e fitness. Questa entità può essere utilizzata per rappresentare articoli di notizie non completati o altri contenuti che l'utente vorrebbe continuare a utilizzare dal punto in cui l'ha lasciato. Esempio: snippet di notizie, snippet del post del blog su argomenti correlati alla salute o al fitness.

      Figura 6. UI che mostra un singolo ArticleEntity all'interno di un cluster Continuation.
    • 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

      Figura 8. UI che mostra un singolo EventReservationEntity all'interno di un cluster Continuation.
  • Il cluster In primo piano è una visualizzazione UI che mostra l'hero GenericFeaturedEntity scelto da molti sviluppatori partner in un unico raggruppamento della UI. È presente un singolo cluster in primo piano, visualizzato nella parte superiore dell'interfaccia utente, con un posizionamento prioritario sopra tutti i cluster dei suggerimenti. Ogni partner di sviluppatori è autorizzato a trasmettere una singola entità di un tipo supportato in In primo piano, con molte entità (potenzialmente di tipo diverso) da più sviluppatori di app nel cluster in primo piano.

    • GenericFeatureEntity: è diverso dall'elemento Consiglio perché deve essere utilizzato per un unico contenuto principale degli sviluppatori e deve rappresentare i singoli contenuti più importanti che saranno interessanti e pertinenti per gli utenti.

      Figura 12: UI che mostra una singola scheda GenericFeatureEntity hero all'interno di un cluster in primo piano

Attività preliminare

Livello API minimo: 19

Aggiungi la raccolta com.google.android.play:engage 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.4.1'
}

Riepilogo

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

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 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 Salute e fitness:

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. PersonEntity
  4. EventEntity
  5. 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. Consulta 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 uno spazio sicuro di 24 dps sia nella parte superiore che nella parte 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: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri

Elenco 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

Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri

Badge Facoltativo

Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.

Trattamento UX speciale sopra l'immagine o il video, ad esempio come overlay del badge sull'immagine

  • Ad es. "Aggiornamento in tempo reale"
  • Ad es. Durata della lettura dell'articolo

Badge - Testo Facoltativo

Titolo del badge

Nota: per il badge è necessario un testo o un'immagine

Testo libero

Dimensioni del testo consigliate: massimo 15 caratteri

Badge - Immagine Facoltativo

Immagine piccola

Trattamento speciale per l'esperienza utente, ad esempio come 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.
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 provider.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta 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 viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine

Per indicazioni, consulta le Specifiche delle immagini.
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: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri

Elenco 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

Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri

Badge Facoltativo

Ogni badge è in testo libero (massimo 15 caratteri) o immagine di piccole dimensioni.

Trattamento UX speciale sopra l'immagine o il video, ad esempio come overlay del badge sull'immagine

  • Ad es. "Aggiornamento in tempo reale"
  • Ad es. Durata della lettura dell'articolo

Badge - Testo Facoltativo

Titolo del badge

Nota: per il badge è necessario un testo o un'immagine

Testo libero

Dimensioni del testo consigliate: massimo 15 caratteri

Badge - Immagine Facoltativo

Immagine piccola

Trattamento speciale per l'esperienza utente, ad esempio come 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 dell'epoca in millisecondi relativo al momento in cui i contenuti sono stati pubblicati / aggiornati nell'app. Timestamp 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 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 questa 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 provider.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti

URI
Profilo - Nome Obbligatorie Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel" e così via.

Stringa

Dimensioni del testo consigliate: massimo 50 caratteri

Profilo - Avatar Obbligatorie

Immagine del profilo o immagine dell'avatar dell'utente.

Nota: deve essere un'immagine quadrata 1:1.

Per indicazioni, consulta le Specifiche delle immagini.
Profilo - Testo aggiuntivo Facoltativo Testo libero come l'handle del profilo.

Testo libero

Dimensioni del testo consigliate: massimo 15 caratteri

Profilo - Immagine aggiuntiva Facoltativo Immagine piccola come un badge di verifica. Per indicazioni, consulta le Specifiche delle immagini.
Immagine intestazione Facoltativo

Quando vengono fornite più immagini, viene mostrata una sola immagine. Le proporzioni consigliate sono 16:9

Nota: le immagini sono vivamente consigliate. Se viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine

Per indicazioni, consulta le Specifiche delle immagini.
Popolarità - Conteggio Facoltativo

Rappresenta l'immagine intestazione. Deve essere diversa dall'immagine del profilo. Questa opzione può essere utilizzata se è disponibile un'immagine aggiuntiva per mettere in evidenza l'interesse della persona sul suo lavoro.

Nota: deve essere un'immagine in formato 16:9. Se viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine

Stringa

Dimensione del testo consigliata: massimo 20 caratteri combinati per conteggio + etichetta

Popolarità - Valore conteggio Facoltativo

Il numero di follower o il valore della popolarità.

Nota:fornisci un valore di conteggio se l'app non vuole gestire la logica di ottimizzazione di un numero elevato per dimensioni di display diverse. Se vengono forniti sia Conteggio che Valore di conteggio, verrà utilizzato Conteggio.

Lungo
Popolarità - Etichetta Facoltativo Indica l'etichetta della popolarità, ad esempio "Mi piace".

Stringa

Dimensione del testo consigliata: massimo 20 caratteri combinati per conteggio + etichetta

Popolarità - Immagini Facoltativo

Indica il motivo dell'interazione. Ad esempio: immagine che mostra l'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 delle immagini.
Valutazione - Valore massimo Obbligatorio

Il valore massimo della scala di valutazione.

Deve essere fornito se viene fornito anche il valore corrente della valutazione.

Numero >= 0,0
Classificazione - Valore corrente Obbligatorio

Il valore attuale della scala di valutazione.

Deve essere fornito se viene fornito anche il valore massimo della valutazione.

Numero >= 0,0
Valutazione - Conteggio Facoltativo

Il conteggio delle valutazioni per l'entità.

Nota: fornisci questo campo se la tua app vuole controllare come viene visualizzato dagli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di usare abbreviazioni come 1 M, in modo che non venga 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 personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Conteggio, utilizzeremo il valore di 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à mostrato all'utente.

Testo libero

Dimensioni del testo consigliate: massimo 20 caratteri circa

Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) della persona o del luogo in cui si trova il servizio.

Testo libero

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 come 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 di sottotitoli, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri

Elenco 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

Dimensioni del testo consigliate per ogni sottotitolo: max 50 caratteri

Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum idonee

  • TYPE_HEALTH_AND_FITENESS (ad es. Istruttore di yoga/fitness)
  • TYPE_HOME_AND_AUTO (ad es. idraulico)
  • TYPE_SPORTS (ad es. giocatore)
  • DATA_TIPO

Per indicazioni, consulta la sezione Categoria di contenuti.

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. Consulta 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 viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine

Per indicazioni, consulta le Specifiche delle immagini.
Località - Paese Obbligatorio in modo condizionale

Il paese in cui si svolge l'evento.

Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o HYBRID

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 HYBRID

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 deve essere mostrato all'utente.

Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o HYBRID

Testo libero

Dimensioni del testo consigliate: massimo 20 caratteri circa

Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) del luogo in cui si tiene 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 ospitato l'evento.

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.

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: all'utente verrà mostrata la descrizione o l'elenco di sottotitoli, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri

Elenco 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

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 come 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.
Prezzo - Prezzo attuale Obbligatorio in modo condizionale

L'attuale prezzo del biglietto/del pass per l'evento.

Deve essere fornito se viene indicato il prezzo barrato.

Testo libero
Prezzo - StrikethroughPrice Facoltativo Il prezzo originale del biglietto/del pass per l'evento. Testo libero
Callout prezzo Facoltativo Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.

Testo libero

Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)

Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum idonee

  • TYPE_MovieS_AND_TV_SHOWS (ad es. cinema)
  • TYPE_DIGITAL_GAMES (ad es. eSport)
  • TYPE_MUSIC (ad es. Concerto)
  • TYPE_TRAVEL_AND_LOCAL (ad es. tour, festival)
  • TYPE_HEALTH_AND_FITENESS (ad es. lezione di yoga)
  • TYPE_EDUCATION (ad es. classe)
  • TYPE_SPORTS (ad es. partita di calcio)
  • TYPE_DATING (ad es. Meetup)

Per indicazioni, consulta la sezione Categoria di contenuti.

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. Consulta 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 HYBRID

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 HYBRID

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 deve essere mostrato all'utente.

Nota: questo passaggio è obbligatorio per gli eventi IN_PERSON o HYBRID

Testo libero

Dimensioni del testo consigliate: massimo 20 caratteri circa

Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) del luogo in cui si tiene 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 ospitato l'evento.

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.

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 viene fornito un badge, assicurati di avere uno spazio di sicurezza di 24 dps nella parte superiore e inferiore dell'immagine

Per indicazioni, consulta le Specifiche delle immagini.
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: il fornitore di servizi richiede testo o immagine.

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: il fornitore di servizi richiede testo o 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 di sottotitoli, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri

Elenco 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

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 come 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 - Prezzo attuale Obbligatorio in modo condizionale

L'attuale prezzo del biglietto/del pass per l'evento.

Deve essere fornito se viene indicato il prezzo barrato.

Testo libero
Prezzo - StrikethroughPrice Facoltativo Il prezzo originale del biglietto/del pass per l'evento. Testo libero
Callout prezzo Facoltativo Callout del prezzo che mostra una promozione, un evento e uno sconto per i membri, se disponibile.

Testo libero

Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)

Valutazione - Valore massimo Facoltativo

Il valore massimo della scala di valutazione.

Deve essere fornito se viene fornito anche il valore corrente della valutazione.

Numero >= 0,0
Classificazione - Valore corrente Facoltativo

Il valore attuale della scala di valutazione.

Deve essere fornito se viene fornito anche il valore massimo della valutazione.

Numero >= 0,0
Valutazione - Conteggio Facoltativo

Il conteggio delle valutazioni per l'evento.

Nota: fornisci questo campo se la tua app vuole controllare come viene visualizzato dagli utenti. Fornisci la stringa concisa che può essere visualizzata dall'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di usare abbreviazioni come 1 M, in modo che non venga 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 personalmente la logica dell'abbreviazione della visualizzazione. Se sono presenti sia Conteggio che Conteggio, utilizzeremo il valore di Conteggio per mostrarlo agli utenti

Lungo
Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum idonee

  • TYPE_MovieS_AND_TV_SHOWS (ad es. cinema)
  • TYPE_DIGITAL_GAMES (ad es. eSport)
  • TYPE_MUSIC (ad es. Concerto)
  • TYPE_TRAVEL_AND_LOCAL (ad es. tour, festival)
  • TYPE_HEALTH_AND_FITENESS (ad es. lezione di yoga)
  • TYPE_EDUCATION (ad es. classe)
  • TYPE_SPORTS (ad es. partita di calcio)
  • TYPE_DATING (ad es. Meetup)

Per indicazioni, consulta la sezione Categoria di contenuti.

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

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

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'immagine in modo da occuparne l'80%.
  • Utilizza uno sfondo trasparente per consentire di visualizzare correttamente l'immagine nelle impostazioni del tema scuro e chiaro.

Categoria di contenuti

Questa categoria di contenuti consente alle app di pubblicare contenuti appartenenti a più categorie. In questo modo i contenuti vengono mappati con alcune delle categorie predefinite, ovvero:

  • TYPE_EDUCATION
  • TYPE_SPORTS
  • TYPE_MOVIES_AND_TV_SHOWS
  • TYPE_BOOKS
  • TYPE_AUDIOBOOKS
  • TYPE_MUSIC
  • TYPE_DIGITAL_GAMES
  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_HOME_AND_AUTO
  • TYPE_BUSINESS
  • TYPE_NEWS
  • TYPE_FOOD_AND_DRINK
  • TYPE_SHOPPING
  • TYPE_HEALTH_AND_FITENESS
  • TYPE_MEDICAL
  • TYPE_PARENTING
  • TYPE_DATING

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

Linee guida per l'utilizzo delle categorie di contenuti

  1. Alcune entità come ArticleEntity e GenericFeatureEntity sono idonee all'utilizzo di qualsiasi categoria di contenuti. Per altre entità come EventEntity, EventReservationEntity, PersonEntity, è idoneo solo un sottoinsieme di queste categorie. Controlla l'elenco delle categorie idonee per un tipo di entità prima di compilare l'elenco.
  2. Utilizza il tipo di entità specifico per alcune categorie di contenuti rispetto a una combinazione di entità Generic e ContentCategory:

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

  4. Nel caso in cui vengano fornite più categorie di contenuti, indicale in ordine di pertinenza rispetto ai contenuti con la categoria di contenuti più pertinente collocata per prima nell'elenco.

Passaggio 2: fornisci i dati del cluster

È consigliabile che il job di pubblicazione dei contenuti venga eseguito in background (ad esempio utilizzando WorkManager) e pianificato regolarmente o in base agli eventi (ad esempio, ogni volta che l'utente apre l'app o quando l'utente 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, 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 suggerimenti aggiornato.

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

publishFeaturedCluster

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

Kotlin


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

Java


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

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

  • I dati 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 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, all'interno di una transazione vengono eseguite le seguenti azioni:

  • 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 quest'ultima possa pubblicare contenuti (o fornire contenuti più 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, all'interno di una transazione vengono eseguite le seguenti azioni:

  • I dati UserAccountManagementCluster esistenti dello sviluppatore partner vengono rimossi.
  • I dati della richiesta vengono analizzati e archiviati nel cluster UserAccountManagementCluster aggiornato.

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

updatePublishStatus

Se per qualsiasi motivo aziendale interno, nessuno dei cluster viene pubblicato, 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 sono stati pubblicati a causa di una situazione prevista dal punto di vista del fornitore.
  • Consente agli sviluppatori di capire quando i dati vengono pubblicati o meno.
  • Google potrebbe utilizzare i codici di stato per sollecitare l'utente a eseguire determinate azioni nell'app in modo che possa vedere i contenuti dell'app o superarli.

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, Google consiglia di pubblicare la scheda di accesso. Se per qualsiasi motivo i fornitori non sono in grado di pubblicare la scheda di accesso, ti consigliamo di chiamare l'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 dai cluster dei 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 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 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 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 che sia possibile eseguire un'azione di follow-up per recuperare e inviare nuovamente un'attività riuscita.

Kotlin


client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java


client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

L'errore viene restituito come AppEngageException e la causa è inclusa sotto forma di codice di errore.

Codice di errore Nota
SERVICE_NOT_FOUND Il servizio non è disponibile sul dispositivo specificato.
SERVICE_NOT_AVAILABLE Il servizio è disponibile sul dispositivo specificato, ma non è disponibile al momento della chiamata (ad esempio, è esplicitamente disabilitato).
SERVICE_CALL_EXECUTION_FAILURE Esecuzione dell'attività non riuscita a causa di problemi di thread. In questo caso, è possibile 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 Publishing Content tramite un job, è necessario anche configurare una BroadcastReceiver per ricevere la richiesta di pubblicazione di contenuti.

L'obiettivo degli intent di trasmissione è principalmente la riattivazione dell'app e la forzatura della sincronizzazione dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto spesso. Viene attivato solo quando il servizio Google Engage stabilisce che i contenuti potrebbero essere inattivi (ad esempio, dopo una settimana). 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 due modi seguenti:

  • Registra dinamicamente un'istanza della classe BroadcastReceiver utilizzando Context.registerReceiver(). Ciò consente la comunicazione da applicazioni 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 file AndroidManifest.xml. Ciò consente all'applicazione di ricevere intent di trasmissione quando non è in esecuzione e di 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>

Il servizio invia i seguenti intent:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Ti consigliamo di avviare una chiamata publishRecommendationClusters quando ricevi questo intent.
  • com.google.android.engage.action.PUBLISH_FEATURED Ti consigliamo di avviare una chiamata publishFeaturedCluster quando ricevi questo intent.
  • com.google.android.engage.action.PUBLISH_CONTINUATION Ti consigliamo di avviare una chiamata publishContinuationCluster quando ricevi questo intent.

Flusso di lavoro di integrazione

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

Domande frequenti

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

Contact

In caso di domande durante il processo di integrazione, contatta engagement-developers@google.com.

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 una revisione interna per garantire che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatta fornendoti i dettagli necessari.
  • Quando il test è stato completato e non sono necessarie modifiche, Google ti contatta per informarti che puoi iniziare a pubblicare l'APK aggiornato e integrato nel Play Store.
  • Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i tuoi cluster Consiglio, In primo piano e Continuazione potrebbero essere pubblicati e visibili agli utenti.