Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Engage SDK – Andere Branchen: Anleitung zur technischen Integration von Drittanbietern

Sie können die App-Interaktion steigern, indem Sie Ihre Nutzer dort erreichen, wo sie sich gerade befinden. Mit dem Engage SDK können Sie personalisierte Empfehlungen und Folgeinhalte direkt auf verschiedenen On-Device-Oberflächen wie Sammlungen, Entertainment Space und im Google Play Store präsentieren. Die Integration vergrößert das APK im Durchschnitt um weniger als 50 KB (komprimiert) und dauert bei den meisten Apps etwa eine Woche. Weitere Informationen finden Sie auf unserer Unternehmenswebsite.

Dieses Dokument enthält eine Anleitung für Entwicklerpartner, wie sie neue Inhalte wie Reservierungen, Veranstaltungen, Unterkünfte, Sehenswürdigkeiten, Personen und andere Inhalte, die möglicherweise keiner dieser Kategorien angehören, einbinden können.

Android-Fähigkeiten

Auf GitHub ansehen

Engage SDK einbinden

Verwenden Sie den Android-Skill für das Engage SDK, um Implementierungsprobleme zu integrieren, zu beheben und zu lösen.

Führen Sie den folgenden Befehl aus, um den Skill über die Android-Befehlszeile zu installieren:

android skills add engage-sdk-integration

Integrationsdetails

In diesem Abschnitt werden die Schritte, Datenmodelle und Begriffe beschrieben, die für die Einbindung des Engage SDK für andere Inhaltskategorien erforderlich sind.

Terminologie

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

Empfehlungscluster enthalten personalisierte Vorschläge von einzelnen Entwicklerpartnern. Es handelt sich um eine UI-Ansicht, die eine Gruppe von Empfehlungen desselben Entwicklerpartners enthält.
- ArticleEntity: ArticleEntity, die eine textbasierte Empfehlung für Inhalte darstellt, die für mehr als eine Inhaltskategorie relevant sind. Mit dem ArticleEntity-Element können Entwickler im Vergleich zu GenericFeaturedEntity eine Vielzahl von Text- und Bildinhalten mit mehr Metadaten bereitstellen, um die Informationen für die Nutzer zu formulieren. Beispiel: Marketinginhalte, Nachrichtenausschnitt
  
  Abbildung 1: Benutzeroberfläche mit einer einzelnen ArticleEntity im Empfehlungscluster.
- EventEntity: EventEntity stellt ein Ereignis dar, das in der Zukunft stattfindet. Der Beginn des Ereignisses ist eine wichtige Information, die den Nutzern mitgeteilt werden muss.
  
  Abbildung 2: Benutzeroberfläche mit einer einzelnen EventEntity im Cluster „Empfehlungen“.
- LodgingEntity: LodgingEntity steht für eine Unterkunft, z. B. ein Hotel, ein Apartment oder ein Ferienhaus, die kurz- oder langfristig gemietet werden kann.
  
  Abbildung 3: Benutzeroberfläche mit einer einzelnen LodgingEntity im Cluster „Empfehlungen“.
- StoreEntity: StoreEntity steht für ein Geschäft, ein Restaurant, ein Café usw. Es hebt Inhalte hervor, bei denen ein Restaurant oder ein Geschäft die wichtigste Information ist, die den Nutzern vermittelt werden soll.
  
  Abbildung 4: Benutzeroberfläche mit einer einzelnen StoreEntity im Empfehlungscluster.
- PointOfInterestEntity: „PointOfInterestEntity“ steht für einen Ort von Interesse, z. B. eine Tankstelle, einen Veranstaltungsort, einen Freizeitpark, ein Museum, eine Touristenattraktion oder einen Wanderweg. Damit werden Inhalte hervorgehoben, bei denen der Standort eine wichtige Information ist, die den Nutzern vermittelt werden muss. Sie sollte nicht für Unterkünfte, Geschäfte oder Restaurants verwendet werden.
  
  Abbildung 5: Benutzeroberfläche mit einer einzelnen PointOfInterestEntity im Cluster „Empfehlungen“.
- PersonEntity: PersonEntity stellt eine Person dar. Die Empfehlungen könnten darin bestehen, eine Person in Kategorien wie Gesundheit und Fitness, Sport, Dating usw. hervorzuheben.
  
  Abbildung 5: Benutzeroberfläche mit einer einzelnen PersonEntity im Cluster „Empfehlungen“.
Im Cluster Fortsetzen werden Inhalte, mit denen Nutzer kürzlich interagiert haben, von mehreren Entwicklerpartnern in einer einzigen UI-Gruppierung angezeigt. Jeder Entwicklerpartner darf maximal 10 Entitäten im Fortsetzungscluster übertragen.

Ihre Fortsetzungsinhalte können die folgende Struktur haben:
- ArticleEntity: ArticleEntity, die eine textbasierte Empfehlung für Inhalte darstellt, die für mehr als eine Inhaltskategorie relevant sind. Diese Entität kann verwendet werden, um unvollständige Nachrichtenartikel oder andere Inhalte darzustellen, die der Nutzer an der Stelle fortsetzen möchte, an der er aufgehört hat. Beispiel: Marketinginhalte, Nachrichten-Snippet
  
  Abbildung 6: Benutzeroberfläche, auf der eine einzelne ArticleEntity in einem Fortsetzungscluster zu sehen ist.
- RestaurantReservationEntity: RestaurantReservationEntity steht für eine Reservierung in einem Restaurant oder Café und hilft Nutzern, anstehende oder laufende Restaurantreservierungen im Blick zu behalten.
  
  Abbildung 7. Benutzeroberfläche mit einer einzelnen RestaurantReservationEntity in einem Fortsetzungscluster.
- EventReservationEntity: „EventReservationEntity“ steht für eine Reservierung für eine Veranstaltung und hilft Nutzern, anstehende oder laufende Reservierungen für Veranstaltungen im Blick zu behalten. Ereignisse können unter anderem Folgendes umfassen:
  - Sportveranstaltungen wie Reservierungen für ein Fußballspiel
  - Gaming-Events wie Reservierungen für E-Sport-Veranstaltungen
  - Unterhaltungsveranstaltungen wie Reservierungen für Kinofilme, Konzerte, Theateraufführungen, Buchsignierungen
  - Reise- oder POI-Reservierungen wie Führungen, Museumstickets
  - Reservierungen für gesellschaftliche Veranstaltungen, Seminare und Konferenzen
  - Reservierungen für Schulungen / Trainings
  Abbildung 8. Benutzeroberfläche, die eine einzelne EventReservationEntity in einem Fortsetzungscluster zeigt.
- LodgingReservationEntity: LodgingEntityReservation steht für eine Reservierung einer Unterkunft und hilft Nutzern, anstehende oder laufende Hotel- oder Ferienunterkunftsreservierungen im Blick zu behalten.
  
  Abbildung 9. Benutzeroberfläche mit einer einzelnen LodgingReservationEntity in einem Fortsetzungscluster.
- TransportationReservationEntity: TransportationReservationEntity steht für eine Reservierung für ein beliebiges Transportmittel und hilft Nutzern, Reservierungen für anstehende oder laufende Flüge, Fähren, Züge, Busse, Fahrdienste oder Kreuzfahrten im Blick zu behalten.
  
  Abbildung 10. Benutzeroberfläche, auf der eine einzelne TransportationReservationEntity in einem Fortsetzungscluster zu sehen ist.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity stellt eine Mietwagenreservierung dar und hilft Nutzern, anstehende oder laufende Mietwagenreservierungen im Blick zu behalten.
  
  Abbildung 11. Benutzeroberfläche mit einer einzelnen VehicleRentalReservationEntity in einem Fortsetzungscluster.
Der Cluster Empfohlen ist eine UI-Ansicht, in der die ausgewählten Hero-GenericFeaturedEntity von vielen Entwicklerpartnern in einer UI-Gruppierung angezeigt werden. Es gibt einen einzelnen hervorgehobenen Cluster, der oben in der Benutzeroberfläche angezeigt wird, mit einer priorisierten Platzierung über allen Empfehlungsclustern. Jeder Entwicklerpartner darf eine einzelne Entität eines unterstützten Typs in „Empfohlen“ übertragen. Im Cluster „Empfohlen“ können viele Entitäten (potenziell unterschiedlicher Typen) von mehreren App-Entwicklern enthalten sein.
- GenericFeaturedEntity: GenericFeaturedEntity unterscheidet sich von Recommendation-Elementen dadurch, dass Featured-Elemente für einzelne Top-Inhalte von Entwicklern verwendet werden sollten und die wichtigsten Inhalte darstellen sollten, die für Nutzer interessant und relevant sind.
  
  Abbildung 12: Benutzeroberfläche mit einer einzelnen Hero-GenericFeaturedEntity-Karte in einem empfohlenen Cluster

Vorarbeit

Mindest-API-Level: 19

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

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

Zusammenfassung

Das Design basiert auf der Implementierung eines gebundenen Dienstes.

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

Clustertyp	Cluster limits	Mindestanzahl von Entitäten in einem Cluster	Maximale Anzahl von Entitäten in einem Cluster
Cluster mit Empfehlungen	Höchstens 7	Mindestens 1	Höchstens 50 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity`, `PointOfInterestEntity` oder `PersonEntity`)
Fortsetzungscluster	Höchstens 1	Mindestens 1	Höchstens 20 (`ArticleEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` oder `VehicleRentalReservationEntity`)
Empfohlener Cluster	Höchstens 1	Mindestens 1	Höchstens 20 (`GenericFeaturedEntity`)

Schritt 1: Daten zum Rechtssubjekt angeben

Im SDK sind verschiedene Entitäten definiert, die die einzelnen Artikeltypen darstellen. Wir unterstützen die folgenden Entitäten für die Kategorie „Sonstige“:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Posterbilder	Erforderlich	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Titel	Optional	Titel der Entität.	Freier Text Recommended text size: 50 chars
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild. Spezielle UX-Anzeige über dem Bild/Video, z. B. als Badge-Overlay auf dem Bild „Livemeldung“ Lesedauer des Artikels
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der Enums Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`ArticleEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	Freier Text Recommended text size: Max 50 chars
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Quelle – Titel	Optional	Der Name des Autors, der Organisation oder des Reporters	Freier Text Empfohlene Textlänge: unter 25 Zeichen
Quelle – Bild	Optional	Ein Bild der Quelle, z. B. des Autors, der Organisation oder des Reporters	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild. Spezielle UX-Anzeige über dem Bild/Video, z. B. als Badge-Overlay auf dem Bild „Livemeldung“ Lesedauer des Artikels
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Zeitpunkt der Veröffentlichung des Inhalts	Optional	Dies ist der Epochenzeitstempel in Millisekunden, der angibt, wann der Inhalt in der App veröffentlicht / aktualisiert wurde.	Zeitstempel in Millisekunden seit Epoche
Letzte Interaktion	Bedingt erforderlich	Der Epochenzeitstempel in Millisekunden, zu dem der Nutzer zuletzt mit dieser Entität interagiert hat. Hinweis: Dieses Feld ist erforderlich, wenn diese Entität Teil des Fortsetzungsclusters ist.	Zeitstempel in Millisekunden seit Epoche
Fortschritt in Prozent	Bedingt erforderlich	Der Prozentsatz des gesamten Inhalts, den der Nutzer bisher konsumiert hat. Hinweis: Dieses Feld ist erforderlich, wenn diese Entität Teil des Fortsetzungsclusters ist.	Ein Ganzzahlwert zwischen 0 und 100 (einschließlich).
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der Enums Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`EventEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	String Recommended text size: Max 50 chars
Beginn	Erforderlich	Der Epoch-Zeitstempel für den voraussichtlichen Beginn des Ereignisses. Hinweis: Dieser Wert wird in Millisekunden angegeben.	Zeitstempel in Millisekunden seit Epoche
Ereignismodus	Erforderlich	Ein Feld, das angibt, ob die Veranstaltung virtuell, vor Ort oder beides ist.	Enum: VIRTUAL, IN_PERSON oder HYBRID
Posterbilder	Erforderlich	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Standort – Land	Bedingt erforderlich	Das Land, in dem die Veranstaltung stattfindet. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Bedingt erforderlich	Die Stadt, in der die Veranstaltung stattfindet. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsorts, die bzw. der dem Nutzer angezeigt werden soll. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse (falls zutreffend) des Veranstaltungsorts.	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Orts, an dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Ende	Optional	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet. Hinweis: Dieser Wert wird in Millisekunden angegeben.	Zeitstempel in Millisekunden seit Epoche
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis des Tickets/der Eintrittskarte für die Veranstaltung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis des Tickets/der Karte für die Veranstaltung.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der zulässigen Enums TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Kino) TYPE_DIGITAL_GAMES (Beispiel: E-Sport) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITENESS (Beispiel: Yoga-Kurs) TYPE_EDUCATION (Beispiel – Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: Meetup) Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`LodgingEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	String Recommended text size: Max 50 chars
Posterbilder	Erforderlich	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Standort – Land	Erforderlich	Das Land, in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Erforderlich	Die Stadt, in der sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Erforderlich	Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse der Unterkunft (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland (falls zutreffend), in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
AvailabilityTimeWindow - Start Time	Optional	Der Zeitstempel in Millisekunden, zu dem die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Zeitstempel in Millisekunden seit Epoche
AvailabilityTimeWindow - End Time	Optional	Der Zeitstempel in Millisekunden, bis zu dem die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Zeitstempel in Millisekunden seit Epoche
Bewertung – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Gib dieses Feld an, wenn deine App steuert, wie die Anzahl den Nutzern angezeigt wird. Verwenden Sie einen prägnanten String. Wenn die Anzahl beispielsweise 1.000.000 beträgt, solltest du eine Abkürzung wie 1 Mio. verwenden, damit die Anzahl auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeigeabkürzung nicht selbst verarbeiten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird den Nutzern „Anzahl“ angezeigt.	Lang
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Unterkunft. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Unterkunft, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)

`StoreEntity`

Das Objekt StoreEntity stellt ein einzelnes Geschäft dar, das Entwicklerpartner veröffentlichen möchten, z. B. ein Restaurant oder ein Lebensmittelgeschäft.

Attribut	Anforderung	Beschreibung	Format
Posterbilder	Erforderlich	Es muss mindestens ein Bild angegeben werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Optional	Der Name des Geschäfts.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (Zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Standort	Optional	Der Standort des Geschäfts.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (Zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Zusatzinformationen	Optional	Hinweis auf ein Angebot, ein Event oder ein Update für das Geschäft, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (Zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Kleingedrucktes im Callout	Optional	Kleingedruckter Text für die Zusatzinformation.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (Zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Beschreibung	Optional	Eine Beschreibung des Geschäfts.	Freier Text Empfohlene Textlänge: unter 90 Zeichen (Zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Bewertung – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Gib dieses Feld an, wenn du in deiner App festlegen möchtest, wie dies für Nutzer angezeigt wird. Geben Sie den prägnanten String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird den Nutzern die Anzahl angezeigt.	Lang

`PointOfInterestEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	String Recommended text size: Max 50 chars
Posterbilder	Erforderlich	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Standort – Land	Erforderlich	Das Land, in dem sich der POI befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Erforderlich	Die Stadt, in der sich der POI befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Erforderlich	Die Adresse des POI, die dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse (falls zutreffend) des POI.	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in dem sich der POI befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl des POI (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend) des POI.	Freier Text Recommended text size: max ~20 chars
AvailabilityTimeWindow - Start Time	Optional	Der Epochenzeitstempel in Millisekunden, zu dem der POI voraussichtlich geöffnet/verfügbar ist.	Zeitstempel in Millisekunden seit Epoche
AvailabilityTimeWindow - End Time	Optional	Der Zeitstempel in Millisekunden, bis zu dem der POI voraussichtlich geöffnet/verfügbar ist.	Zeitstempel in Millisekunden seit Epoche
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Bewertung – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für den POI. Hinweis:Gib dieses Feld an, wenn deine App steuert, wie die Anzahl den Nutzern angezeigt wird. Verwenden Sie einen prägnanten String. Wenn die Anzahl beispielsweise 1.000.000 beträgt, solltest du eine Abkürzung wie 1 Mio. verwenden, damit die Anzahl auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für den POI. Hinweis:Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verwalten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird Nutzern „Anzahl“ angezeigt.	Lang
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Tickets/Eintrittskarten für den POI. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Tickets/Eintrittskarten für den POI.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der zulässigen Enums TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Theater) TYPE_MEDICAL (Beispiel: Krankenhaus) TYPE_EDUCATION (Beispiel: Schule) TYPE_SPORTS (Beispiel: Stadion) Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`PersonEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Profil – Name	Erforderlich	Profilname, ID oder Alias, z. B. „John Doe“, „@TeamPixel“ usw.	String Recommended text size: Max 50 chars
Profil – Avatar	Erforderlich	Profilbild oder Avatarbild des Nutzers. Hinweis:Es muss ein quadratisches Bild im Format 1:1 sein.	Weitere Informationen finden Sie unter Bildspezifikationen.
Profil – Zusätzlicher Text	Optional	Freitext wie der Profil-Alias.	Freier Text Empfohlene Textlänge: max. 15 Zeichen
Profil – Zusätzliches Bild	Optional	Kleines Bild, z. B. ein Bestätigungskennzeichen.	Weitere Informationen finden Sie unter Bildspezifikationen.
Header image	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beliebtheit – Anzahl	Optional	Geben Sie die Anzahl der Follower oder den Beliebtheitswert an, z. B. „3,7 Mio.“. Hinweis: Wenn sowohl „Anzahl“ als auch „Anzahlwert“ angegeben sind, wird „Anzahl“ verwendet.	String Empfohlene Textgröße: maximal 20 Zeichen für Anzahl und Label zusammen
Beliebtheit – Anzahlwert	Optional	Die Anzahl der Follower oder der Beliebtheitswert. Hinweis:Gib einen Zählwert an, wenn deine App keine Logik zur Optimierung großer Zahlen für verschiedene Displaygrößen verarbeiten soll. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ angegeben sind, wird „Anzahl“ verwendet.	Lang
Beliebtheit – Label	Optional	Geben Sie an, was das Beliebtheitslabel ist, z. B. „Likes“.	String Empfohlene Textgröße: maximal 20 Zeichen für Anzahl und Label zusammen
Beliebtheit – Visuell	Optional	Geben Sie an, wofür die Interaktion gedacht ist. Beispiel: Bild mit dem Symbol „Mag ich“ und einem Emoji. Du kannst mehr als ein Bild angeben, aber möglicherweise werden nicht alle auf allen Formfaktoren angezeigt. Hinweis:Es muss ein quadratisches Bild im Format 1:1 sein.	Weitere Informationen finden Sie unter Bildspezifikationen.
Bewertung – Höchstwert	Erforderlich	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Erforderlich	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Entität. Hinweis:Gib dieses Feld an, wenn du in deiner App festlegen möchtest, wie dies für Nutzer angezeigt wird. Geben Sie den prägnanten String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – 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 möchten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird den Nutzern die Anzahl angezeigt.	Lang
Standort – Land	Optional	Das Land, in dem sich die Person befindet oder in dem sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Optional	Die Stadt, in der sich die Person befindet oder in der sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Optional	Die Adresse, an der sich die Person befindet oder an der sie Dienstleistungen erbringt, wird dem Nutzer angezeigt.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse (falls zutreffend), an der sich die Person befindet oder an der sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland (falls zutreffend), in dem sich die Person befindet oder in dem sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Ortes, an dem sich die Person befindet oder an dem sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem sich die Person befindet oder in dem sie tätig ist.	Freier Text Recommended text size: max ~20 chars
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der zulässigen Enums TYPE_HEALTH_AND_FITENESS (Beispiel: Yoga-/Fitnesstrainer) TYPE_HOME_AND_AUTO (Beispiel: Klempner) TYPE_SPORTS (Beispiel – Spieler) TYPE_DATING Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`RestaurantReservationEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	String Recommended text size: Max 50 chars
Beginn der Reservierung	Erforderlich	Der Epochenzeitstempel in Millisekunden, zu dem die Reservierung voraussichtlich beginnt.	Zeitstempel in Millisekunden seit Epoche
Standort – Land	Erforderlich	Das Land, in dem sich das Restaurant befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Erforderlich	Die Stadt, in der sich das Restaurant befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Erforderlich	Die Adresse des Restaurants, die dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse des Restaurants (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland (falls zutreffend), in dem sich das Restaurant befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl des Restaurants (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem sich das Restaurant befindet.	Freier Text Recommended text size: max ~20 chars
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Tabellengröße	Optional	Die Anzahl der Personen in der Reservierungsgruppe	Ganzzahl > 0

`EventReservationEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	String Recommended text size: Max 50 chars
Beginn	Erforderlich	Der Epoch-Zeitstempel für den voraussichtlichen Beginn des Ereignisses. Hinweis: Dieser Wert wird in Millisekunden angegeben.	Zeitstempel in Millisekunden seit Epoche
Ereignismodus	Erforderlich	Ein Feld, das angibt, ob die Veranstaltung virtuell, vor Ort oder beides ist.	Enum: VIRTUAL, IN_PERSON oder HYBRID
Standort – Land	Bedingt erforderlich	Das Land, in dem die Veranstaltung stattfindet. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Bedingt erforderlich	Die Stadt, in der die Veranstaltung stattfindet. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsorts, die bzw. der dem Nutzer angezeigt werden soll. Hinweis: Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse (falls zutreffend) des Veranstaltungsorts.	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Orts, an dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Recommended text size: max ~20 chars
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Ende	Optional	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet. Hinweis: Dieser Wert wird in Millisekunden angegeben.	Zeitstempel in Millisekunden seit Epoche
Dienstanbieter – Name	Optional	Der Name des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: Name des Veranstalters/der Tour
Dienstleister – Bild	Optional	Das Logo/Bild des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Abzeichen	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Logo – Text	Optional	Titel für das Badge Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Recommended text size: max 15 chars
Logo – Bild	Optional	Kleines Bild Spezielle UX-Anzeige, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail. Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Reservierungs-ID	Optional	Die Reservierungs-ID für die Ereignisreservierung.	Freier Text
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis des Tickets/der Eintrittskarte für die Veranstaltung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis des Tickets/der Karte für die Veranstaltung.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Bewertung – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für das Ereignis. Hinweis:Gib dieses Feld an, wenn du in deiner App festlegen möchtest, wie dies für Nutzer angezeigt wird. Geben Sie den prägnanten String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für das Ereignis. Hinweis:Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird den Nutzern die Anzahl angezeigt.	Lang
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie des Inhalts in der Entität.	Liste der zulässigen Enums TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Kino) TYPE_DIGITAL_GAMES (Beispiel: E-Sport) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITENESS (Beispiel: Yoga-Kurs) TYPE_EDUCATION (Beispiel – Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: Meetup) Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`LodgingReservationEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „Ihr Aufenthalt ab dem 12. Dezember“ Recommended text size: Max 50 chars
Check-in-Zeit	Erforderlich	Der Epochenzeitstempel in Millisekunden, der die Check-in-Zeit für die Reservierung darstellt.	Zeitstempel in Millisekunden seit Epoche
Check-out-Zeit	Erforderlich	Der Epochenzeitstempel in Millisekunden, der die Check-out-Zeit für die Reservierung darstellt.	Zeitstempel in Millisekunden seit Epoche
Standort – Land	Erforderlich	Das Land, in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Stadt	Erforderlich	Die Stadt, in der sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Adresse anzeigen	Erforderlich	Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Location - Street Address (Standort – Adresse)	Optional	Die Adresse der Unterkunft (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Bundesland	Optional	Das Bundesland (falls zutreffend), in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Recommended text size: max ~20 chars
Standort – Stadtteil	Optional	Das Viertel (falls zutreffend), in dem sich die Unterkunft befindet.	Freier Text Recommended text size: max ~20 chars
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Reservierungs-ID	Optional	Die Reservierungs-ID für die Reservierung der Unterkunft.	Freier Text
Bewertung – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben ist.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Gib dieses Feld an, wenn du in deiner App festlegen möchtest, wie dies für Nutzer angezeigt wird. Geben Sie den prägnanten String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahlwert“ vorhanden sind, wird den Nutzern die Anzahl angezeigt.	Lang
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Unterkunft. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Unterkunft, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)

`TransportationReservationEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „SFO nach SAN“ Recommended text size: Max 50 chars
Art des Verkehrsmittels	Erforderlich	Die Mobilitätsform für die Reservierung.	Enum: FLIGHT, TRAIN, BUS oder FERRY
Abflugzeit	Erforderlich	Der Epochenzeitstempel in Millisekunden, der die Abfahrtszeit darstellt.	Zeitstempel in Millisekunden seit Epoche
Ankunft	Erforderlich	Der Epochenzeitstempel in Millisekunden, der die Ankunftszeit darstellt.	Zeitstempel in Millisekunden seit Epoche
Abflugort – Land	Optional	Das Abreiseland.	Freier Text Recommended text size: max ~20 chars
Abflugort – Stadt	Optional	Der Abflugort.	Freier Text Recommended text size: max ~20 chars
Abflugort – Angezeigte Adresse	Optional	Der Abfahrtsort, der dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Abfahrtsort – Adresse	Optional	Die Adresse (falls zutreffend) des Abfahrtsorts.	Freier Text Recommended text size: max ~20 chars
Abflugort – Bundesland	Optional	Das Bundesland (falls zutreffend) des Abflugorts.	Freier Text Recommended text size: max ~20 chars
Abfahrtsort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Abflugorts.	Freier Text Recommended text size: max ~20 chars
Abfahrtsort – Stadtteil	Optional	Das Viertel (falls zutreffend) des Abfahrtsorts.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Land	Optional	Das Ankunftsland.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Stadt	Optional	Der Ankunftsort.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Adresse anzeigen	Optional	Der Ankunftsort, der dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Adresse	Optional	Die Adresse (falls zutreffend) des Ankunftsorts.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Bundesland	Optional	Das Bundesland (falls zutreffend) des Ankunftsorts.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Ankunftsorts.	Freier Text Recommended text size: max ~20 chars
Ankunftsort – Stadtteil	Optional	Das Viertel (falls zutreffend) des Ankunftsorts.	Freier Text Recommended text size: max ~20 chars
Dienstanbieter – Name	Optional	Der Name des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: Name der Fluggesellschaft
Dienstleister – Bild	Optional	Das Logo/Bild des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Reservierungs-ID	Optional	Die Reservierungs-ID für die Transportreservierung.	Freier Text
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Reservierung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)
Transportnummer	Erforderlich	Die Flug-, Bus-, Zug- oder Fähr-/Kreuzfahrtnummer.	Freier Text
Boardingzeit	Erforderlich	Der Zeitstempel, der die Boardingzeit für die Reservierung darstellt (falls zutreffend)	Zeitstempel in Millisekunden seit Epoche

`VehicleRentalReservationEntity`

Attribut	Anforderung	Beschreibung	Format
Aktions-URI	Erforderlich	Deeplink zur Entität in der Anbieter-App. Hinweis: Sie können Deeplinks für die Attribution verwenden. Weitere Informationen finden Sie in diesen FAQs.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „Avis Union Square SF“ Recommended text size: Max 50 chars
Abholzeit	Erforderlich	Der Zeitstempel, der die Abholzeit für die Reservierung darstellt.	Zeitstempel in Millisekunden seit Epoche
Rückflugzeit	Optional	Der Epochenzeitstempel, der die Check-out-Zeit für die Reservierung darstellt.	Zeitstempel in Millisekunden seit Epoche
Abholadresse – Land	Optional	Das Land des Abholorts.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Ort	Optional	Die Stadt des Abholorts.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Angezeigte Adresse	Optional	Der Abholort, der dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Straße und Hausnummer	Optional	Die Adresse (falls zutreffend) des Abholorts.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Bundesland	Optional	Das Bundesland (falls zutreffend) des Abholorts.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Abholorts.	Freier Text Recommended text size: max ~20 chars
Abholadresse – Stadtteil	Optional	Der Stadtteil (falls zutreffend) des Abholorts.	Freier Text Recommended text size: max ~20 chars
Rücksendeadresse – Land	Optional	Das Land der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Absender – Stadt	Optional	Die Stadt der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Rücksendeadresse – Angezeigte Adresse	Optional	Die Rücksendeadresse, die dem Nutzer angezeigt wird.	Freier Text Recommended text size: max ~20 chars
Return Address - Street Address (Absender – Straße)	Optional	Die Adresse (falls zutreffend) der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Absender – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Absender – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Rücksendeadresse – Stadtteil	Optional	Das Viertel (falls zutreffend) der Rücksendeadresse.	Freier Text Recommended text size: max ~20 chars
Dienstanbieter – Name	Optional	Der Name des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: „Avis Autovermietung“
Dienstleister – Bild	Optional	Das Logo/Bild des Dienstleisters. Hinweis:Für den Dienstleister ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Bildspezifikationen.
Posterbilder	Optional	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz, der die Entität beschreibt. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textlänge: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel aus einer einzelnen Textzeile besteht. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Bestätigungs-ID	Optional	Die Bestätigungs-ID für die Mietwagenreservierung.	Freier Text
Price - CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Reservierung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preis-Callout	Optional	Preishinweis, um ein Angebot, ein Ereignis oder einen Mitgliederrabatt hervorzuheben, falls verfügbar.	Freier Text Empfohlene Textlänge: unter 45 Zeichen (zu langer Text wird möglicherweise mit Auslassungspunkten angezeigt)

Bildspezifikationen

In dieser Tabelle sind die erforderlichen Spezifikationen für Bild-Assets aufgeführt:

Seitenverhältnis	Mindestanzahl Pixel	Empfohlene Pixel
Quadratisch (1 × 1) Bevorzugt	300 x 300	1200 × 1200
Querformat (1,91 × 1)	600 × 314	1200 × 628
Hochformat (4 : 5)	480 × 600	960 × 1200

Seitenverhältnis

Mindestanzahl Pixel

Empfohlene Pixel

Quadratisch (1 × 1)

Bevorzugt

300 x 300

1200 × 1200

Querformat (1,91 × 1)

600 × 314

1200 × 628

Hochformat (4 : 5)

480 × 600

960 × 1200

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

Dateiformate

PNG, JPG, statisches GIF, WebP

Maximale Dateigröße

5.120 KB

Zusätzliche Empfehlungen

Bildbereich:Platzieren Sie wichtige Inhalte in den mittleren 80% des Bildes.
Verwenden Sie einen transparenten Hintergrund, damit das Bild sowohl im dunklen als auch im hellen Design richtig angezeigt wird.

Inhaltskategorie

Über die Inhaltskategorie können Apps Inhalte veröffentlichen, die zu mehreren Kategorien gehören. Dabei werden die Inhalte einigen der vordefinierten Kategorien zugeordnet:

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

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

Richtlinien für die Verwendung von Inhaltskategorien

Einige Entitäten wie ArticleEntity und GenericFeaturedEntity können alle Inhaltskategorien verwenden. Für andere Entitäten wie EventEntity, EventReservationEntity und PointOfInterestEntity ist nur eine Teilmenge dieser Kategorien zulässig. Prüfen Sie die Liste der Kategorien, die für einen Entitätstyp infrage kommen, bevor Sie die Liste füllen.
Verwenden Sie für einige Inhaltskategorien den spezifischen Entitätstyp anstelle einer Kombination aus den generischen Entitäten und der ContentCategory:
- TYPE_MOVIES_AND_TV_SHOWS: Sieh dir die Entitäten im Leitfaden zur Einbindung von Watch an, bevor du die generischen Entitäten verwendest.
- TYPE_BOOKS: Sehen Sie sich die EbookEntity an, bevor Sie die generischen Entitäten verwenden.
- TYPE_AUDIOBOOKS – Sehen Sie sich AudiobookEntity an, bevor Sie die generischen Entitäten verwenden.
- TYPE_SHOPPING – Sehen Sie sich ShoppingEntity an, bevor Sie die generischen Entitäten verwenden.
- TYPE_FOOD_AND_DRINK: Bevor Sie die generischen Entitäten verwenden, lesen Sie den Leitfaden zur Integration von Lebensmitteln.
Das Feld „ContentCategory“ ist optional und sollte leer bleiben, wenn der Inhalt keiner der oben genannten Kategorien angehört.
Wenn mehrere Inhaltskategorien angegeben werden, geben Sie sie in der Reihenfolge ihrer Relevanz für den Inhalt an. Die relevanteste Inhaltskategorie muss an erster Stelle in der Liste stehen.

Schritt 2: Clusterdaten angeben

Es wird empfohlen, den Job zum Veröffentlichen von Inhalten im Hintergrund auszuführen (z. B. mit WorkManager) und regelmäßig oder ereignisbasiert zu planen (z. B. jedes Mal, wenn der Nutzer die App öffnet oder wenn er gerade etwas in den Einkaufswagen gelegt hat).

AppEngagePublishClient ist für die Veröffentlichung von Clustern verantwortlich.

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

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

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

Für Engage SDK v1.6.0 und höher (empfohlen)

Android-Fähigkeiten

Auf GitHub ansehen

Engage SDK-Integration

Führen Sie den folgenden Befehl aus, um den Skill über die Android-Befehlszeile zu installieren:

android skills add engage-sdk-integration

Wenn Ihr Team KI-Coding-Tools wie Gemini in Android Studio verwendet, können Sie diese Migration automatisieren, indem Sie Ihren KI-Assistenten auffordern:

Use the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.

Sie können die Dienstverfügbarkeit für jeden Clustertyp prüfen, den Sie veröffentlichen möchten. Die isServiceAvailable API akzeptiert ein Anfrageobjekt, ServiceAvailabilityRequest, das die Clustertypen enthält, für die die Dienstverfügbarkeit geprüft werden muss. Die für ServiceAvailabilityRequest erforderlichen ClusterType-Enum-Werte finden Sie in der folgenden Tabelle.

Clustertyp	Clustertypkonstante	Ganzzahlwert
Unbekannt	`TYPE_UNKNOWN`	0
Empfehlungscluster	`TYPE_RECOMMENDATION`	1
Empfohlener Cluster	`TYPE_FEATURED`	2
Fortsetzungscluster	`TYPE_CONTINUATION`	3
Einkaufswagen-Cluster	`TYPE_SHOPPING_CART`	4
Cluster für Nachbestellung von Lebensmitteln	`TYPE_FOOD_REORDER`	5
Cluster „Einkaufswagen mit Lebensmitteln“	`TYPE_FOOD_SHOPPING_CART`	6
Cluster für Einkaufsliste für Lebensmittel	`TYPE_FOOD_SHOPPING_LIST`	7
Nutzerverwaltungscluster	`TYPE_ENGAGEMENT`	8
Einkaufslisten-Cluster	`TYPE_SHOPPING_LIST`	9
Cluster für Nachbestellungen im Bereich Shopping	`TYPE_SHOPPING_REORDER`	10
Shopping-Bestellverfolgungscluster	`TYPE_SHOPPING_ORDER_TRACKING`	11
Abo-Cluster	`TYPE_SUBSCRIPTION`	12
Suchcluster fortsetzen	`TYPE_CONTINUE_SEARCH`	13
Reservierungscluster	`TYPE_RESERVATION`	14

Kotlin

val request = ServiceAvailabilityRequest.Builder()
    .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
    .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
    .build()

client.isServiceAvailable(request).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val availabilityMap = task.result
        if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
            // Proceed with publishing continuation content
        }
        if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
}

Java

ServiceAvailabilityRequest request =
    new ServiceAvailabilityRequest.Builder()
        .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
        .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
        .build();

client.isServiceAvailable(request).addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        Map<Integer, Boolean> availabilityMap = task.getResult();
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
            // Proceed with publishing continuation content
        }
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
});

Funktion für bedingte Dienstverfügbarkeit

Einige integrierte Apps erfordern eine spezielle Konfiguration, bei der der Engage-Dienst zeitweise aktiviert und deaktiviert wird, um die Kosten für die Bereitstellung zu senken. Diese Strategie der unregelmäßigen Contentaufnahme wirkt sich jedoch negativ auf die Nutzerfreundlichkeit aus: Veraltete Inhalte werden nicht präsentiert und einige Oberflächen werden nicht bedient.

Ab Version 1.6.0 kann mit dem Engage SDK die Verfügbarkeit für bestimmte Clustertypen geprüft werden. Wenn Ihre App die unregelmäßige Aufnahme verwendet:

Fortsetzungscluster (z. B. „Weiterlesen“ und „Reservierungen“) bleiben auf allen unterstützten Geräten standardmäßig aktiviert.
Andere Clustertypen (z. B. Empfehlungen) werden zeitweise aktiviert und deaktiviert.

Wenn diese Standardkonfiguration nicht Ihren Anforderungen entspricht, wenden Sie sich an engage-developers@google.com.

Für SDK-Versionen vor v1.6.0 (eingestellt)

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`

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

Kotlin

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

Java

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

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

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`publishFeaturedCluster`

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

Kotlin

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

Java

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

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

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`publishContinuationCluster`

Diese API wird verwendet, um ein ContinuationCluster-Objekt zu veröffentlichen.

Kotlin

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

Java

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

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

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`publishUserAccountManagementRequest`

Diese API wird verwendet, um eine Anmeldekarte zu veröffentlichen . Die Anmeldeaktion leitet Nutzer zur Anmeldeseite der App weiter, damit die App Inhalte veröffentlichen oder personalisierte Inhalte bereitstellen kann.

Die folgenden Metadaten sind Teil der Anmeldekarte:

Attribut	Anforderung	Beschreibung
Aktions-URI	Erforderlich	Deeplink zur Aktion (z.B. zur Anmeldeseite der App)
Bild	Optional – wenn nicht angegeben, muss der Titel angegeben werden	Auf der Karte angezeigtes Bild Bilder im Seitenverhältnis 16:9 mit einer Auflösung von 1264 × 712
Titel	Optional – wenn nicht angegeben, muss ein Bild angegeben werden	Titel auf der Karte
Aktionstext	Optional	Text, der im CTA angezeigt wird (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, werden die folgenden Aktionen innerhalb einer Transaktion ausgeführt:

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

Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`updatePublishStatus`

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

Die Angabe des Status in allen Szenarien, auch wenn der Inhalt veröffentlicht ist (STATUS == PUBLISHED), ist wichtig, um Dashboards zu füllen, die diesen expliziten Status verwenden, um den Zustand und andere Messwerte Ihrer Integration zu vermitteln.
Wenn keine Inhalte veröffentlicht werden, der Integrationsstatus aber nicht fehlerhaft ist (STATUS == NOT_PUBLISHED), kann Google vermeiden, dass Benachrichtigungen in den Dashboards zum App-Zustand ausgelöst werden. Sie bestätigt, dass Inhalte aufgrund einer aus Sicht des Anbieters erwarteten Situation nicht veröffentlicht werden.
So können Entwickler Informationen dazu bereitstellen, wann die Daten veröffentlicht werden und wann nicht.
Google kann die Statuscodes verwenden, um den Nutzer zu bestimmten Aktionen in der App aufzufordern, damit er den App-Inhalt sehen oder das Problem beheben kann.

Die Liste der zulässigen Statuscodes für die Veröffentlichung lautet :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Wenn der Inhalt nicht veröffentlicht wird, weil ein Nutzer nicht angemeldet ist, 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());

`deleteRecommendationsClusters`

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

Kotlin

client.deleteRecommendationsClusters()

Java

client.deleteRecommendationsClusters();

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

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem empfohlenen Cluster entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`deleteContinuationCluster`

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Wenn der Dienst die Anfrage empfängt, werden die vorhandenen Daten aus dem Fortsetzungscluster entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteClusters`

Mit dieser API wird der Inhalt eines bestimmten Clustertyps gelöscht.

Kotlin

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

Java

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

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

Fehlerbehandlung

Es wird dringend empfohlen, das Ergebnis der Aufgabe von den Veröffentlichungs-APIs zu überwachen, damit eine Folgemaßnahme ergriffen 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 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 Aufrufs nicht verfügbar (z. B. weil er explizit deaktiviert ist).
`3`	`SERVICE_CALL_EXECUTION_FAILURE`	Die Ausführung der Aufgabe ist aufgrund von Threading-Problemen fehlgeschlagen. In diesem Fall kann der Vorgang wiederholt werden.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Der Aufrufer ist nicht berechtigt, den Dienstaufruf auszuführen.
`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`	Aufseiten des Dienstes ist ein Fehler aufgetreten.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	Der Dienstaufruf wird zu häufig ausgeführt.

Schritt 3: Broadcast-Intents verarbeiten

Zusätzlich zu Content API-Aufrufen über einen Job ist es auch erforderlich, einen BroadcastReceiver einzurichten, um die Anfrage für eine Inhaltsveröffentlichung zu empfangen.

Broadcast-Intents dienen hauptsächlich der Reaktivierung von Apps und der erzwungenen Datensynchronisierung. Broadcast-Intents sind nicht für den häufigen Versand gedacht. Er wird nur ausgelöst, wenn der Engage-Dienst feststellt, dass der Inhalt möglicherweise veraltet ist (z. B. eine Woche alt). So ist es wahrscheinlicher, dass der Nutzer aktuelle Inhalte sieht, auch wenn die Anwendung längere Zeit nicht ausgeführt wurde.

BroadcastReceiver muss auf die folgenden zwei Arten eingerichtet werden:

Registrieren Sie eine Instanz der Klasse BroadcastReceiver dynamisch mit Context.registerReceiver(). Dies ermöglicht die Kommunikation von Anwendungen, die noch im Speicher aktiv sind.

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 continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

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 continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);
}

Deklarieren Sie eine Implementierung statisch mit dem <receiver>-Tag in Ihrer AndroidManifest.xml-Datei. Dadurch kann die Anwendung Broadcast-Intents empfangen, wenn sie nicht ausgeführt wird, und die Inhalte veröffentlichen.

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

Die folgenden Intents werden vom Dienst gesendet:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Es wird empfohlen, einen publishRecommendationClusters-Aufruf zu starten, wenn dieser Intent empfangen wird.
com.google.android.engage.action.PUBLISH_FEATURED Es wird empfohlen, einen publishFeaturedCluster-Anruf zu starten, wenn dieser Intent empfangen wird.
com.google.android.engage.action.PUBLISH_CONTINUATION Es wird empfohlen, einen publishContinuationCluster-Anruf zu starten, wenn dieser Intent empfangen wird.

Integrationsworkflow

Eine detaillierte Anleitung zum Überprüfen der Integration nach Abschluss finden Sie im Workflow für die Integration von Engage-Entwicklern.

Häufig gestellte Fragen

Häufig gestellte Fragen zum Engage SDK

Kontakt

Wende dich an engage-developers@google.com, wenn du während des Integrationsprozesses Fragen hast.

Nächste Schritte

Nach Abschluss dieser Integration sind die nächsten Schritte:

Sende eine E-Mail an engage-developers@google.com und hänge dein integriertes APK an, das von Google getestet werden kann.
Google führt eine interne Überprüfung durch, um sicherzustellen, dass die Integration wie erwartet funktioniert. Falls Änderungen erforderlich sind, wird Google Sie mit den entsprechenden Details kontaktieren.
Wenn die Tests abgeschlossen sind und keine Änderungen erforderlich sind, wirst du von Google benachrichtigt, dass du das aktualisierte und integrierte APK im Play Store veröffentlichen kannst.
Nachdem Google bestätigt hat, dass dein aktualisiertes APK im Google Play Store veröffentlicht wurde, können deine Cluster Empfehlung, Empfohlen und Fortsetzung veröffentlicht und für Nutzer sichtbar gemacht werden.

Engage SDK – Andere Branchen: Anleitung zur technischen Integration von Drittanbietern Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Integrationsdetails

Terminologie

Vorarbeit

Zusammenfassung

Schritt 1: Daten zum Rechtssubjekt angeben

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

PersonEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Bildspezifikationen

Inhaltskategorie

Schritt 2: Clusterdaten angeben

isServiceAvailable

Für Engage SDK v1.6.0 und höher (empfohlen)

Kotlin

Java

Funktion für bedingte Dienstverfügbarkeit

Für SDK-Versionen vor v1.6.0 (eingestellt)

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishContinuationCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationsClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteContinuationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteClusters

Kotlin

Java

Fehlerbehandlung

Kotlin

Java

Schritt 3: Broadcast-Intents verarbeiten

Kotlin

Java

Integrationsworkflow

Häufig gestellte Fragen

Kontakt

Nächste Schritte

Engage SDK – Andere Branchen: Anleitung zur technischen Integration von Drittanbietern

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`PersonEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishContinuationCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationsClusters`

`deleteFeaturedCluster`

`deleteContinuationCluster`

`deleteUserManagementCluster`

`deleteClusters`