Diese Seite wurde von der Cloud Translation API übersetzt.

Engage SDK Travel: Anleitung zur technischen Integration von Drittanbietern

Die App-Interaktionen steigern, indem Sie Nutzer dort erreichen, wo sie sich aufhalten Mit dem Engage SDK kannst du personalisierte Empfehlungen und Fortsetzungsinhalte direkt auf verschiedenen On-Device-Oberflächen wie Sammlungen, Entertainment Space und dem Google Play Store präsentieren. Die Integration vergrößert das APK im Durchschnitt um weniger als 50 KB (komprimiert) und erfordert bei den meisten Apps etwa eine Woche Entwicklerzeit. Weitere Informationen

In dieser Anleitung finden Entwicklerpartner Informationen dazu, wie sie Reise- und Veranstaltungscontent für Engage-Inhaltsplattformen bereitstellen können.

Integrationsdetails

Terminologie

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

In Empfehlungsclustern werden personalisierte Reise- und Veranstaltungsvorschläge von einem einzelnen Entwicklerpartner angezeigt. Diese Empfehlungen können personalisiert oder allgemein sein (z. B. Trendartikel). Damit können Sie Empfehlungen für Artikel, Veranstaltungen, Unterkünfte oder Sehenswürdigkeiten anzeigen.
- Ein Empfehlungscluster kann aus ArticleEntity-, EventEntity-, LodgingEntity-, PointOfInterestEntity- oder StoreEntity-Einträgen bestehen, aber nicht aus einer Mischung verschiedener Entitätstypen.
Ihre Empfehlungen haben die folgende Struktur:
- Empfehlungscluster:Eine Benutzeroberflächenansicht, 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 Einheiten, die über das Empfehlungscluster angezeigt werden:
  - ArticleEntity: ArticleEntity stellt eine Empfehlung für textbasierte Inhalte im Zusammenhang mit Reisen und Veranstaltungen dar. Sie kann für Artikel, Blogbeiträge, Marketinginhalte, Nachrichten-Snippets usw. verwendet werden.
    
    Abbildung 1:Benutzeroberfläche mit einer einzelnen ArticleEntity im Empfehlungscluster.
  - EventEntity: EventEntity stellt ein zukünftiges Ereignis dar. Die Startzeit des Events ist eine wichtige Information, die den Nutzern mitgeteilt werden muss.
    
    Abbildung 2:Benutzeroberfläche mit einer einzelnen EventEntity in einem Empfehlungscluster.
  - LodgingEntity: LodgingEntity steht für eine Unterkunft wie ein Hotel, ein Apartment oder ein Ferienhaus, die kurz- oder langfristig vermietet werden kann.
    
    Abbildung 3:Benutzeroberfläche mit einer einzelnen LodgingEntity im Empfehlungscluster.
  - StoreEntity: StoreEntity steht für ein Geschäft, ein Restaurant, ein Café usw. Es wird verwendet, um Inhalte hervorzuheben, in denen ein Restaurant oder Geschäft die wichtigste Information ist, die Nutzern vermittelt werden muss.
    
    Abbildung 4:Benutzeroberfläche mit einer einzelnen StoreEntity im Empfehlungscluster.
  - PointOfInterestEntity: PointOfInterestEntity steht für einen Ort von Interesse wie eine Tankstelle, einen Veranstaltungsort, einen Freizeitpark, ein Museum, eine Touristenattraktion oder einen Wanderweg. Sie hebt Inhalte hervor, 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 Empfehlungscluster.
Im Cluster Reservierung werden Inhalte angezeigt, mit denen Nutzer kürzlich interagiert haben. Die Inhalte stammen von mehreren Entwicklerpartnern und sind in einer einzigen Benutzeroberflächengruppe zusammengefasst. Jeder Entwicklerpartner darf maximal 10 Entitäten im Reservierungscluster übertragen.

Ihre Reservierungsinhalte können die 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, Reservierungen für anstehende oder laufende Veranstaltungen im Blick zu behalten. Beispiele für Ereignisse:
  - Sportveranstaltungen wie Reservierungen für ein Fußballspiel
  - Gaming-Events wie Reservierungen für eSports
  - Unterhaltungsveranstaltungen wie Reservierungen für Kinofilme, Konzerte, Theateraufführungen oder Buchsignierungen
  - Reservierungen für Reisen oder Sehenswürdigkeiten wie Führungen oder Museumstickets
  - Reservierungen für soziale Veranstaltungen / Seminare / Konferenzen
  - Reservierungen für Bildungs- und Schulungsveranstaltungen
  Abbildung 7. Benutzeroberfläche mit einer einzelnen EventReservationEntity in einem Reservierungscluster.
- 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 Reservierungen für Transportmittel jeglicher Art und hilft Nutzern, Reservierungen für anstehende oder laufende Flüge, Fähren, Züge, Busse, Taxis, Fahrdienste oder Kreuzfahrten im Blick zu behalten.
  
  Abbildung 9. Benutzeroberfläche mit einer einzelnen TransportationReservationEntity in einem Reservierungscluster.
- VehicleRentalReservationEntity: VehicleRentalReservationEntity stellt eine Mietwagenreservierung dar und hilft Nutzern, anstehende oder laufende Mietwagenreservierungen im Blick zu behalten.
  
  Abbildung 10. Benutzeroberfläche mit einer einzelnen VehicleRentalReservationEntity in einem Reservierungscluster.
Im Cluster Vorgestellt werden ausgewählte Entitäten von mehreren Entwicklerpartnern in einer UI-Gruppierung präsentiert. Es gibt einen einzelnen Cluster „Empfohlen“, der oben in der Benutzeroberfläche angezeigt wird und eine höhere Priorität als alle Empfehlungscluster hat. Jeder Entwicklerpartner darf bis zu 10 Entitäten im Cluster „Empfohlen“ übertragen.
- GenericFeaturedEntity: GenericFeaturedEntity unterscheidet sich von RecommendationItem dadurch, dass FeaturedItem für einzelne Top-Inhalte von Entwicklern verwendet werden sollte und die wichtigsten Inhalte repräsentieren sollte, die für Nutzer interessant und relevant sind.
  
  Abbildung 11:Benutzeroberfläche mit einem FeaturedCluster mit einer Liste von GenericFeaturedEntity
Mit dem Cluster Suche fortsetzen können Nutzer ihre vorherige Reiseplanung fortsetzen. Dazu wird eine Liste mit Suchanfragen angezeigt, nach denen der Nutzer kürzlich in allen seinen Reise-Apps gesucht hat. Der Cluster wird an zweiter Stelle platziert, nach Reservierungen und vor Clustern mit Empfehlungen und vorgestellten Inhalten. Jeder Entwicklerpartner darf bis zu drei Entitäten im Cluster „Suche fortsetzen“ präsentieren.
- PointOfInterestEntity:PointOfInterestEntity stellt einen Ort von Interesse dar, z. B. eine Tankstelle, einen Veranstaltungsort, einen Freizeitpark, ein Museum, eine Touristenattraktion oder einen Wanderweg. Sie hebt Inhalte hervor, nach denen der Nutzer zuvor gesucht hat.

Vorbereitung

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.

Für die Daten, die ein Client veröffentlichen kann, gelten für die verschiedenen Clustertypen die folgenden Einschränkungen:

Clustertyp	Cluster limits	Mindestlimits für Entitäten in einem Cluster	Maximale Entitätslimits in einem Cluster
Empfehlungscluster	Höchstens 7	Mindestens 1	Maximal 50 (`ArticleEntity`, `EventEntity`, `LodgingEntity`, `StoreEntity` oder `PointOfInterestEntity`)
Reservierungscluster	Höchstens 1	Mindestens 1	Höchstens 20 (`RestaurantReservationEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` oder `VehicleRentalReservationEntity`)
Angesagter Cluster	Höchstens 1	Mindestens 1	Höchstens 20 (`GenericFeaturedEntity`)
Cluster suchen fortsetzen	Höchstens 1	Mindestens 1	Höchstens 3 (`PointOfInterestEntity`)

Schritt 1: Rechtssubjektdaten angeben

Im SDK sind verschiedene Entitäten definiert, um die einzelnen Elementtypen darzustellen. Wir unterstützen die folgenden Einheiten für die Kategorie „Reisen & Events“:

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	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 auf dem Bild ein Mindestabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Überschrift	Optional	Titel der Entität.	Freier Text Empfohlene Textgröße: 50 Zeichen
Beschreibung	Optional	Ein einzelner Textabsatz zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild. Spezielle UX-Behandlung über dem Bild/Video, z. B. als Badge-Overlay auf dem Bild „Live-Update“ Dauer des Lesens von Artikeln
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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“.
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`ArticleEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	Freier Text Empfohlene Textgröße: max. 50 Zeichen
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 sicherer Bereich 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 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 Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild. Besondere UX-Behandlung über dem Bild/Video, z. B. als Badge-Overlay auf dem Bild „Live-Update“ Dauer des Lesens von Artikeln
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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 von Inhalten	Optional	Dies ist der Epochenzeitstempel in Millisekunden, der angibt, wann die Inhalte in der App veröffentlicht / aktualisiert wurden.	Epochen-Zeitstempel in Millisekunden
Zeitpunkt der letzten Interaktion	Optional	Der Epochen-Zeitstempel in Millisekunden, als der Nutzer zuletzt mit diesem Element interagiert hat.	Epochen-Zeitstempel in Millisekunden
Prozentsatz des Fortschritts	Optional	Der Prozentsatz der vollständigen Inhalte, die der Nutzer bisher angesehen hat.	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“.
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`EventEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: max. 50 Zeichen
Lokalisierte Startzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der angibt, wann das Ereignis voraussichtlich beginnt.	Joda-Time Instant
Lokalisierte Startzeit – Zeitzone	Erforderlich	Die Zeitzone, in der das Ereignis voraussichtlich beginnt.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Ereignismodus	Erforderlich	Ein Feld, in dem angegeben wird, ob die Veranstaltung virtuell, vor Ort oder beides stattfindet.	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 sicherer Bereich von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Standort – Land	Bedingt erforderlich	Das Land, in dem das Ereignis stattfindet. Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
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 Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsorts, der dem Nutzer angezeigt werden soll. Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ort – Adresse	Optional	Die Straßenadresse (falls zutreffend) des Veranstaltungsorts.	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: max. 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 – Stadtteil	Optional	Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ende	Optional	Der Epoch-Zeitstempel, der angibt, wann das Ereignis voraussichtlich endet. Hinweis:Dieser Wert wird in Millisekunden angegeben.	Epochen-Zeitstempel in Millisekunden
Beschreibung	Optional	Ein einzelner Textabsatz zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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.
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis des Tickets/Passes für die Veranstaltung. Muss angegeben werden, wenn der durchgestrichene Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis des Tickets/Passes für die Veranstaltung.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte 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: eSports) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITNESS (Beispiel: Yogakurs) TYPE_EDUCATION (Beispiel: Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: Treffen) Weitere Informationen finden Sie im Abschnitt „Inhaltskategorie“.
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`LodgingEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: max. 50 Zeichen
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 auf dem Bild ein Mindestabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Standort – Land	Erforderlich	Das Land, in dem die Unterkunft erfolgt.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadt	Erforderlich	Die Stadt, in der die Unterkunft liegt.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse, die dem Nutzer angezeigt wird. Wir empfehlen, für die meisten Anwendungsfälle den Namen der Stadt und möglicherweise den Bundesstaat oder das Land anzugeben. Geben Sie nur die Adresse oder das Viertel an, wenn sich der Nutzer in der Nähe des Standorts befindet, der Nutzer mit dem Standort vertraut ist oder die Stadt im Clustertitel enthalten ist. Wenn Sie die Adresse angeben, verwenden Sie eine kurze Adresse und kürzen Sie Wörter nach Möglichkeit ab, z. B. „Str.“ für „Straße“ oder „Allee“ für „Allee“.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ort – 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: max. 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadtteil	Optional	Das Viertel der Unterkunft, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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 zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel für den Zeitpunkt, zu dem die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitzone	Optional	Die Zeitzone, in der die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, bis zu dem die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time Instant
AvailabilityTimeWindow – Localized End Time – Timezone	Optional	Die Zeitzone, in der die Unterkunft voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Altersfreigabe – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben wird.	Zahl >= 0,0
Altersfreigabe – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben wird.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern soll, wie die Informationen für Nutzer angezeigt werden. 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 1M verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Zählwert	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 „Anzahlswert“ vorhanden sind, verwenden wir die Anzahl für die Anzeige für Nutzer.	Lang
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Unterkunft. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis der Unterkunft, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`StoreEntity`

Das StoreEntity-Objekt stellt ein einzelnes Geschäft dar, das Entwicklerpartner veröffentlichen möchten, z. B. ein beliebtes Restaurant oder Lokal, das für die Reiseplanung relevant ist.

Attribut	Anforderung	Beschreibung	Formatieren
Posterbilder	Erforderlich	Es muss mindestens ein Bild angegeben werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Optional	Der Name des Geschäfts.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Standort	Optional	Der Standort des Geschäfts.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Zusatzinformationen	Optional	Hinweis, um eine Werbeaktion, ein Event oder ein Update für den Store zu präsentieren, sofern verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Kleingedrucktes für Zusatzinformationen	Optional	Kleingedruckter Text für die Zusatzinformation.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Beschreibung	Optional	Eine Beschreibung des Geschäfts.	Freier Text Empfohlene Textgröße: unter 90 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt.)
Kategorie	Optional	Kategorie eines Geschäfts. Im Zusammenhang mit Gastronomiebetrieben kann dies eine Küche wie „französisch“, „neuamerikanisch“, „Ramen“ oder „Gourmet“ sein.	Freier Text Empfohlene Textgröße: unter 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 Bewertung angegeben wird.	Zahl >= 0,0
Altersfreigabe – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben wird.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern soll, wie die Informationen für Nutzer angezeigt werden. 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 1M verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Zählwert	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 „Anzahlswert“ vorhanden sind, verwenden wir die Anzahl für die Anzeige für Nutzer.	Lang
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`PointOfInterestEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: max. 50 Zeichen
Posterbilder	Bedingt erforderlich	Wenn mehrere Bilder bereitgestellt werden, wird nur eines davon angezeigt. Das empfohlene Seitenverhältnis ist 16:9. Hinweis:Ein Bild ist erforderlich, wenn die Einheit Teil eines Empfehlungsclusters ist. Wenn ein Logo bereitgestellt wird, muss oben und unten im Bild ein Sicherheitsabstand von 24 dps eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Zeitpunkt der letzten Interaktion	Bedingt erforderlich	Der Epochen-Zeitstempel, zu dem der Nutzer zuletzt mit diesem Element interagiert hat. Hinweis:Dieses Feld ist erforderlich, wenn die Einheit Teil des Clusters „Suche fortsetzen“ ist.	Joda-Time Instant
Standort – Land	Bedingt erforderlich	Das Land, in dem sich der POI befindet. Hinweis:Dieses Feld ist erforderlich, wenn die Einheit Teil eines Empfehlungsclusters ist.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadt	Bedingt erforderlich	Die Stadt, in der sich der POI befindet. Hinweis:Dieses Feld ist erforderlich, wenn die Einheit Teil eines Empfehlungsclusters ist.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse, die dem Nutzer angezeigt wird. Geben Sie eine kurze Adresse an und verwenden Sie nach Möglichkeit Abkürzungen (z. B. „Str.“ für „Straße“, „Allee“ für „Allee“). Dieser String wird je nach Gerät und Einstellungen des Nutzers möglicherweise gekürzt. Geben Sie den Namen der Stadt an, damit die Identifizierung eindeutig ist. Hinweis:Dieses Feld ist erforderlich, wenn die Einheit Teil eines Empfehlungsclusters ist.	Freier Text Empfohlene Textgröße: max. ca. 35 Zeichen
Ort – Adresse	Optional	Die Adresse des POI, falls zutreffend.	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: max. 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des POI, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadtteil	Optional	Das Viertel des POI, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel für den Zeitpunkt, zu dem der Point of Interest voraussichtlich geöffnet/verfügbar ist.	Joda-Time Instant
AvailabilityTimeWindow – Lokalisierte Startzeit – Zeitzone	Optional	Die Zeitzone, in der der POI voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
AvailabilityTimeWindow – Lokalisierte Endzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, bis zu dem der Point of Interest voraussichtlich geöffnet/verfügbar ist.	Joda-Time Instant
AvailabilityTimeWindow – Localized End Time – Timezone	Optional	Die Zeitzone, in der der POI voraussichtlich geöffnet/verfügbar ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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 zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Altersfreigabe – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben wird.	Zahl >= 0,0
Altersfreigabe – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben wird.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für den POI. Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern soll, wie die Informationen für Nutzer angezeigt werden. 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 1M verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Zählwert	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 „Anzahlswert“ vorhanden sind, verwenden wir die Anzahl für die Anzeige für Nutzer.	Lang
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit. Muss angegeben werden, wenn der durchgestrichene Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte 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: Kino) TYPE_MEDICAL (Beispiel: Krankenhaus) TYPE_EDUCATION (Beispiel: Schule) TYPE_SPORTS (Beispiel: Stadion) Weitere Informationen finden Sie im Abschnitt „Inhaltskategorie“.
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`RestaurantReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: max. 50 Zeichen
Lokalisierte Reservierungsstartzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel für den voraussichtlichen Beginn der Reservierung.	Joda-Time Instant
Lokalisierte Startzeit der Reservierung – Zeitzone	Erforderlich	Die Zeitzone, in der die Reservierung voraussichtlich beginnt.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Standort – Land	Erforderlich	Das Land, in dem sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadt	Erforderlich	Die Stadt, in der sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse des Restaurants, die dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ort – 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 der sich das Restaurant befindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl des Restaurants (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadtteil	Optional	Das Viertel des Restaurants, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
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 zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber 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
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`EventReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	String Empfohlene Textgröße: max. 50 Zeichen
Lokalisierte Startzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der angibt, wann das Ereignis voraussichtlich beginnt.	Joda-Time Instant
Lokalisierte Startzeit – Zeitzone	Erforderlich	Die Zeitzone, in der das Ereignis voraussichtlich beginnt.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Ereignismodus	Erforderlich	Ein Feld, in dem angegeben wird, ob die Veranstaltung virtuell, vor Ort oder beides stattfindet.	Enum: VIRTUAL, IN_PERSON oder HYBRID
Standort – Land	Bedingt erforderlich	Das Land, in dem das Ereignis stattfindet. Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
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 Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Bedingt erforderlich	Die Adresse oder der Name des Veranstaltungsorts, der dem Nutzer angezeigt werden soll. Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ort – Adresse	Optional	Die Straßenadresse (falls zutreffend) des Veranstaltungsorts.	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: max. 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 – Stadtteil	Optional	Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
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 sicherer Bereich von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Lokalisierte Endzeit – Zeitstempel	Optional	Der Epoch-Zeitstempel, der angibt, wann das Ereignis voraussichtlich endet.	Joda-Time Instant
Lokalisierte Endzeit – Zeitzone	Optional	Die Zeitzone, in der das Ereignis voraussichtlich endet.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Dienstanbieter – Name	Optional	Der Name des Dienstanbieters. Hinweis:Für den Dienstanbieter ist entweder Text oder ein Bild erforderlich.	Freitext. z. B. 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 Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Badges	Optional	Jedes Badge ist entweder ein Freitext (max. 15 Zeichen) oder ein kleines Bild.
Badge – Text	Optional	Titel für das Logo Hinweis:Für das Badge ist entweder Text oder ein Bild erforderlich.	Freier Text Empfohlene Textgröße: max. 15 Zeichen
Badge – Bild	Optional	Kleines Bild Besondere UX-Behandlung, 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 Eventreservierung.	Freier Text
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis des Tickets/Passes für die Veranstaltung. Muss angegeben werden, wenn der durchgestrichene Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis des Tickets/Passes für die Veranstaltung.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 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 Bewertung angegeben wird.	Zahl >= 0,0
Altersfreigabe – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben wird.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für das Ereignis. Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern soll, wie die Informationen für Nutzer angezeigt werden. 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 1M verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Zählwert	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 „Anzahlswert“ vorhanden sind, verwenden wir die Anzahl für die Anzeige für Nutzer.	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: eSports) TYPE_MUSIC (Beispiel: Konzert) TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival) TYPE_HEALTH_AND_FITNESS (Beispiel: Yogakurs) TYPE_EDUCATION (Beispiel: Kurs) TYPE_SPORTS (Beispiel: Fußballspiel) TYPE_DATING (Beispiel: Treffen) Weitere Informationen finden Sie im Abschnitt „Inhaltskategorie“.
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`LodgingReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	Freitext. Beispiel: „Ihr Aufenthalt ab 12. Dezember“ Empfohlene Textgröße: max. 50 Zeichen
Lokalisierte Check-in-Zeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Check-in-Zeit 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 angegeben ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Lokalisierte Check-out-Zeit – Zeitstempel	Erforderlich	Der Epochenzeitstempel, der die Check-out-Zeit für die Reservierung darstellt.	Joda-Time Instant
Lokalisierte Check-out-Zeit – Zeitzone	Erforderlich	Die Zeitzone, in der die Check-out-Zeit für die Reservierung angegeben ist.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Standort – Land	Erforderlich	Das Land, in dem sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadt	Erforderlich	Die Stadt, in der sich die Unterkunft befindet.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse anzeigen	Erforderlich	Die Adresse, die dem Nutzer angezeigt wird. Geben Sie eine kurze Adresse an und verwenden Sie nach Möglichkeit Abkürzungen (z. B. „Str.“ für „Straße“, „Allee“ für „Allee“). Dieser String wird je nach Gerät und Einstellungen des Nutzers möglicherweise gekürzt. Geben Sie den Namen der Stadt an, damit die Identifizierung eindeutig ist.	Freier Text Empfohlene Textgröße: max. ca. 35 Zeichen
Ort – 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: max. 20 Zeichen
Standort – Postleitzahl	Optional	Die Postleitzahl der Unterkunft (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Standort – Stadtteil	Optional	Das Viertel der Unterkunft, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
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 auf dem Bild ein Mindestabstand von 24 dp eingehalten werden.	Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung	Optional	Ein einzelner Textabsatz zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Reservierungs-ID	Optional	Die Reservierungs-ID für die Unterkunftsreservierung.	Freier Text
Altersfreigabe – Höchstwert	Optional	Der Höchstwert der Bewertungsskala. Muss angegeben werden, wenn auch der aktuelle Wert der Bewertung angegeben wird.	Zahl >= 0,0
Altersfreigabe – Aktueller Wert	Optional	Der aktuelle Wert der Bewertungsskala. Muss angegeben werden, wenn auch der Höchstwert der Bewertung angegeben wird.	Zahl >= 0,0
Bewertung – Anzahl	Optional	Die Anzahl der Bewertungen für die Unterkunft. Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern soll, wie die Informationen für Nutzer angezeigt werden. 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 1M verwenden, damit sie auf kleineren Displays nicht abgeschnitten wird.	String
Bewertung – Zählwert	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 „Anzahlswert“ vorhanden sind, verwenden wir die Anzahl für die Anzeige für Nutzer.	Lang
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Unterkunft. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis der Unterkunft, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`TransportationReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	Erforderlich	Titel der Entität.	Freitext. Beispiel: „SFO nach SAN“ Empfohlene Textgröße: max. 50 Zeichen
Art des Verkehrsmittels	Erforderlich	Das Transportmittel für die Reservierung.	Enum: FLIGHT, TRAIN, BUS oder FERRY
Lokalisierte Abflugzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der die Abfahrtszeit darstellt.	Joda-Time Instant
Lokalisierte Abfahrtszeit – Zeitzone	Erforderlich	Die Zeitzone der Abfahrtszeit.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Lokalisierte Ankunftszeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der die Ankunftszeit darstellt.	Joda-Time Instant
Lokalisierte Ankunftszeit – Zeitzone	Erforderlich	Die Zeitzone der Ankunftszeit.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Transportnummer	Erforderlich	Die Flug-, Bus-, Zug- oder Fähr-/Kreuzfahrtnummer.	Freier Text
Lokalisierte Boardingzeit – Zeitstempel	Erforderlich	Der Epoch-Zeitstempel, der die Boardingzeit für die Reservierung darstellt (falls zutreffend)	Joda-Time Instant
Lokalisierte Boardingzeit – Zeitzone	Erforderlich	Die Zeitzone der Boardingzeit für die Reservierung (falls zutreffend)	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Abreiseort – Land	Optional	Das Abreiseland.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abflugort – 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: max. 20 Zeichen
Abfahrtsort – Adresse	Optional	Die Adresse des Abfahrtsorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abflugort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Abfahrtsorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abfahrtsort – Postleitzahl	Optional	Die Postleitzahl des Abfahrtsorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abfahrtsort – Stadtteil	Optional	Das Viertel (falls zutreffend) des Abfahrtsorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ankunftsort – Land	Optional	Das Land der Ankunft.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Zielort – Stadt	Optional	Die Stadt der Ankunft.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ankunftsort – Adresse anzeigen	Optional	Der Ankunftsort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ankunftsort – Adresse	Optional	Die Adresse des Zielorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ankunftsort – Bundesland	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Ankunftsorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Zielort – Postleitzahl	Optional	Die Postleitzahl des Zielorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Ankunftsort – Stadtteil	Optional	Das Viertel (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 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 zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Reservierungs-ID	Optional	Die Reservierungs-ID für die Verkehrsmittelreservierung.	Freier Text
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Reservierung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

`VehicleRentalReservationEntity`

Attribut	Anforderung	Beschreibung	Formatieren
Aktions-URI	Erforderlich	Deeplink zur Einheit in der Anbieter-App. Hinweis: Sie können Deeplinks für die Zuordnung verwenden. Häufig gestellte Fragen	Uri
Überschrift	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 Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Lokalisierte Rückgabezeit – Zeitstempel	Optional	Der Epochenzeitstempel, der die Check-out-Zeit für die Reservierung darstellt.	Joda-Time Instant
Lokalisierte Rückgabezeit – Zeitzone	Optional	Die Zeitzone der Check-out-Zeit für die Reservierung.	Joda-Time DateTimeZone Weitere Informationen finden Sie unter Zeitzonenspezifikationen.
Abholadresse – Land	Optional	Das Land des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Stadt	Optional	Die Stadt des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Adresse anzeigen	Optional	Der Abholort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Straße	Optional	Die Adresse des Abholorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Bundesstaat	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Postleitzahl	Optional	Die Postleitzahl des Abholorts (falls zutreffend).	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Abholadresse – Stadtteil	Optional	Der Stadtteil (falls zutreffend) des Abholorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Land	Optional	Das Land des Rückgabeorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Stadt	Optional	Die Stadt der Rücksendeadresse.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Adresse anzeigen	Optional	Der Rückgabeort, der dem Nutzer angezeigt wird.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Straße	Optional	Die Adresse des Rückgabeorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Bundesstaat	Optional	Das Bundesland oder die Provinz (falls zutreffend) des Rückgabeorts.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Absender – Postleitzahl	Optional	Die Postleitzahl des Rückgabeorts, falls zutreffend.	Freier Text Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Stadtteil	Optional	Das Viertel (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 Car Rental“
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 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 zur Beschreibung der Entität. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber nicht beides.	Freier Text Empfohlene Textgröße: 180 Zeichen
Untertitel-Liste	Optional	Bis zu drei Untertitel, wobei jeder Untertitel eine einzelne Textzeile ist. Hinweis:Dem Nutzer wird entweder die Beschreibung oder die Untertitelliste angezeigt, aber 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
Preis – CurrentPrice	Bedingt erforderlich	Der aktuelle Preis der Reservierung. Muss angegeben werden, wenn ein durchgestrichener Preis angegeben wird.	Freier Text
Preis – StrikethroughPrice	Optional	Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen wird.	Freier Text
Preishinweis	Optional	Preisangabe, um ein Angebot, ein Event oder einen Mitgliederrabatt zu präsentieren, falls verfügbar.	Freier Text Empfohlene Textgröße: unter 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
DisplayTimeWindow (Optional): Legen Sie ein Zeitfenster für die Anzeige von Inhalten auf der Oberfläche fest.
Startzeitstempel	Optional	Der Epoch-Zeitstempel, nach dem die Inhalte auf der Plattform angezeigt werden sollen. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden
Zeitstempel des Endes	Optional	Der Epoch-Zeitstempel, nach dem der Inhalt nicht mehr auf der Oberfläche angezeigt wird. Wenn sie nicht festgelegt ist, können Inhalte auf der Plattform präsentiert werden.	Epochen-Zeitstempel in Millisekunden

Bildspezifikationen

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

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

Seitenverhältnis

Mindestanzahl an Pixeln

Empfohlene Pixel

Quadratisch (1 × 1)

Bevorzugt

300 × 300

1200 × 1200

Querformat (1,91 × 1)

600 × 314

1200 × 628

Hochformat (4 : 5)

480 × 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 das helle und das dunkle Design richtig angezeigt werden kann.

Zeitzonenspezifikationen

Bevorzugen Sie die ID (z. B. „America/Los_Angeles“) gegenüber dem Offset (z. B. „-07:00“).

Verwendungsbeispiel: DateTimeZone.forID("America/Los_Angeles")

Content-Kategorie

Mit der Inhaltskategorie können Apps Inhalte aus mehreren Kategorien veröffentlichen. Dadurch 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 der Inhaltskategorien

Für einige Einheiten wie ArticleEntity und GenericFeaturedEntity können alle Inhaltskategorien verwendet werden. Für andere Rechtspersönlichkeiten wie EventEntity, EventReservationEntity und PointOfInterestEntity ist nur eine Teilmenge dieser Kategorien zulässig. Sehen Sie sich die Liste der Kategorien an, die für einen Entitätstyp infrage kommen, bevor Sie die Liste ausfüllen.
Verwenden Sie für einige Inhaltstypen den spezifischen Entitätstyp anstelle einer Kombination aus den generischen Entitäten und ContentCategory:
- TYPE_MOVIES_AND_TV_SHOWS: Sehen Sie sich die Entitäten im Leitfaden zur Watch-Integration an, bevor Sie die generischen Entitäten verwenden.
- TYPE_BOOKS: Sehen Sie sich die EbookEntity an, bevor Sie die generischen Einheiten verwenden.
- TYPE_AUDIOBOOKS: Sehen Sie sich AudiobookEntity an, bevor Sie die generischen Einheiten verwenden.
- TYPE_SHOPPING: Sehen Sie sich ShoppingEntity an, bevor Sie die generischen Einheiten verwenden.
- TYPE_FOOD_AND_DRINK: Sehen Sie sich die Entitäten im Leitfaden zur Integration von Lebensmitteln an, bevor Sie die generischen Entitäten verwenden.
Das Feld „ContentCategory“ ist optional und sollte leer gelassen werden, wenn der Inhalt keiner der oben genannten Kategorien angehört.
Wenn mehrere Inhaltstypen angegeben werden, geben Sie sie in der Reihenfolge ihrer Relevanz für den Inhalt an. Der relevanteste Inhaltstyp sollte dabei 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 gerade etwas in den Einkaufswagen gelegt hat).

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

Es gibt die folgenden APIs zum Veröffentlichen von Clustern im Client:

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 Integration 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 empfängt, werden die folgenden Aktionen in 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`

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 empfängt, werden die folgenden Aktionen in einer Transaktion ausgeführt:

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

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

`publishReservationCluster`

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

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 empfängt, werden die folgenden Aktionen in einer Transaktion ausgeführt:

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

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

`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 empfängt, werden die folgenden Aktionen in einer Transaktion ausgeführt:

Vorhandene ContinueSearchCluster-Daten des Entwicklerpartners werden entfernt.
Die Daten aus der Anfrage werden geparst und im aktualisierten Cluster „Suche fortsetzen“ 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 (d.h. zur Anmeldeseite der App)
Bild	Optional – Wenn nicht angegeben, muss „Title“ angegeben werden.	Auf der Karte angezeigtes Bild Bilder mit einem Seitenverhältnis von 16:9 und einer Auflösung von 1264 × 712
Überschrift	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 in 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 API updatePublishStatus zu aktualisieren. Das ist aus folgenden Gründen wichtig :

Es ist wichtig, den Status in allen Szenarien anzugeben, auch wenn die Inhalte veröffentlicht sind (STATUS == PUBLISHED), damit Dashboards, in denen dieser explizite Status verwendet wird, mit Daten gefüllt werden können, 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 in den App-Health-Dashboards Benachrichtigungen ausgelöst werden. Sie bestätigt, dass Inhalte aufgrund einer erwarteten Situation aus Sicht des Anbieters nicht veröffentlicht werden.
So können Entwickler angeben, 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 die App-Inhalte sehen oder das Problem beheben kann.

Die Liste der infrage kommenden Veröffentlichungsstatuscodes 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 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 updatePublishStatus-API 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 wird der Inhalt von Empfehlungsclustern gelöscht.

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 vorhandene Status beibehalten.

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteReservationCluster`

Mit dieser API wird der Inhalt des Reservierungsclusters gelöscht.

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus dem Reservierungscluster 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 erhält, werden die vorhandenen Daten aus dem UserAccountManagement-Cluster entfernt. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

`deleteContinueSearchCluster`

Mit dieser API wird der Inhalt des Clusters „Suche fortsetzen“ gelöscht.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Wenn der Dienst die Anfrage erhält, werden die vorhandenen Daten aus dem Cluster „Continue Search“ 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_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 empfängt, werden die vorhandenen Daten aus allen Clustern entfernt, die den angegebenen Clustertypen entsprechen. Clients können einen oder mehrere Clustertypen übergeben. Bei einem Fehler wird die gesamte Anfrage abgelehnt und der vorhandene Status bleibt erhalten.

Fehlerbehandlung

Es wird dringend empfohlen, das Ergebnis des Tasks aus den Publish-APIs abzurufen, damit eine Folgemaßnahme ergriffen werden kann, um einen erfolgreichen Task 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. Die Ursache ist als Fehlercode enthalten.

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 Threading-Problemen fehlgeschlagen. In diesem Fall kann der Vorgang wiederholt werden.
`4`	`SERVICE_CALL_PERMISSION_DENIED`	Der Anrufer darf den Serviceanruf nicht tätigen.
`5`	`SERVICE_CALL_INVALID_ARGUMENT`	Die Anfrage enthält ungültige Daten, z. B. mehr Cluster als zulässig.
`6`	`SERVICE_CALL_INTERNAL`	Auf der Dienstseite ist ein Fehler aufgetreten.
`7`	`SERVICE_CALL_RESOURCE_EXHAUSTED`	Der Dienstaufruf erfolgt zu häufig.

Schritt 3: Broadcast-Intents verarbeiten

Zusätzlich zu den API-Aufrufen zum Veröffentlichen von Inhalten über einen Job ist es auch erforderlich, eine BroadcastReceiver einzurichten, um die Anfrage zum Veröffentlichen von Inhalten zu erhalten.

Der Zweck von Broadcast-Intents besteht hauptsächlich darin, Apps zu reaktivieren und die Datensynchronisierung zu erzwingen. Broadcast-Intents sind nicht dafür gedacht, sehr häufig gesendet zu werden. Sie wird nur ausgelöst, wenn der Engage-Dienst feststellt, dass die Inhalte möglicherweise veraltet sind (z. B. eine Woche alt). So ist es wahrscheinlicher, dass der Nutzer neue Inhalte sieht, auch wenn die Anwendung längere Zeit nicht ausgeführt wurde.

Das BroadcastReceiver muss auf zwei Arten eingerichtet werden:

Registrieren Sie eine Instanz der Klasse BroadcastReceiver dynamisch mit Context.registerReceiver(). Dadurch wird die Kommunikation von Anwendungen ermöglicht, die noch im Arbeitsspeicher 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 continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           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(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

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

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           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 continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION 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 Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         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. So kann die Anwendung Broadcast-Intents empfangen, wenn sie nicht ausgeführt wird, und auch 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.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

Die folgenden Intents werden vom Dienst gesendet:

com.google.android.engage.action.PUBLISH_RECOMMENDATION Es wird empfohlen, einen publishRecommendationClusters-Anruf zu starten, wenn dieser Intent empfangen wird.
com.google.android.engage.action.PUBLISH_FEATURED Es wird empfohlen, bei Empfang dieses Intents einen publishFeaturedCluster-Anruf zu starten.
com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH Es wird empfohlen, einen publishContinueSearchCluster-Anruf zu starten, wenn dieser Intent empfangen wird.
com.google.android.engage.action.travel.PUBLISH_RESERVATION Es wird empfohlen, einen publishReservationCluster-Anruf zu starten, wenn dieser Intent empfangen wird.

Integrationsworkflow

Eine Schritt-für-Schritt-Anleitung zum Überprüfen Ihrer Integration nach Abschluss finden Sie unter Workflow für die Entwicklerintegration.

Häufig gestellte Fragen

Häufig gestellte Fragen zum Engage SDK

Kontakt

Bei Fragen während des Integrationsprozesses wenden Sie sich bitte an engage-developers@google.com.

Nächste Schritte

Nachdem Sie diese Integration abgeschlossen haben, sind die nächsten Schritte folgende:

Senden Sie eine E-Mail an engage-developers@google.com und hängen Sie Ihr integriertes APK an, das für Tests durch Google bereit ist.
Google führt eine Überprüfung durch und prüft intern, ob die Integration wie erwartet funktioniert. Falls Änderungen erforderlich sind, werden Sie von Google mit allen erforderlichen Details kontaktiert.
Wenn die Tests abgeschlossen sind und keine Änderungen erforderlich sind, benachrichtigt Google Sie, dass Sie das aktualisierte und integrierte APK im Play Store veröffentlichen können.
Nachdem Google bestätigt hat, dass Ihr aktualisiertes APK im Play Store veröffentlicht wurde, werden Ihre Cluster Empfehlung, Vorgestellt, Reservierung und Suche fortsetzen möglicherweise veröffentlicht und für Nutzer sichtbar.

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

Integrationsdetails

Terminologie

Vorbereitung

Zusammenfassung

Schritt 1: Rechtssubjektdaten angeben

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

Bildspezifikationen

Zeitzonenspezifikationen

Content-Kategorie

Schritt 2: Clusterdaten angeben

isServiceAvailable

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishReservationCluster

Kotlin

Java

publishContinueSearchCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteReservationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteContinueSearchCluster

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 Travel: Anleitung zur technischen Integration von Drittanbietern

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishReservationCluster`

`publishContinueSearchCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationClusters`

`deleteFeaturedCluster`

`deleteReservationCluster`

`deleteUserManagementCluster`

`deleteContinueSearchCluster`

`deleteClusters`