Engage SDK Shopping: 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 loro migliori contenuti avanzati in un canale dedicato al di fuori della loro app.

Questa guida contiene istruzioni che consentono agli sviluppatori partner di integrare i loro contenuti di Shopping utilizzando l'SDK Engage per compilare sia questa nuova area di superficie sia le piattaforme Google esistenti come Entertainment Space.

Dettagli integrazione

Terminologia

Questa integrazione include i seguenti cinque tipi di cluster: Consiglio, In evidenza, Carrello degli acquisti, Lista della spesa, Riordina e Monitoraggio degli ordini di acquisto.

• I cluster di consigli mostrano suggerimenti di acquisto personalizzati di un singolo sviluppatore partner. Questi consigli possono essere personalizzati in base all'utente o essere generali (ad esempio, elementi di tendenza). Utilizzali per mostrare prodotti, eventi, saldi, promozioni e abbonamenti in base alle tue esigenze.

  I consigli hanno la seguente struttura:

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

  • ShoppingEntity: un oggetto che rappresenta un singolo elemento in un cluster.

• Il cluster In primo piano mostra una selezione di entità di più sviluppatori partner in un unico raggruppamento dell'interfaccia utente. Verrà visualizzato un singolo cluster in primo piano, che viene mostrato nella parte superiore dell'interfaccia utente con un posizionamento prioritario sopra tutti i cluster di consigli. Ogni sviluppatore partner potrà trasmettere fino a 10 entità nel cluster In primo piano.

• Il cluster Carrello mostra un'anteprima dei carrelli di molti sviluppatori partner in un unico raggruppamento dell'interfaccia utente, incoraggiando gli utenti a completare i carrelli in sospeso. Esiste un singolo cluster del carrello degli acquisti, visualizzato nella parte superiore dell'interfaccia utente, con un posizionamento prioritario rispetto a tutti i cluster di consigli. Ogni sviluppatore partner può trasmettere fino a tre istanze ShoppingCart nel cluster del carrello degli acquisti.

  Il carrello degli acquisti ha la seguente struttura:

  • Cluster del carrello degli acquisti:una visualizzazione dell'interfaccia utente che contiene un gruppo di anteprime del carrello degli acquisti di molti sviluppatori partner.

  • Carrello degli acquisti: un oggetto che rappresenta l'anteprima del carrello per un singolo partner sviluppatore, da visualizzare nel cluster del carrello degli acquisti. ShoppingCart deve mostrare il conteggio totale degli articoli nel carrello e può includere anche le immagini di alcuni articoli nel carrello dell'utente.

• Il cluster Lista della spesa mostra un'anteprima delle liste della spesa di più sviluppatori partner in un unico raggruppamento dell'interfaccia utente, invitando gli utenti a tornare all'app corrispondente per aggiornare e completare le proprie liste. Esiste un singolo cluster di liste della spesa.

• Il cluster Riordina mostra un'anteprima degli ordini precedenti di più sviluppatori partner in un unico raggruppamento dell'interfaccia utente, chiedendo agli utenti di riordinare. Esiste un unico cluster di riordino.

  • Il cluster di riordino deve mostrare il conteggio totale degli articoli nell'ordine precedente dell'utente e deve includere anche uno dei seguenti elementi:

    • Immagini di X articoli nell'ordine precedente dell'utente.
    • Etichette per X articoli nell'ordine precedente dell'utente.

• Il cluster Monitoraggio ordini Shopping mostra un'anteprima degli ordini Shopping in attesa o completati di recente di molti sviluppatori partner in un unico raggruppamento dell'interfaccia utente, consentendo agli utenti di monitorare i propri ordini.

  Esiste un singolo cluster ShoppingOrderTracking visualizzato nella parte superiore dell'interfaccia utente, con un posizionamento prioritario sopra tutti i cluster Recommendation. Ogni sviluppatore partner può trasmettere più elementi ShoppingOrderTrackingEntity nel cluster di monitoraggio degli ordini Shopping.

  • ShoppingOrderTrackingCluster ha la seguente struttura:

    • ShoppingOrderTracking Cluster: una visualizzazione dell'interfaccia utente che contiene un gruppo di anteprime di monitoraggio degli ordini di molti sviluppatori partner
    • ShoppingOrderTrackingEntity: un oggetto che rappresenta un'anteprima di monitoraggio degli ordini di acquisto per un singolo partner sviluppatore, da visualizzare nel cluster di monitoraggio degli ordini di acquisto. ShoppingOrderTrackingEntity deve mostrare lo stato dell'ordine e la relativa ora. Ti consigliamo vivamente di compilare i tempi di consegna previsti per ShoppingOrderTrackingEntity, in quanto viene mostrato agli utenti quando viene fornito.
    Nota: fornisci più oggetti ShoppingOrderTrackingEntity se un ordine è stato suddiviso in più spedizioni.

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'
}

Per ulteriori informazioni, consulta la sezione Visibilità dei pacchetti in Android 11.

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 massimi di entità in un cluster
Cluster di consigli	Al massimo 5	Al massimo 25 ShoppingEntity
Cluster in primo piano	Al massimo 1	Al massimo 10 ShoppingEntity
Cluster di carrelli degli acquisti	Al massimo 1	Al massimo 3 ShoppingCart Sono previsti più carrelli solo per le app con carrelli separati per commerciante.
Cluster di liste della spesa	Al massimo 1	Al massimo 1 ShoppingListEntity
Cluster per il riordinamento Shopping	Al massimo 1	Al massimo 1 ReorderEntity
Cluster di monitoraggio degli ordini di Shopping	Massimo 3	Al massimo 3 ShoppingOrderTrackingEntity

Passaggio 1: fornisci i dati delle entità

L'SDK ha definito entità diverse per rappresentare ogni tipo di elemento. Per la categoria Shopping sono supportate le seguenti entità:

1. ShoppingEntity
2. ShoppingCart
3. ShoppingList
4. Reorder
5. ShoppingOrderTracking

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

ShoppingEntity

L'oggetto ShoppingEntity rappresenta un prodotto, una promozione, un deal, un abbonamento o un evento che i partner sviluppatori vogliono pubblicare.

ShoppingEntity

Attributo	Requisito	Descrizione	Formato
Immagini dei poster	Obbligatorie	Devi fornire almeno un'immagine.	Per indicazioni, consulta le specifiche per le immagini.
URI azione	Obbligatorie	Il link diretto alla pagina nell'app che mostra i dettagli dell'entità. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Titolo	Facoltativo	Il nome dell'entità.	Testo libero Dimensioni del testo consigliate: meno di 90 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Prezzo - attuale	Obbligatorio in modo condizionale	Il prezzo corrente dell'entità. Deve essere fornito se viene fornito il prezzo barrato.	Testo libero
Prezzo - barrato	Facoltativo	Il prezzo originale dell'entità, che viene barrato nell'UI.	Testo libero
Callout	Facoltativo	Callout per mettere in evidenza una promozione, un evento o un aggiornamento per l'entità, se disponibile.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Clausole dei callout	Facoltativo	Testo delle clausole per il callout.	Testo libero Dimensioni del testo consigliate: meno di 45 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Valutazione (facoltativa) - Nota: tutte le valutazioni vengono visualizzate utilizzando il nostro sistema di valutazione standard a stelle.
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'entità. Nota: fornisci questo campo se la tua app controlla il modo in cui il conteggio viene visualizzato agli utenti. Usa una stringa concisa. Ad esempio, se il conteggio è 1.000.000, valuta la possibilità di utilizzare un'abbreviazione come 1 M, in modo che il conteggio non venga troncato su schermi di dimensioni inferiori.	Stringa
Valutazione - Valore conteggio	Facoltativo	Il conteggio delle valutazioni per l'entità. Nota: fornisci questo campo se non gestisci autonomamente la logica di visualizzazione dell'abbreviazione. Se sono presenti sia Conteggio che Valore conteggio, Conteggio viene visualizzato per gli utenti.	Lungo
DisplayTimeWindow (facoltativo) - Imposta una finestra temporale per la visualizzazione di contenuti sulla piattaforma
Timestamp inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere visualizzati sulla piattaforma. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Data e ora di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più visualizzati sulla piattaforma. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

ShoppingCart

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Il link diretto al carrello degli acquisti nell'app del partner. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Numero di elementi	Obbligatorio	Il numero di articoli (non solo il numero di prodotti) nel carrello degli acquisti. Ad esempio: se nel carrello sono presenti 3 camicie identiche e 1 cappello, questo numero deve essere 4.	Numero intero >= 1
Testo dell'azione	Facoltativo	Il testo dell'invito all'azione del pulsante nel carrello degli acquisti (ad esempio Il tuo carrello). Se lo sviluppatore non fornisce alcun testo dell'azione, Visualizza carrello è l'impostazione predefinita. Questo attributo è supportato dalla versione 1.1.0 in poi.	Stringa
Titolo	Facoltativo	Il titolo del carrello (ad esempio, La tua borsa della spesa). Se lo sviluppatore non fornisce alcun titolo, l'impostazione predefinita è Il tuo carrello. Se lo sviluppatore partner pubblica un carrello separato per ogni commerciante, includi il nome del commerciante nel titolo.	Testo libero Dimensioni del testo consigliate: meno di 25 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati puntini di sospensione)
Immagini del carrello	Facoltativo	Immagini di ogni prodotto nel carrello. È possibile fornire fino a 10 immagini in ordine di priorità. Il numero effettivo di immagini visualizzate dipende dal fattore di forma del dispositivo.	Per indicazioni, consulta le specifiche per le immagini.
Etichette elemento	Facoltativo	L'elenco delle etichette per gli articoli presenti nella lista della spesa. Il numero effettivo di etichette visualizzate dipende dal fattore di forma del dispositivo.	Elenco di etichette di testo libero Dimensioni del testo consigliate: meno di 20 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati puntini di sospensione)
Timestamp ultima interazione dell'utente	Facoltativo	Numero di millisecondi trascorsi dall'epoca, che identifica l'ultima volta in cui l'utente ha interagito con il carrello. Questo valore verrà passato come input dagli sviluppatori partner che pubblicano un carrello separato per ogni commerciante e potrebbe essere utilizzato per il ranking.	Timestamp in millisecondi
DisplayTimeWindow (facoltativo) - Imposta una finestra temporale per la visualizzazione di contenuti sulla piattaforma
Timestamp inizio	Facoltativo	Il timestamp epoch dopo il quale i contenuti devono essere visualizzati sulla piattaforma. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi
Data e ora di fine	Facoltativo	Il timestamp epoch dopo il quale i contenuti non vengono più visualizzati sulla piattaforma. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

ShoppingList

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Il link diretto alla lista della spesa nell'app del partner. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
Numero di elementi	Obbligatorie	Il numero di articoli nella lista della spesa.	Numero intero >= 1
Titolo	Facoltativo	Il titolo dell'elenco (ad esempio La tua lista della spesa). Se lo sviluppatore non fornisce un titolo, Lista della spesa è il valore predefinito.	Testo libero Dimensioni del testo consigliate: meno di 25 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati puntini di sospensione)
Etichette elemento	Obbligatorie	L'elenco delle etichette per gli articoli presenti nella lista della spesa. Deve essere fornita almeno un'etichetta e possono essere fornite fino a 10 etichette in ordine di priorità. Il numero effettivo di etichette visualizzate dipende dal fattore di forma del dispositivo.	Elenco di etichette di testo libero Dimensioni del testo consigliate: meno di 20 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati puntini di sospensione)

ShoppingReorderCluster

Attributo	Requisito	Descrizione	Formato
URI azione	Obbligatorio	Il link diretto per ordinare nuovamente nell'app del partner. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente	URI
Testo dell'azione	Facoltativo	Il testo dell'invito all'azione del pulsante su Riordina (ad es. Ordina di nuovo). Se lo sviluppatore non fornisce alcun testo per l'azione, l'impostazione predefinita è Riordina. Questo attributo è supportato dalla versione 1.1.0 in poi.	Stringa
Numero di elementi	Obbligatorio	Il numero di articoli (non solo il numero di prodotti) nell'ordine precedente. Ad esempio: se nell'ordine precedente erano presenti 3 caffè piccoli e 1 croissant, questo numero deve essere 4.	Numero intero >= 1
Titolo	Obbligatorio	Il titolo dell'articolo da ordinare di nuovo.	Testo libero Dimensioni del testo consigliate: meno di 40 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati dei puntini di sospensione)
Etichette elemento	Facoltativo (se non fornite, devono essere fornite immagini dei poster)	L'elenco di etichette degli articoli per l'ordine precedente. È possibile fornire fino a 10 etichette in ordine di priorità. Il numero effettivo di etichette visualizzate dipende dal fattore di forma del dispositivo.	Elenco di testo libero Dimensione del testo consigliata per etichetta: meno di 20 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati i puntini di sospensione)
Immagini dei poster	Facoltativo (se non specificato, devono essere fornite le etichette degli articoli)	Immagini degli articoli nell'ordine precedente. È possibile fornire fino a 10 immagini in ordine di priorità. Il numero effettivo di immagini visualizzate dipende dal fattore di forma del dispositivo.	Per indicazioni, consulta le Specifiche delle immagini.

ShoppingOrderTrackingCluster

Attributo	Requisito	Descrizione	Formato
Titolo	Obbligatorio	Un breve titolo del pacco/degli articoli monitorati o il numero di tracciamento.	Testo libero Dimensioni del testo consigliate: 50 caratteri (se il testo è troppo lungo, verranno visualizzati i puntini di sospensione)
Tipo di ordine	Obbligatorio	Un breve titolo del pacco/degli articoli monitorati oppure il numero di riferimento.	Enum: IN_STORE_PICKUP, SAME_DAY_DELIVERY, MULTI_DAY_DELIVERY
Stato	Obbligatorio	Lo stato attuale dell'ordine. Ad esempio: "In ritardo", "In transito", "In ritardo", "Spedito", "Consegnato", "Non disponibile", "Ordine pronto"	Testo libero Dimensioni del testo consigliate: 25 caratteri (se il testo è troppo lungo, verranno visualizzati i puntini di sospensione)
Data/ora ordine	Obbligatorie	Il timestamp epoch in millisecondi in cui è stato effettuato l'ordine. L'ora dell'ordine verrà visualizzata se la finestra di tempo di consegna prevista non è presente	Timestamp epoch in millisecondi
URI azione	Obbligatorio	Link diretto al monitoraggio degli ordini nell'app del partner.	URI
OrderDeliveryTimeWindow (facoltativo) - Imposta una finestra temporale per l'ordine monitorato dal momento dell'ordine fino al momento della consegna prevista/effettiva.
OrderDeliveryTimeWindow - Ora di inizio	Facoltativo	Il timestamp epoch in millisecondi a partire dal quale l'ordine verrà consegnato o sarà pronto per il ritiro.	Timestamp epoch in millisecondi
OrderDeliveryTimeWindow - End Time	Facoltativo	Il timestamp epoch in millisecondi entro/prima del quale l'ordine verrà fornito o sarà pronto per il ritiro.	Timestamp epoch in millisecondi
Immagini dei poster	Facoltativo	Immagine di un articolo/prodotto che fa parte dell'ordine. Le proporzioni consigliate sono 1:1	Per indicazioni, consulta le Specifiche delle immagini.
Numero di elementi	Facoltativo	Il numero di articoli nell'ordine.	Numero intero >= 1
Descrizione	Facoltativo	Un singolo paragrafo di testo per descrivere gli articoli nell'ordine. Nota: all'utente verrà mostrata la descrizione o l'elenco dei sottotitoli codificati, non entrambi.	Testo libero Dimensioni del testo consigliate: 180 caratteri
Elenco 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
Valore ordine - CurrentPrice	Facoltativo	Il valore corrente dell'ordine.	Testo libero
Numero ordine	Facoltativo	Il numero/ID dell'ordine che può essere utilizzato per identificare in modo univoco l'ordine.	Testo libero Dimensione del testo consigliata: massimo 25 caratteri
Numero di riferimento	Facoltativo	Il numero di riferimento della consegna dell'ordine/del pacco nel caso in cui l'ordine richieda una consegna.	Testo libero Dimensioni del testo consigliate: massimo 25 caratteri

Specifiche per le immagini

Di seguito sono elencate le specifiche richieste per gli asset immagine:

Proporzioni	Numero minimo di pixel	Risoluzione consigliata in pixel
Quadrato (1 x 1) Preferito per i cluster non in primo piano	300x300	1200 x 1200
Orizzontale (1,91 x 1) Preferito per i cluster in primo piano	600 x 314	1200 x 628
Verticale (4 x 5)	480x600	960 x 1200

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 in modo che l'immagine possa essere visualizzata correttamente nelle impostazioni dei temi scuro e chiaro.

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).

AppEngageShoppingClient è responsabile della pubblicazione di cluster di shopping.

Le seguenti API sono esposte per pubblicare cluster nel client:

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishShoppingCart
• publishShoppingCarts
• publishShoppingList
• publishShoppingReorderCluster
• publishShoppingOrderTrackingCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteShoppingCartCluster
• deleteShoppingListCluster
• deleteShoppingReorderCluster
• deleteShoppingOrderTrackingCluster
• 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.
    }
});

Nota: ti consigliamo vivamente di mantenere in esecuzione un job periodico per verificare se il servizio diventa disponibile in un secondo momento. La disponibilità del servizio può cambiare con gli upgrade della versione di Android, gli upgrade delle app, le installazioni e le disinstallazioni. Garantendo controlli periodici dei job a un determinato intervallo di tempo, i dati possono essere pubblicati non appena il servizio diventa disponibile.

publishRecommendationClusters

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

Un oggetto RecommendationCluster può avere i seguenti attributi:

Attributo	Requisito	Descrizione
Elenco di ShoppingEntity	Obbligatorio	Un elenco di oggetti ShoppingEntity che costituiscono i suggerimenti per questo cluster di suggerimenti.
Titolo	Obbligatorio	Il titolo del cluster di suggerimenti. Dimensioni del testo consigliate: meno di 25 caratteri (se il testo è troppo lungo, potrebbero essere visualizzati i puntini di sospensione)
Sottotitolo	Facoltativo	Il sottotitolo del cluster di consigli.
URI azione	Facoltativo	Il link diretto alla pagina nell'app partner in cui gli utenti possono visualizzare l'elenco completo dei consigli. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta questa domanda frequente

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build())

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build());

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

• Tutti i dati esistenti dei cluster di consigli vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati in nuovi cluster di consigli.

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

publishFeaturedCluster

Questa API viene utilizzata per pubblicare un oggetto FeaturedCluster.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishFeaturedCluster(
            PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    FeaturedCluster.Builder()
                        ...
                        .build())
                .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    new FeaturedCluster.Builder()
                        ...
                        .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.

publishShoppingCart

Questa API viene utilizzata per pubblicare un oggetto ShoppingCartCluster.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishShoppingCart(
            PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())

Java

client.publishShoppingCart(
            new PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

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

• I dati ShoppingCart esistenti del partner sviluppatore vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster del carrello degli acquisti aggiornato.

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

publishShoppingCarts

Questa API viene utilizzata per pubblicare più oggetti ShoppingCart. Questo vale per gli sviluppatori partner che pubblicano carrelli separati per ogni commerciante. Includi il nome del commerciante nel titolo quando utilizzi questa API.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare in seguito le API di eliminazione e pubblicazione per sostituire il contenuto, poiché le API di pubblicazione lo fanno intrinsecamente.

Kotlin

client.publishShoppingCarts(
            PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())

Java

client.publishShoppingCarts(
            new PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

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

• I dati ShoppingCart esistenti del partner sviluppatore vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster del carrello degli acquisti aggiornato.

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

publishShoppingList

Questa API viene utilizzata per pubblicare un oggetto FoodShoppingList.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishFoodShoppingList(
            PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build())

Java

client.publishFoodShoppingList(
            new PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    new FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build());

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

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

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

publishShoppingReorderCluster

Questa API viene utilizzata per pubblicare un oggetto ShoppingReorderCluster.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

client.publishShoppingReorderCluster(
            PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build())

Java

client.publishShoppingReorderCluster(
            new PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    new ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build());

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

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

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

publishShoppingOrderTrackingCluster

Questa API viene utilizzata per pubblicare un oggetto ShoppingOrderTrackingCluster.

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare in seguito le API di eliminazione e pubblicazione per sostituire il contenuto, poiché le API di pubblicazione lo fanno intrinsecamente.

Kotlin

client.publishShoppingOrderTrackingCluster(
            PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build())

Java

client.publishShoppingOrderTrackingCluster(
            new PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    new ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build());

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

• I dati ShoppingOrderTrackingCluster esistenti dello sviluppatore partner vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster di monitoraggio degli ordini Shopping 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 mostrato sull'invito all'azione (ad es. Accedi)
Sottotitolo	Facoltativo	Sottotitolo facoltativo sulla scheda

Importante: le API di pubblicazione sono API upsert; sostituiscono i contenuti esistenti. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco.

Kotlin

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

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

Java

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

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

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

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

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

updatePublishStatus

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

• Fornire lo stato in tutti gli scenari, anche quando i contenuti vengono pubblicati (STATO == PUBBLICATO), è fondamentale per compilare le dashboard che usano questo stato esplicito per comunicare lo stato di integrità e altre metriche dell'integrazione.
• Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non è in errore (STATUS == NOT_PUBLISHED), Google può evitare di attivare 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.
• 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.

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

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

deleteRecommendationClusters

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

Importante: le API di eliminazione devono essere chiamate solo quando non ci sono contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire il contenuto, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteFeaturedCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non ci sono contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteShoppingCartCluster

Questa API viene utilizzata per eliminare i contenuti del cluster del carrello degli acquisti.

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteShoppingCartCluster()

Java

client.deleteShoppingCartCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster del carrello degli acquisti. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

Nota: questa API è disponibile dalla versione 1.1.0 in poi.

deleteShoppingListCluster

Questa API viene utilizzata per eliminare i contenuti del cluster della lista della spesa.

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteShoppingListCluster()

Java

client.deleteShoppingListCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster della lista della spesa. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteShoppingReorderCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteShoppingReorderCluster()

Java

client.deleteShoppingReorderCluster();

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

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteShoppingOrderTrackingCluster

Questa API viene utilizzata per eliminare i contenuti del cluster di monitoraggio degli ordini Shopping.

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. Contatta engagement-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteShoppingOrderTrackingCluster()

Java

client.deleteShoppingOrderTrackingCluster();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dal cluster di monitoraggio degli ordini di Shopping. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

Nota: questa API è disponibile nelle versioni 1.4.0 e successive.

deleteUserManagementCluster

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

Importante: le API di eliminazione devono essere chiamate solo quando non ci sono contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire il contenuto, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta engage-developers@ prima di utilizzare le API di eliminazione.

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.

Nota: questa API è disponibile a partire dalla versione 1.1.0.

deleteClusters

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

Importante: le API di eliminazione devono essere chiamate solo quando non sono presenti contenuti da pubblicare. Non chiamare successivamente le API di eliminazione e pubblicazione per sostituire il contenuto, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta engagement-developers@ prima di utilizzare le API di eliminazione.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      ...
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .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	Nome errore	Nota
1	SERVICE_NOT_FOUND	Il servizio non è disponibile sul dispositivo specificato.
2	SERVICE_NOT_AVAILABLE	Il servizio è disponibile sul dispositivo specificato, ma non al momento della chiamata (ad esempio, è disattivato esplicitamente).
3	SERVICE_CALL_EXECUTION_FAILURE	L'esecuzione dell'attività non è riuscita a causa di problemi di threading. In questo caso, è possibile eseguire nuovamente il tentativo.
4	SERVICE_CALL_PERMISSION_DENIED	Il chiamante non è autorizzato a effettuare la chiamata di servizio.
5	SERVICE_CALL_INVALID_ARGUMENT	La richiesta contiene dati non validi (ad esempio, più del numero consentito di cluster).
6	SERVICE_CALL_INTERNAL	Si è verificato un errore lato servizio.
7	SERVICE_CALL_RESOURCE_EXHAUSTED	La chiamata all'assistenza viene effettuata troppo spesso.

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 attivato solo quando il servizio Google Engage stabilisce che i contenuti potrebbero essere inattivi (ad esempio, dopo una settimana). In questo modo, l'utente può avere maggiore fiducia di poter usufruire di contenuti aggiornati, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei due modi seguenti:

• Registra in modo dinamico 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 shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast
  // is received
  // Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast
  // is received
  // Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
  // received
  // Trigger shopping order tracking cluster publish when
  // PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER 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 Shopping Cart Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_CART))

// Register Shopping List Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_LIST))

// Register Reorder Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_REORDER_CLUSTER))

// Register Shopping Order Tracking Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER))
}

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 shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast is
// received

// Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER
// 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 Shopping Cart Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_CART));

// Register Shopping List Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_LIST));

// Register Reorder Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_REORDER_CLUSTER));

// Register Shopping Order Tracking Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER));

}

• 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: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.shopping.PUBLISH_SHOPPING_CART" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER" />
      </intent-filter>
   </receiver>
</application>

I seguenti intent vengono inviati dal servizio:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION È consigliabile avviare una chiamata publishRecommendationClusters quando viene ricevuto questo intento.
• com.google.android.engage.action.PUBLISH_FEATURED È consigliabile avviare una chiamata publishFeaturedCluster quando viene ricevuta questa intenzione.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART È consigliabile avviare una chiamata publishShoppingCart quando viene ricevuta questa intenzione.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST Ti consigliamo di avviare una chiamata publishShoppingList quando viene ricevuto questo intent.
• com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER È consigliabile avviare una chiamata publishReorderCluster quando viene ricevuta questa intenzione.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER Ti consigliamo di avviare una chiamata publishShoppingOrderTrackingCluster quando viene ricevuto 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 [e-mail] in caso di domande durante la procedura di integrazione. Il nostro team risponde il prima possibile.

Passaggi successivi

Dopo aver completato questa integrazione, svolgi i seguenti passaggi:

• Invia un'email all'indirizzo [e-mail] e allega il tuo APK integrato pronto per i test 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 il tuo APK aggiornato è stato pubblicato sul Play Store, i cluster Consiglio, In evidenza, Carrello degli acquisti, Elenco della spesa, Cluster di riordino e Cluster di monitoraggio degli ordini di acquisto potrebbero essere pubblicati e visibili agli utenti.