Coinvolgi incontri con SDK: istruzioni per l'integrazione tecnica di terze parti

Google sta creando una piattaforma on-device che organizza le app degli utenti per verticali e consente una nuova esperienza immersiva per la scoperta e il consumo di contenuti personalizzati delle app. Questa esperienza a schermo intero offre agli sviluppatori partner l'opportunità di mostrare i propri contenuti avanzati migliori in un canale dedicato al di fuori della loro app.Questa guida contiene le istruzioni per gli sviluppatori partner per integrare i propri contenuti di incontri, utilizzando l'SDK Engage per compilare questa nuova area.

Dettaglio dell'integrazione

Terminologia

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

  • I cluster di consigli mostrano suggerimenti di appuntamenti personalizzati di un singolo sviluppatore partner. Questi consigli possono essere personalizzati in base all'utente.

    • Un cluster di consigli può essere composto da ArticleEntity, PersonEntity o EventEntity, ma non da una combinazione di diversi tipi di entità.

    I consigli hanno la seguente struttura:

    • Cluster di consigli:una visualizzazione dell'interfaccia utente che contiene un gruppo di consigli dello stesso sviluppatore partner.

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

      • ArticleEntity: ArticleEntity rappresenta un consiglio per contenuti basati su testo correlati agli appuntamenti. L'elemento ArticleEntity consente agli sviluppatori di fornire una varietà di contenuti di testo e immagini con più metadati per articolare le informazioni agli utenti.

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

      • PersonEntity: PersonEntity rappresenta una persona. I suggerimenti potrebbero essere finalizzati a mettere in evidenza una persona tra le possibili scelte per gli appuntamenti.

        Figura 2: interfaccia utente che mostra una singola entità Persone all'interno del cluster di consigli.

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

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

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

    I contenuti di continuazione possono avere la seguente struttura:

    • ArticleEntity: ArticleEntity rappresenta un consiglio per contenuti basati su testo correlati agli appuntamenti. Questa entità può essere utilizzata per rappresentare articoli di notizie incompiuti o altri contenuti che l'utente vorrebbe continuare a consumare da dove li ha interrotti.

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

    • EventReservationEntity: EventReservationEntity rappresenta la prenotazione di un evento e aiuta gli utenti a monitorare le prenotazioni di appuntamenti e incontri imminenti o in corso.

      Figura 8. Interfaccia utente che mostra un singolo EventReservationEntity all'interno di un cluster di continuazione.

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

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

      Figura 12: interfaccia utente che mostra un FeaturedCluster con un elenco di GenericFeaturedEntity

Preparazione

Livello API minimo: 19

Aggiungi la raccolta com.google.android.engage:engage-core alla tua app:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

Riepilogo

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

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

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

Passaggio 1: fornisci i dati delle entità

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

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. PersonEntity
  4. EventEntity
  5. EventReservationEntity

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

GenericFeaturedEntity

Attributo Requisito Descrizione Formato
URI azione Obbligatorio

Link diretto all'entità nell'app del fornitore.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

URI
Immagini dei poster Obbligatorio

Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9

Nota: se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia in alto che in basso nell'immagine.

 Per indicazioni, consulta le specifiche per le immagini.
Titolo Facoltativo Titolo dell'entità.

Testo libero

Dimensioni del testo consigliate: 50 caratteri
Descrizione Facoltativo

Un singolo paragrafo di testo per descrivere l'entità.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli Facoltativo

Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Badge Facoltativo

Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.

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

  • "Aggiornamento in tempo reale"
  • Durata della lettura dell'articolo
Badge - Testo Facoltativo

Titolo del badge

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

Testo libero

Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine Facoltativo

Immagine piccola

Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video.

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

Per indicazioni, consulta le specifiche per le immagini.
Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum

Per indicazioni, consulta la sezione Categoria di contenuti.

ArticleEntity

Attributo Requisito Descrizione Formato
URI azione Obbligatorio

Link diretto all'entità nell'app del fornitore.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

URI
Titolo Obbligatorio Titolo dell'entità.

Testo libero

Dimensioni del testo consigliate: massimo 50 caratteri
Immagini dei poster Facoltativo

Se vengono fornite più immagini, ne mostreremo una sola. Le proporzioni consigliate sono 16:9

Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.

 Per indicazioni, consulta le specifiche per le immagini.
Origine - Titolo Facoltativo Il nome dell'autore, dell'organizzazione o del reporter

Testo libero

Dimensione del testo consigliata: meno di 25 caratteri
Origine - Immagine Facoltativo Un'immagine della fonte, ad esempio l'autore, l'organizzazione, il reporter Per indicazioni, consulta le specifiche per le immagini.
Descrizione Facoltativo

Un singolo paragrafo di testo per descrivere l'entità.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli Facoltativo

Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Badge Facoltativo

Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.

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

  • Ad esempio, "Aggiornamento in tempo reale"
  • Ad esempio, Durata lettura articolo
Badge - Testo Facoltativo

Titolo del badge

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

Testo libero

Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine Facoltativo

Immagine piccola

Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video.

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

Per indicazioni, consulta le specifiche per le immagini.
Ora di pubblicazione dei contenuti Facoltativo Si tratta del timestamp epoch in millisecondi relativo alla data di pubblicazione / aggiornamento dei contenuti nell'app. Timestamp epoch in millisecondi
Ora ultimo coinvolgimento Obbligatorio condizionalmente

Il timestamp epoch in millisecondi dell'ultima interazione dell'utente con questa entità.

Nota:questo campo è obbligatorio se l'entità fa parte del cluster di continuazione.

 Timestamp epoch in millisecondi
Percentuale di avanzamento Obbligatorio condizionalmente

La percentuale dei contenuti completi consumati dall'utente fino ad oggi.

Nota:questo campo è obbligatorio se l'entità fa parte del cluster di continuazione.

 Un valore int compreso tra 0 e 100 inclusi.
Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum

Per indicazioni, consulta la sezione Categoria di contenuti.

PersonEntity

Attributo Requisito Descrizione Formato
URI azione Obbligatorio

Link diretto all'entità nell'app del fornitore.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

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

Stringa

Dimensioni del testo consigliate: massimo 50 caratteri
Profilo - Avatar Obbligatorio

Immagine del profilo o dell'avatar dell'utente.

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

 Per indicazioni, consulta le specifiche per le immagini.
Profilo - Testo aggiuntivo Facoltativo Testo libero, ad esempio l'handle del profilo.

Testo libero

Dimensioni del testo consigliate: massimo 15 caratteri
Profilo - Immagine aggiuntiva Facoltativo Immagine piccola, ad esempio un badge di verifica. Per indicazioni, consulta le specifiche per le immagini.
Immagine intestazione Facoltativo

Rappresenta l'immagine intestazione. Deve essere diversa dall'immagine del profilo. Può essere utilizzata se sono disponibili altre immagini che aiutano a mettere in evidenza la persona e il suo lavoro.

Nota: deve essere un'immagine in formato 16:9. Se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine

Per indicazioni, consulta le specifiche per le immagini.
Popolarità - Conteggio Facoltativo

Indica il numero di follower o il valore di popolarità, ad esempio "3,7 M".

Nota: se vengono forniti sia Conteggio sia Valore conteggio, verrà utilizzato il valore Conteggio.

Stringa

Dimensioni del testo consigliate: massimo 20 caratteri per conteggi e etichette combinati
Popolarità - Valore conteggio Facoltativo

Il numero di follower o il valore di popolarità.

Nota: fornisci il valore di conteggio se la tua app non vuole gestire la logica su come ottimizzare un numero elevato per dimensioni di visualizzazione diverse. Se vengono forniti sia Conteggio sia Valore conteggio, viene visualizzato il valore Conteggio.

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

Stringa

Dimensioni del testo consigliate: massimo 20 caratteri per conteggi e etichette combinati
Popolarità - Visual Facoltativo

Indica lo scopo dell'interazione. Ad esempio, immagine che mostra icona Mi piace, emoji.

Puoi fornire più di un'immagine, anche se non tutte potrebbero essere visualizzate su tutti i fattori di forma.

Nota: deve essere un'immagine quadrata 1:1

 Per indicazioni, consulta le specifiche per le immagini.
Valutazione - Valore massimo Obbligatorio

Il valore massimo della scala di valutazione.

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

 Numero >= 0,0
Valutazione - Valore corrente Obbligatorio

Il valore attuale della scala di valutazione.

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

 Numero >= 0,0
Valutazione - Conteggio Facoltativo

Il conteggio delle valutazioni per l'entità.

Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.

 Stringa
Valutazione - Valore conteggio Facoltativo

Il conteggio delle valutazioni per l'entità.

Nota:fornisci questo campo se non vuoi gestire autonomamente la logica di visualizzazione dell'abbreviazione. Se sono presenti sia Conteggio sia Valore conteggio, utilizzeremo il Conteggio per la visualizzazione agli utenti

 Lungo
Località - Paese Facoltativo Il paese in cui si trova la persona o in cui presta servizio.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Città Facoltativo La città in cui si trova la persona o in cui opera.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato Facoltativo All'utente verrà mostrato l'indirizzo in cui si trova la persona o in cui viene servito il prodotto.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) in cui si trova la persona o viene servito il servizio.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato Facoltativo Lo stato (se applicabile) in cui si trova la persona o in cui viene svolta l'attività.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Codice postale Facoltativo Il codice postale (se applicabile) in cui si trova la persona o dove presta servizio.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere Facoltativo Il quartiere (se applicabile) in cui si trova la persona o in cui opera.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Badge Facoltativo

Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo Facoltativo

Titolo del badge

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

Testo libero

Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine Facoltativo

Immagine piccola

Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video.

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

Per indicazioni, consulta le specifiche per le immagini.
Descrizione Facoltativo

Un singolo paragrafo di testo per descrivere l'entità.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli Facoltativo

Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum idonei

  • TYPE_HEALTH_AND_FITENESS (esempio: istruttore di yoga/fitness)
  • TYPE_HOME_AND_AUTO (esempio: idraulico)
  • TYPE_SPORTS (esempio: giocatore)
  • TYPE_DATING

Per indicazioni, consulta la sezione Categoria di contenuti.

EventEntity

Attributo Requisito Descrizione Formato
URI azione Obbligatorio

Link diretto all'entità nell'app del fornitore.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

URI
Titolo Obbligatorio Titolo dell'entità.

Stringa

Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio Obbligatorio

Il timestamp epoch in cui è previsto l'inizio dell'evento.

Nota:questo valore verrà rappresentato in millisecondi.

 Timestamp epoch in millisecondi
Modalità evento Obbligatorio

Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.

 Enum: VIRTUAL, IN_PERSON o HYBRID
Immagini dei poster Obbligatorio

Se vengono fornite più immagini, ne mostreremo solo una. Le proporzioni consigliate sono 16:9

Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.

 Per indicazioni, consulta le specifiche per le immagini.
Località - Paese Obbligatorio condizionalmente

Il paese in cui si svolge l'evento.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Città Obbligatorio condizionalmente

La città in cui si svolge l'evento.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato Obbligatorio condizionalmente

L'indirizzo o il nome del luogo in cui si svolgerà l'evento che deve essere visualizzato dall'utente.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) della sede in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato Facoltativo Lo stato o la provincia (se applicabile) in cui viene organizzato l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Codice postale Facoltativo Il codice postale (se applicabile) della località in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere Facoltativo Il quartiere (se applicabile) in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Ora di fine Facoltativo

Il timestamp epoch in cui è previsto il termine dell'evento.

Nota:questo valore verrà rappresentato in millisecondi.

 Timestamp epoch in millisecondi
Descrizione Facoltativo

Un singolo paragrafo di testo per descrivere l'entità.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli Facoltativo

Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Badge Facoltativo

Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo Facoltativo

Titolo del badge

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

Testo libero

Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine Facoltativo

Immagine piccola

Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video.

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

Per indicazioni, consulta le specifiche per le immagini.
Prezzo - CurrentPrice Obbligatorio condizionalmente

Il prezzo corrente del biglietto/del pass per l'evento.

Deve essere fornito se viene fornito il prezzo barrato.

Testo libero
Prezzo - StrikethroughPrice Facoltativo Il prezzo originale del biglietto/del pass per l'evento. Testo libero
Callout del prezzo Facoltativo callout del prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.

Testo libero

Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Categorie di contenuti Facoltativo Descrivi la categoria dei contenuti nell'entità.

Elenco di enum idonei

  • TYPE_MOVIES_AND_TV_SHOWS (esempio: Cinema)
  • TYPE_DIGITAL_GAMES (esempio: eSports)
  • TYPE_MUSIC (esempio: concerto)
  • TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival)
  • TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga)
  • TYPE_EDUCATION (esempio: Corso)
  • TYPE_SPORTS (esempio: partita di calcio)
  • TYPE_DATING (esempio: meetup)

Per indicazioni, consulta la sezione Categoria di contenuti.

EventReservationEntity

Attributo Requisito Descrizione Formato
URI azione Obbligatorio

Link diretto all'entità nell'app del fornitore.

Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

URI
Titolo Obbligatorio Titolo dell'entità.

Stringa

Dimensioni del testo consigliate: massimo 50 caratteri
Ora di inizio Obbligatorio

Il timestamp epoch in cui è previsto l'inizio dell'evento.

Nota:questo valore verrà rappresentato in millisecondi.

 Timestamp epoch in millisecondi
Modalità evento Obbligatorio

Un campo per indicare se l'evento sarà virtuale, in presenza o entrambi.

 Enum: VIRTUAL, IN_PERSON o HYBRID
Località - Paese Obbligatorio condizionalmente

Il paese in cui si svolge l'evento.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Città Obbligatorio condizionalmente

La città in cui si svolge l'evento.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo visualizzato Obbligatorio condizionalmente

L'indirizzo o il nome del luogo in cui si svolgerà l'evento che deve essere visualizzato dall'utente.

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

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Indirizzo Facoltativo L'indirizzo (se applicabile) della sede in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Stato Facoltativo Lo stato o la provincia (se applicabile) in cui viene organizzato l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Località - Codice postale Facoltativo Il codice postale (se applicabile) della località in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Posizione - Quartiere Facoltativo Il quartiere (se applicabile) in cui si svolge l'evento.

Testo libero

Dimensione del testo consigliata: massimo 20 caratteri
Immagini dei poster Facoltativo

Se vengono fornite più immagini, ne mostreremo una sola. Le proporzioni consigliate sono 16:9

Nota: l'immagine è vivamente consigliata. Se viene fornito un badge, assicurati di lasciare uno spazio sicuro di 24 dpi sia nella parte superiore che in quella inferiore dell'immagine.

 Per indicazioni, consulta le specifiche per le immagini.
Ora di fine Facoltativo

Il timestamp epoch in cui è previsto il termine dell'evento.

Nota:questo valore verrà rappresentato in millisecondi.

 Timestamp epoch in millisecondi
Fornitore di servizi - Nome Facoltativo

Il nome del fornitore di servizi.

Nota: è necessario il testo o l'immagine per il fornitore di servizi.

Testo libero. Ad esempio, il nome dell'organizzatore dell'evento/del tour
Fornitore di servizi - Immagine Facoltativo

Il logo/l'immagine del fornitore di servizi.

Nota: è necessario il testo o l'immagine per il fornitore di servizi.

Per indicazioni, consulta le specifiche per le immagini.
Descrizione Facoltativo

Un singolo paragrafo di testo per descrivere l'entità.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensioni del testo consigliate: 180 caratteri
Elenco dei sottotitoli Facoltativo

Fino a 3 sottotitoli, ciascuno costituito da una singola riga di testo.

Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.

Testo libero

Dimensione del testo consigliata per ogni sottotitolo: massimo 50 caratteri
Badge Facoltativo

Ogni badge può essere un testo libero (massimo 15 caratteri) o un'immagine di piccole dimensioni.
Badge - Testo Facoltativo

Titolo del badge

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

Testo libero

Dimensione del testo consigliata: massimo 15 caratteri
Badge - Immagine Facoltativo

Immagine piccola

Trattamento UX speciale, ad esempio come overlay del badge sulla miniatura dell'immagine/del video.

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

Per indicazioni, consulta le specifiche per le immagini.
ID prenotazione Facoltativo L'ID prenotazione per la prenotazione dell'evento. Testo libero
Prezzo - CurrentPrice Obbligatorio condizionalmente

Il prezzo corrente del biglietto/del pass per l'evento.

Deve essere fornito se viene fornito il prezzo barrato.

Testo libero
Prezzo - StrikethroughPrice Facoltativo Il prezzo originale del biglietto/del pass per l'evento. Testo libero
Callout del prezzo Facoltativo callout del prezzo per mettere in evidenza una promozione, un evento o uno sconto per i membri, se disponibile.

Testo libero

Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Valutazione - Valore massimo Facoltativo

Il valore massimo della scala di valutazione.

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

 Numero >= 0,0
Valutazione - Valore corrente Facoltativo

Il valore attuale della scala di valutazione.

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

 Numero >= 0,0
Valutazione - Conteggio Facoltativo

Il conteggio delle valutazioni per l'evento.

Nota:fornisci questo campo se la tua app vuole controllare la modalità di visualizzazione per gli utenti. Fornisci la stringa concisa che può essere mostrata all'utente. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare abbreviazioni come 1M, in modo che non venga troncato su dimensioni di visualizzazione più piccole.

 Stringa
Valutazione - Valore conteggio Facoltativo

Il conteggio delle valutazioni per l'evento.

Nota:fornisci questo campo se non vuoi gestire autonomamente la logica di visualizzazione dell'abbreviazione. Se sono presenti sia Conteggio sia Valore conteggio, utilizzeremo il Conteggio per la visualizzazione agli utenti

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

Elenco di enum idonei

  • TYPE_MOVIES_AND_TV_SHOWS (esempio: Cinema)
  • TYPE_DIGITAL_GAMES (esempio: eSports)
  • TYPE_MUSIC (esempio: concerto)
  • TYPE_TRAVEL_AND_LOCAL (esempio: tour, festival)
  • TYPE_HEALTH_AND_FITENESS (esempio: corso di yoga)
  • TYPE_EDUCATION (esempio: Corso)
  • TYPE_SPORTS (esempio: partita di calcio)
  • TYPE_DATING (esempio: meetup)

Per indicazioni, consulta la sezione Categoria di contenuti.

Specifiche per le immagini

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

Proporzioni Numero minimo di pixel Risoluzione consigliata in pixel

Quadrato (1 x 1)

Preferiti

 300x300 1200x1200
Orizzontale (1,91 x 1) 600x314 1200x628
Ritratto (4 x 5) 480x600 960x1200

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

Formati file

PNG, JPG, GIF statico, WebP

Dimensioni massime del file

5120 kB

Consigli aggiuntivi

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

Categoria di contenuti

La categoria dei contenuti consente alle app di pubblicare contenuti appartenenti a più categorie. I contenuti vengono associati ad alcune delle categorie predefinite, ovvero:

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

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

Linee guida per l'utilizzo delle categorie di contenuti

  1. Alcune entità come ArticleEntity e GenericFeaturedEntity sono idonee all'utilizzo di qualsiasi categoria di contenuti. Per altre entità come EventEntity, EventReservationEntity, PersonEntity, solo un sottoinsieme di queste categorie è idoneo. Controlla l'elenco delle categorie idonee per un tipo di entità prima di compilarlo.

  2. Utilizza il tipo di entità specifico per alcune categorie di contenuti anziché una combinazione di entità generiche e ContentCategory:

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

  4. Se vengono fornite più categorie di contenuti, forniscile nell'ordine di pertinenza per i contenuti, con la categoria più pertinente posizionata prima nell'elenco.

Passaggio 2: fornisci i dati del cluster

Ti consigliamo di eseguire il job di pubblicazione dei contenuti in background (ad esempio utilizzando WorkManager) e di pianificarlo su base regolare o in base a un evento (ad esempio ogni volta che l'utente apre l'app o quando l'utente ha appena aggiunto un articolo al carrello).

AppEngagePublishClient è responsabile della pubblicazione dei cluster.

Esistono le seguenti API per pubblicare i cluster nel client:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishContinuationCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteContinuationCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Questa API viene utilizzata per verificare se il servizio è disponibile per l'integrazione e se i contenuti possono essere presentati sul dispositivo.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

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

Kotlin

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

Java

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

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

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

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

publishFeaturedCluster

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

Kotlin

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

Java

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

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

  • I dati FeaturedCluster esistenti del partner sviluppatore vengono rimossi.
  • I dati della richiesta vengono analizzati e archiviati nel cluster in primo piano aggiornato.

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

publishContinuationCluster

Questa API viene utilizzata per pubblicare un oggetto ContinuationCluster.

Kotlin

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

Java

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

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

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

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

publishUserAccountManagementRequest

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

I seguenti metadati fanno parte della scheda Accedi:

Attributo Requisito Descrizione
URI azione Obbligatorio Link diretto all'azione (ad es. alla pagina di accesso all'app)
Immagine (Facoltativo) Se non viene fornito, deve essere fornito il titolo

Immagine mostrata sulla scheda

Immagini con proporzioni 16 x 9 e una risoluzione di 1264 x 712
Titolo Facoltativo: se non viene fornito, deve essere fornita l'immagine Nome sulla carta
Testo dell'azione Facoltativo Testo visualizzato nell'invito all'azione (ad es. Accedi)
Sottotitolo Facoltativo Sottotitolo facoltativo nella scheda

Kotlin

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

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

Java

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

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

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

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

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

updatePublishStatus

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

  • Fornire lo stato in tutti gli scenari, anche quando i contenuti sono pubblicati (STATUS == PUBLISHED), è fondamentale per compilare le dashboard che utilizzano questo stato esplicito per trasmettere l'integrità e altre metriche dell'integrazione.
  • Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non è in errore (STATUS == NOT_PUBLISHED), Google può evitare di attivare gli avvisi nelle dashboard di salute dell'app. Conferma che i contenuti non vengono pubblicati a causa di una situazione prevedibile dal punto di vista del fornitore.
  • Aiuta gli sviluppatori a fornire informazioni su quando i dati vengono pubblicati o meno.
  • Google potrebbe utilizzare i codici di stato per indurre l'utente a eseguire determinate azioni nell'app in modo da poter vedere i contenuti dell'app o superarli.

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

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

deleteRecommendationClusters

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dai cluster di consigli. 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 da poter intraprendere un'azione di follow-up per recuperare e inviare nuovamente un'attività riuscita.

Kotlin

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

Java

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

L'errore viene restituito come AppEngageException con la causa inclusa come 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 al momento della chiamata (ad esempio, è disattivato esplicitamente).
SERVICE_CALL_EXECUTION_FAILURE L'esecuzione dell'attività non è riuscita a causa di problemi di threading. In questo caso, è possibile eseguire nuovamente il tentativo.
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 lato servizio.
SERVICE_CALL_RESOURCE_EXHAUSTED La chiamata al servizio viene effettuata troppo di frequente.

Passaggio 3: gestisci gli intent di trasmissione

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

Lo scopo degli intent di trasmissione è principalmente la riattivazione dell'app e l'applicazione forzata della sincronizzazione dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto di frequente. Viene attivata solo quando il servizio Engage determina che i contenuti potrebbero essere obsoleti (ad esempio, risalenti a una settimana prima). In questo modo, è più probabile che l'utente possa avere un'esperienza con contenuti aggiornati, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei seguenti due modi:

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

Kotlin

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

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

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),
                          com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                          /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

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

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

I seguenti intent vengono inviati dal servizio:

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

Flusso di lavoro di integrazione

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

Domande frequenti

Consulta le Domande frequenti sull'SDK Engage per approfondire.

Contatto

Contatta engage-developers@google.com in caso di domande durante la procedura di integrazione.

Passaggi successivi

Dopo aver completato questa integrazione, i passaggi successivi sono i seguenti:

  • Invia un'email all'indirizzo engage-developers@google.com e allega l'APK integrato pronto per i test da parte di Google.
  • Google esegue una verifica e delle revisioni interne per assicurarsi che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatterà con tutti i dettagli necessari.
  • Al termine del test, se non sono necessarie modifiche, Google ti contatta per informarti che puoi iniziare a pubblicare l'APK aggiornato e integrato sul Play Store.
  • Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, i cluster Consiglio, In evidenza e Continuazione potrebbero essere pubblicati e visibili agli utenti.