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. Diese Vollbildansicht 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.
In Clustern vom Typ Empfehlung werden personalisierte Shopping-Vorschläge von einem einzelnen Entwicklerpartner angezeigt. 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 UI-Gruppierung, um Nutzer dazu anzuregen, ihre ausstehenden Einkäufe abzuschließen. Es gibt einen einzelnen Einkaufswagen-Cluster, der oben in der Benutzeroberfläche angezeigt wird und eine bevorzugte Platzierung über allen Empfehlungsclustern hat. Jeder Entwicklerpartner darf bis zu drei
ShoppingCart
-Instanzen im Shopping Cart-Cluster übertragen.Ihr Einkaufswagen hat die folgende Struktur:
Einkaufswagen-Cluster:Eine UI-Ansicht mit einer Gruppe von Einkaufswagenvorschauen von vielen Entwicklerpartnern.
ShoppingCart:Ein Objekt, das die Einkaufswagenvorschau für einen einzelnen Entwicklerpartner darstellt und im Einkaufswagencluster angezeigt wird. Die
ShoppingCart
muss die Gesamtzahl der Artikel im Einkaufswagen anzeigen und kann auch Bilder für einige Artikel im Einkaufswagen des Nutzers enthalten.
Der Cluster Einkaufsliste enthält 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 Cluster für die Einkaufsliste.
Im Cluster Neu anordnen wird eine Vorschau der bisherigen Bestellungen mehrerer Entwicklerpartner in einer UI-Gruppierung angezeigt, die Nutzer zum Neuanordnen auffordert. 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 Angaben:
- 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.
Es gibt einen einzelnen ShoppingOrderTracking-Cluster, der oben in der Benutzeroberfläche angezeigt wird und eine vorrangige Platzierung über allen Empfehlungsclustern hat. 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 Bestellzeit enthalten. 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 Kunde veröffentlichen kann, unterliegen den folgenden Einschränkungen für verschiedene Clustertypen:
Clustertyp | Cluster limits | Maximale Entitätslimits in einem Cluster |
---|---|---|
Empfehlungscluster | Höchstens 7 | Maximal 50 ShoppingEntity |
Empfohlener Cluster | Maximal 1 | Höchstens 20 ShoppingEntity |
Einkaufswagencluster | Maximal 1 | Höchstens 3 ShoppingCart
Mehrere Einkaufswagen sind nur für Apps mit separaten Einkaufswagen pro Händler zu erwarten. |
Einkaufslisten-Cluster | Maximal 1 | Höchstens 1 ShoppingListEntity |
Shopping-Cluster für die Neubestellung | Maximal 1 | Höchstens 1 ReorderEntity |
Shopping Order Tracking Cluster | 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 Shopping-Kategorie werden die folgenden Entitäten unterstützt:
ShoppingEntity
ShoppingCart
ShoppingList
Reorder
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 angegeben 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: Sie können Deeplinks für die Attribution 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 Originalpreis der Entität, der in der Benutzeroberfläche durchgestrichen ist. | Freier Text |
Zusatzinformationen | Optional | Zusatzinformation zu einer Werbeaktion, einem Ereignis oder einem Update für die Entität, sofern 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 Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Altersfreigabe angegeben wird. |
Zahl >= 0.0 |
Altersfreigabe – Aktueller Wert | Optional | Der aktuelle Wert der Altersfreigabe. Muss angegeben werden, wenn auch der maximale Wert der Bewertung angegeben wird. |
Zahl >= 0.0 |
Altersfreigabe – 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 kurzen 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 präsentiert werden. |
Epochen-Zeitstempel in Millisekunden |
Endzeitstempel | Optional |
Der Epoch-Zeitstempel, nach dem die Inhalte nicht mehr angezeigt werden. Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche präsentiert 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 (nicht nur die Anzahl der Produkte) im Einkaufswagen. 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. Einkaufswagen) 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 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. |
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.
Dieser Wert wird von Entwicklerpartnern, die einen separaten Einkaufswagen pro Händler veröffentlichen, als Eingabe übergeben und kann 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 präsentiert werden. |
Epochen-Zeitstempel in Millisekunden |
Endzeitstempel | Optional |
Der Epoch-Zeitstempel, nach dem die Inhalte nicht mehr angezeigt werden. Wenn sie nicht festgelegt ist, können Inhalte auf der Oberfläche präsentiert werden. |
Epochen-Zeitstempel in Millisekunden |
ShoppingList
Attribut | Anforderung | Beschreibung | Formatieren |
---|---|---|---|
Aktions-URI | Erforderlich |
Der Deeplink zur Einkaufsliste 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 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 und bis zu zehn Labels können in Prioritätsreihenfolge 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: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in dieser FAQ. |
Uri |
Aktionstext | Optional |
Der Call-to-Action-Text der Schaltfläche „Neu anordnen“ (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 die vorherige Bestellung 3 kleine Kaffees und 1 Croissant enthielt, sollte diese Zahl 4 sein. |
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 vorhanden, sollten Plakatbilder bereitgestellt 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 Verfolgungsnummer. |
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: „Verzögert“, „Auf dem Weg“, „Verzögert“, „Versandt“, „Zugestellt“, „Nicht auf Lager“, „Bestellung ist fertig“ |
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 App des Partners. |
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 Epoch-Zeitstempel in Millisekunden, an dem/nach dem die Bestellung geliefert oder zur Abholung bereit ist. |
Epochen-Zeitstempel in Millisekunden |
OrderDeliveryTimeWindow – Endzeit | Optional |
Der Epoch-Zeitstempel in Millisekunden, an dem/vor dem die Bestellung geliefert oder zur Abholung bereit sein soll. |
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:Den Nutzern wird entweder die Beschreibung oder die Liste der Untertitel 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 jede Untertitelung: max. 50 Zeichen |
Bestellwert – Aktueller Preis | Optional | Der aktuelle Wert der Bestellung. | 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
Die erforderlichen Spezifikationen für Bild-Assets finden Sie unten:
Seitenverhältnis | Mindestanzahl Pixel | Empfohlene Pixel |
---|---|---|
Quadratisch (1 × 1) Bevorzugt für nicht angezeigte Cluster |
300 × 300 | 1200 × 1200 |
Querformat (1,91 × 1) Empfohlen für vorgestellte Cluster |
600 × 314 | 1.200 × 628 |
Hochformat (4 : 5) | 480 x 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 Designs richtig angezeigt werden kann.
Schritt 2: Clusterdaten angeben
Wir empfehlen, den Job zum Veröffentlichen von Inhalten im Hintergrund auszuführen (z. B. mit WorkManager) und regelmäßig oder auf Ereignisbasis zu planen (z. B. jedes Mal, wenn der Nutzer die App öffnet oder etwas in den Einkaufswagen gelegt hat).
AppEngageShoppingClient
ist für die Veröffentlichung von Shopping-Clustern verantwortlich.
Die folgenden APIs sind verfügbar, um Cluster im Client zu veröffentlichen:
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.
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
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. |
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 erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- Alle vorhandenen Daten zu Empfehlungsclustern 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
Mit dieser API wird ein FeaturedCluster
-Objekt veröffentlicht.
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 innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- Vorhandene
FeaturedCluster
-Daten des Entwicklerpartners werden entfernt. - Die Daten aus der Anfrage werden analysiert und im aktualisierten „Empfohlen“-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.
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 innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- Vorhandene
ShoppingCart
-Daten des Entwicklerpartners werden entfernt. - Die Daten aus der Anfrage werden analysiert und im aktualisierten Einkaufswagencluster gespeichert.
Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status bleibt erhalten.
publishShoppingCarts
Mit dieser API können mehrere ShoppingCart
-Objekte veröffentlicht werden. 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.
client.publishShoppingCarts( PublishShoppingCartClustersRequest.Builder() .addShoppingCart( ShoppingCart.Builder() ... .build()) .build())
client.publishShoppingCarts( new PublishShoppingCartClustersRequest.Builder() .addShoppingCart( new ShoppingCart.Builder() ... .build()) .build())
Wenn der Dienst die Anfrage erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- Vorhandene
ShoppingCart
-Daten des Entwicklerpartners werden entfernt. - Die Daten aus der Anfrage werden analysiert und im aktualisierten Einkaufswagencluster 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.
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 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 Cluster „Einkaufsliste“ 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.
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 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.
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 innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- Vorhandene
ShoppingOrderTrackingCluster
-Daten des Entwicklerpartners werden entfernt. - Die Daten aus der Anfrage werden analysiert und im aktualisierten Shopping Order Tracking Cluster 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. Wenn nicht angegeben, muss „Titel“ angegeben werden. |
Auf der Karte angezeigtes Bild Bilder mit einem Seitenverhältnis von 16:9 und einer Auflösung von 1.264 x 712 |
Titel | Optional. Wenn nicht angegeben, muss „Image“ angegeben werden. | Titel auf der Karte |
Aktionstext | Optional | Text im CTA (z.B. „Anmelden“) |
Untertitel | Optional | Optionaler Untertitel auf der Karte |
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 erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:
- 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 mit der updatePublishStatus API zu aktualisieren. Das ist aus folgenden Gründen wichtig :
- Der Status muss in allen Fällen angegeben werden, auch wenn die Inhalte veröffentlicht wurden (STATUS == PUBLISHED). Andernfalls können Dashboards nicht mit diesem expliziten Status gefüllt werden, 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.
Folgende Veröffentlichungsstatuscodes sind zulässig :
// 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.
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
Mit dieser API können Sie den Inhalt von Empfehlungsclustern löschen.
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.
Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus dem „Empfohlen“-Cluster entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status beibehalten.
deleteShoppingCartCluster
Mit dieser API können Sie den Inhalt des Einkaufswagen-Clusters löschen.
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.
Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Cluster „Einkaufsliste“. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der aktuelle Status beibehalten.
deleteShoppingReorderCluster
Mit dieser API können Sie den Inhalt des Shopping-Clusters „Noch einmal bestellen“ löschen.
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 Clusters für die Sendungsverfolgung von Bestellungen löschen.
Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Cluster für die Sendungsverfolgung von Bestellungen. 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.
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
Mit dieser API können Sie den Inhalt eines bestimmten Clustertyps 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 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.
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 enthalten ist.
Fehlercode | Fehlername | Hinweis |
---|---|---|
1 |
SERVICE_NOT_FOUND |
Der Dienst ist auf dem angegebenen 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 |
Es ist ein Fehler auf Dienstebene aufgetreten. |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Der Dienstaufruf wird zu häufig ausgeführt. |
Schritt 3: Broadcast-Intents verarbeiten
Zusätzlich zu API-Aufrufen für die Veröffentlichung von Inhalten über einen Job muss auch eine BroadcastReceiver
eingerichtet werden, um die Anfrage für die Veröffentlichung von Inhalten zu erhalten.
Broadcast-Intents dienen hauptsächlich zur Reaktivierung von Apps und zum Erzwingen der Datensynchronisierung. Broadcast-Intents sind nicht für häufige Übermittlungen 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 mitContext.registerReceiver()
. So ist die Kommunikation von Anwendungen möglich, 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)); }
- Deklarieren Sie eine Implementierung statisch mit dem
<receiver>
-Tag in der DateiAndroidManifest.xml
. 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, einenpublishRecommendationClusters
-Anruf zu starten, wenn diese Absicht empfangen wird.com.google.android.engage.action.PUBLISH_FEATURED
Wir empfehlen, bei Erhalt dieser Absicht einenpublishFeaturedCluster
-Aufruf zu starten.com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART
Wir empfehlen, bei Erhalt dieser Absicht einenpublishShoppingCart
-Aufruf zu starten.com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST
Wir empfehlen, einenpublishShoppingList
-Aufruf zu starten, wenn diese Absicht empfangen wird.com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER
Wir empfehlen, einenpublishReorderCluster
-Aufruf zu starten, wenn diese Absicht empfangen wird.com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER
Wir empfehlen, einenpublishShoppingOrderTrackingCluster
-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 erneute Bestellung und Cluster für die Sendungsverfolgung von Bestellungen veröffentlicht und für Nutzer sichtbar werden.