Engage SDK Travel: Anleitung zur technischen Integration von Drittanbietern

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

Integrationsdetails

Terminologie

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

  • In Empfehlungsclustern werden personalisierte Reise- und Veranstaltungsvorschläge von einem einzelnen Entwicklerpartner angezeigt. Diese Empfehlungen können für den Nutzer personalisiert oder generalisiert werden (z. B. angesagte Artikel). So können Sie Empfehlungen für Artikel, Veranstaltungen, Unterkünfte oder Sehenswürdigkeiten erhalten.

    • Ein Empfehlungscluster kann aus ArticleEntity-, EventEntity-, LodgingEntity-, PointOfInterestEntity- oder StoreEntity-Einträgen bestehen, darf jedoch nicht verschiedene Entitätstypen enthalten.

    Ihre Empfehlungen haben folgende Struktur:

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

    • Entität: Ein Objekt, das ein einzelnes Element in einem Cluster darstellt. Diese Integration bietet einige Entitäten, die mit dem Empfehlungscluster angezeigt werden:

      • ArticleEntity: „ArticleEntity“ ist eine Empfehlung für textbasierte Inhalte zu Reisen und Veranstaltungen. Sie können für Artikel, Blogposts, Marketinginhalte, News-Snippets usw. verwendet werden.

        Abbildung 1:Benutzeroberfläche mit einer einzelnen „ArticleEntity“ im Cluster „Empfehlungen“.

      • EventEntity: „EventEntity“ steht für ein Ereignis in der Zukunft. Der Beginn des Ereignisses ist eine wichtige Information, die den Nutzern mitgeteilt werden muss.

        Abbildung 2: Benutzeroberfläche mit einer einzelnen EventEntity im Cluster „Empfehlungen“.

      • LodgingEntity: „LodgingEntity“ steht für eine Unterkunft, z. B. ein Hotel, eine Wohnung oder ein Ferienhaus, das für Kurz- und Langzeitaufenthalte vermietet wird.

        Abbildung 3: Benutzeroberfläche mit einer einzelnen LodgingEntity im Cluster „Empfehlungen“.

      • StoreEntity: „StoreEntity“ steht für ein Geschäft, Restaurant, Café usw. und hebt Inhalte hervor, bei denen ein Restaurant oder Geschäft die wichtigste Information ist, die den Nutzern vermittelt werden muss.

        Abbildung 4: Benutzeroberfläche mit einer einzelnen StoreEntity im Cluster „Empfehlungen“.

      • PointOfInterestEntity: „PointOfInterestEntity“ steht für einen POI wie eine Tankstelle, einen Veranstaltungsort, einen Freizeitpark, ein Museum, eine Touristenattraktion oder einen Wanderweg. Damit werden Inhalte hervorgehoben, bei denen der Standort eine wichtige Information ist, die den Nutzern vermittelt werden muss. Sie sollte nicht für Unterkünfte, Geschäfte oder Restaurants verwendet werden.

        Abbildung 5: Benutzeroberfläche mit einer einzelnen PointOfInterestEntity im Cluster „Empfehlungen“.

  • Der Cluster Fortsetzung enthält Inhalte, mit denen Nutzer vor Kurzem von mehreren Entwicklerpartnern interagiert haben. Diese werden in einer einzigen UI-Gruppierung angezeigt. Jeder Entwicklerpartner darf maximal 10 Entitäten im Fortsetzungscluster übertragen.

    Die Fortsetzungsinhalte können folgende Struktur haben:

    • ArticleEntity: „ArticleEntity“ steht für eine Empfehlung für Inhalte, die sich auf Reisen und Veranstaltungen beziehen. Diese Entität kann verwendet werden, um unvollständige Nachrichtenartikel oder andere Inhalte darzustellen, die der Nutzer an der Stelle weiter ansehen möchte, an der er sie verlassen hat. Beispiele: Nachrichten-Snippet, Blogpost-Snippet zu einem Reiseziel oder einer Veranstaltung.

      Abbildung 6: Benutzeroberfläche mit einer einzelnen ArticleEntity innerhalb eines Fortsetzungsclusters

    • RestaurantReservationEntity: „RestaurantReservationEntity“ steht für eine Reservierung in einem Restaurant oder Café und hilft Nutzern, anstehende oder laufende Restaurantreservierungen im Blick zu behalten.

      Abbildung 7. Benutzeroberfläche mit einer einzelnen RestaurantReservationEntity in einem Continuation-Cluster

    • EventReservationEntity: „EventReservationEntity“ steht für eine Reservierung für eine Veranstaltung und hilft Nutzern, anstehende oder laufende Reservierungen für Veranstaltungen zu verfolgen. Beispiele für Ereignisse:

      • Sportveranstaltungen wie die Reservierung eines Fußballspiels
      • Gaming-Events wie Reservierungen für eSports
      • Unterhaltungsereignisse wie Kinofilme, Konzerte, Theateraufführungen oder Buchpräsentationen
      • Reservierungen für Reisen oder Sehenswürdigkeiten wie Führungen oder Museumstickets
      • Soziale Netzwerke / Seminare / Konferenzen
      • Reservierungen für Schulungen
      Abbildung 8 Benutzeroberfläche mit einer einzelnen „EventReservationEntity“ innerhalb eines Fortsetzungsclusters.

    • LodgingReservationEntity: „LodgingEntityReservation“ stellt eine Reservierung für eine Reiseunterkunft dar und hilft Nutzern, anstehende oder laufende Hotel- oder Ferienunterkunftsreservierungen im Blick zu behalten.

      Abbildung 9. Benutzeroberfläche mit einer einzelnen „LodgingReservationEntity“ in einem Fortsetzungscluster

    • TransportationReservationEntity: „TransportationReservationEntity“ steht für eine Reservierung für beliebige Verkehrsmittel und hilft Nutzern, Reservierungen für anstehende oder laufende Flüge, Fähren, Züge, Busse, Fahrdienste oder Kreuzfahrten zu verfolgen.

      Abbildung 10. Benutzeroberfläche mit einer einzelnen TransportationReservationEntity in einem Continuation-Cluster

    • VehicleRentalReservationEntity: „VehicleRentalReservationEntity“ steht für eine Mietwagenreservierung und hilft Nutzern, anstehende oder laufende Mietwagenreservierungen im Blick zu behalten.

      Abbildung 11. Benutzeroberfläche mit einer einzelnen „VehicleRentalReservationEntity“ innerhalb eines Fortsetzungsclusters

  • Im Cluster Empfohlen werden in einer UI-Gruppierung eine Auswahl von Entitäten verschiedener Entwicklerpartner präsentiert. Es wird einen einzelnen empfohlenen Cluster geben, der oben in der UI angezeigt wird und über allen Empfehlungsclustern platziert wird. Jeder Entwicklerpartner darf bis zu zehn Entitäten im Cluster „Empfohlen“ senden.

    • GenericFeaturedEntity: „GenericFeaturedEntity“ unterscheidet sich von „RecommendationItem“ dadurch, dass „FeaturedItem“ für einen einzelnen Top-Inhalt von Entwicklern verwendet werden sollte und den wichtigsten Inhalt darstellen sollte, der für Nutzer interessant und relevant ist.

      Abbildung 12: Benutzeroberfläche mit einem „Empfohlener Cluster“ mit einer Liste von „GenericFeaturedEntity“

Vorarbeiten

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 der Implementierung eines gebundenen Dienstes.

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

Clustertyp Clusterlimits Mindestanzahl von Entitäten in einem Cluster Maximale Entitätslimits in einem Cluster
Empfehlungscluster Höchstens 5 Mindestens 5 Maximal 25 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity oder PointOfInterestEntity)
Fortsetzungscluster Maximal 1 Mindestens 1 Höchstens 10 (ArticleEntity, RestaurantReservationEntity EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity oder VehicleRentalReservationEntity)
Ausgewählter Cluster Maximal 1 Mindestens 1 Maximal 10 (GenericFeaturedEntity)

Schritt 1: Entitätsdaten angeben

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

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

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

GenericFeaturedEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Posterbilder Erforderlich

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Titel Optional Titel der Entität.

Freier Text

Empfohlene Textgröße: 50 Zeichen
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Badges Optional

Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.

Spezielle UX-Behandlung über dem Bild/Video, z. B. als Logo-Overlay auf dem Bild

  • „Liveaktualisierung“
  • Dauer der Artikellektüre
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Inhaltskategorien Optional Beschreiben Sie die Kategorie des Inhalts in der Entität.

Liste der Enums

Weitere Informationen finden Sie im Abschnitt "Inhaltskategorie".

ArticleEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

Freier Text

Empfohlene Textgröße: max. 50 Zeichen
Posterbilder Optional

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Ein Bild wird dringend empfohlen. Wenn Sie ein Logo erhalten, achten Sie darauf, dass sowohl oben als auch unten im Bild ein Mindestabstand von 24 dps vorhanden ist.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Quelle – Titel Optional Der Name des Autors, der Organisation oder des Reporters

Freier Text

Empfohlene Textgröße: Weniger als 25 Zeichen
Quelle – Bild Optional Ein Bild der Quelle, z. B. des Autors, der Organisation oder des Reporters Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Badges Optional

Jedes Kennzeichen besteht entweder aus freiem Text (max. 15 Zeichen) oder einem kleinen Bild.

Spezielle UX-Behandlung über dem Bild/Video, z. B. als Logo-Overlay auf dem Bild

  • „Live-Update“
  • Dauer der Artikellektüre
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Veröffentlichungszeitpunkt des Inhalts Optional Dies ist der Epochenzeitstempel in Millisekunden, zu dem die Inhalte in der App veröffentlicht oder aktualisiert wurden. Epochen-Zeitstempel in Millisekunden
Zeitpunkt der letzten Interaktion Bedingt erforderlich

Der Epochenzeitstempel in Millisekunden, zu dem der Nutzer zuletzt mit dieser Entität interagiert hat.

Hinweis: Dieses Feld ist erforderlich, wenn diese Entität Teil des Fortsetzungsclusters ist.

 Epochen-Zeitstempel in Millisekunden
Prozentsatz des Fortschritts Bedingt erforderlich

Der Prozentsatz des gesamten Inhalts, den der Nutzer bisher genutzt hat.

Hinweis: Dieses Feld ist erforderlich, wenn diese Entität Teil des Fortsetzungsclusters ist.

 Eine Ganzzahl zwischen 0 und 100.
Inhaltskategorien Optional Beschreiben Sie die Kategorie des Inhalts in der Entität.

Liste der Enums

Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

EventEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

String

Empfohlene Textgröße: max. 50 Zeichen
Beginn Erforderlich

Der Epochenzeitstempel, an dem das Ereignis voraussichtlich beginnen wird.

Hinweis: Dieser Wert wird in Millisekunden angegeben.

 Epochen-Zeitstempel in Millisekunden
Ereignismodus Erforderlich

Ein Feld, das angibt, ob die Veranstaltung virtuell, vor Ort oder beides stattfinden soll.

 Enum: VIRTUAL, IN_PERSON oder HYBRID
Posterbilder Erforderlich

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Ein Bild wird dringend empfohlen. Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land Bedingt erforderlich

Das Land, in dem das Ereignis stattfindet.

Hinweis: Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort Bedingt erforderlich

Die Stadt, in der die Veranstaltung stattfindet.

Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen Bedingt erforderlich

Die Adresse oder der Name des Veranstaltungsortes, an dem die Veranstaltung stattfindet, die dem Nutzer angezeigt werden soll.

Hinweis: Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die (falls zutreffend) Straße und Hausnummer des Veranstaltungsortes.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in der die Veranstaltung stattfindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Veranstaltungsorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Ende Optional

Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet.

Hinweis: Dieser Wert wird in Millisekunden angegeben.

 Epochen-Zeitstempel in Millisekunden
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Badges Optional

Jedes Badge kann entweder aus freiem Text (max. 15 Zeichen) oder aus einem kleinen Bild bestehen.
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis des Tickets/Passes für die Veranstaltung.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis des Tickets/Passes für die Veranstaltung. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Inhaltskategorien Optional Beschreiben Sie die Kategorie des Inhalts in der Entität.

Liste der möglichen Aufzählungen

  • TYPE_MovieS_AND_TV_SHOWS (Beispiel – Kino)
  • TYPE_DIGITAL_GAMES (Beispiel: eSports)
  • TYPE_MUSIC (Beispiel: Konzert)
  • TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival)
  • TYPE_HEALTH_AND_FITENESS (Beispiel: Yogakurs)
  • TYPE_EDUCATION (Beispiel: Kurs)
  • TYPE_SPORTS (Beispiel: Fußballspiel)
  • TYPE_DATING (Beispiel: „Meetup“)

Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

LodgingEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

String

Empfohlene Textgröße: max. 50 Zeichen
Posterbilder Erforderlich

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land Erforderlich Das Land, in dem die Unterkunft liegt.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Stadt Erforderlich Die Stadt, in der die Unterkunft gebucht wurde.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – angezeigte Adresse Erforderlich Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die Adresse der Unterkunft (falls zutreffend).

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in der sich die Unterkunft befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl der Unterkunft (falls zutreffend).

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend) der Unterkunft.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Badges Optional

Jedes Badge kann entweder aus freiem Text (max. 15 Zeichen) oder aus einem kleinen Bild bestehen.
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jeden Untertitel: max. 50 Zeichen
Verfügbarkeitszeitraum – Startzeit Optional Der Epochenzeitstempel in Millisekunden, in dem die Unterkunft voraussichtlich offen/verfügbar sein soll. Epochen-Zeitstempel in Millisekunden
AvailabilityTimeWindow – Endzeit Optional Der Epoch-Zeitstempel in Millisekunden, bis zu dem die Unterkunft voraussichtlich geöffnet/verfügbar sein wird. Epochen-Zeitstempel in Millisekunden
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 Altersfreigabe.

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

 Zahl >= 0,0
Altersfreigabe – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern möchte, wie dies den Nutzern angezeigt wird. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.

 String
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis: Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahl“ vorhanden sind, verwenden wir „Anzahl“, um Nutzern

 Lang
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis der Unterkunft.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis der Unterkunft, der auf der Benutzeroberfläche durchgestrichen ist. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

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

StoreEntity

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

Attribut Anforderung Beschreibung Formatieren
Posterbilder Erforderlich Es muss mindestens ein Bild angegeben werden. Weitere Informationen finden Sie unter Anforderungen an Bilder.
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Optional Der Name des Geschäfts.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Standort Optional Der Standort des Geschäfts.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Zu langer Text enthält möglicherweise Auslassungspunkte)
Zusatzinformationen Optional Zusatzinformation zu einer Werbeaktion, einem Ereignis oder einer Neuigkeit für den Shop, sofern verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Zu langer Text enthält möglicherweise Auslassungspunkte)
Kleingedrucktes mit Zusatzinformationen Optional Kleingedruckter Text für die Zusatzinformation.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (Zu langer Text enthält möglicherweise Auslassungspunkte)
Beschreibung Optional Eine Beschreibung des Geschäfts.

Freier Text

Empfohlene Textgröße: weniger als 90 Zeichen (Bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
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 Altersfreigabe.

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

 Zahl >= 0,0
Altersfreigabe – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern möchte, wie dies den Nutzern angezeigt wird. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.

 String
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis: Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahl“ vorhanden sind, verwenden wir „Anzahl“, um Nutzern

 Lang

PointOfInterestEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

String

Empfohlene Textgröße: max. 50 Zeichen
Posterbilder Erforderlich

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Ein Bild wird dringend empfohlen. Wenn Sie ein Logo erhalten, achten Sie darauf, dass sowohl oben als auch unten im Bild ein Mindestabstand von 24 dps vorhanden ist.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Standort – Land Erforderlich Das Land, in dem sich der POI befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Stadt Erforderlich Die Stadt, in der sich der POI befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – angezeigte Adresse Erforderlich Die Adresse des POI, die dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die Adresse (falls zutreffend) des POI.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in der sich der POI befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl des POI (falls zutreffend).

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend) des POI.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Verfügbarkeitszeitraum – Startzeit Optional Der Epochenzeitstempel in Millisekunden, zu dem der POI voraussichtlich geöffnet/verfügbar sein wird. Epochen-Zeitstempel in Millisekunden
AvailabilityTimeWindow – Endzeit Optional Der Epoch-Zeitstempel in Millisekunden, bis zu dem der POI voraussichtlich geöffnet/verfügbar ist. Epochen-Zeitstempel in Millisekunden
Badges Optional

Jedes Badge kann entweder aus freiem Text (max. 15 Zeichen) oder aus einem kleinen Bild bestehen.
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Altersfreigabe – Höchstwert Optional

Der Höchstwert der Bewertungsskala.

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

 Zahl >= 0,0
Altersfreigabe – Aktueller Wert Optional

Der aktuelle Wert der Altersfreigabe.

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

 Zahl >= 0,0
Altersfreigabe – Anzahl Optional

Die Anzahl der Bewertungen für den POI.

Hinweis: Geben Sie dieses Feld an, wenn Sie in Ihrer App festlegen möchten, wie diese Informationen den Nutzern angezeigt werden. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.

 String
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für den POI.

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

 Lang
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis der Tickets/Eintrittskarten für die Sehenswürdigkeit. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

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

Inhaltskategorien Optional Beschreiben Sie die Kategorie des Inhalts in der Entität.

Liste der zulässigen „enum“-Strings

  • REISENTYP_UND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (Beispiel: Theater)
  • TYPE_MEDICAL (Beispiel: Krankenhaus)
  • TYPE_EDUCATION (Beispiel: Schule)
  • TYPE_SPORTS (Beispiel – Stadion)

Weitere Informationen finden Sie im Abschnitt "Inhaltskategorie".

RestaurantReservationEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

String

Empfohlene Textgröße: max. 50 Zeichen
Reservierungsbeginn Erforderlich Der Epochenzeitstempel in Millisekunden, zu dem die Reservierung voraussichtlich beginnt. Epochen-Zeitstempel in Millisekunden
Standort – Land Erforderlich Das Land, in dem das Restaurant stattfindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Stadt Erforderlich Die Stadt, in der sich das Restaurant befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – angezeigte Adresse Erforderlich Die Adresse des Restaurants, die dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die Adresse des Restaurants (falls zutreffend).

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in dem bzw. der sich das Restaurant befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Restaurants.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend) des Restaurants.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Posterbilder Optional Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Tabellengröße Optional Die Anzahl der Personen in der Reservierungsgruppe Ganzzahl > 0

EventReservationEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

String

Empfohlene Textgröße: max. 50 Zeichen
Beginn Erforderlich

Der Epochenzeitstempel, an dem das Ereignis voraussichtlich beginnen wird.

Hinweis: Dieser Wert wird in Millisekunden angegeben.

 Epochen-Zeitstempel in Millisekunden
Ereignismodus Erforderlich

Ein Feld, das angibt, ob die Veranstaltung virtuell, vor Ort oder beides stattfinden soll.

 Enum: VIRTUAL, IN_PERSON oder HYBRID
Standort – Land Bedingt erforderlich

Das Land, in dem das Ereignis stattfindet.

Hinweis: Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Ort Bedingt erforderlich

Die Stadt, in der die Veranstaltung stattfindet.

Hinweis:Dies ist für Veranstaltungen erforderlich, die IN_PERSON oder HYBRID sind.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Adresse anzeigen Bedingt erforderlich

Die Adresse oder der Name des Veranstaltungsortes, an dem die Veranstaltung stattfindet, die dem Nutzer angezeigt werden soll.

Hinweis: Dies ist für Ereignisse erforderlich, die „IN_PERSON“ oder „HYBRID“ sind.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die (falls zutreffend) Straße und Hausnummer des Veranstaltungsortes.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in der die Veranstaltung stattfindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Veranstaltungsorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend), in dem die Veranstaltung stattfindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Posterbilder Optional

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Ein Bild wird dringend empfohlen. Wenn Sie ein Logo erhalten, achten Sie darauf, dass sowohl oben als auch unten im Bild ein Mindestabstand von 24 dps vorhanden ist.

 Weitere Informationen finden Sie unter Anforderungen an Bilder.
Ende Optional

Der Epochenzeitstempel, zu dem das Ereignis voraussichtlich endet.

Hinweis: Dieser Wert wird in Millisekunden angegeben.

 Epochen-Zeitstempel in Millisekunden
Dienstanbieter – Name Optional

Der Name des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Freier Text. Beispiel: Name des Organisators/der Tour
Dienstanbieter – Bild Optional

Das Logo oder Bild des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Badges Optional

Jedes Badge kann entweder aus freiem Text (max. 15 Zeichen) oder aus einem kleinen Bild bestehen.
Badge – Text Optional

Titel für das Gütesiegel

Hinweis: Für das Logo ist entweder Text oder ein Bild erforderlich.

Freier Text

Empfohlene Textgröße: max. 15 Zeichen
Logo – Bild Optional

Kleines Bild

Spezielle UX-Optimierung, z. B. als Logo-Overlay auf dem Bild-/Video-Thumbnail

Hinweis: Für das Gütesiegel ist entweder Text oder ein Bild erforderlich.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Reservierungs-ID Optional Die Reservierungs-ID für die Ereignisreservierung. Freier Text
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis des Tickets/Passes für die Veranstaltung.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis des Tickets/Passes für die Veranstaltung. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Altersfreigabe – Höchstwert Optional

Der Höchstwert der Bewertungsskala.

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

 Zahl >= 0,0
Altersfreigabe – Aktueller Wert Optional

Der aktuelle Wert der Altersfreigabe.

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

 Zahl >= 0,0
Altersfreigabe – Anzahl Optional

Die Anzahl der Bewertungen für das Ereignis.

Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern möchte, wie dies den Nutzern angezeigt wird. Geben Sie einen kurzen 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 bei kleineren Displays nicht abgeschnitten wird.

 String
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für das Ereignis.

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

 Lang
Inhaltskategorien Optional Beschreiben Sie die Kategorie des Inhalts in der Entität.

Liste der möglichen Aufzählungen

  • TYPE_MovieS_AND_TV_SHOWS (Beispiel – Kino)
  • TYPE_DIGITAL_GAMES (Beispiel: eSports)
  • TYPE_MUSIC (Beispiel: Konzert)
  • TYPE_TRAVEL_AND_LOCAL (Beispiel: Tour, Festival)
  • TYPE_HEALTH_AND_FITENESS (Beispiel: Yogakurs)
  • TYPE_EDUCATION (Beispiel: Kurs)
  • TYPE_SPORTS (Beispiel: Fußballspiel)
  • TYPE_DATING (Beispiel: „Meetup“)

Weitere Informationen finden Sie im Abschnitt Inhaltskategorie.

LodgingReservationEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

Freitext. Beispiel: „Ihr Aufenthalt vom 12. Dezember“

Empfohlene Textgröße: max. 50 Zeichen
Check-in-Zeit Erforderlich Der Epochenzeitstempel in Millisekunden, der die Ankunftszeit für die Reservierung darstellt. Epochen-Zeitstempel in Millisekunden
Check-out-Zeit Erforderlich Der Epochenzeitstempel in Millisekunden, der die Abholzeit für die Reservierung darstellt. Epochen-Zeitstempel in Millisekunden
Standort – Land Erforderlich Das Land, in dem sich die Unterkunft befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Stadt Erforderlich Die Stadt, in der sich die Unterkunft befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – angezeigte Adresse Erforderlich Die Adresse der Unterkunft, die dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Adresse Optional Die Adresse der Unterkunft (falls zutreffend).

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Standort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend), in der sich die Unterkunft befindet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Postleitzahl Optional Die Postleitzahl der Unterkunft (falls zutreffend).

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Standort – Umgebung Optional Der Stadtteil (falls zutreffend) der Unterkunft.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Posterbilder Optional

Wenn mehrere Bilder angegeben werden, wird nur eines davon angezeigt. Empfohlenes Seitenverhältnis: 16:9

Hinweis: Wenn ein Logo verwendet wird, muss oben und unten im Bild ein sicherer Bereich von 24 dps vorhanden sein.

Weitere Informationen finden Sie unter Anforderungen an Bilder.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Reservierungs-ID Optional Die Reservierungs-ID für die Hotelreservierung. Freier Text
Bewertung – Maximalwert 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 Altersfreigabe.

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

 Zahl >= 0,0
Altersfreigabe – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis:Geben Sie dieses Feld an, wenn Ihre App steuern möchte, wie dies den Nutzern angezeigt wird. Geben Sie einen kurzen String an, der dem Nutzer angezeigt werden kann. Wenn die Anzahl beispielsweise 1.000.000 beträgt, sollten Sie Abkürzungen wie 1 Mio. verwenden, damit sie bei kleineren Bildschirmgrößen nicht abgeschnitten wird.

 String
Bewertung – Anzahl Optional

Die Anzahl der Bewertungen für die Unterkunft.

Hinweis: Geben Sie dieses Feld an, wenn Sie die Logik für die Anzeige von Abkürzungen nicht selbst verarbeiten möchten. Wenn sowohl „Anzahl“ als auch „Anzahl“ vorhanden sind, verwenden wir „Anzahl“, um Nutzern

 Lang
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis der Unterkunft.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis der Unterkunft, der auf der Benutzeroberfläche durchgestrichen ist. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

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

TransportationReservationEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

Freier Text. Beispiel: „SFO nach SAN“

Empfohlene Textgröße: max. 50 Zeichen
Art des Verkehrsmittels Erforderlich Die Mobilitätsform/der Transportmitteltyp für die Reservierung. Enum: FLIGHT, TRAIN, BUS oder FERRY
Abflugzeit Erforderlich Der Zeitstempel der Epoche in Millisekunden, der die Abfahrtszeit angibt. Epochen-Zeitstempel in Millisekunden
Ankunft Erforderlich Der Zeitstempel der Epoche in Millisekunden, der die Ankunftszeit angibt. Epochen-Zeitstempel in Millisekunden
Abreiseort – Land Optional Das Abreiseland.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Stadt Optional Der Abflugort.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abfahrtsort – Adresse anzeigen Optional Der Abfahrtsort, der dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Abreiseort – Adresse Optional Die Adresse (falls zutreffend) des Abfahrtsorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abreiseort – Bundesland Optional Das Bundesland (falls zutreffend) des Abreiseorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abflugort – Postleitzahl Optional Die Postleitzahl des Abfahrtsorts (falls zutreffend).

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Abfahrtsort – Stadtteil Optional Der Stadtteil (falls zutreffend) des Startorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Land Optional Das Land, in dem die Reise endet.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Stadt Optional Die Ankunftsstadt.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Anzeigeadresse Optional Der Ankunftsort, der dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Zielort – Adresse Optional Die Adresse (falls zutreffend) des Zielorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend) des Zielorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Zielorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Ankunftsort – Stadtteil Optional Der Stadtteil (falls zutreffend) des Zielorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Dienstanbieter – Name Optional

Der Name des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Freitext. Beispiel: Name der Fluggesellschaft
Dienstanbieter – Bild Optional

Das Logo oder Bild des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Weitere Informationen finden Sie unter Bildspezifikationen.
Posterbilder Optional

Wenn mehrere Bilder zur Verfügung gestellt werden, wird nur ein Bild angezeigt. Empfohlenes Seitenverhältnis: 16:9

Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Reservierungs-ID Optional Die Reservierungs-ID für die Reservierung des Verkehrsmittels. Freier Text
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis der Reservierung.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen ist. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (bei zu langem Text werden möglicherweise Auslassungspunkte angezeigt)
Transportnummer Erforderlich Die Flug-, Bus-, Zug- oder Fähr-/Kreuzfahrtnummer. Freier Text
Boardingzeit Erforderlich Der Epochezeitstempel, der die Boardingzeit für die Reservierung darstellt (falls zutreffend) Epochen-Zeitstempel in Millisekunden

VehicleRentalReservationEntity

Attribut Anforderung Beschreibung Formatieren
Aktions-URI Erforderlich

Deeplink zur Entität in der Anbieter-App.

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

Uri
Titel Erforderlich Titel der Entität.

Freitext. Beispiel: „Avis Union Square SF“

Empfohlene Textgröße: max. 50 Zeichen
Abholzeit Erforderlich Der Epochenzeitstempel, der die Abholzeit der Reservierung darstellt. Epochen-Zeitstempel in Millisekunden
Rückgabezeit Optional Der Epochenzeitstempel, der die Abreisezeit für die Reservierung darstellt. Epochen-Zeitstempel in Millisekunden
Abholadresse – Land Optional Das Land des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Ort Optional Die Stadt des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – angezeigte Adresse Optional Der Abholort, der dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Straße Optional Die Adresse (falls zutreffend) des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Bundesland Optional Das Bundesland oder die Provinz (falls zutreffend) des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Abholadresse – Stadtteil Optional Der Stadtteil (falls zutreffend) des Abholorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Land Optional Das Land des Rückgabeorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Stadt Optional Die Stadt des Rücksendeorts.

Freier Text

Empfohlene Textgröße: max. 20 Zeichen
Rücksendeadresse – Anzeigeadresse Optional Der Rückgabeort, der dem Nutzer angezeigt wird.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Straße Optional Die Adresse (falls zutreffend) des Rücksendeorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse (Bundesstaat) Optional Das Bundesland oder die Provinz (falls zutreffend) des Rücksendeorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Absenderadresse – Postleitzahl Optional Die Postleitzahl (falls zutreffend) des Rückgabeorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Rücksendeadresse – Wohnort Optional Der Stadtteil (falls zutreffend) des Rückgabeorts.

Freier Text

Empfohlene Textgröße: maximal 20 Zeichen
Dienstanbieter – Name Optional

Der Name des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Freitext. Beispiel: „Avis Car Rental“
Dienstanbieter – Bild Optional

Das Logo oder Bild des Dienstanbieters.

Hinweis:Für den Dienstanbieter sind entweder Text oder Bilder erforderlich.

Weitere Informationen finden Sie unter Bildspezifikationen.
Posterbilder Optional

Wenn mehrere Bilder zur Verfügung gestellt werden, wird nur ein Bild angezeigt. Empfohlenes Seitenverhältnis: 16:9

Weitere Informationen finden Sie unter Bildspezifikationen.
Beschreibung Optional

Ein einzelner Textabschnitt zur Beschreibung der Entität.

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

Freier Text

Empfohlene Textgröße: 180 Zeichen
Untertitelliste Optional

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

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

Freier Text

Empfohlene Textgröße für jede Untertitelung: max. 50 Zeichen
Bestätigungs-ID Optional Die Bestätigungs-ID für die Reservierung des Mietwagens. Freier Text
Preis – Aktueller Preis Bedingt erforderlich

Der aktuelle Preis der Reservierung.

Muss angegeben werden, wenn ein durchgestrichener Preis angegeben ist.

Freier Text
Preis – Durchgestrichener Preis Optional Der ursprüngliche Preis der Reservierung, der in der Benutzeroberfläche durchgestrichen ist. Freier Text
Zusatzinformationen zum Preis Optional Preishinweis für ein Angebot, ein Ereignis oder einen Rabatt für Mitglieder, falls verfügbar.

Freier Text

Empfohlene Textgröße: weniger als 45 Zeichen (zu langer Text enthält möglicherweise Auslassungspunkte)

Bildspezifikationen

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

Seitenverhältnis Mindestanzahl Pixel Empfohlene Pixel

Quadrat (1 × 1)

Bevorzugt

 300 × 300 1200 × 1200
Querformat (1,91 × 1) 600 × 314 1200 × 628
Hochformat (4 : 5) 480 x 600 960 × 1.200

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

Dateiformate

PNG, JPG, statisches GIF, WebP

Maximale Dateigröße

5.120 KB

Weitere Empfehlungen

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

Content-Kategorie

Mit der Inhaltskategorie können Apps Inhalte veröffentlichen, die zu mehreren Kategorien gehören. Die Inhalte werden dabei einigen der vordefinierten Kategorien zugeordnet:

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

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

Richtlinien für die Verwendung der Inhaltskategorien

  1. Einige Entitäten wie ArticleEntity und GenericFeaturedEntity können jede der Inhaltskategorien verwenden. Bei anderen Entitäten wie EventEntity, EventReservationEntity und PointOfInterestEntity sind nur einige dieser Kategorien zulässig. Sehen Sie sich die Liste der Kategorien an, die für einen Entitätstyp infrage kommen, bevor Sie die Liste füllen.

  2. Verwenden Sie für einige Inhaltskategorien den spezifischen Entitätstyp anstelle einer Kombination aus den generischen Entitäten und der ContentCategory:

    • TYPE_MOVIES_AND_TV_SHOWS: Sehen Sie sich die Entitäten aus dem Leitfaden zur YouTube TV-Integration an, bevor Sie die generischen Entitäten verwenden.
    • TYPE_BOOKS: Sehen Sie sich die EbookEntity an, bevor Sie die generischen Entitäten verwenden.
    • TYPE_AUDIOBOOKS: Schauen Sie sich Hörbuchentität an, bevor Sie die generischen Entitäten verwenden.
    • TYPE_SHOPPING: Sehen Sie sich ShoppingEntity an, bevor Sie die generischen Entitäten verwenden.
    • TYPE_FOOD_AND_DRINK: Prüfen Sie die Entitäten im Food Integration Guide, bevor Sie die generischen Entitäten verwenden.

  3. Das Feld „ContentCategory“ ist optional und sollte leer bleiben, wenn der Inhalt zu keiner der oben genannten Kategorien gehört.

  4. Wenn mehrere Inhaltskategorien angegeben werden, ordnen Sie sie in der Reihenfolge ihrer Relevanz für die Inhalte an. Die relevanteste Inhaltskategorie muss dabei an erster Stelle stehen.

Schritt 2: Clusterdaten angeben

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

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

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

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishContinuationCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteContinuationCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Mit dieser API wird geprüft, ob der Dienst für die Integration verfügbar ist und ob die Inhalte auf dem Gerät dargestellt 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, finden innerhalb einer Transaktion die folgenden Aktionen statt:

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

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

publishFeaturedCluster

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

Kotlin

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

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

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

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

Tritt ein Fehler auf, wird die gesamte Anfrage abgelehnt und der vorhandene Status beibehalten.

publishContinuationCluster

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

Kotlin

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

Java

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

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

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

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

publishUserAccountManagementRequest

Mit dieser API wird eine Anmeldekarte veröffentlicht. Über die Anmeldeaktion werden Nutzer zur Anmeldeseite der App weitergeleitet, damit sie Inhalte veröffentlichen (oder stärker 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 „Titel“ angegeben werden.

Auf der Karte angezeigtes Bild

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

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

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

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

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

updatePublishStatus

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

  • Es ist wichtig, den Status in allen Szenarien anzugeben, auch wenn die Inhalte veröffentlicht wurden (STATUS == PUBLISHED), um Dashboards zu erstellen, in denen dieser explizite Status verwendet wird, um den Zustand und andere Messwerte deiner Integration zu vermitteln.
  • Wenn keine Inhalte veröffentlicht werden, der Integrationsstatus aber nicht fehlerhaft ist (STATUS == NOT_PUBLISHED), kann Google Warnungen in den Dashboards zur App-Integrität vermeiden. Hiermit wird bestätigt, dass Inhalte aufgrund einer erwarteten Situation aus Sicht des Anbieters nicht veröffentlicht werden.
  • Sie hilft Entwicklern, Aufschluss darüber zu geben, wann die Daten veröffentlicht werden und wann nicht.
  • Google kann die Statuscodes verwenden, um Nutzer zu bestimmten Aktionen in der App anzuregen, damit sie die App-Inhalte sehen oder überwinden können.

Folgende Veröffentlichungsstatuscodes sind zulässig:

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

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

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

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

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

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

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

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

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

Wenn die Inhalte nicht veröffentlicht werden, weil ein Nutzer nicht angemeldet ist, empfiehlt Google, die Anmeldekarte zu veröffentlichen. Wenn Anbieter die Anmeldekarte aus irgendeinem Grund nicht veröffentlichen können, empfehlen wir, die API updatePublishStatus mit dem Statuscode NOT_PUBLISHED_REQUIRES_SIGN_IN aufzurufen.

Kotlin

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

Java

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

deleteRecommendationClusters

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

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

deleteFeaturedCluster

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

deleteContinuationCluster

Mit dieser API können Sie den Inhalt eines Fortsetzungsclusters löschen.

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

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

deleteUserManagementCluster

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

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

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

deleteClusters

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

Kotlin

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

Java

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

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

Fehlerbehandlung

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

Kotlin

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

Java

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

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

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

Schritt 3: Mit Broadcast-Intents umgehen

Zusätzlich zu API-Aufrufen für die Veröffentlichung von Inhalten über einen Job muss auch eine BroadcastReceiver eingerichtet werden, um die Anfrage für die Veröffentlichung von Inhalten zu erhalten.

Das Ziel von Broadcast-Intents besteht hauptsächlich darin, die App wieder zu aktivieren und die Datensynchronisierung zu erzwingen. Broadcast-Intents sind nicht für häufiges Senden vorgesehen. Sie wird nur ausgelöst, wenn Google Engage für Agenturen feststellt, dass der Inhalt möglicherweise veraltet ist (z. B. eine Woche alt). So ist die Wahrscheinlichkeit höher, dass Nutzer aktuelle Inhalte sehen, auch wenn die Anwendung seit einiger Zeit nicht ausgeführt wurde.

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

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

Kotlin

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

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

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

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

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

Java

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

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

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

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

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

}
  • Deklariere eine Implementierung statisch mit dem <receiver>-Tag in der Datei AndroidManifest.xml. So kann die Anwendung Broadcast-Intents empfangen, wenn sie nicht ausgeführt wird, und die Inhalte veröffentlichen.
<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

Der Dienst sendet die folgenden Intents:

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

Integrationsablauf

Eine detaillierte Anleitung zur Überprüfung Ihrer Integration nach ihrer Fertigstellung finden Sie im Workflow für die Engage-Entwicklerintegration.

Häufig gestellte Fragen

Häufig gestellte Fragen zum Engage SDK

Kontakt

Falls während des Integrationsprozesses Fragen auftauchen, wenden Sie sich bitte an Engage-developers@google.com.

Nächste Schritte

Nach Abschluss dieser Integration sind folgende Schritte erforderlich:

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