Engage SDK Shopping: Anleitung zur technischen Integration von Drittanbietern

Google entwickelt eine On-Device-Oberfläche, auf der die Apps der Nutzer nach Branchen organisiert werden. So können Nutzer personalisierte App-Inhalte noch besser entdecken und nutzen. Dieser Vollbildmodus bietet Entwicklerpartnern die Möglichkeit, ihre besten Inhalte in einem speziellen Kanal außerhalb ihrer App zu präsentieren.

Dieser Leitfaden enthält eine Anleitung für Entwicklerpartner, wie sie ihre Shopping-Inhalte mit dem Engage SDK einbinden und damit sowohl diese neue Oberfläche als auch bestehende Google-Oberflächen wie Entertainment Space befüllen können.

Integrationsdetails

Terminologie

Diese Integration umfasst die folgenden fünf Clustertypen: Empfehlung, Empfohlen, Einkaufswagen, Einkaufsliste, Wiederbestellen und Bestellungsverlauf.

  • Empfehlungscluster zeigen personalisierte Shopping-Vorschläge von einzelnen Entwicklerpartnern. Diese Empfehlungen können für den Nutzer personalisiert oder allgemein gehalten werden (z. B. angesagte Artikel). So kannst du nach Belieben Produkte, Veranstaltungen, Angebote, Werbeaktionen und Abos präsentieren.

    Ihre Empfehlungen haben folgende Struktur:

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

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

  • Im Cluster Empfohlen werden in einer UI-Gruppierung eine Auswahl von Entitäten verschiedener Entwicklerpartner präsentiert. Es gibt einen einzelnen „Empfohlen“-Cluster, der oben in der Benutzeroberfläche mit einer bevorzugten Platzierung über allen Empfehlungsclustern angezeigt wird. Jeder Entwicklerpartner kann bis zu zehn Entitäten im Cluster „Empfohlen“ übertragen.

  • Der Cluster Einkaufswagen zeigt einen Einblick in die Einkaufswagen vieler Entwicklerpartner in einer einzigen UI-Gruppierung, um Nutzer dazu anzuregen, ihre ausstehenden Einkäufe abzuschließen. Es gibt einen einzelnen Einkaufswagen-Cluster, der oben in der Benutzeroberfläche mit Vorrang vor allen Empfehlungsclustern angezeigt wird. Jeder Entwicklerpartner darf bis zu drei ShoppingCart-Instanzen im Shopping Cart-Cluster übertragen.

    Ihr Einkaufswagen hat die folgende Struktur:

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

    • Einkaufswagen:Ein Objekt, das die Einkaufswagenvorschau für einen einzelnen Entwicklerpartner darstellt und im Einkaufswagen-Cluster angezeigt wird. ShoppingCart muss die Gesamtzahl der Artikel im Einkaufswagen enthalten und kann auch Bilder für einige Artikel im Einkaufswagen enthalten.

  • Der Cluster Einkaufsliste zeigt einen Ausschnitt der Einkaufslisten verschiedener Entwicklerpartner in einer einzigen Benutzeroberfläche. Nutzer werden aufgefordert, zur entsprechenden App zurückzukehren, um ihre Listen zu aktualisieren und zu vervollständigen. Es gibt einen einzelnen Einkaufslisten-Cluster.

  • Im Cluster Neu anordnen wird in einer UI-Gruppierung ein Ausblick auf die bisherigen Bestellungen mehrerer Entwicklerpartner angezeigt, wodurch Nutzer dazu aufgefordert werden, eine Neuanordnung vorzunehmen. Es gibt einen einzelnen Cluster für die Neuanordnung.

    • Der Cluster für die Nachbestellung muss die Gesamtzahl der Artikel in der vorherigen Bestellung des Nutzers enthalten und außerdem eine der folgenden Optionen:

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

  • Der Cluster Shopping Order Tracking (Sendungsverfolgung für Bestellungen) bietet einen Überblick über ausstehende oder kürzlich abgeschlossene Bestellungen von vielen Entwicklerpartnern in einer einzigen UI-Gruppierung, über die Nutzer ihre Bestellungen verfolgen können.

    Im oberen Bereich der Benutzeroberfläche wird ein einzelner ShoppingOrderTracking-Cluster angezeigt, dessen Priorität über allen Empfehlungsclustern liegt. Jeder Entwicklerpartner darf mehrere ShoppingOrderTrackingEntity-Elemente im Shopping Order Tracking-Cluster senden.

    • Ihr ShoppingOrderTrackingCluster hat folgende Struktur:

      • ShoppingOrderTracking Cluster: Eine UI-Ansicht mit einer Gruppe von Vorschauen für die Bestellverfolgung von vielen Entwicklerpartnern
      • ShoppingOrderTrackingEntity: Ein Objekt, das eine Vorschau des Shopping-Bestell-Trackings für einen einzelnen Entwicklerpartner darstellt und im Cluster „Shopping-Bestell-Tracking“ angezeigt wird. Die ShoppingOrderTrackingEntity muss den Status der Bestellung und die Uhrzeit der Bestellung anzeigen. Wir empfehlen dringend, die voraussichtliche Lieferzeit für „ShoppingOrderTrackingEntity“ anzugeben, da sie Nutzern angezeigt wird, wenn sie angegeben ist.

Vorarbeit

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 finden Sie unter Paketsichtbarkeit unter Android 11.

Zusammenfassung

Das Design basiert auf einer Implementierung eines gebundenen Dienstes.

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

Clustertyp Clusterlimits Maximale Entitätslimits in einem Cluster
Empfehlungscluster Höchstens 5 Höchstens 25 ShoppingEntity
Ausgewählter Cluster Maximal 1 Höchstens 10 ShoppingEntity
Einkaufswagencluster Maximal 1 Höchstens 3 ShoppingCart

Mehrere Einkaufswagen werden nur bei Apps mit separaten Einkaufswagen pro Händler erwartet.

Einkaufslisten-Cluster Maximal 1 Höchstens 1 ShoppingListEntity
Shopping-Neuanordnungs-Cluster Höchstens 1 Höchstens 1 ReorderEntity
Cluster zur Bestellverfolgung Maximal 3 Höchstens 3 ShoppingOrderTrackingEntity

Schritt 1: Entitätsdaten angeben

Im SDK sind verschiedene Entitäten für jeden Artikeltyp definiert. Für die Kategorie „Shopping“ werden die folgenden Entitäten unterstützt:

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

In den folgenden Diagrammen sind die verfügbaren Attribute und Anforderungen für jeden Typ aufgeführt.

ShoppingEntity

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

ShoppingEntity
Attribut Anforderung Beschreibung Formatieren
Posterbilder Erforderlich Es muss mindestens ein Bild zur Verfügung gestellt werden. Weitere Informationen finden Sie unter Anforderungen an Bilder.
Aktions-URI Erforderlich

Der Deeplink zur Seite in der App mit Details zur Entität.

Hinweis: Für die Attribution können Sie Deeplinks verwenden. Weitere Informationen finden Sie in dieser FAQ.

Uri
Titel Optional Der Name der Entität.

Freier Text

Empfohlene Textgröße: weniger als 90 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Preis – aktuell Bedingt erforderlich

Der aktuelle Preis der Entität.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – durchgestrichen Optional Der ursprüngliche Preis der Entität, der in der UI durchgestrichen wird. Freier Text
Zusatzinformationen Optional Callout zum Bewerben einer Werbeaktion, Veranstaltung oder Aktualisierung für die Entität, falls verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Kleingedrucktes zu Zusatzinformationen Optional Kleingedruckter Text für die Zusatzinformation.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Bewertung (optional): Hinweis: Alle Bewertungen werden mit unserem standardmäßigen Bewertungssystem mit Sternen angezeigt.
Altersfreigabe – Höchstwert Optional

Der Maximalwert der Bewertungsskala.

Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben wird.

 Zahl >= 0,0
Bewertung – Aktueller Wert Optional

Der aktuelle Wert der Bewertungsskala.

Muss angegeben werden, wenn auch der maximale Wert der Bewertung angegeben wird.

 Zahl >= 0.0
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für die Entität.

Hinweis: Geben Sie dieses Feld an, wenn in Ihrer App festgelegt wird, wie die Anzahl den Nutzern angezeigt wird. Verwenden Sie einen prägnanten String. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie eine Abkürzung wie 1 Mio. verwenden, damit die Anzahl bei kleineren Bildschirmgrößen nicht abgeschnitten wird.

String
Altersfreigabe – Wert für die Anzahl Optional

Die Anzahl der Bewertungen für die Entität.

Hinweis: Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten. Wenn sowohl „Anzahl“ als auch „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ den Nutzern angezeigt.

 Lang
DisplayTimeWindow (optional): Legen Sie ein Zeitfenster fest, in dem Inhalte auf der Oberfläche angezeigt werden sollen.
Startzeitstempel Optional

Der Epoch-Zeitstempel, nach dem die Inhalte auf der Oberfläche angezeigt werden sollen.

Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche angezeigt werden.

 Epochen-Zeitstempel in Millisekunden
Endzeitstempel Optional

Der Epochenzeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird.

Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche angezeigt werden.

 Epochen-Zeitstempel in Millisekunden

ShoppingCart

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Der Deeplink zum Einkaufswagen in der App des Partners.

Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in dieser FAQ.

Uri
Anzahl der Elemente Erforderlich

Die Anzahl der Artikel im Einkaufswagen (nicht nur die Anzahl der Produkte).

Beispiel: Wenn sich 3 identische Hemden und 1 Hut im Einkaufswagen befinden, sollte diese Zahl 4 lauten.

Ganzzahl >= 1
Aktionstext Optional

Der Call-to-Action-Text der Schaltfläche im Einkaufswagen (z. B. Meine Einkaufstasche).

Wenn der Entwickler keinen Aktionstext angibt, ist Einkaufswagen ansehen standardmäßig festgelegt.

Dieses Attribut wird ab Version 1.1.0 unterstützt.

String
Titel Optional

Der Titel des Einkaufswagens (z. B. Ihr Einkaufswagen).

Wenn der Entwickler keinen Titel angibt, wird standardmäßig Ihr Einkaufswagen verwendet.

Wenn der Entwicklerpartner einen separaten Einkaufswagen pro Händler veröffentlicht, geben Sie bitte den Namen des Händlers im Titel an.

Freier Text

Empfohlene Textgröße: weniger als 25 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Bilder im Einkaufswagen Optional

Bilder der einzelnen Produkte im Einkaufswagen.

Es können bis zu zehn Bilder in der Reihenfolge ihrer Priorität bereitgestellt werden. Die tatsächliche Anzahl der angezeigten Bilder hängt vom Formfaktor des Geräts ab.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Artikellabels Optional

Die Liste der Labels für Artikel auf der Einkaufsliste.

Die tatsächlich angezeigte Anzahl der Labels hängt vom Formfaktor des Geräts ab.

Liste der Labels mit freiem Text

Empfohlene Textgröße: weniger als 20 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Zeitstempel der letzten Nutzerinteraktion Optional Die Anzahl der Millisekunden, die seit der Epoche vergangen sind, und die angeben, wann der Nutzer zuletzt mit dem Einkaufswagen interagiert hat.

Diese Daten werden von den Entwicklerpartnern, die einen separaten Einkaufswagen pro Händler veröffentlichen, als Eingabe übergeben und können für das Ranking verwendet werden.

Epochen-Zeitstempel in Millisekunden
DisplayTimeWindow (optional): Legen Sie ein Zeitfenster fest, in dem Inhalte auf der Oberfläche angezeigt werden sollen.
Startzeitstempel Optional

Der Epoch-Zeitstempel, nach dem die Inhalte auf der Oberfläche angezeigt werden sollen.

Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche angezeigt werden.

 Epochen-Zeitstempel in Millisekunden
Endzeitstempel Optional

Der Epochenzeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird.

Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche angezeigt werden.

 Epochen-Zeitstempel in Millisekunden

ShoppingList

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Der Deeplink zur Einkaufsliste in der Partner-App.

Hinweis: Für die Attribution können Sie Deeplinks verwenden. Weitere Informationen finden Sie in diesen FAQs

Uri
Anzahl der Elemente Erforderlich Die Anzahl der Artikel auf der Einkaufsliste. Ganzzahl >= 1
Titel Optional

Der Titel der Liste (z. B. Einkaufsliste).

Wenn der Entwickler keinen Titel angibt, wird standardmäßig Einkaufsliste verwendet.

Freier Text

Empfohlene Textgröße: weniger als 25 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Artikellabels Erforderlich

Die Liste der Labels für Artikel auf der Einkaufsliste.

Es muss mindestens ein Label angegeben werden. Es können bis zu zehn Labels in der Reihenfolge ihrer Priorität angegeben werden. Die tatsächlich angezeigte Anzahl der Labels hängt vom Formfaktor des Geräts ab.

Liste der Labels mit freiem Text

Empfohlene Textgröße: weniger als 20 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)

ShoppingReorderCluster

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Der Deeplink, über den die Reihenfolge in der App des Partners geändert werden soll.

Hinweis: Für die Attribution können Sie Deeplinks verwenden. Weitere Informationen finden Sie in dieser FAQ.

Uri
Aktionstext Optional

Der Call-to-Action-Text der Schaltfläche bei der Neuanordnung (z. B. Noch einmal bestellen).

Wenn der Entwickler keinen Aktionstext angibt, ist Neu anordnen standardmäßig festgelegt.

Dieses Attribut wird ab Version 1.1.0 unterstützt.

String
Anzahl der Elemente Erforderlich

Die Anzahl der Artikel (nicht nur die Anzahl der Produkte) in der vorherigen Bestellung.

Beispiel: Wenn in der vorherigen Bestellung 3 kleine Kaffeesorten und 1 Croissant vorhanden waren, sollte diese Zahl „4“ lauten.

Ganzzahl >= 1
Titel Erforderlich Der Titel des Artikels, der nachbestellt werden soll.

Freier Text

Empfohlene Textgröße: weniger als 40 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt.)
Artikellabels

Optional

(Falls nicht, sollten auch Posterbilder zur Verfügung gestellt werden.)

Die Liste der Artikellabels für die vorherige Bestellung.

Es können bis zu 10 Labels in der Reihenfolge der Priorität angegeben werden. Die tatsächlich angezeigte Anzahl der Labels hängt vom Formfaktor des Geräts ab.

Liste mit freiem Text

Empfohlene Textgröße pro Label: weniger als 20 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt.)

Posterbilder

Optional

(Falls nicht vorhanden, sollten Artikellabels angegeben werden.)

Bilder der Artikel aus der vorherigen Bestellung.

Es können bis zu 10 Bilder in der Reihenfolge ihrer Priorität angegeben werden. Die tatsächlich angezeigte Anzahl der Bilder hängt vom Formfaktor des Geräts ab.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.

ShoppingOrderTrackingCluster

Attribut Anforderung Beschreibung Formatieren
Titel Erforderlich

Ein kurzer Titel des Pakets/der Artikel, die verfolgt werden, oder die Sendungsnummer.

Freier Text

Empfohlene Textgröße: 50 Zeichen. Bei zu langem Text werden Auslassungspunkte angezeigt.

Bestellart Erforderlich

Ein kurzer Titel des Pakets/der Artikel, die verfolgt werden, oder die Verfolgungsnummer.

Enum: IN_STORE_PICKUP, SAME_DAY_DELIVERY, MULTI_DAY_DELIVERY
Status Erforderlich

Der aktuelle Status der Bestellung.

Beispiel: „Verspätung“, „Unterwegs“, „Verspätete Lieferung“, „Versendet“, „Zugestellt“, „Nicht auf Lager“, „Bestellbar“

Freier Text

Empfohlene Textgröße: 25 Zeichen. Bei zu langem Text werden Auslassungspunkte angezeigt.

Bestellzeit Erforderlich

Der Epochenzeitstempel in Millisekunden, zu dem die Bestellung aufgegeben wurde.

Die Bestellzeit wird angezeigt, wenn der Zeitraum für die voraussichtliche Lieferzeit nicht vorhanden ist.

 Epochen-Zeitstempel in Millisekunden
Aktions-URI Erforderlich

Deeplink zur Bestellverfolgung in der Partner-App.

 Uri
OrderDeliveryTimeWindow (optional): Legen Sie ein Zeitfenster für die Bestellung fest, das von der Bestellung bis zur voraussichtlichen/tatsächlichen Lieferung verfolgt wird.
OrderDeliveryTimeWindow – Startzeit Optional

Der Epochenzeitstempel in Millisekunden, ab dem oder nach dem die Bestellung geliefert wird oder zur Abholung bereit ist.

 Epochen-Zeitstempel in Millisekunden
OrderDeliveryTimeWindow - Endzeit Optional

Der Epochenzeitstempel in Millisekunden, an dem/vor dem die Bestellung geliefert wird oder zur Abholung bereitsteht.

Epochen-Zeitstempel in Millisekunden
Posterbilder Optional

Bild eines Artikels/Produkts, das Teil der Bestellung ist.

Empfohlenes Seitenverhältnis: 1:1

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Anzahl der Elemente Optional Die Anzahl der Artikel in der Bestellung. Ganzzahl >= 1
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Artikel in der Bestellung.

Hinweis: Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist.

Hinweis: Den Nutzern wird entweder die Beschreibung oder die Liste der Untertitel angezeigt, nicht beides.

Freier Text

Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Bestellwert – Aktueller Preis Optional Der aktuelle Wert des Auftrags. Freier Text
Bestellnummer Optional Die Bestellnummer/-ID, mit der die Bestellung eindeutig identifiziert werden kann.

Freier Text

Empfohlene Textgröße: max. 25 Zeichen
Sendungsnummer Optional Die Verfolgungsnummer für die Bestellung/Paketzustellung, falls für die Bestellung eine Zustellung erforderlich ist.

Freier Text

Empfohlene Textgröße: max. 25 Zeichen

Bildspezifikationen

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

Seitenverhältnis Mindestanzahl Pixel Empfohlene Pixel

Quadratisch (1 × 1)

Bevorzugt für nicht angezeigte Cluster

 300 × 300 1200 × 1200

Querformat (1,91 x 1)

Bevorzugt für vorgestellte Cluster

 600 × 314 1200 × 628
Hochformat (4:5) 480 × 600 960 × 1.200

Dateiformate

PNG, JPG, statisches GIF, WebP

Maximale Dateigröße

5.120 KB

Weitere Empfehlungen

  • Bildbereich: Platzieren Sie wichtige Inhalte in den mittleren 80 % des Bildes.
  • Verwenden Sie einen transparenten Hintergrund, damit das Bild in den Einstellungen für dunkle und helle Themen richtig angezeigt werden kann.

Schritt 2: Clusterdaten angeben

Es empfiehlt sich, den Job zur Inhaltsveröffentlichung 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).

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
  • publishShoppingCarts
  • 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 Einbindung verfügbar ist und ob die Inhalte auf dem Gerät präsentiert werden können.

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

publishRecommendationClusters

Mit dieser API wird eine Liste von RecommendationCluster-Objekten veröffentlicht.

Ein RecommendationCluster-Objekt kann die folgenden Attribute haben:

Attribut Anforderung Beschreibung
Liste der ShoppingEntity Erforderlich Eine Liste von ShoppingEntity-Objekten, die die Empfehlungen für diesen Empfehlungscluster bilden.
Titel Erforderlich

Der Titel für den Empfehlungscluster.

Empfohlene Textgröße: weniger als 25 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Untertitel Optional Der Untertitel für den Empfehlungscluster.
Aktions-URI Optional

Der Deeplink zur Seite in der Partner-App, auf der Nutzer die vollständige Liste der Empfehlungen sehen können.

Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in dieser FAQ.

Kotlin

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

Java

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

Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishFeaturedCluster

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

Kotlin

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

Java

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

Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishShoppingCart

Mit dieser API wird ein ShoppingCartCluster-Objekt veröffentlicht.

Kotlin

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

Java

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

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

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishShoppingCarts

Mit dieser API werden mehrere ShoppingCart-Objekte veröffentlicht. Dies gilt für Entwicklerpartner, die separate Einkaufswagen pro Händler veröffentlichen. Fügen Sie bei Verwendung dieser API den Namen des Händlers in den Titel ein.

Kotlin

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

Java

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

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

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishShoppingList

Mit dieser API wird ein FoodShoppingList-Objekt veröffentlicht.

Kotlin

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

Java

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

Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

  • Vorhandene FoodShoppingList-Daten des Entwicklerpartners werden entfernt.
  • Die Daten aus der Anfrage werden analysiert und im aktualisierten Shopping-Listen-Cluster gespeichert.

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishShoppingReorderCluster

Mit dieser API wird ein ShoppingReorderCluster-Objekt veröffentlicht.

Kotlin

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

Java

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

Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

  • Vorhandene ShoppingReorderCluster-Daten des Entwicklerpartners werden entfernt.
  • Die Daten aus der Anfrage werden analysiert und im aktualisierten Cluster für die Neuanordnung gespeichert.

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishShoppingOrderTrackingCluster

Mit dieser API wird ein ShoppingOrderTrackingCluster-Objekt veröffentlicht.

Kotlin

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

Java

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

Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

publishUserAccountManagementRequest

Mit dieser API wird eine Anmeldekarte veröffentlicht. Die Anmeldeaktion leitet Nutzer zur Anmeldeseite der App weiter, damit die App Inhalte veröffentlichen oder personalisiertere Inhalte bereitstellen kann.

Die folgenden Metadaten sind Teil der Anmeldekarte:

Attribut Anforderung Beschreibung
Aktions-URI Erforderlich Deeplink zur Aktion (d. h. zur Anmeldeseite der App)
Bild Optional – falls nicht angegeben, muss ein Titel angegeben werden

Auf der Karte angezeigtes Bild

Bilder mit einem Seitenverhältnis von 16:9 und einer Auflösung von 1264 x 712
Titel Optional – falls nicht angegeben, muss ein Bild angegeben werden Titel auf der Karte
Aktionstext Optional Text im CTA (z. B. „Anmelden“)
Untertitel Optional Optionaler Untertitel auf der Karte

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

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 analysiert und im aktualisierten Cluster „UserAccountManagementCluster“ gespeichert.

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

updatePublishStatus

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

  • Es ist wichtig, den Status in allen Szenarien anzugeben, auch wenn die Inhalte veröffentlicht wurden (STATUS == PUBLISHED), um Dashboards zu erstellen, in denen dieser explizite Status verwendet wird, 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 Warnungen in den Dashboards zur App-Integrität vermeiden. Hiermit wird bestätigt, dass Inhalte aufgrund einer erwarteten Situation aus Sicht des Anbieters nicht veröffentlicht werden.
  • Sie hilft Entwicklern, Aufschluss darüber zu geben, wann die Daten veröffentlicht werden und wann nicht.
  • Google kann die Statuscodes verwenden, um Nutzer zu bestimmten Aktionen in der App anzuregen, damit sie die App-Inhalte 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 aufgrund einer fehlenden Nutzeranmeldung nicht veröffentlicht werden, empfiehlt Google, die Anmeldekarte zu veröffentlichen. Wenn Anbieter die Anmeldekarte aus irgendeinem Grund nicht veröffentlichen können, empfehlen wir, die API updatePublishStatus mit dem Statuscode NOT_PUBLISHED_REQUIRES_SIGN_IN aufzurufen.

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

Mit dieser API können Sie den Inhalt von Empfehlungsclustern löschen.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus den Empfehlungsclustern entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status beibehalten.

deleteFeaturedCluster

Mit dieser API können Sie den Inhalt des „Empfohlen“-Clusters löschen.

Kotlin

client.deleteFeaturedCluster()

Java

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.

deleteShoppingCartCluster

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

Kotlin

client.deleteShoppingCartCluster()

Java

client.deleteShoppingCartCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Einkaufswagencluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status beibehalten.

deleteShoppingListCluster

Mit dieser API können Sie den Inhalt des Clusters „Einkaufsliste“ löschen.

Kotlin

client.deleteShoppingListCluster()

Java

client.deleteShoppingListCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Cluster „Einkaufsliste“. Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

deleteShoppingReorderCluster

Mit dieser API können Sie den Inhalt des Shopping-Clusters für die Weiterbestellung löschen.

Kotlin

client.deleteShoppingReorderCluster()

Java

client.deleteShoppingReorderCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Shopping-Cluster für die Nachbestellung. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status beibehalten.

deleteShoppingOrderTrackingCluster

Mit dieser API können Sie den Inhalt des Shopping Order Tracking Cluster löschen.

Kotlin

client.deleteShoppingOrderTrackingCluster()

Java

client.deleteShoppingOrderTrackingCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem Shopping Order Tracking Cluster entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

deleteUserManagementCluster

Mit dieser API können Sie den Inhalt des Clusters „UserAccountManagement“ löschen.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Cluster „UserAccountManagement“. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.

deleteClusters

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

Kotlin

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

Java

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

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. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status bleibt erhalten.

Fehlerbehandlung

Es wird dringend empfohlen, das Aufgabenergebnis aus den Veröffentlichungs-APIs abzuhören, damit eine Folgeaktion ausgeführt werden kann, um eine erfolgreiche Aufgabe wiederherzustellen und noch einmal einzureichen.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

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

Fehlercode Fehlername Hinweis
1 SERVICE_NOT_FOUND Der Dienst ist auf dem betreffenden Gerät nicht verfügbar.
2 SERVICE_NOT_AVAILABLE Der Dienst ist auf dem angegebenen Gerät verfügbar, aber zum Zeitpunkt des Anrufs nicht (z. B. weil er explizit deaktiviert ist).
3 SERVICE_CALL_EXECUTION_FAILURE Die Ausführung der Aufgabe ist aufgrund von Problemen mit dem Thread fehlgeschlagen. In diesem Fall kann der Vorgang wiederholt werden.
4 SERVICE_CALL_PERMISSION_DENIED Der Anrufer ist nicht berechtigt, den Dienst anzurufen.
5 SERVICE_CALL_INVALID_ARGUMENT Die Anfrage enthält ungültige Daten (z. B. mehr als die zulässige Anzahl von Clustern).
6 SERVICE_CALL_INTERNAL Dienstseitig ist ein Fehler aufgetreten.
7 SERVICE_CALL_RESOURCE_EXHAUSTED Der Dienstaufruf erfolgt zu häufig.

Schritt 3: Broadcast-Intents verarbeiten

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 häufiges Senden vorgesehen. Sie wird nur ausgelöst, wenn der Engage-Dienst feststellt, dass die Inhalte möglicherweise veraltet sind (z. B. eine Woche alt). So ist die Wahrscheinlichkeit höher, dass Nutzer aktuelle Inhalte sehen, auch wenn die Anwendung seit einiger Zeit nicht ausgeführt wurde.

Das BroadcastReceiver muss auf eine der folgenden beiden Arten eingerichtet werden:

  • Registrieren Sie eine Instanz der Klasse BroadcastReceiver dynamisch mit Context.registerReceiver(). So ist die Kommunikation von Anwendungen möglich, die sich noch im Arbeitsspeicher befinden.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION
  // broadcast is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is
  // received
  // Trigger shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast
  // is received
  // Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast
  // is received
  // Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
  // received
  // Trigger shopping order tracking cluster publish when
  // PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER broadcast is received
}

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

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

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

// Register Shopping Cart Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_CART))

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

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

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

Java

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

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast is
// received

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

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

// Trigger reorder cluster publish when PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER
// broadcast is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

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

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

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

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

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

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

}
  • Deklarieren Sie eine Implementierung statisch mit dem <receiver>-Tag in Ihrer AndroidManifest.xml-Datei. So kann die Anwendung Broadcast-Intents empfangen, wenn sie nicht ausgeführt wird, und die 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.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 gesendet:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Wir empfehlen, einen publishRecommendationClusters-Anruf zu starten, wenn dieser Intent empfangen wird.
  • com.google.android.engage.action.PUBLISH_FEATURED Wir empfehlen, bei Erhalt dieser Absicht einen publishFeaturedCluster-Aufruf zu starten.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART Wir empfehlen, bei Erhalt dieser Absicht einen publishShoppingCart-Aufruf zu starten.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST Wir empfehlen, bei Erhalt dieser Absicht einen publishShoppingList-Aufruf zu starten.
  • com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER Wir empfehlen, bei Erhalt dieser Absicht einen publishReorderCluster-Aufruf zu starten.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER Wir empfehlen, einen publishShoppingOrderTrackingCluster-Aufruf zu starten, wenn dieser Intent empfangen wird.

Integrationsablauf

Eine detaillierte Anleitung zum Überprüfen Ihrer Integration nach Abschluss finden Sie unter Integrationsablauf für Entwickler.

Häufig gestellte Fragen

Häufig gestellte Fragen zum Engage SDK

Kontakt

Wenn Sie während der Integration Fragen haben, wenden Sie sich an engage-developers@google.com. Unser Team meldet sich so schnell wie möglich bei dir.

Nächste Schritte

Nach Abschluss dieser Integration sind folgende Schritte erforderlich:

  • Senden Sie eine E-Mail an engage-developers@google.com und hängen Sie Ihr integriertes APK an, das für den Test durch Google bereit ist.
  • Google führt eine interne Überprüfung durch, um sicherzustellen, dass die Integration wie erwartet funktioniert. Wenn Änderungen erforderlich sind, kontaktiert Sie Google mit allen erforderlichen Details.
  • Wenn die Tests abgeschlossen sind und keine Änderungen erforderlich sind, benachrichtigt Sie Google, dass Sie mit der Veröffentlichung des aktualisierten und integrierten APK im Play Store beginnen können.
  • Nachdem Google bestätigt hat, dass Ihr aktualisiertes APK im Play Store veröffentlicht wurde, können die Cluster Empfehlung, Empfohlen, Einkaufswagen, Einkaufsliste, Cluster für die Wiederholung von Bestellungen und Cluster für die Sendungsverfolgung von Bestellungen veröffentlicht und für Nutzer sichtbar werden.