Feed erstellen

Der Medienfeed ist ein JSON-Objekt, das eine Sammlung von Entitäten enthält, die die Medieninhalte in deinem Katalog repräsentieren, z. B. Serien, Filme, Songs und Alben. Der erste Schritt beim Onboarding besteht darin, Ihre Feeds zu entwickeln. Sobald die Dateien fertig sind, müssen Sie den Feed mit einer der unterstützten Hostingmethoden hosten, damit Google ihn regelmäßig abrufen kann.

Formatanforderungen an Feeddateien

Für die Feeddatei(en) gelten die folgenden Anforderungen:

  • Die Feeddatei muss die Dateiendung .json haben.
  • Verschlüsseln Sie Ihre Feeddatei nicht.
  • Codieren Sie Ihre Feeddatei in UTF-8 (prüfen Sie die Einstellung Ihres Dateieditors).

    alt_text

  • Wenn die Feeddatei größer als 1 GB ist (unkomprimiert), teilen Sie sie in mehrere Dateien auf.

  • Wir empfehlen, eine Datei pro Entitätstyp zu erstellen (z. B. tvseries.json, tvseasons.json, tvepisodes.json, movies.json usw.).

    • Wenn eine dieser Dateien 1 GB überschreitet, teilen Sie die Entitäten in mehrere Dateien auf (z. B. tvepisodes_01.json, tvepisodes_02.json usw.).
    • Solange die Dateigröße unter 1 GB liegt, ist die Anzahl der Entitäten, die in einer einzelnen Datei enthalten sein können, nicht begrenzt.
  • Die Datei muss gemäß der JSON-Spezifikation ohne BOM codiert sein. Unter Linux darf hexdump file.json | head -n 1 nicht mit BBEF an der Adresse 0x00 beginnen.

Feedarten

Produktionsfeed

  • Dies ist die JSON-Feeddatei bzw. die JSON-Feeddateien, die zusammen Ihren gesamten Katalog darstellen, den Sie auf Google veröffentlichen möchten. Im folgenden Abschnitt erfahren Sie, wie Sie einen Feed erstellen.
  • Dieser Feed ist der einzige, den Sie benötigen, wenn Sie Google zum ersten Mal einbinden.
  • Nachdem dieser Feed an Google gesendet wurde, wird er ausführlich analysiert und mehrmals iteriert, um eine höhere Qualität in Bezug auf die Menge der erfassten Informationen und deren Richtigkeit zu erreichen, bevor er endgültig aufgenommen und veröffentlicht wird.

Staging-Feed

  • Für bestimmte Anwendungsfälle ist die Erweiterung des Produktionsfeeds erforderlich. Beispiele für solche Szenarien:
    • Der Feed wurde um neue Entitätstypen erweitert, die bisher nicht eingeführt wurden.
    • Der Feed wurde um eine große Anzahl neuer Entitäten/Metadaten erweitert, die in neuen Sprachen eingeführt werden.
    • Ausweitung des Feeds auf neue Plattformtypen Beispiel: Der Produktionsfeed wird nur in der Google Suche veröffentlicht und Sie möchten die Einführung auf Google TV ausweiten.
  • In solchen Fällen ist ein Staging-Feed erforderlich. Dieser Feed ist eine Kopie des Produktionsfeeds, enthält aber zusätzliche Metadaten, z. B. Deeplinks für eine neue Plattform oder Metadaten für eine neue Sprache.
  • Ähnlich wie beim Produktionsfeed wird dieser Feed ausführlich analysiert und mehrmals iteriert, um eine höhere Qualität hinsichtlich der erfassten Informationen und ihrer Richtigkeit zu erreichen. Sobald die Qualitätsstufe erreicht ist, ersetzt dieser Feed den aktuellen Produktionsfeed und wird zum neuen Produktionsfeed.
  • Mit diesem Feed können wir die erste Einführung von den zusätzlichen Einführungen trennen und alle erforderlichen Tests durchführen, ohne den Produktionsfeed zu beeinträchtigen. So wird sichergestellt, dass die Nutzererfahrung nicht beeinträchtigt wird.

Wenden Sie sich an Ihren Google-Ansprechpartner, um eventuelle Fragen zu den oben genannten Punkten zu klären.

Feeddatei erstellen

Beachten Sie beim Erstellen des Feeds die folgenden Best Practices:

  1. Beispielfeed mit wenigen Entitäten erstellen

    Bevor Sie einen Feed erstellen, der alle Inhalte in Ihrem Katalog enthält, empfehlen wir Ihnen, einen Beispielfeed mit nur wenigen Entitäten zu erstellen. Bei der Arbeit an Ihrem Feed werden Sie wahrscheinlich auf Probleme stoßen. Wenn Sie die Größe der Entitätsgruppe begrenzen, können Sie diese Fehler und Warnungen leichter beheben.

  2. Beispielfeed validieren

    Wir stellen Tools zur Verfügung, mit denen Sie dafür sorgen können, dass Ihr Feed den Spezifikationen entspricht. Wir empfehlen Ihnen, diese Tools zu verwenden, um alle Fehler und Warnungen in Ihrem Beispielfeed zu beheben.

  3. Produktionsfeed erstellen

    Nachdem Sie überprüft haben, dass Sie eine gute Struktur für die kleine Gruppe Ihrer Entitäten haben, erstellen Sie einen Feed für Ihren gesamten Katalog.

Beispielfeed erstellen

  1. Wählen Sie eine repräsentative Entität aus Ihrem Katalog aus. Wählen Sie eine Entität mit einer relativ komplexen Struktur aus, die aber dennoch für eine Entität im Katalog typisch ist.
  2. Verwenden Sie das Tool zur Datenfeed-Validierung, um Syntaxfehler und fehlende erforderliche Properties zu prüfen. (Details hierzu finden Sie im nächsten Abschnitt.)

    Beispiel für einen Feed mit einer einzelnen Movie-Entität

    {
      "@context": "http://schema.org",
      "@type": "DataFeed",
      "dateModified": "2018-07-20T00:44:51Z",
      "dataFeedElement": [
        {
          "@context": ["http://schema.org", {"@language": "en"}],
          "@type": "Movie",
          "@id": "http://www.example.com/my_favorite_movie",
          "url": "http://www.example.com/my_favorite_movie",
          "name": "My Favorite Movie",
          "potentialAction": {
            "@type": "WatchAction",
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
              "inLanguage": "en",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform",
                "http://schema.googleapis.com/GoogleVideoCast"
              ]
            },
            "actionAccessibilityRequirement": {
              "@type": "ActionAccessSpecification",
              "category": "subscription",
              "requiresSubscription": {
                "@type": "MediaSubscription",
                "name": "Example Package",
                "commonTier": true,
                "@id": "[partner determined string]"
              },
              "availabilityStarts": "2018-07-21T10:35:29Z",
              "availabilityEnds": "2019-10-21T10:35:29Z",
              "eligibleRegion": [
                {
                  "@type": "Country",
                  "name": "US"
                },
                {
                  "@type": "Country",
                  "name": "CA"
                }
              ]
            }
          },
          "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
          "releasedEvent": {
            "@type": "PublicationEvent",
            "startDate": "2008-01-20",
            "location": {
              "@type": "Country",
              "name": "US"
            }
          },
          "description": "This is my favorite movie.",
          "actor": [
            {
              "@type": "Person",
              "name": "John Doe",
              "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
            },
            {
              "@type": "Person",
              "name": "Jane Doe",
              "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
            }
          ],
          "identifier": [
            {
              "@type": "PropertyValue",
              "propertyID": "IMDB_ID",
              "value":  "tt0123456"
            }
          ]
        }
      ]
    }

Beispielfeed validieren

Mit den folgenden Tools können Sie einen Beispielfeed anhand der Spezifikationen für strukturierte Daten von Google für Medienfeeds validieren.

  • Datenfeed-Validierungstool

    Mit dem Datenfeed-Validierungstool können Sie jeweils nur eine Entität validieren. Mit diesem Tool können Sie eine Beispielentität aus Ihrem Katalog auf strukturelle Fehler und häufige Inhaltsfehler prüfen. Weitere Informationen zum Tool

  • JSON Schema Validation Tool

    Mit dem JSON-Schema-Validierungstool können alle Dateien in einem Feed validiert werden. Verwenden Sie dieses Tool während der Entwicklung des Feeds, um häufige strukturelle Fehler zu vermeiden. Weitere Informationen zum Tool

Produktionsfeed erstellen

  1. Sobald alle Fehler und Warnungen im Beispielfeed behoben sind, erweitern Sie den Feed, um alle Entitäten in Ihrem Katalog aufzunehmen.
  2. Verwenden Sie das Datenfeed-Validierungstool häufig, um jeweils eine kleine Anzahl von Entitäten in Ihrem Feed zu validieren. Wenn Sie eine große Anzahl von Entitäten in das Tool einfügen, kann der Webbrowser einfrieren. Prüfen Sie, ob Ihr Feed alle Entitäten in Ihrem Katalog enthält, indem Sie die Anzahl der Entitäten in Ihrem Feed mit der Anzahl der Artikel in Ihrem Katalog vergleichen.