Der Medienfeed ist ein JSON-Objekt, das eine Sammlung von Entitäten enthält, die die Medieninhalte in deinem Katalog darstellen, z. B. Serien, Filme, Songs und Alben. Der erste Schritt im Onboarding-Prozess ist die Entwicklung Ihrer Feeds. Sobald die Dateien bereit sind, müssen Sie den Feed mit einer der unterstützten Hosting-Methoden hosten, damit Google ihn regelmäßig abrufen kann.
Anforderungen an das Feeddateiformat
Für die Feeddatei(en) gelten die folgenden Anforderungen:
- Die Feeddatei muss die Dateiendung
.jsonhaben. - Verschlüsseln Sie Ihre Feeddatei nicht.
Codieren Sie Ihre Feeddatei im UTF-8-Format (prüfen Sie die Einstellung Ihres Dateieditors).
Teilen Sie die Datei in mehrere Dateien auf, wenn Ihre Feeddatei größer als 1 GB (unkomprimiert) ist.
Wir empfehlen, für jeden Entitätstyp eine eigene Datei zu erstellen (z. B.
tvseries.json,tvseasons.json,tvepisodes.json,movies.jsonusw.).- Wenn eine dieser Dateien größer als 1 GB ist, teilen Sie die Entitäten in mehrere Dateien auf (z. B.
tvepisodes_01.json,tvepisodes_02.jsonusw.). - Solange die Dateigröße unter 1 GB liegt, gibt es keine Beschränkung für die Anzahl der Entitäten, die Sie in eine einzelne Datei aufnehmen können.
- Wenn eine dieser Dateien größer als 1 GB ist, teilen Sie die Entitäten in mehrere Dateien auf (z. B.
Die Datei muss gemäß der JSON-Spezifikation ohne BOM codiert sein. Bei einem Linux-Betriebssystem darf
hexdump file.json | head -n 1nicht mitBBEFan Adresse 0x00 beginnen.
Feedarten
Produktionsfeed
- Dies ist die Gruppe von JSON-Feeddateien, die zusammen den gesamten Katalog darstellen, den Sie auf Google veröffentlichen möchten. Im Abschnitt unten erfahren Sie, wie Sie einen Feed erstellen.
- Dies ist der einzige Feed, den Sie benötigen, wenn Sie zum ersten Mal eine Integration mit Google vornehmen.
- Nachdem dieser Feed bei Google eingereicht wurde, wird er umfassend analysiert und mehrmals überarbeitet, um die Qualität der erfassten Informationen und deren Richtigkeit zu verbessern, bevor er schließlich aufgenommen und veröffentlicht wird.
Staging-Feed
- In bestimmten Anwendungsfällen muss der Produktionsfeed erweitert werden. Hier einige Beispiele für solche Szenarien:
- Erweiterung des Feeds um neue Entitätstypen, die bisher nicht eingeführt wurden.
- Erweiterung des Feeds um eine große Anzahl neuer Entitäten/Metadaten für die Einführung in neuen Regionen.
- Erweiterung des Feeds auf neue Plattformtypen. Beispiel: Der Produktionsfeed wird nur in der Google Suche eingeführt und du möchtest die Einführung jetzt auf Google TV ausweiten.
- In solchen Fällen ist ein Staging-Feed erforderlich. Dieser Feed ist eine Kopie des Produktionsfeeds, enthält jedoch zusätzliche Metadaten, z. B. Deeplinks für eine neue Plattform oder Metadaten für eine neue Sprache.
- Ähnlich wie der Produktionsfeed wird dieser Feed umfassend analysiert und mehrmals iteriert, um eine höhere Qualität in Bezug auf die Menge der erfassten Informationen und deren Richtigkeit zu erreichen. Sobald die Qualitätsanforderungen erfüllt sind, 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 werden Unterbrechungen für die Endnutzer vermieden.
Wenden Sie sich bei Fragen zu den oben genannten Punkten an Ihren Google-Ansprechpartner.
Feeddatei erstellen
Beachten Sie beim Erstellen des Feeds die folgenden Best Practices:
Beispielfeed mit einer kleinen Anzahl von Entitäten erstellen
Bevor du einen Feed erstellst, der alle Inhalte deines Katalogs enthält, solltest du einen Beispielfeed mit nur wenigen Entitäten erstellen. Bei der Arbeit an Ihrem Feed treten wahrscheinlich Probleme auf. Wenn Sie die Größe der Entitätenmenge begrenzen, können Sie diese Fehler und Warnungen leichter beheben.
-
Wir stellen Tools zur Verfügung, mit denen Sie prüfen können, ob Ihr Feed den Spezifikationen entspricht. Wir empfehlen, diese Tools zu verwenden, um alle Fehler und Warnungen in Ihrem Beispielfeed zu beheben.
-
Wenn Sie sicher sind, dass die Struktur für die kleine Gruppe von Entitäten gut ist, entwickeln Sie einen Feed für Ihren gesamten Katalog.
Beispielfeed erstellen
- Wählen Sie ein repräsentatives Rechtssubjekt aus Ihrem Katalog aus. Wählen Sie eine Entität mit einer einigermaßen komplexen Struktur aus, die aber dennoch typisch für eine Entität im Katalog ist.
- Verwenden Sie das JSON-Schema-Validierungstool, um nach Syntaxfehlern und fehlenden erforderlichen Attributen zu suchen. (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:
JSON-Schema-Validierungstool
Mit dem JSON-Schemavalidierungstool werden alle Dateien in einem Feed vor dem Upload lokal validiert. Verwenden Sie dieses Tool während der Entwicklung des Feeds, um häufige Struktur- und Typfehler zu vermeiden. Weitere Informationen zum Tool
Katalog-Properties in der Search Console
Nachdem Ihr Google-Ansprechpartner Ihre Search Console-Katalog-Property aktiviert und Ihr Beispiel- oder Staging-Feed aufgenommen wurde, können Sie mit Katalog-Properties in der Search Console Validierungsfehler, Warnungen und Aufnahmediagnosen auf Entitätsebene prüfen.
Produktionsfeed erstellen
- Sobald alle strukturellen Fehler und Warnungen im Beispielfeed behoben sind, erweitern Sie den Feed, um alle Entitäten in Ihrem Katalog aufzunehmen.
- Führe das JSON-Schema-Validierungstool für deine erweiterten Feeddateien aus und prüfe nach dem Upload die Katalog-Properties in der Search Console, um sicherzustellen, dass keine Validierungsfehler vorliegen. 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.