Diese Seite wurde von der Cloud Translation API übersetzt.

Engage SDK Travel: Anleitung zur technischen Integration von Drittanbietern

Google entwickelt eine On-Device-Oberfläche, auf der die Apps der Nutzer nach Branchen organisiert werden. So können Nutzer personalisierte App-Inhalte noch besser entdecken und nutzen. Dieser Vollbildmodus bietet Entwicklerpartnern die Möglichkeit, ihre besten Rich-Media-Inhalte in einem speziellen Kanal außerhalb ihrer App zu präsentieren. In diesem Leitfaden erfahren Entwicklerpartner, wie sie ihre Reise- und Veranstaltungsinhalte mit dem Engage SDK in diese neue Oberfläche einbinden.

Integrationsdetails

Terminologie

Diese Integration umfasst die folgenden Clustertypen: Empfehlung, Empfohlen, Reservierung und Suche fortsetzen.

In Empfehlungsclustern werden personalisierte Reise- und Veranstaltungsvorschläge von einem einzelnen Entwicklerpartner angezeigt. Diese Empfehlungen können für den Nutzer personalisiert oder allgemein gehalten sein (z. B. angesagte Artikel). So können Sie Empfehlungen für Artikel, Veranstaltungen, Unterkünfte oder Sehenswürdigkeiten erhalten.
- Ein Empfehlungscluster kann aus Einträgen vom Typ ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity oder StoreEntity bestehen, aber nicht aus einer Mischung verschiedener Entitätstypen.
Ihre Empfehlungen haben folgende Struktur:
- Empfehlungscluster:Eine UI-Ansicht, die eine Gruppe von Empfehlungen desselben Entwicklerpartners enthält.
- Entität: Ein Objekt, das ein einzelnes Element in einem Cluster darstellt. Diese Integration bietet einige Entitäten, die mit dem Empfehlungscluster angezeigt werden:
  - ArticleEntity: „ArticleEntity“ ist eine Empfehlung für textbasierte Inhalte zu Reisen und Veranstaltungen. Sie kann für Artikel, Blogbeiträge, Marketinginhalte, Nachrichten-Snippets usw. verwendet werden.
    
    Abbildung 1:Benutzeroberfläche mit einer einzelnen „ArticleEntity“ im Cluster „Empfehlungen“.
  - EventEntity: „EventEntity“ steht für ein Ereignis in der Zukunft. 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 wie ein Hotel, eine Wohnung oder ein Ferienhaus, das für Kurz- und Langzeitaufenthalte vermietet wird.
    
    Abbildung 3:Benutzeroberfläche mit einer einzelnen „LodgingEntity“ im Cluster „Empfehlungen“.
  - StoreEntity: „StoreEntity“ steht für ein Geschäft, Restaurant, Café usw. und hebt Inhalte hervor, bei denen ein Restaurant oder Geschäft die wichtigste Information ist, die den Nutzern vermittelt werden muss.
    
    Abbildung 4:Benutzeroberfläche mit einer einzelnen StoreEntity im Cluster „Empfehlungen“.
  - PointOfInterestEntity: „PointOfInterestEntity“ steht für einen POI wie 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“.
Der Cluster Reservierung enthält Inhalte verschiedener Entwicklerpartner, mit denen Nutzer in letzter Zeit interagiert haben, in einer einzigen Benutzeroberflächengruppierung. Jeder Entwicklerpartner darf maximal 10 Entitäten im Reservierungscluster übertragen.

Der Inhalt Ihrer Reservierung kann folgende Struktur haben:
- RestaurantReservationEntity: „RestaurantReservationEntity“ steht für eine Reservierung in einem Restaurant oder Café und hilft Nutzern, anstehende oder laufende Restaurantreservierungen im Blick zu behalten.
  
  Abbildung 6: Benutzeroberfläche mit einer einzelnen RestaurantReservationEntity in einem Reservierungscluster
- EventReservationEntity: „EventReservationEntity“ steht für eine Reservierung für eine Veranstaltung und hilft Nutzern, anstehende oder laufende Reservierungen für Veranstaltungen zu verfolgen. Beispiele für Ereignisse:
  - Sportveranstaltungen wie die Reservierung für ein Fußballspiel
  - Gaming-Events wie Reservierungen für eSports
  - Unterhaltungsereignisse wie Kinofilme, Konzerte, Theateraufführungen oder Buchpräsentationen
  - Reservierungen für Reisen oder Sehenswürdigkeiten wie Führungen oder Museumstickets
  - Reservierungen für Veranstaltungen, Seminare und Konferenzen
  - Reservierungen für Schulungen
  Abbildung 7 Benutzeroberfläche mit einer einzelnen EventReservationEntity innerhalb eines Reservierungsclusters
- LodgingReservationEntity: „LodgingEntityReservation“ stellt eine Reservierung für eine Reiseunterkunft dar und hilft Nutzern, anstehende oder laufende Hotel- oder Ferienunterkunftsreservierungen im Blick zu behalten.
  
  Abbildung 8. Benutzeroberfläche mit einer einzelnen LodgingReservationEntity in einem Reservierungscluster
- TransportationReservationEntity: „TransportationReservationEntity“ steht für eine Reservierung für beliebige Verkehrsmittel und hilft Nutzern, Reservierungen für anstehende oder laufende Flüge, Fähren, Züge, Busse, Fahrdienste oder Kreuzfahrten zu verfolgen.
  
  Abbildung 9. Benutzeroberfläche mit einer einzelnen TransportationReservationEntity innerhalb eines Reservations-Clusters
- VehicleRentalReservationEntity: „VehicleRentalReservationEntity“ steht für eine Mietwagenreservierung und hilft Nutzern, anstehende oder laufende Mietwagenreservierungen im Blick zu behalten.
  
  Abbildung 10. Benutzeroberfläche mit einer einzelnen VehicleRentalReservationEntity in einem Reservierungscluster
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.
- GenericFeaturedEntity: „GenericFeaturedEntity“ unterscheidet sich von „RecommendationItem“ dadurch, dass „FeaturedItem“ für einen einzelnen Top-Inhalt von Entwicklern verwendet werden sollte und den wichtigsten Inhalt darstellen sollte, der für Nutzer interessant und relevant ist.
  
  Abbildung 11:Benutzeroberfläche mit einem „Empfohlener Cluster“ mit einer Liste von „GenericFeaturedEntity“
Der Cluster Suche fortsetzen hilft Nutzern, ihre vorherige Reisesuche fortzusetzen. Dazu wird eine Liste der Suchanfragen angezeigt, die der Nutzer in seinen Reise-Apps in letzter Zeit eingegeben hat. Der Cluster wird an zweiter Stelle angepinnt, nach Reservierungen und vor Clustern mit empfohlenen Unterkünften und Vorschlägen. Jeder Entwicklerpartner kann bis zu drei Entitäten im Cluster „Weitersuchen“ übertragen.
- PointOfInterestEntity: „PointOfInterestEntity“ steht für einen POI wie eine Tankstelle, einen Veranstaltungsraum, einen Freizeitpark, ein Museum, eine Touristenattraktion oder einen Wanderweg. Es werden Inhalte hervorgehoben, nach denen der Nutzer zuvor gesucht hat.

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

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	Mindestanzahl von Entitäten in einem Cluster	Maximale Entitätslimits in einem Cluster
Empfehlungscluster	Maximal 5	Mindestens 5	Maximal 25 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity` oder `PointOfInterestEntity`)
Reservierungscluster	Höchstens 1	Mindestens 1	Maximal 10 (`RestaurantReservationEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` oder `VehicleRentalReservationEntity`)
Empfohlener Cluster	Höchstens 1	Mindestens 1	Maximal 10 (`GenericFeaturedEntity`)
Suche im Cluster fortsetzen	Höchstens 1	Mindestens 1	Maximal 3 (`PointOfInterestEntity`)

Schritt 1: Entitätsdaten angeben

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

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Posterbilder	Erforderlich	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Titel	Optional	Titel der Entität.	Freier Text Empfohlene Textgröße: 50 Zeichen
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild. Spezielle UX-Behandlung über dem Bild/Video, z. B. als Logo-Overlay auf dem Bild „Liveaktualisierung“ Dauer der Artikellektüre
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie der Inhalte in der Entität.	Liste der Enums Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`ArticleEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	Freier Text Empfohlene Textgröße: Max. 50 Zeichen
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Quelle – Titel	Optional	Der Name des Autors, der Organisation oder des Reporters	Freier Text Empfohlene Textgröße: Weniger als 25 Zeichen
Quelle – Bild	Optional	Ein Bild der Quelle, z. B. des Autors, der Organisation oder des Reporters	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild. Spezielle UX-Behandlung über dem Bild/Video, z. B. als Logo-Overlay auf dem Bild „Liveaktualisierung“ Dauer der Artikellektüre
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Veröffentlichungszeitpunkt des Inhalts	Optional	Dies ist der Epochenzeitstempel in Millisekunden, zu dem die Inhalte in der App veröffentlicht oder aktualisiert wurden.	Epochen-Zeitstempel in Millisekunden
Zeitpunkt der letzten Interaktion	Bedingt erforderlich	Der Epochenzeitstempel in Millisekunden, zu dem der Nutzer zuletzt mit dieser Entität interagiert hat. Hinweis:Dieses Feld ist erforderlich, wenn dieses Element Teil des Reservierungsclusters ist.	Epochen-Zeitstempel in Millisekunden
Prozentsatz des Fortschritts	Bedingt erforderlich	Der Prozentsatz des gesamten Inhalts, der vom Nutzer bisher angesehen wurde. Hinweis:Dieses Feld ist erforderlich, wenn dieses Element Teil des Reservierungsclusters ist.	Eine Ganzzahl zwischen 0 und 100.
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie der Inhalte in der Entität.	Liste der Enums Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`EventEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: Max. 50 Zeichen
Lokale Startzeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich beginnt.	Joda-Time Instant
Lokale Startzeit – Zeitzone	Erforderlich	Die Zeitzone, in der das Ereignis voraussichtlich beginnt.	Joda-Time DateTimeZone
Ereignismodus	Erforderlich	Ein Feld, in dem angegeben wird, ob die Veranstaltung virtuell, vor Ort oder beides ist.	Enum: VIRTUAL, IN_PERSON oder HYBRID
Posterbilder	Erforderlich	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land	Bedingt erforderlich	Das Land, in dem das Ereignis stattfindet. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Bedingt erforderlich	Die Stadt, in der die Veranstaltung stattfindet. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsortes, an dem die Veranstaltung stattfindet, die dem Nutzer angezeigt werden soll. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die (falls zutreffend) Straße und Hausnummer des Veranstaltungsortes.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in der die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des Orts, an dem die Veranstaltung stattfindet, sofern zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Ende	Optional	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet. Hinweis:Dieser Wert wird in Millisekunden angegeben.	Epochen-Zeitstempel in Millisekunden
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Preis – Aktueller Preis	Bedingt erforderlich	Der aktuelle Preis des Tickets/Passes 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/Passes für die Veranstaltung.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie der Inhalte in der Entität.	Liste der zulässigen Enumerationen TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Kino) TYPE_DIGITAL_GAMES (Beispiel: eSports) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITENESS (Beispiel: Yogakurs) TYPE_EDUCATION (Beispiel: Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: „Meetup“) Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`LodgingEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: Max. 50 Zeichen
Posterbilder	Erforderlich	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land	Erforderlich	Das Land, in dem die Unterkunft liegt.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Erforderlich	Die Stadt, in der die Unterkunft gebucht wurde.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die Adresse der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in der sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend) der Unterkunft.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, zu dem die Unterkunft voraussichtlich geöffnet/verfügbar sein wird.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitzone	Optional	Die Zeitzone, in der die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, bis zu dem die Unterkunft voraussichtlich geöffnet/verfügbar sein wird.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitzone	Optional	Die Zeitzone, in der die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone
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 Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, können Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.	String
Altersfreigabe – Wert für die 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 „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ für Nutzer angezeigt.	Lang
Preis – Aktueller Preis	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 auf der Benutzeroberfläche durchgestrichen ist.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)

`StoreEntity`

Das StoreEntity-Objekt steht für ein einzelnes Geschäft, das Entwicklerpartner veröffentlichen möchten, z. B. ein beliebtes Restaurant, das für Reisende relevant ist.

Attribut	Anforderung	Beschreibung	Formatieren
Posterbilder	Erforderlich	Es muss mindestens ein Bild angegeben werden.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
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 dieser FAQ.	Uri
Titel	Optional	Der Name des Geschäfts.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt.)
Standort	Optional	Der Standort des Geschäfts.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Zusatzinformationen	Optional	Zusatzinformation zu einer Werbeaktion, einem Ereignis oder einer Neuigkeit für den Shop, 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)
Beschreibung	Optional	Eine Beschreibung des Geschäfts.	Freier Text Empfohlene Textgröße: weniger als 90 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Kategorie	Optional	Die Kategorie eines Geschäfts. Im Zusammenhang mit Restaurants kann es sich um eine Küche wie „französisch“, „neue amerikanische Küche“, „Ramen“ oder „gehobene Küche“ handeln.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte 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 Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, können Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.	String
Altersfreigabe – Wert für die 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 „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ für Nutzer angezeigt.	Lang

`PointOfInterestEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: Max. 50 Zeichen
Posterbilder	Erforderlich	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land	Erforderlich	Das Land, in dem sich der POI befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Erforderlich	Die Stadt, in der sich der POI befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse des POI, die dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die Adresse (falls zutreffend) des POI.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in der sich der POI befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des POI (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend) des POI.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitstempel	Optional	Der Zeitstempel der Epoche, zu dem der POI voraussichtlich geöffnet/verfügbar sein wird.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitzone	Optional	Die Zeitzone, in der der POI voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, bis zu dem der POI voraussichtlich geöffnet/verfügbar ist.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitzone	Optional	Die Zeitzone, in der der POI voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
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 den POI. Hinweis:Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, können Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.	String
Altersfreigabe – Wert für die 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 verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ für Nutzer angezeigt.	Lang
Preis – Aktueller Preis	Bedingt erforderlich	Der aktuelle Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.	Freier Text
Preis – Durchgestrichener Preis	Optional	Der ursprüngliche Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie der Inhalte in der Entität.	Liste der zulässigen Enumerationen 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.

`RestaurantReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: Max. 50 Zeichen
Lokale Reservierungsstartzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, zu dem die Reservierung voraussichtlich beginnt.	Joda-Time Instant
Lokalisierte Reservierungsstartzeit – Zeitzone	Erforderlich	Die Zeitzone, in der die Reservierung voraussichtlich beginnt.	Joda-Time DateTimeZone
Standort – Land	Erforderlich	Das Land, in dem sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Erforderlich	Die Stadt, in der sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse des Restaurants, die dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die Adresse des Restaurants (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in dem bzw. der sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des Restaurants (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend) des Restaurants.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Tabellengröße	Optional	Die Anzahl der Personen in der Reservierungsgruppe	Ganzzahl > 0

`EventReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: Max. 50 Zeichen
Lokale Startzeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich beginnt.	Joda-Time Instant
Lokale Startzeit – Zeitzone	Erforderlich	Die Zeitzone, in der das Ereignis voraussichtlich beginnt.	Joda-Time DateTimeZone
Ereignismodus	Erforderlich	Ein Feld, in dem angegeben wird, ob die Veranstaltung virtuell, vor Ort oder beides ist.	Enum: VIRTUAL, IN_PERSON oder HYBRID
Standort – Land	Bedingt erforderlich	Das Land, in dem das Ereignis stattfindet. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Bedingt erforderlich	Die Stadt, in der die Veranstaltung stattfindet. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsortes, an dem die Veranstaltung stattfindet, die dem Nutzer angezeigt werden soll. Hinweis:Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die (falls zutreffend) Straße und Hausnummer des Veranstaltungsortes.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in der die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des Orts, an dem die Veranstaltung stattfindet, sofern zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Ein Bild wird dringend empfohlen. Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Lokale Endzeit – Zeitstempel	Optional	Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet.	Joda-Time Instant
Lokale Endzeit – Zeitzone	Optional	Die Zeitzone, in der das Ereignis voraussichtlich endet.	Joda-Time DateTimeZone
Dienstanbieter – Name	Optional	Der Name des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: Name des Veranstalters/der Tour
Dienstanbieter – Bild	Optional	Das Logo/Bild des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Badges	Optional	Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.
Logo – Text	Optional	Titel für das Gütesiegel Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: maximal 15 Zeichen
Logo – Bild	Optional	Kleines Bild Spezielle UX-Optimierung, z. B. als Badge-Overlay auf dem Bild-/Video-Thumbnail Hinweis:Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Reservierungs-ID	Optional	Die Reservierungs-ID für die Ereignisreservierung.	Freier Text
Preis – Aktueller Preis	Bedingt erforderlich	Der aktuelle Preis des Tickets/Passes 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/Passes für die Veranstaltung.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte 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 das Ereignis. Hinweis:Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, können Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.	String
Altersfreigabe – Wert für die 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 „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ für Nutzer angezeigt.	Lang
Inhaltskategorien	Optional	Beschreiben Sie die Kategorie der Inhalte in der Entität.	Liste der zulässigen Enumerationen TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Kino) TYPE_DIGITAL_GAMES (Beispiel: eSports) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITENESS (Beispiel: Yogakurs) TYPE_EDUCATION (Beispiel: Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: „Meetup“) Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

`LodgingReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „Ihr Aufenthalt vom 12. Dezember“ Empfohlene Textgröße: Max. 50 Zeichen
Lokale Check-in-Zeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Anreisezeit für die Reservierung darstellt.	Joda-Time Instant
Lokalisierte Check-in-Zeit – Zeitzone	Erforderlich	Die Zeitzone, in der die Check-in-Zeit für die Reservierung liegt.	Joda-Time Instant
Lokalisierte Check-out-Zeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Abreisezeit der Reservierung darstellt.	Joda-Time Instant
Lokalisierte Check-out-Zeit – Zeitzone	Erforderlich	Die Zeitzone, in der die Abreisezeit für die Reservierung festgelegt ist.	Joda-Time DateTimeZone
Standort – Land	Erforderlich	Das Land, in dem sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort	Erforderlich	Die Stadt, in der sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse	Optional	Die Adresse der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend), in der sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Umgebung	Optional	Der Stadtteil (falls zutreffend) der Unterkunft.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Hinweis:Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Reservierungs-ID	Optional	Die Reservierungs-ID für die Hotelreservierung.	Freier Text
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 Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, können Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.	String
Altersfreigabe – Wert für die 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 „Anzahl (Wert)“ vorhanden sind, wird „Anzahl“ für Nutzer angezeigt.	Lang
Preis – Aktueller Preis	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 auf der Benutzeroberfläche durchgestrichen ist.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)

`TransportationReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „SFO nach SAN“ Empfohlene Textgröße: max. 50 Zeichen
Art des Verkehrsmittels	Erforderlich	Die Mobilitätsform/der Mobilitätstyp für die Reservierung.	Enum: FLIGHT, TRAIN, BUS oder FERRY
Lokale Abflugzeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Abfahrtszeit angibt.	Joda-Time Instant
Lokalisierte Abflugzeit – Zeitzone	Erforderlich	Die Zeitzone der Abfahrtszeit.	Joda-Time DateTimeZone
Lokalisierte Ankunftszeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Ankunftszeit angibt.	Joda-Time Instant
Lokalisierte Ankunftszeit – Zeitzone	Erforderlich	Die Zeitzone der Ankunftszeit.	Joda-Time DateTimeZone
Transportnummer	Erforderlich	Die Flug-, Bus-, Zug- oder Fähr-/Kreuzfahrtnummer.	Freier Text
Lokale Boardingzeit – Zeitstempel	Erforderlich	Der Epochezeitstempel, der die Boardingzeit für die Reservierung darstellt (falls zutreffend)	Joda-Time Instant
Lokale Boardingzeit – Zeitzone	Erforderlich	Zeitzone der Boardingzeit für die Reservierung (falls zutreffend)	Joda-Time DateTimeZone
Abreiseort – Land	Optional	Das Abreiseland.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Stadt	Optional	Der Abreiseort.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abfahrtsort – Adresse anzeigen	Optional	Der Abfahrtsort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Adresse	Optional	Die Adresse (falls zutreffend) des Abfahrtsorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Abreiseorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abflugort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Abfahrtsorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Viertel	Optional	Der Stadtteil (falls zutreffend) des Abfahrtsorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Land	Optional	Das Land, in dem die Reise endet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Zielort – Stadt	Optional	Die Ankunftsstadt.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Anzeigeadresse	Optional	Der Zielort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Zielort – Adresse	Optional	Die Adresse (falls zutreffend) des Zielorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Zielorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Zielort – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Zielorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Stadtteil	Optional	Der Stadtteil (falls zutreffend) des Zielorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Dienstanbieter – Name	Optional	Der Name des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: Name der Fluggesellschaft
Dienstanbieter – Bild	Optional	Das Logo/Bild des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Reservierungs-ID	Optional	Die Reservierungs-ID für die Reservierung des Verkehrsmittels.	Freier Text
Preis – Aktueller Preis	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 ist.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)

`VehicleRentalReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
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 dieser FAQ.	Uri
Titel	Erforderlich	Titel der Entität.	Freitext. Beispiel: „Avis Union Square SF“ Empfohlene Textgröße: Max. 50 Zeichen
Lokalisierte Abholzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der die Abholzeit für die Reservierung darstellt.	Joda-Time Instant
Lokalisierte Abholzeit – Zeitzone	Erforderlich	Die Zeitzone der Abholzeit für die Reservierung.	Joda-Time DateTimeZone
Lokale Rückgabezeit – Zeitstempel	Optional	Der Epochenzeitstempel, der die Abreisezeit der Reservierung angibt.	Joda-Time Instant
Lokalisierte Rückgabezeit – Zeitzone	Optional	Die Zeitzone der Abreisezeit für die Reservierung.	Joda-Time DateTimeZone
Abholadresse – Land	Optional	Das Land des Abholorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Ort	Optional	Die Stadt des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Anzeigeadresse	Optional	Der Abholort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Straße	Optional	Die Adresse (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Stadtteil	Optional	Der Stadtteil (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Land	Optional	Das Land des Rückgabeorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Ort	Optional	Die Stadt des Rücksendeorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Anzeigeadresse	Optional	Der Rückgabeort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Straße	Optional	Die Adresse (falls zutreffend) des Rücksendeorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Rücksendeorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Absenderadresse – Postleitzahl	Optional	Die Postleitzahl (falls zutreffend) des Rückgabeorts.	Freier Text Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Wohnort	Optional	Der Stadtteil (falls zutreffend) des Rückgabeorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Dienstanbieter – Name	Optional	Der Name des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Freitext. Beispiel: „Avis Autovermietung“
Dienstanbieter – Bild	Optional	Das Logo/Bild des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Posterbilder	Optional	Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9	Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung	Optional	Ein einzelner Textabschnitt zur Beschreibung der Entität. 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
Bestätigungs-ID	Optional	Die Bestätigungs-ID für die Reservierung des Mietwagens.	Freier Text
Preis – Aktueller Preis	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 ist.	Freier Text
Zusatzinformationen zum Preis	Optional	Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.	Freier Text Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)

Bildspezifikationen

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

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

Seitenverhältnis

Mindestanzahl Pixel

Empfohlene Pixel

Quadratisch (1 × 1)

Bevorzugt

300 × 300

1200 × 1200

Querformat (1,91 × 1)

600 × 314

1.200 × 628

Hochformat (4 : 5)

480 x 600

960 × 1.200

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

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.

Content-Kategorie

Mit der Inhaltskategorie können Apps Inhalte veröffentlichen, die zu mehreren Kategorien gehören. Die Inhalte werden dabei 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 der Inhaltskategorien

Für einige Entitäten wie ArticleEntity und GenericFeaturedEntity kann eine beliebige Inhaltskategorie verwendet werden. Bei anderen Entitäten wie EventEntity, EventReservationEntity und PointOfInterestEntity sind nur einige dieser Kategorien zulässig. Sehen Sie sich die Liste der Kategorien an, 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: Sehen Sie sich die Entitäten aus dem Leitfaden zur YouTube TV-Integration an, bevor Sie die generischen Entitäten verwenden.
- TYPE_BOOKS: Sehen Sie sich die EbookEntity an, bevor Sie die generischen Entitäten verwenden.
- TYPE_AUDIOBOOKS: 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: Sehen Sie sich die Entitäten aus dem Leitfaden zur Integration von Lebensmitteln an, bevor Sie die generischen Entitäten verwenden.
Das Feld „ContentCategory“ ist optional und sollte leer bleiben, wenn der Inhalt keiner der oben genannten Kategorien zugewiesen werden kann.
Wenn mehrere Inhaltskategorien angegeben werden, ordnen Sie sie in der Reihenfolge ihrer Relevanz für die Inhalte an. Die relevanteste Inhaltskategorie muss dabei an erster Stelle stehen.

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

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

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

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishReservationCluster
publishContinueSearchCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteReservationCluster
deleteContinueSearchCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

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

Kotlin

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

Java

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

`publishRecommendationClusters`

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

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 erhält, werden innerhalb einer Transaktion die folgenden Aktionen ausgeführt:

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

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

`publishFeaturedCluster`

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

Kotlin

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

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .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.

`publishReservationCluster`

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

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

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

Vorhandene ReservationCluster-Daten des Entwicklerpartners werden entfernt.
Die Daten aus der Anfrage werden analysiert und im aktualisierten Reservierungscluster gespeichert.

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

`publishContinueSearchCluster`

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

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

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

Vorhandene ContinueSearchCluster-Daten des Entwicklerpartners werden entfernt.
Die Daten aus der Anfrage werden analysiert und im aktualisierten Cluster „Weitersuchen“ 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 × 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

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 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 nicht veröffentlicht werden, weil ein Nutzer nicht angemeldet ist, empfiehlt Google, die Anmeldekarte zu veröffentlichen. Wenn Anbieter die Anmeldekarte aus irgendeinem Grund nicht veröffentlichen können, empfehlen wir, die API updatePublishStatus mit dem Statuscode NOT_PUBLISHED_REQUIRES_SIGN_IN aufzurufen.

Kotlin

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

Java

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

`deleteRecommendationClusters`

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteReservationCluster`

Mit dieser API können Sie den Inhalt des Reservierungsclusters löschen.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Reservierungscluster. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status bleibt erhalten.

`deleteUserManagementCluster`

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

`deleteContinueSearchCluster`

Mit dieser API können Sie den Inhalt des Clusters „Weiter mit der Suche“ löschen.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Wenn der Dienst die Anfrage erhält, entfernt er die vorhandenen Daten aus dem Cluster „Weiter mit der Suche“. 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.

Kotlin

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

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RESERVATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
                .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.

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 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 erfolgt zu häufig.

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

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 mit Context.registerReceiver(). So ist die Kommunikation von Anwendungen möglich, die sich noch im Arbeitsspeicher befinden.

Kotlin

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

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

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
}

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

}

Deklarieren Sie eine Implementierung statisch mit dem <receiver>-Tag in der Datei AndroidManifest.xml. So kann die Anwendung auch dann 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>
   </receiver>
</application>

Der Dienst sendet die folgenden Intents:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Es wird empfohlen, bei Erhalt dieses Intents einen publishRecommendationClusters-Aufruf zu starten.
com.google.android.engage.action.PUBLISH_FEATURED Es wird empfohlen, bei Erhalt dieser Absicht einen publishFeaturedCluster-Anruf zu starten.

Integrationsablauf

Eine detaillierte Anleitung zur Überprüfung 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.

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 das integrierte 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, Reservierung und Suche fortsetzen veröffentlicht und für Nutzer sichtbar werden.