Engage SDK Health and Fitness: Anleitung zur technischen Integration von Drittanbietern

Google entwickelt eine On-Device-Oberfläche, die die Apps von Nutzern nach Branchen einordnet und eine neue immersive Umgebung für die Nutzung und Auffindbarkeit personalisierter App-Inhalte ermöglicht. Diese Vollbildansicht bietet Entwicklern die Möglichkeit, ihre besten Rich Contents in einem speziellen Kanal außerhalb ihrer App zu präsentieren.Dieser Leitfaden enthält eine Anleitung für Entwicklerpartner, wie sie ihre Gesundheits- und Fitnessinhalte mithilfe des Engage SDK einbinden können.

Integrationsdetails

Terminologie

Diese Integration umfasst die folgenden drei Clustertypen: Empfehlung, Empfohlen und Fortsetzung.

• Empfehlungscluster zeigen personalisierte Gesundheits- und Fitnessvorschläge von einem einzelnen Entwicklerpartner an. Diese Empfehlungen können für den Nutzer personalisiert oder generalisiert werden (z. B. Trends zu Fitness und Gesundheit). Hiermit können Sie Artikel oder Personen aus dem Bereich Gesundheit und Fitness anzeigen.

  • Ein Empfehlungscluster kann aus ArticleEntity, PersonEntity oder EventEntity erstellt werden, aber nicht mit einer Mischung aus verschiedenen Entitätstypen.

  Ihre Empfehlungen haben folgende Struktur:

  • Empfehlungscluster:Eine UI-Ansicht, die eine Gruppe von Empfehlungen desselben Entwicklerpartners enthält.

  • Entität:Ein Objekt, das ein einzelnes Element in einem Cluster darstellt. Diese Integration bietet einige Entitäten, die im Empfehlungscluster angezeigt werden würden:

    • ArticleEntity: ArticleEntity steht für eine Empfehlung für textbasierte Inhalte im Zusammenhang mit Gesundheit und Fitness. Sie können für Artikel, Blogposts, Marketinginhalte, News-Snippets usw. verwendet werden.

      

    • PersonEntity: PersonEntity repräsentiert eine Person. Die Empfehlungen könnten sein, einen Coach oder eine andere Person in Bezug auf Gesundheit und Fitness usw. hervorzuheben.

      

    • EventEntity: EventEntity repräsentiert ein Ereignis, das in der Zukunft stattfindet. Die Startzeit des Ereignisses ist eine wichtige Information, die den Nutzern vermittelt werden muss. Diese Entität könnte für die Anzeige von Veranstaltungen wie Blutspenden-Camp, Trainings, Fitnessstudio- oder Yoga-Kursen in Bezug auf Gesundheit und Fitness verwendet werden.

      

• Der Cluster Continuation zeigt Inhalte, die kürzlich von Nutzern mehrerer Entwicklerpartner in einer einzelnen UI-Gruppierung interagiert haben. Jeder Entwicklerpartner darf maximal 10 Entitäten im Continuation-Cluster senden.

  Fortsetzungsinhalte können die folgende Struktur haben:

  • ArticleEntity: ArticleEntity steht für eine Empfehlung für textbasierte Inhalte in den Bereichen Gesundheit und Fitness. Diese Entität kann verwendet werden, um unvollständige Nachrichtenartikel oder andere Inhalte darzustellen, die der Nutzer an der Stelle weiter ansehen möchte, an der er sie verlassen hat. Beispiel: Nachrichten-Snippet, Blogpost-Snippet zu Themen rund um Gesundheit oder Fitness.

    

  • EventReservationEntity: EventReservationEntity steht für die Reservierung eines Termins und hilft Nutzern, anstehende oder laufende Reservierungen für Fitness- und Gesundheitsveranstaltungen zu verfolgen. Beispiel: Schulungen

    

• Der Cluster Empfohlen ist eine UI-Ansicht, in der das ausgewählte Hero-GenericFeaturedEntity von vielen Entwicklerpartnern in einer UI-Gruppierung präsentiert wird. Oben auf der Benutzeroberfläche wird ein einzelner „Empfohlen“-Cluster angezeigt, dessen Priorität über allen Empfehlungsclustern liegt. Jeder Entwicklerpartner darf eine einzelne Entität eines unterstützten Typs in „Empfohlen“ mit vielen Entitäten (möglicherweise unterschiedlicher Typen) von mehreren App-Entwicklern im „Empfohlen“-Cluster senden.

  • GenericFeaturedEntity: GenericFeaturedEntity unterscheidet sich insofern von einem Empfehlungselement, dass ein empfohlenes Element für einen einzelnen Top-Inhalt von Entwicklern verwendet werden und den wichtigsten Inhalt darstellen sollte, der für die Nutzer interessant und relevant ist.

    

Vorarbeiten

Mindest-API-Level: 19

Fügen Sie Ihrer App die com.google.android.play:engage-Bibliothek hinzu:

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

Zusammenfassung

Das Design basiert auf der Implementierung eines gebundenen Dienstes.

Die Daten, die ein Client veröffentlichen kann, unterliegen den folgenden Limits für verschiedene Clustertypen:

Schritt 1: Entitätsdaten angeben

Im SDK sind verschiedene Entitäten für jeden Elementtyp definiert. In der Kategorie „Gesundheit und Fitness“ werden die folgenden Entitäten unterstützt:

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

In den folgenden Tabellen sind die verfügbaren Attribute und Anforderungen für die einzelnen Typen aufgeführt.

GenericFeaturedEntity

ArticleEntity

PersonEntity

EventEntity

EventReservationEntity

Bildspezifikationen

Die erforderlichen Spezifikationen für Bild-Assets sind in der folgenden Tabelle aufgeführt:

Die Images müssen auf öffentlichen CDNs gehostet werden, damit Google darauf zugreifen kann.

Dateiformate

PNG, JPG, statisches GIF, WebP

Maximale Dateigröße

5.120 KB

Weitere Empfehlungen

• Bildbereich:Wichtige Inhalte sollten in den mittleren 80% des Bildes positioniert werden.
• Verwenden Sie einen transparenten Hintergrund, damit das Bild in den Einstellungen für das dunkle und helle Design richtig angezeigt wird.

Content-Kategorie

Mit der Inhaltskategorie können Apps Inhalte veröffentlichen, die mehreren Kategorien angehören. Dadurch wird der Inhalt einigen der vordefinierten Kategorien zugeordnet, nämlich:

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

Die Images müssen auf öffentlichen CDNs gehostet werden, damit Google darauf zugreifen kann.

Richtlinien für die Verwendung der Inhaltskategorien

1. Einige Entitäten wie ArticleEntity und GenericFeaturedEntity können jede der Inhaltskategorien verwenden. Für andere Entitäten wie EventEntity, EventReservationEntity und PersonEntity ist nur eine Teilmenge dieser Kategorien zulässig. Prüfen Sie die Liste der Kategorien, die für einen Entitätstyp infrage kommen, bevor Sie die Liste ausfüllen.

2. Verwenden Sie für einige Inhaltskategorien den spezifischen Entitätstyp statt einer Kombination aus generischen Entitäten und ContentCategory:

   • TYPE_MovieS_AND_TV_SHOWS: Sehen Sie sich die Entitäten im Integrationsleitfaden ansehen an, bevor Sie die generischen Entitäten verwenden.
   • TYPE_BOOKS: Sehen Sie sich die EbookEntity an, bevor Sie die generischen Entitäten verwenden.
   • TYPE_AUDIOBOOKS: Schauen Sie sich Hörbuchentität an, bevor Sie die generischen Entitäten verwenden.
   • TYPE_SHOPPING: Prüfen Sie ShoppingEntity, bevor Sie allgemeine Entitäten verwenden.
   • TYPE_FOOD_AND_DRINK: Prüfen Sie die Entitäten im Food Integration Guide, bevor Sie die generischen Entitäten verwenden.

3. Das Feld „ContentCategory“ ist optional und sollte leer bleiben, wenn der Inhalt zu keiner der oben genannten Kategorien gehört.

4. Falls mehrere Inhaltskategorien angegeben werden, geben Sie diese in der Reihenfolge ihrer Relevanz für den Inhalt an, wobei die relevanteste Inhaltskategorie an erster Stelle in der Liste steht.

Schritt 2: Clusterdaten bereitstellen

Es empfiehlt sich, den Job zur Veröffentlichung von Inhalten im Hintergrund (z. B. mit WorkManager) auszuführen und ihn regelmäßig oder auf Ereignisbasis zu planen (z. B. jedes Mal, wenn der Nutzer die App öffnet oder gerade etwas in seinen Einkaufswagen gelegt hat).

AppEngagePublishClient ist für das Veröffentlichen von Clustern zuständig.

Es gibt die folgenden APIs, um Cluster im Client zu veröffentlichen:

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

isServiceAvailable

Mit dieser API wird geprüft, ob der Dienst für die Integration verfügbar ist und ob die Inhalte auf dem Gerät dargestellt werden können.

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

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

publishRecommendationClusters

Diese API wird verwendet, um eine Liste von RecommendationCluster-Objekten zu veröffentlichen.

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

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

Wenn der Dienst die Anfrage empfängt, finden innerhalb einer Transaktion die folgenden Aktionen statt:

• Vorhandene RecommendationCluster-Daten des Entwicklerpartners werden entfernt.
• Daten aus der Anfrage werden geparst und im aktualisierten Empfehlungscluster gespeichert.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

publishFeaturedCluster

Diese API wird verwendet, um eine Liste von FeaturedCluster-Objekten zu veröffentlichen.

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

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

Wenn der Dienst die Anfrage empfängt, finden innerhalb einer Transaktion die folgenden Aktionen statt:

• Vorhandene FeaturedCluster-Daten des Entwicklerpartners werden entfernt.
• Die Daten aus der Anfrage werden geparst und im aktualisierten „Featured Cluster“ gespeichert.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

publishContinuationCluster

Diese API wird zum Veröffentlichen eines ContinuationCluster-Objekts verwendet.

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

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

Wenn der Dienst die Anfrage empfängt, finden innerhalb einer Transaktion die folgenden Aktionen statt:

• Vorhandene ContinuationCluster-Daten des Entwicklerpartners werden entfernt.
• Die Daten aus der Anfrage werden geparst und im aktualisierten Continuation-Cluster gespeichert.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

publishUserAccountManagementRequest

Dieses API wird verwendet, um eine Anmeldekarte zu veröffentlichen . Über die Anmeldeaktion werden Nutzer zur Anmeldeseite der App weitergeleitet, damit sie Inhalte veröffentlichen (oder stärker personalisierte Inhalte) bereitstellen kann.

Die folgenden Metadaten sind Teil der Anmeldekarte:

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());

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());

Wenn der Dienst die Anfrage empfängt, finden innerhalb einer Transaktion die folgenden Aktionen statt:

• Vorhandene UserAccountManagementCluster-Daten des Entwicklerpartners werden entfernt.
• Die Daten aus der Anfrage werden geparst und im aktualisierten UserAccountManagementCluster-Cluster gespeichert.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

updatePublishStatus

Wenn aus internen geschäftlichen Gründen keiner der Cluster veröffentlicht wird, empfehlen wir dringend, den Veröffentlichungsstatus mithilfe der updatePublishStatus API zu aktualisieren. Dies ist aus folgenden Gründen wichtig :

• Die Angabe des Status in allen Szenarien, selbst wenn der Inhalt veröffentlicht wurde (STATUS == VERÖFFENTLICHT), ist wichtig, um Dashboards mit diesem expliziten Status zu füllen, um den Zustand und andere Messwerte deiner Integration zu vermitteln.
• Wenn keine Inhalte veröffentlicht werden, der Integrationsstatus aber nicht fehlerhaft ist (STATUS == NOT_PUBLISHED), kann Google verhindern, dass Benachrichtigungen in den Dashboards zum Zustand der Anwendung ausgelöst werden. Er bestätigt, dass Inhalte aufgrund einer erwarteten Situation aus Sicht des Anbieters nicht veröffentlicht wurden.
• Entwickler können so herausfinden, wann die Daten veröffentlicht werden und wann nicht.
• Google kann die Statuscodes verwenden, um Nutzer zu bestimmten Aktionen in der App zu bewegen, damit sie den App-Inhalt sehen oder überwinden können.

Die Liste der zulässigen Veröffentlichungsstatuscodes sieht so aus :

// 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

Wenn die Inhalte nicht veröffentlicht werden, weil ein Nutzer nicht angemeldet ist, empfiehlt Google, die Anmeldekarte zu veröffentlichen. Wenn Anbieter die Anmeldekarte aus irgendeinem Grund nicht veröffentlichen können, empfehlen wir, die updatePublishStatus API mit dem Statuscode NOT_PUBLISHED_REQUIRES_SIGN_IN aufzurufen.

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

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

deleteRecommendationClusters

Diese API wird verwendet, um den Inhalt von Empfehlungsclustern zu löschen.

client.deleteRecommendationClusters()

client.deleteRecommendationClusters();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus den Empfehlungsclustern entfernt. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

deleteFeaturedCluster

Diese API wird verwendet, um den Inhalt von empfohlenen Clustern zu löschen.

client.deleteFeaturedCluster()

client.deleteFeaturedCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem hervorgehobenen Cluster entfernt. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

deleteContinuationCluster

Diese API wird verwendet, um den Inhalt des Fortsetzungsclusters zu löschen.

client.deleteContinuationCluster()

client.deleteContinuationCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem Continuation-Cluster entfernt. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

deleteUserManagementCluster

Diese API wird verwendet, um den Inhalt des UserAccountManagement-Clusters zu löschen.

client.deleteUserManagementCluster()

client.deleteUserManagementCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem UserAccountManagement-Cluster entfernt. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

deleteClusters

Diese API wird verwendet, um den Inhalt eines bestimmten Clustertyps zu löschen.

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

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

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus allen Clustern entfernt, die den angegebenen Clustertypen entsprechen. Clients können einen oder mehrere Clustertypen übergeben. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

Fehlerbehandlung

Es wird dringend empfohlen, das Aufgabenergebnis der Publish APIs zu überwachen, damit eine Folgeaktion zum Wiederherstellen und erneuten Senden einer erfolgreichen Aufgabe eingeleitet werden kann.

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

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
                    }
                  }
                }
              });

Der Fehler wird als AppEngageException zurückgegeben, wobei die Ursache als Fehlercode angegeben wird.

Schritt 3: Mit Broadcast-Intents umgehen

Neben den Aufrufen der Content API zur Veröffentlichung über einen Job muss auch ein BroadcastReceiver eingerichtet werden, um die Anfrage für eine Inhaltsveröffentlichung zu erhalten.

Das Ziel von Broadcast-Intents besteht hauptsächlich darin, die App wieder zu aktivieren und die Datensynchronisierung zu erzwingen. Broadcast-Intents sind nicht für das häufige Senden konzipiert. Sie wird nur ausgelöst, wenn Google Engage für Agenturen feststellt, dass der Inhalt möglicherweise veraltet ist (z. B. eine Woche alt). So lässt sich die Sicherheit des Nutzers erhöhen, auch wenn die App längere Zeit nicht ausgeführt wurde.

BroadcastReceiver muss auf zwei Arten eingerichtet werden:

• Registriert eine Instanz der BroadcastReceiver-Klasse dynamisch mit Context.registerReceiver(). Dies ermöglicht die Kommunikation von Anwendungen, die sich noch im Arbeitsspeicher befinden.

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

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

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

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

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

}

• Deklariere eine Implementierung statisch mit dem <receiver>-Tag in der Datei AndroidManifest.xml. Dadurch kann die Anwendung Übertragungs-Intents empfangen, wenn sie nicht ausgeführt wird, und Inhalte veröffentlichen.

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

Die folgenden Intents werden vom Dienst gesendet:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION Es wird empfohlen, beim Empfang dieses Intents einen publishRecommendationClusters-Aufruf zu starten.
• com.google.android.engage.action.PUBLISH_FEATURED Es wird empfohlen, beim Empfang dieses Intents einen publishFeaturedCluster-Aufruf zu starten.
• com.google.android.engage.action.PUBLISH_CONTINUATION Es wird empfohlen, beim Empfang dieses Intents einen publishContinuationCluster-Aufruf zu starten.

Integrationsablauf

Eine detaillierte Anleitung zur Überprüfung Ihrer Integration nach ihrer Fertigstellung finden Sie im Workflow für die Engage-Entwicklerintegration.

Häufig gestellte Fragen

FAQs finden Sie unter Häufig gestellte Fragen zum Engage SDK.

Kontakt

Bitte wenden Sie sich an Engage-developers@google.com, wenn während des Integrationsprozesses Fragen auftreten sollten.

Nächste Schritte

Nach Abschluss der Integration sind folgende Schritte erforderlich:

• Sende eine E-Mail an Engage-developers@google.com und hänge dein integriertes APK an, das von Google getestet werden kann.
• Google führt eine Überprüfung durch und überprüft intern, ob die Integration wie erwartet funktioniert. Wenn Änderungen erforderlich sind, kontaktiert Google Sie mit allen erforderlichen Details.
• Wenn die Tests abgeschlossen sind und keine Änderungen erforderlich sind, teilt Google dir mit, dass du mit der Veröffentlichung des aktualisierten und integrierten APK im Play Store beginnen kannst.
• Nachdem Google bestätigt hat, dass Ihr aktualisiertes APK im Play Store veröffentlicht wurde, können Ihre Cluster Empfehlung, Empfohlen und Fortsetzung veröffentlicht und für Nutzer sichtbar sein.