Feed erstellen

Der Medienfeed ist ein JSON-Objekt mit einer Sammlung von Entitäten, die den Medieninhalt in Ihrem Katalog darstellen, z. B. TV-Serien, Filme, Songs, Alben und mehr. Der erste Schritt im Onboardingprozess ist die Entwicklung Ihrer Feeds. Wenn die Dateien bereit sind, müssen Sie den Feed über eine der unterstützten Hostingmethoden hosten, damit Google ihn regelmäßig abrufen kann.

Anforderungen an das Feeddateiformat

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

  • Die Feeddatei muss die Dateierweiterung .json haben.
  • Verschlüsseln Sie die Feeddatei nicht.
  • Codieren Sie die Feeddatei in UTF-8 (prüfen Sie die Einstellung im Dateieditor).

    alt_text

  • Teilen Sie die Datei in mehrere Dateien auf, wenn Ihre Feeddatei (unkomprimiert) größer als 1 GB ist.

  • 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 kleiner als 1 GB ist, gibt es keine Begrenzung für die Anzahl der Entitäten, die Sie in eine einzelne Datei aufnehmen können.
  • Die Datei muss ohne BOM gemäß der JSON-Spezifikation codiert sein. Zum Prüfen auf einem Linux-Betriebssystem darf hexdump file.json | head -n 1 nicht mit BBEF an der Adresse 0x00 beginnen.

Feedarten

Produktionsfeed

  • Das sind die JSON-Feeddateien, die Ihren gesamten Katalog für Google darstellen. Im folgenden Abschnitt erfahren Sie, wie Sie einen Feed erstellen.
  • Das ist der einzige Feed, den Sie benötigen, wenn Sie Google zum ersten Mal einbinden.
  • Nachdem dieser Feed an Google gesendet wurde, wird er einige Male eingehend analysiert und iteriert, um eine höhere Qualität zu gewährleisten – ohne dass die Menge der erfassten Informationen und ihre Richtigkeit vor der Aufnahme und Einführung der Informationen korrekt ist.

Staging-Feed

  • In bestimmten Fällen ist eine Erweiterung des Produktionsfeeds erforderlich. Hier ein paar Beispiele:
    • Erweiterung des Feeds auf neue, noch nicht eingeführte Entitätstypen.
    • Erweiterung des Feeds um eine große Anzahl neuer Entitäten/Metadaten zur Einführung in neuen Sprachen.
    • Ausweitung des Feeds auf neue Plattformtypen Das ist beispielsweise der Fall, wenn der Produktionsfeed nur in der Google Suche verfügbar ist und du ihn jetzt auch auf Google TV ausweiten möchtest.
  • In solchen Fällen ist ein Staging-Feed erforderlich. Dieser Feed ist eine Kopie des Produktionsfeeds, außer dass er zusätzliche Metadaten enthält, z. B. Deeplinks für eine neue Plattform oder Metadaten für eine neue Sprache.
  • Ähnlich wie im Produktionsfeed wird dieser Vorgang einige Male eingehend analysiert und iteriert, sodass ein höherer Qualitätsstandard für die Menge der erfassten Informationen und ihre Richtigkeit erreicht wird. Sobald der Qualitätsstandard erreicht ist, ersetzt dieser Feed den aktuellen Produktionsfeed.
  • Mit diesem Feed können wir den ersten Start von den zusätzlichen Markteinführungen trennen und alle erforderlichen Tests durchführen, ohne den Produktionsfeed zu beeinträchtigen. So werden Unterbrechungen für die Endnutzer vermieden.

Wenn Sie Fragen haben, wenden Sie sich bitte an Ihren Google-Ansprechpartner.

Feeddatei erstellen

Beachten Sie beim Erstellen des Feeds die folgenden Best Practices:

  1. Beispielfeed mit einer kleinen Gruppe von Entitäten erstellen

    Bevor Sie einen Feed erstellen, der den gesamten Inhalt Ihres Katalogs enthält, sollten Sie einen Beispielfeed mit nur wenigen Entitäten erstellen. Bei der Arbeit an Ihrem Feed können wahrscheinlich Probleme auftreten. Wenn Sie die Größe der Entitäten festlegen, können Sie diese Fehler und Warnungen einfacher beheben.

  2. Beispielfeed prüfen

    Wir stellen Tools bereit, die sicherstellen, dass Ihr Feed den Spezifikationen entspricht. Wir empfehlen die Verwendung dieser Tools, um alle Fehler und Warnungen in Ihrem Beispielfeed zu beheben.

  3. Produktionsfeed erstellen

    Nachdem Sie sich vergewissert haben, dass Sie eine gute Struktur für eine kleine Gruppe von 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 für eine Entität im Katalog aber dennoch typisch ist.
  2. Verwenden Sie das Tool zur Validierung von Datenfeeds, um nach Syntaxfehlern und fehlenden erforderlichen Properties zu suchen. Weitere Informationen 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

Die folgenden Tools helfen dir dabei, einen Beispielfeed mit den Spezifikationen für strukturierte Daten von Google für Medienfeeds zu validieren.

  • Datenfeed-Validierungstool

    Mit dem Tool zur Validierung von Datenfeeds kann immer nur eine Entität validiert werden. Mit diesem Tool können Sie eine Beispielentität aus Ihrem Katalog auf strukturelle Fehler und häufige Inhaltsfehler überprüfen. Weitere Informationen zum Tool

  • JSON-Validierungstool

    Das JSON-Schemavalidierungstool kann alle Dateien in einem Feed validieren. Verwende 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, maximieren Sie den Feed, sodass alle Entitäten in Ihrem Katalog enthalten sind.
  2. Verwenden Sie das Datenfeed-Validierungstool häufig, um eine kleine Anzahl von Entitäten in Ihrem Feed gleichzeitig zu validieren. Wenn Sie eine große Anzahl von Entitäten in das Tool einfügen, wird der Webbrowser möglicherweise eingefroren. 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 Elemente in Ihrem Katalog vergleichen.