Engage SDK Shopping: Anleitung zur technischen Integration von Drittanbietern

Google entwickelt eine On-Device-Oberfläche, Apps nach Branchen und ermöglicht ein neues immersives Erlebnis zur Nutzung personalisierter App-Inhalte. und Auffindbarkeit. Diese Vollbildansicht bietet Entwicklern die Möglichkeit, ihre besten hochwertigen Inhalte in einem eigenen Kanal außerhalb von Google zu präsentieren. ihrer App.

Dieser Leitfaden enthält Anweisungen für Entwicklerpartner zur Integration mit dem Engage SDK die neue Oberfläche und bestehende Google-Plattformen wie Entertainment Space.

Integrationsdetails

Terminologie

Diese Integration umfasst die folgenden fünf Clustertypen: Empfehlung, Empfohlen, Einkaufswagen, Einkaufsliste, Neu anordnen und Bestellverfolgung:

• Empfehlungscluster zeigen personalisierte Shopping-Vorschläge aus einer einzelnen Entwicklerpartner. Diese Empfehlungen können auf die Nutzer oder generalisiert werden (z. B. Trendartikel). Verwenden Sie diese, um Produkten, Veranstaltungen, Sonderangeboten, Werbeaktionen oder Abos.

  Ihre Empfehlungen haben folgende Struktur:

  • Empfehlungscluster:Eine UI-Ansicht, die eine Gruppe von vom selben Entwicklerpartner erhalten.

  • ShoppingEntity:Ein Objekt, das einen einzelnen Artikel in einem Cluster darstellt.

• Im Cluster Empfohlen wird der ausgewählte Held ShoppingEntity aus vielen präsentiert. Entwicklerpartner in einer UI-Gruppierung zusammengefasst. Es gibt einen einzelnen Cluster, der oben in der UI angezeigt wird, mit einer Priorität die über allen Empfehlungsclustern liegt. Jeder Entwicklerpartner eine einzelne ShoppingEntity im Cluster „Featured“ veröffentlichen.

• Der Cluster Einkaufswagen bietet eine Vorschau der Einkaufswagen von vielen Entwicklerpartner in einer UI-Gruppierung zusammengefasst, um Nutzer zum Abschließen ihrer ausstehende Warenkörbe. Es gibt einen Einkaufswagen-Cluster, erscheinen im oberen Bereich der Benutzeroberfläche, wobei vor allem eine Prioritätsplatzierung Empfehlungscluster. Jeder Entwicklerpartner darf eine nur eine ShoppingCart im Einkaufswagen-Cluster.

  Ihr Einkaufswagen hat folgende Struktur:

  • Einkaufswagen-Cluster: Eine UI-Ansicht, die eine Gruppe von Einkaufswagen enthält. Warenkorbvorschauen von vielen Entwicklerpartnern ansehen.

  • ShoppingCart:Ein Objekt, das die Einkaufswagenvorschau darstellt. für einen einzelnen Entwicklerpartner, die im Einkaufswagen angezeigt werden sollen. Cluster. ShoppingCart muss die Gesamtzahl der Elemente in den sowie Bilder für einige Artikel im Einkaufswagen enthalten.

• Die Gruppe Einkaufsliste zeigt einen kleinen Vorgeschmack auf das Einkaufsangebot. Listen von mehreren Entwicklerpartnern in einer UI-Gruppierung an, kehren zur entsprechenden App zurück, um die Listen zu aktualisieren und zu vervollständigen. Es gibt eine einzelnen Einkaufslisten-Cluster.

• Der Cluster Neu anordnen bietet eine Vorschau der vorherigen Bestellungen von mehrere Entwicklerpartner in einer UI-Gruppierung gruppieren, wodurch Nutzer aufgefordert werden, ihre Bestellung nachzubestellen. Es gibt einen einzelnen Reorder-Cluster.

  • Der neu angeordnete Cluster muss die Gesamtzahl der Elemente im vorherige Bestellung des Nutzers und muss außerdem eines der folgenden Elemente enthalten:

    • Bilder für X Artikel in der vorherigen Bestellung des Nutzers.
    • Labels für X Elemente in der vorherigen Bestellung des Nutzers.

• Der Cluster Shopping Order Tracking (Bestellverfolgung) bietet eine Vorschau auf ausstehende oder kürzlich abgeschlossene Einkaufsbestellungen von vielen Entwicklerpartnern in einer einzigen Benutzeroberfläche Gruppierung, sodass Nutzende ihre Bestellungen verfolgen können.

  Es wird ein einzelner ShoppingOrderTracking-Cluster angezeigt, im oberen Bereich der Benutzeroberfläche mit einer Prioritätsplatzierung über der Empfehlung. Cluster. Jeder Entwicklerpartner darf mehrere ShoppingOrderTrackingEntity-Artikel im Cluster zur Bestellverfolgung.

  • Ihr ShoppingOrderTrackingCluster hat die folgende Struktur:

    • ShoppingOrderTracking Cluster: Eine UI-Ansicht, die eine Gruppe von Vorschauen der Bestellverfolgung von vielen Entwicklerpartnern
    • ShoppingOrderTrackingEntity: Ein Objekt, das eine Bestellung darstellt. für einen einzelnen Entwicklerpartner, die im Cluster zur Bestellverfolgung. Die ShoppingOrderTrackingEntity muss Folgendes anzeigen: Status der Bestellung und die Uhrzeit der Bestellung angezeigt. Wir empfehlen dringend, zum Eingeben der voraussichtlichen Lieferdauer für ShoppingOrderTrackingEntity wie und wird Nutzern angezeigt, sofern sie bereitgestellt werden.

Vorarbeiten

Mindest-API-Level: 19

Fügen Sie Ihrer App die com.google.android.engage:engage-core-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.5.2'
}

Weitere Informationen zur Paketsichtbarkeit in Android 11.

Zusammenfassung

Das Design basiert auf der Implementierung einer gebundenen

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

Schritt 1: Entitätsdaten angeben

Im SDK sind verschiedene Entitäten für jeden Elementtyp definiert. Die Folgende Entitäten werden für die Kategorie „Shopping“ unterstützt:

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

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

ShoppingEntity

Das ShoppingEntity-Objekt steht für ein Produkt, eine Werbeaktion, ein Angebot, ein Abo oder Ereignisse, die Entwicklerpartner veröffentlichen möchten.

ShoppingEntity

ShoppingCart

ShoppingList

ShoppingReorderCluster

ShoppingOrderTrackingCluster

Bildspezifikationen

Im Folgenden finden Sie die erforderlichen Spezifikationen für Bild-Assets:

Dateiformate

PNG, JPG, statisches GIF, WebP

Maximale Dateigröße

5.120 KB

Weitere Empfehlungen

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

Schritt 2: Clusterdaten bereitstellen

Es wird empfohlen, den Job zur Inhaltsveröffentlichung im Hintergrund auszuführen. (z. B. mit WorkManager) regelmäßig oder auf Ereignisbasis (z. B. jedes Mal wenn der Nutzer die App öffnet oder gerade etwas in den Einkaufswagen gelegt hat.

AppEngageShoppingClient ist für die Veröffentlichung von Shopping-Clustern zuständig.

Die folgenden APIs werden für die Veröffentlichung von Clustern im Client verfügbar gemacht:

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishShoppingCart
• publishShoppingList
• publishShoppingReorderCluster
• publishShoppingOrderTrackingCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteShoppingCartCluster
• deleteShoppingListCluster
• deleteShoppingReorderCluster
• deleteShoppingOrderTrackingCluster
• deleteUserManagementCluster
• deleteClusters

isServiceAvailable

Mit dieser API wird geprüft, ob der Dienst für die Integration verfügbar ist ob die Inhalte auf dem Gerät angezeigt 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.

Ein RecommendationCluster-Objekt kann die folgenden Attribute haben:

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

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

Wenn der Dienst die Anfrage empfängt, werden die folgenden Aktionen innerhalb von eine Transaktion:

• Alle vorhandenen Empfehlungsclusterdaten werden entfernt.
• Daten aus der Anfrage werden geparst und in neuen Empfehlungsclustern gespeichert.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

publishFeaturedCluster

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

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

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

Wenn der Dienst die Anfrage erhält, werden die folgenden Aktionen innerhalb von eine Transaktion:

• 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 aktuelle Status lautet beibehalten werden.

publishShoppingCart

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

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

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

Wenn der Dienst die Anfrage erhält, werden die folgenden Aktionen innerhalb von eine Transaktion:

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

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

publishShoppingList

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

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

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

Wenn der Dienst die Anfrage erhält, werden die folgenden Aktionen innerhalb von eine Transaktion:

• Vorhandene FoodShoppingList-Daten des Entwicklerpartners werden entfernt.
• Die Daten aus der Anfrage werden geparst und in der aktualisierten Einkaufsliste gespeichert. Cluster.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

publishShoppingReorderCluster

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

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

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

Wenn der Dienst die Anfrage erhält, werden die folgenden Aktionen innerhalb von eine Transaktion:

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

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

publishShoppingOrderTrackingCluster

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

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

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

Wenn der Dienst die Anfrage erhält, werden die folgenden Aktionen innerhalb von eine Transaktion:

• Vorhandene ShoppingOrderTrackingCluster-Daten vom Entwicklerpartner sind entfernt.
• Die Daten aus der Anfrage werden geparst und in der aktualisierten Shopping Order gespeichert. Tracking-Cluster.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

publishUserAccountManagementRequest

Dieses API wird verwendet, um eine Anmeldekarte zu veröffentlichen . Bei der Anmeldung werden Nutzer weitergeleitet zu Anmeldeseite der App hinzufügen, damit die App Inhalte veröffentlichen oder weitere personalisierte Inhalte)

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, werden die folgenden Aktionen innerhalb von eine Transaktion:

• Vorhandene UserAccountManagementCluster-Daten vom Entwicklerpartner sind entfernt.
• Die Daten aus der Anfrage werden geparst und in der aktualisierten UserAccountManagementCluster-Cluster.

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der aktuelle Status lautet beibehalten werden.

updatePublishStatus

Wenn aus einem internen Geschäftsgrund keiner der Cluster veröffentlicht wird, Wir empfehlen dringend, den Veröffentlichungsstatus mithilfe der updatePublishStatus verwenden. Dies ist aus folgenden Gründen wichtig :

• Angabe des Status in allen Szenarien, auch wenn die Inhalte veröffentlicht wurden (STATUS == VERÖFFENTLICHT) ist wichtig, um Dashboards mit diesem expliziten Status, 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), Google kann verhindern, dass Benachrichtigungen in der App ausgelöst werden Gesundheits-Dashboards. Er bestätigt, dass Inhalte aufgrund eines erwartete Situation aus Sicht des Anbieters.
• Es hilft Entwickelnden, Erkenntnisse darüber zu geben, wann die Daten veröffentlicht werden nicht.
• Google kann die Statuscodes verwenden, um Nutzer zu bestimmten Aktionen im 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 der Inhalt nicht veröffentlicht wird, weil ein Nutzer nicht angemeldet ist, Google empfiehlt, die Log-in-Karte zu veröffentlichen. Wenn Anbieter die Anmeldekarte aus irgendeinem Grund nicht veröffentlichen können sollten Sie die API updatePublishStatus aufrufen, mit dem Statuscode NOT_PUBLISHED_REQUIRES_SIGN_IN

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 erhält, werden die vorhandenen Daten aus der Empfehlungscluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt. und der bestehende Zustand beibehalten wird.

deleteFeaturedCluster

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

client.deleteFeaturedCluster()

client.deleteFeaturedCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der Empfohlener Cluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt. und der bestehende Zustand beibehalten wird.

deleteShoppingCartCluster

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

client.deleteShoppingCartCluster()

client.deleteShoppingCartCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der Einkaufswagen-Cluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt. und der bestehende Zustand beibehalten wird.

deleteShoppingListCluster

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

client.deleteShoppingListCluster()

client.deleteShoppingListCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der Einkaufslisten-Cluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt. und der bestehende Zustand beibehalten wird.

deleteShoppingReorderCluster

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

client.deleteShoppingReorderCluster()

client.deleteShoppingReorderCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der Shopping-Neuanordnungs-Cluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt. und der bestehende Zustand beibehalten wird.

deleteShoppingOrderTrackingCluster

Diese API wird verwendet, um den Inhalt des Clusters zur Bestellverfolgung zu löschen.

client.deleteShoppingOrderTrackingCluster()

client.deleteShoppingOrderTrackingCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der Cluster zur Bestellverfolgung. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der bestehende Status wird beibehalten.

deleteUserManagementCluster

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

client.deleteUserManagementCluster()

client.deleteUserManagementCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus der UserAccountManagement-Cluster. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der bestehende Status wird beibehalten.

deleteClusters

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

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

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

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus allen Cluster, die den angegebenen Clustertypen entsprechen. Kunden können ein oder mehrere viele Clustertypen. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der der aktuelle Zustand beibehalten wird.

Fehlerbehandlung

Es wird dringend empfohlen, das Aufgabenergebnis der Publish-APIs wie dass eine Folgeaktion ergriffen werden kann, um eine erfolgreiche Aufgabe wiederherzustellen und erneut zu senden.

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 Fehlercode angezeigt.

Schritt 3: Mit Broadcast-Intents umgehen

Neben den Aufrufen der Content API zum Veröffentlichen über einen Job für die Einrichtung eines BroadcastReceiver zum Empfangen von um die Veröffentlichung von Inhalten zu beantragen.

Das Ziel von Broadcast-Intents besteht hauptsächlich darin, die App wieder zu aktivieren und Daten zu erzwingen synchronisieren. Broadcast-Intents sind nicht für das häufige Senden konzipiert. Es ist nur die ausgelöst werden, wenn Google Engage für Agenturen feststellt, dass die Inhalte veraltet sind (für z. B. eine Woche alt). Auf diese Weise besteht ein größeres Vertrauen, dass die Nutzenden Inhalte aktualisieren, auch wenn die App seit einem lange Zeit verbringen.

BroadcastReceiver muss auf zwei Arten eingerichtet werden:

• Dynamisches Registrieren einer Instanz der BroadcastReceiver-Klasse mithilfe von 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 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))
}

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

}

• Sie müssen eine Implementierung mit dem <receiver>-Tag in Ihrem AndroidManifest.xml-Datei. Dadurch kann die Anwendung Nachrichten an alle Intents erstellt, wenn sie nicht ausgeführt wird, und ermöglicht der App, für den Inhalt.

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

Die folgenden Intents werden vom Dienst:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION Es wird empfohlen, einen publishRecommendationClusters-Aufruf zu starten, wenn Intent empfangen wird.
• com.google.android.engage.action.PUBLISH_FEATURED Es wird empfohlen, einen publishFeaturedCluster-Aufruf zu starten, wenn dieser Intent erhalten haben.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART Es wird empfohlen, einen publishShoppingCart-Aufruf zu starten, wenn dieser Intent erhalten haben.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST Es wird empfohlen, einen publishShoppingList-Aufruf zu starten, wenn dieser Intent erhalten haben.
• com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER Es wird empfohlen, einen publishReorderCluster-Aufruf zu starten, wenn dieser Intent erhalten haben.
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER Es empfiehlt sich, einen publishShoppingOrderTrackingCluster-Anruf zu starten, wenn dieser Intent empfangen wird.

Integrationsablauf

Eine detaillierte Anleitung zur Verifizierung deiner Integration nach Abschluss findest du unter Workflow zur Einbindung von Entwicklern:

Häufig gestellte Fragen

Weitere Informationen finden Sie in den häufig gestellten Fragen zum Engage SDK für FAQs

Kontakt

Kontakt Engage-developers@google.com, falls folgende Voraussetzungen erfüllt sind: Fragen während des Integrationsprozesses stellen. Unser Team antwortet möglich.

Nächste Schritte

Nach Abschluss der Integration sind folgende Schritte erforderlich:

• E-Mail senden an Engage-developers@google.com und fügen Sie dein integriertes APK, das von Google getestet werden kann.
• Google führt eine Überprüfung durch und prüft diese intern, um sicherzustellen, wie erwartet funktioniert. Falls Änderungen erforderlich sind, kontaktiert Google Sie. mit allen erforderlichen Details.
• Wenn die Tests abgeschlossen sind und keine Änderungen erforderlich sind, kontaktiert Google Sie, benachrichtigt, dass Sie mit der Veröffentlichung des aktualisierten und integrierten APK im Play Store
• Nachdem Google bestätigt hat, dass Ihr aktualisiertes APK im Play Store, deine Empfehlung, Angesagt, Einkaufswagen Einkaufsliste, Cluster für neu anzuordnen und Cluster zur Bestellverfolgung Cluster können veröffentlicht und für Nutzer sichtbar sein.