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 offre una nuova esperienza immersiva per il consumo e la scoperta di contenuti delle app personalizzati. Questa esperienza a schermo intero offre agli sviluppatori partner l'opportunità di mostrare i loro migliori contenuti avanzati in un canale dedicato esterno alla loro app.

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

Dettagli integrazione

La sezione seguente illustra i dettagli dell'integrazione.

Terminologia

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

I consigli hanno la seguente struttura:

Cluster dei suggerimenti: visualizzazione dell'interfaccia utente che contiene un gruppo di suggerimenti dallo stesso sviluppatore partner.

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

• Verticale MediaEntity
• SocialPostEntity

VerticalMediaEntity deve contenere un'immagine verticale per il post. I metadati relativi al profilo e all'interazione sono facoltativi.

• Post

  • Immagine in modalità verticale e timestamp oppure
  • Immagine in modalità verticale + contenuto testuale e timestamp

• Profilo

  • Avatar, nome o handle, immagine aggiuntiva

• Interazione

  • Solo conteggio ed etichetta oppure
  • Conteggio e visualizzazione (icona)

SocialPostEntity contiene metadati relativi a profilo, post e interazioni.

• Profilo

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

• Post

  • Testo e timestamp oppure
  • Rich media (immagine o URL rich media) e timestamp, oppure
  • Testo e rich media (URL immagine o rich media) e timestamp

• Interazioni

  • Solo Conteggio ed etichetta oppure
  • Conteggio e immagini (icona)

Preparazione

Livello API minimo: 19

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

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

Riepilogo

Il design si basa sull'implementazione di un servizio associato.

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

Tipo di cluster	Limiti del cluster	Limiti minimi di entità in un cluster	Limiti massimi di entità in un cluster
Cluster di suggerimenti	Massimo 5	Almeno 5 (PortraitMediaEntity o SocialPostEntity)	Al massimo 25 (PortraitMediaEntity o SocialPostEntity)

Passaggio 1: fornisci i dati dell'entità

L'SDK ha definito diverse entità 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 descrivono gli attributi disponibili e i requisiti per ciascun tipo.

PortraitMediaEntity

Attributo	Requisito	Descrizione	Formato
URI dell'azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
(Obbligatorio) Metadati correlati al post
Immagini	Obbligatorio	Le immagini devono avere proporzioni verticali. La UI può mostrare una sola immagine se vengono fornite più immagini. Tuttavia, la UI potrebbe fornire un'indicazione visiva della presenza di più immagini nell'app. Se il post è un video, il fornitore deve fornire una miniatura del video da mostrare come immagine.	Per istruzioni, consulta la sezione Specifiche delle immagini.
Contenuti testuali	Facoltativo	Il testo principale di un post, aggiornamento e così via.	Stringa (consigliati max 140 caratteri)
Timestamp	Facoltativo	L'ora in cui il post è stato pubblicato.	Timestamp epoca in millisecondi
(Facoltativo) Metadati relativi al profilo
Nome	Obbligatorio	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel"	Stringa(consigliati max 25 caratteri)
L'avatar	Obbligatorio	Immagine del profilo o dell'avatar dell'utente. Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
Immagine aggiuntiva	Facoltativo	Badge del profilo, ad esempio badge di verifica Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
(Facoltativo) Metadati correlati alle interazioni
Conteggio	Obbligatorio	Indica il numero di interazioni, ad esempio: "3,7 M".	Stringa (max 20 caratteri consigliati per conteggio + etichetta combinato)
Casa discografica	Facoltativo Se non viene specificato, è necessario specificare il valore Immagini.	Indica a cosa serve l'interazione, ad esempio "Mi piace".	Stringa (max 20 caratteri consigliati per conteggio + etichetta combinato)
Visivo	Facoltativo Se non viene fornita, è necessario fornire l'etichetta.	Indica lo scopo dell'interazione. Ad esempio: immagine che mostra l'icona dei Mi piace ed emoji. È possibile fornire più di un'immagine, anche se non tutte potrebbero essere mostrate in tutti i fattori di forma. Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
(Facoltativo) DisplayTimeWindow: imposta una finestra temporale per la visualizzazione di un contenuto in superficie
Timestamp inizio	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti dovrebbero essere mostrati in superficie. Se non viene configurato, i contenuti sono idonei a essere mostrati in evidenza.	Timestamp epoca in millisecondi
Timestamp fine	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più mostrati in superficie. Se non viene configurato, i contenuti sono idonei a essere mostrati in evidenza.	Timestamp epoca in millisecondi

SocialPostEntity

Attributo	Requisito	Descrizione	Formato
URI dell'azione	Obbligatorie	Link diretto all'entità nell'app del provider. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti	URI
(Obbligatorio) Metadati correlati al post È richiesto almeno un contenuto di testo, un'immagine o un contenuto web
Immagini	Facoltativo	Le immagini devono avere proporzioni verticali. La UI può mostrare una sola immagine se vengono fornite più immagini. Tuttavia, la UI potrebbe fornire un'indicazione visiva della presenza di più immagini nell'app. Se il post è un video, il fornitore deve fornire una miniatura del video da mostrare come immagine.	Per istruzioni, consulta la sezione Specifiche delle immagini.
Contenuti testuali	Facoltativo	Il testo principale di un post, aggiornamento e così via.	Stringa (consigliati max 140 caratteri)
Anteprima link (facoltativo)
Anteprima link - Titolo	Obbligatorio	Testo per indicare il titolo dei contenuti della pagina web	Stringa
Anteprima link - Nome host	Obbligatorio	Testo per indicare il proprietario della pagina web, ad es. "INSIDER"	Stringa
Anteprima link - Immagine	Facoltativo	Immagine hero per i contenuti web	Per istruzioni, consulta la sezione Specifiche delle immagini.
Timestamp	Facoltativo	L'ora in cui il post è stato pubblicato.	Timestamp epoca in millisecondi
(Facoltativo) Metadati relativi al profilo
Nome	Obbligatorio	Nome, ID o handle del profilo, ad esempio "Mario Rossi", "@TeamPixel".	Stringa(consigliati max 25 caratteri)
Testo aggiuntivo	Facoltativo	Può essere utilizzato come ID profilo, handle o metadati aggiuntivi Ad esempio "@Mario-Rossi", "5 Mln di follower", "Potrebbe piacerti", "Di tendenza","5 nuovi post".	Stringa(consigliati max 40 caratteri)
L'avatar	Obbligatorio	Immagine del profilo o dell'avatar dell'utente. Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
Immagine aggiuntiva	Facoltativo	Badge del profilo, ad esempio badge di verifica Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
(Facoltativo) Metadati correlati alle interazioni
Conteggio	Obbligatorio	Indica il numero di interazioni, ad esempio: "3,7 M".	Stringa (max 20 caratteri consigliati per conteggio + etichetta combinato)
Casa discografica	Facoltativo Se non viene specificato, è necessario specificare il valore Immagini.	Indica lo scopo dell'interazione. Ad esempio "Mi piace".	Stringa (max 20 caratteri consigliati per conteggio + etichetta combinato)
Visivo	Facoltativo Se non viene fornita, è necessario fornire l'etichetta.	Indica lo scopo dell'interazione. Ad esempio: immagine che mostra l'icona dei Mi piace, Emoji . È possibile fornire più di un'immagine, anche se non tutte potrebbero essere mostrate in tutti i fattori di forma. Immagine quadrata 1:1	Per istruzioni, consulta la sezione Specifiche delle immagini.
(Facoltativo) DisplayTimeWindow: imposta una finestra temporale per la visualizzazione di un contenuto in superficie
Timestamp inizio	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti dovrebbero essere mostrati in superficie. Se non viene configurato, i contenuti sono idonei a essere mostrati in evidenza.	Timestamp epoca in millisecondi
Timestamp fine	Facoltativo	Il timestamp dell'epoca dopo il quale i contenuti non vengono più mostrati in superficie. Se non viene configurato, i contenuti sono idonei a essere mostrati in evidenza.	Timestamp epoca in millisecondi

Specifiche per le immagini

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

Formati file

PNG, JPG, GIF statica, WebP

Dimensione massima 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 del tema scuro e chiaro.

Passaggio 2: fornisci i dati del cluster

È consigliabile eseguire il job di pubblicazione dei contenuti in background (ad esempio, utilizzando WorkManager) e pianificato a intervalli regolari o in base agli eventi (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 social.

Esistono 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 mantenere un job periodico in esecuzione per verificare se il servizio diventa disponibile in un secondo momento. La disponibilità del servizio può variare 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 SocialPostEntity o PortraitMediaEntity	Obbligatorie	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	Obbligatorie	Il titolo del cluster di suggerimenti (ad esempio, Più recenti dei tuoi amici). Dimensioni del testo consigliate: meno di 25 caratteri (il testo troppo lungo potrebbe mostrare dei puntini di sospensione)
URI azione	Facoltativo	Il link diretto alla pagina dell'app del partner in cui gli utenti possono visualizzare l'elenco completo dei suggerimenti. Nota: puoi utilizzare i link diretti per l'attribuzione. Consulta queste domande frequenti

Importante: le API di pubblicazione sono API upsert e sostituiscono i contenuti esistenti. Non chiamare delete e pubblicare successivamente le API per sostituire i contenuti, come fanno le API di pubblicazione intrinsecamente.

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, le seguenti azioni vengono eseguite nell'ambito 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 suggerimenti.

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

publishUserAccountManagementRequest

Questa API viene utilizzata per pubblicare una scheda di accesso . L'azione di accesso indirizza gli utenti alla pagina di accesso dell'app affinché quest'ultima possa pubblicare contenuti (o fornire contenuti più personalizzati)

I seguenti metadati fanno parte della scheda di accesso:

Attributo	Requisito	Descrizione
URI azione	Obbligatorio	Link diretto all'azione (ad esempio, consente di accedere alla pagina di accesso dell'app)
Immagine	Facoltativo: se non viene specificato, è necessario specificare il titolo	Immagine mostrata nella scheda Immagini con proporzioni 16:9 con una risoluzione di 1264x712
Titolo	Facoltativo - Se non viene fornita, è necessario fornire l'immagine	Titolo sulla scheda
Testo dell'azione	Facoltativo	Testo visualizzato nell'invito all'azione (ad es. Accedi)
Sottotitolo	Facoltativo	Sottotitolo facoltativo sulla scheda

Importante: le API di pubblicazione sono API upsert e sostituiscono i contenuti esistenti. Non chiamare delete e pubblicare successivamente le API per sostituire i contenuti, come fanno le API di pubblicazione 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, le seguenti azioni vengono eseguite nell'ambito di una transazione:

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

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

updatePublishStatus

Se per qualsiasi motivo aziendale interno non viene pubblicato nessuno dei cluster, 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 (STATUS == PUBBLICATO), è fondamentale per completare le dashboard che utilizzano questo stato esplicito per comunicare lo stato e altre metriche dell'integrazione.
• Se non vengono pubblicati contenuti, ma lo stato dell'integrazione non funziona (STATUS == NOT_PUBED), Google può evitare di attivare avvisi nelle dashboard di integrità dell'app. Conferma che i contenuti non sono stati pubblicati a causa di una situazione prevista dal punto di vista del fornitore.
• Aiuta gli sviluppatori a fornire insight sul momento in cui 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 da visualizzarne i contenuti o superarli.

Di seguito sono elencati i codici di stato di pubblicazione idonei :

// 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 provider non riescono a pubblicare la scheda di accesso, ti consigliamo di chiamare l'API updatepublishStatus con il codice di stato NOT_PUBBLICAZIONE_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 il contenuto dei cluster di suggerimenti.

Importante: le API di eliminazione dovrebbero essere richiamate solo quando non ci sono contenuti da pubblicare. Non chiamare "delete" e pubblicare successivamente le API per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta engagement-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 di suggerimenti. In caso di errore, l'intera richiesta viene rifiutata e lo stato esistente viene mantenuto.

deleteUserManagementCluster

Questa API viene utilizzata per eliminare il contenuto del cluster UserAccountManagement.

Importante: le API di eliminazione dovrebbero essere richiamate solo quando non ci sono contenuti da pubblicare. Non chiamare "delete" e pubblicare successivamente le API per sostituire i contenuti, poiché le API di pubblicazione lo fanno intrinsecamente. Contatta engagement-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 dovrebbero essere richiamate solo quando non ci sono contenuti da pubblicare. Non chiamare "delete" e pubblicare successivamente le API per sostituire i contenuti, 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 eseguire 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	Nota
SERVICE_NOT_FOUND	Il servizio non è disponibile sul dispositivo specificato.
SERVICE_NOT_AVAILABLE	Il servizio è disponibile sul dispositivo in questione, ma non al momento della chiamata (ad esempio, è disabilitato esplicitamente).
SERVICE_CALL_EXECUTION_FAILURE	Esecuzione dell'attività non riuscita a causa di problemi di organizzazione in thread. In questo caso, sarà possibile riprovare.
SERVICE_CALL_PERMISSION_DENIED	Il chiamante non è autorizzato a effettuare la chiamata di servizio.
SERVICE_CALL_INVALID_ARGUMENT	La richiesta contiene dati non validi (ad esempio, più del numero consentito di cluster).
SERVICE_CALL_INTERNAL	È presente un errore sul lato servizio.
SERVICE_CALL_RESOURCE_EXHAUSTED	La chiamata al servizio viene effettuata troppo spesso.

Passaggio 3: gestisci gli intent di trasmissione

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

L'obiettivo degli intent di trasmissione è principalmente la riattivazione dell'app e la forzatura della sincronizzazione dei dati. Gli intent di trasmissione non sono progettati per essere inviati molto di frequente. Viene attivato solo quando il servizio Engage determina che i contenuti potrebbero essere obsoleti (ad esempio, una settimana fa). In questo modo, si può avere più sicurezza che l'utente possa avere un'esperienza con i contenuti aggiornati, anche se l'applicazione non è stata eseguita per un lungo periodo di tempo.

BroadcastReceiver deve essere configurato nei due modi seguenti:

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

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

Il servizio invia i seguenti intent:

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

Flusso di lavoro di integrazione

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

Domande frequenti

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

Contact

Contatta [e-mail] in caso di domande durante la procedura di integrazione. Il nostro team ti risponderà appena possibile.

Passaggi successivi

Una volta completata l'integrazione, i passaggi successivi sono i seguenti:

• Invia un'email all'indirizzo [e-mail] e allega l'APK integrato pronto per i test di Google.
• Google esegue una verifica ed esamina internamente per assicurarsi che l'integrazione funzioni come previsto. Se sono necessarie modifiche, Google ti contatta fornendoti tutti i dettagli necessari.
• Quando il test è completo e non sono necessarie modifiche, Google ti contatta per informarti che puoi iniziare a pubblicare l'APK aggiornato e integrato nel Play Store.
• Dopo che Google avrà confermato che l'APK aggiornato è stato pubblicato sul Play Store, il tuo consiglio verrà pubblicato e i cluster saranno visibili agli utenti.