Engage SDK Social: 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.

Questo documento contiene le istruzioni per gli sviluppatori partner per integrare i propri contenuti social utilizzando l'SDK Engage per compilare questa nuova area.

Dettagli integrazione

La sezione seguente acquisisce i dettagli dell'integrazione.

Terminologia

I cluster di consigli mostrano suggerimenti personalizzati di un singolo sviluppatore partner.

I consigli hanno la seguente struttura:

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

Ogni cluster di suggerimenti è costituito da uno dei seguenti due tipi di entità :

• PortraitMediaEntity
• SocialPostEntity

PortraitMediaEntity deve contenere un'immagine verticale per il post. I metadati relativi a profilo e interazione sono facoltativi.

• Post

  • Immagine in modalità Ritratto e Timestamp oppure
  • Immagine in modalità Ritratto + contenuti di testo e timestamp

• Profilo

  • Avatar, Nome o handle, Immagine aggiuntiva

• Interazioni

  • Conta e etichetta solo oppure
  • Conteggio e visualizzazione (icona)

SocialPostEntity contiene metadati correlati a profilo, post e interazione.

• Profilo

  • Avatar, nome o handle, testo aggiuntivo, immagine aggiuntiva

• Post

  • testo e timestamp; oppure
  • Rich media (immagine o URL rich) e timestamp oppure
  • Testo e rich media (immagine o URL rich) e timestamp oppure
  • Anteprima del video (miniatura e durata) e timestamp

• Interazioni

  • Contare ed etichettare solo oppure
  • Conteggio e immagini (icona)

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

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

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 (PortraitMediaEntity o SocialPostEntity)	Al massimo 25 (PortraitMediaEntity o SocialPostEntity)

Passaggio 1: fornisci i dati dell'entità

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

1. PortraitMediaEntity
2. SocialPostEntity

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

PortraitMediaEntity

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
(Obbligatorio) Metadati correlati al post
Immagini	Obbligatorio	Le immagini devono avere proporzioni verticali. L'interfaccia utente potrebbe mostrare una sola immagine se ne vengono fornite più di una. Tuttavia, l'interfaccia utente potrebbe fornire un'indicazione visiva della presenza di altre immagini nell' app. Se il post è un video, il fornitore deve fornire una miniatura del video da mostrare come immagine.	Per indicazioni, consulta le specifiche per le immagini.
Contenuti testuali	Facoltativo	Il testo principale di un post, di un aggiornamento e così via.	Stringa (massimo 140 caratteri consigliati)
Timestamp	Facoltativo	Ora di pubblicazione del post.	Timestamp in millisecondi
Sono contenuti video	Facoltativo	Il post è un video?	booleano
Durata video	Facoltativo	La durata del video in millisecondi.	Lungo
Metadati relativi al profilo (facoltativi)
Nome	Obbligatorio	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel"	Stringa(consigliato massimo 25 caratteri)
Avatar	Obbligatorio	Immagine del profilo o dell'avatar dell'utente. Immagine quadrata 1:1	Per indicazioni, consulta le specifiche per le immagini.
Immagine aggiuntiva	Facoltativo	Badge del profilo, ad esempio badge verificato Immagine quadrata 1:1	Per indicazioni, consulta le Specifiche delle immagini.
(Facoltativo) Metadati relativi alle interazioni
Conteggio	Facoltativo	Indica il numero di interazioni, 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
Valore conteggio	Facoltativo	Il numero di interazioni come valore. Nota:fornisci un valore di conteggio anziché di conteggio se l'app non gestisce la logica di come ottimizzare un numero elevato per dimensioni di visualizzazione diverse. Se vengono forniti sia Conteggi sia Valore conteggi, viene utilizzato Conteggi.	Lungo
Etichetta	Facoltativo	Indica a cosa serve l'etichetta dell'interazione. Ad esempio: "Mi piace".	Stringa Dimensioni del testo consigliate: massimo 20 caratteri per conteggi e etichette combinati
Immagini	Facoltativo	Indica lo scopo dell'interazione. Ad esempio: immagine che mostra l'icona Mi piace, un'emoji. Puoi fornire più di un'immagine, anche se non tutte potrebbero essere mostrate su tutti i fattori di forma. Nota: deve essere un'immagine quadrata 1:1	Per indicazioni, consulta le specifiche per le immagini.
DisplayTimeWindow (facoltativo): imposta una finestra temporale per la visualizzazione di un contenuto in superficie
Timestamp inizio	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti devono essere mostrati in superficie. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp in millisecondi
Data e ora di fine	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più mostrati in superficie. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

SocialPostEntity

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
Metadati relativi al post (obbligatori) È obbligatorio specificare almeno uno dei valori TextContent, Image o WebContent
Immagini	Facoltativo	Le immagini devono avere proporzioni verticali. L'interfaccia utente potrebbe mostrare una sola immagine se ne vengono fornite più di una. Tuttavia, l'interfaccia utente potrebbe fornire un'indicazione visiva della presenza di altre immagini nell' app. Se il post è un video, il fornitore deve fornire una miniatura del video da mostrare come immagine.	Per indicazioni, consulta le specifiche per le immagini.
Contenuti testuali	Facoltativo	Il testo principale di un post, di un aggiornamento e così via.	Stringa (massimo 140 caratteri consigliati)
Contenuti video (facoltativi)
Durata	Obbligatorio	La durata del video in millisecondi.	Lungo
Immagine	Obbligatorio	Immagine di anteprima dei contenuti video.	Per indicazioni, consulta le Specifiche delle immagini.
Anteprima link (facoltativa)
Anteprima link - Titolo	Obbligatorio	Testo per indicare il titolo dei contenuti della pagina web	Stringa
Anteprima link - Nome host	Obbligatorio	Testo che indica il proprietario della pagina web, ad esempio "INSIDER"	Stringa
Anteprima link - Immagine	Facoltativo	Immagine hero per i contenuti web	Per indicazioni, consulta le specifiche per le immagini.
Timestamp	Facoltativo	Ora di pubblicazione del post.	Timestamp in millisecondi
Metadati relativi al profilo (facoltativo)
Nome	Obbligatorio	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel".	Stringa(massimo 25 caratteri consigliati)
Testo aggiuntivo	Facoltativo	Può essere utilizzato come ID profilo o handle o come metadati aggiuntivi Ad esempio, "@Mario Rossi", "5 milioni di follower", "Potrebbero piacerti", "Tendenze", "5 nuovi post"	Stringa(consigliati max 40 caratteri)
Avatar	Obbligatorio	Immagine del profilo o dell'avatar dell'utente. Immagine quadrata 1:1	Per indicazioni, consulta le specifiche per le immagini.
Immagine aggiuntiva	Facoltativo	Badge del profilo, ad esempio badge verificato Immagine quadrata 1:1	Per indicazioni, consulta le specifiche per le immagini.
(Facoltativo) Metadati relativi alle interazioni
Conteggio	Obbligatorio	Indica il numero di interazioni, ad esempio "3,7 M".	Stringa (consigliati max 20 caratteri per conteggio + etichetta combinati)
Etichetta	Facoltativo Se non viene fornito, è necessario specificare Visual.	Indica lo scopo dell'interazione. Ad esempio: "Mi piace".	Stringa (è consigliabile un massimo di 20 caratteri per conteggio + etichetta combinati)
Immagini	Facoltativo Se non viene specificato, è necessario fornire Etichetta.	Indica lo scopo dell'interazione. Ad esempio: immagine che mostra l'icona Mi piace ed emoji. Puoi fornire più di un'immagine, anche se non tutte potrebbero essere mostrate su tutti i fattori di forma. Immagine quadrata 1:1	Per indicazioni, consulta le specifiche per le immagini.
DisplayTimeWindow (facoltativo): imposta una finestra temporale per la visualizzazione di un contenuto in superficie
Timestamp inizio	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti devono essere mostrati in superficie. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp in millisecondi
Data e ora di fine	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più mostrati in superficie. Se non è impostato, i contenuti sono idonei alla visualizzazione sulla piattaforma.	Timestamp epoch in millisecondi

Specifiche per le immagini

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.

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 seguito un nuovo account)

AppEngageSocialClient è responsabile della pubblicazione dei cluster sociali.

Esistono le seguenti API per pubblicare i cluster nel client:

• isServiceAvailable
• publishRecommendationClusters
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• 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: consigliamo vivamente di tenere 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 in un determinato intervallo di tempo, i dati possono essere pubblicati quando 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 SocialPostEntity o PortraitMediaEntity	Obbligatorio	Un elenco di entità che costituiscono i suggerimenti per questo cluster di suggerimenti. Le entità in un singolo cluster devono essere dello stesso tipo.
Titolo	Obbligatorio	Il titolo del cluster di consigli (ad es. Ultimi contenuti dei tuoi amici). Dimensioni del testo consigliate: meno di 25 caratteri (il testo troppo lungo potrebbe mostrare puntini di sospensione)
Sottotitolo	Facoltativo	Il sottotitolo del cluster di consigli.
URI azione	Facoltativo	Il link diretto alla pagina dell'app partner in cui gli utenti possono visualizzare l'elenco completo dei consigli. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti

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

Importante: per le app di social networking, è fondamentale aggiornare i consigli dopo ogni utilizzo dell'app. Gli utenti delle app social sono più interessati ai consigli più recenti e, idealmente, vorrebbero vedere un post al massimo una volta.

Kotlin

client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Latest from your friends")
                        .build())
                .build())

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Latest from your friends")
                        .build())
                .build());

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

• Tutti i dati esistenti del cluster di suggerimenti 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.

publishUserAccountManagementRequest

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

I seguenti metadati fanno parte della scheda Accedi:

Attributo	Requisito	Descrizione
URI azione	Obbligatorio	Link diretto all'azione (ad es. alla pagina di accesso all'app)
Immagine	(Facoltativo) Se non viene fornito, deve essere fornito il titolo	Immagine mostrata sulla scheda Immagini con proporzioni 16:9 con 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

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

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

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

Java

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

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

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

• I dati UserAccountManagementCluster esistenti dello sviluppatore partner vengono rimossi.
• I dati della richiesta vengono analizzati e archiviati nel cluster 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 è interrotto (STATUS == NOT_PUBLISHERED), Google può evitare di attivare avvisi nelle dashboard sullo stato dell'app. Conferma che i contenuti non vengono pubblicati a causa di una situazione prevedibile dal punto di vista del fornitore.
• Aiuta gli sviluppatori a fornire informazioni su quando i dati vengono pubblicati o meno.
• Google potrebbe utilizzare i codici di stato per indurre l'utente a eseguire determinate azioni nell'app in modo da poter vedere i contenuti dell'app o superarli.

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

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

deleteRecommendationClusters

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

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

Java

client.deleteRecommendationClusters();

Quando il servizio riceve la richiesta, rimuove i dati esistenti dai gruppi di consigli. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

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 i contenuti, poiché le API di pubblicazione lo fanno in modo intrinseco. 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.

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_RECOMMENDATION)
      ...
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .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.

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 dell'errore	Nota
1	SERVICE_NOT_FOUND	Il servizio non è disponibile sul dispositivo specificato.
2	SERVICE_NOT_AVAILABLE	Il servizio è disponibile sul dispositivo specificato, ma non al momento della chiamata (ad esempio, è disattivato esplicitamente).
3	SERVICE_CALL_EXECUTION_FAILURE	L'esecuzione dell'attività non è riuscita a causa di problemi di threading. In questo caso, è possibile riprovare.
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 al servizio viene effettuata troppo di frequente.

Passaggio 3: gestisci gli intent di trasmissione

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

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

BroadcastReceiver deve essere configurato nei due modi seguenti:

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

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION 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));

}

• 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>
   </receiver>
</application>

I seguenti intent verranno inviati dal servizio:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION Ti consigliamo di avviare una chiamata publishRecommendationClusters 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 [e-mail] in caso di domande durante la procedura di integrazione. Il nostro team ti risponderà 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 una revisione interna per garantire 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 la pubblicazione dell'APK aggiornato sul Play Store, il tuo Consiglio verrà pubblicato e i cluster saranno visibili agli utenti.