Der Medien-Feed ist ein JSON-Objekt, das eine Sammlung von Entitäten enthält, die die Medieninhalte in Ihrem Katalog wie Serien, Filme, Songs und Alben. Der erste Schritt im besteht der Onboardingprozess darin, mit der Entwicklung Ihrer Feeds zu beginnen. Sobald die Dateien bereit sind, müssen Sie sie hosten. den Feed mithilfe einer der unterstützten Hostingmethoden, die Google regelmäßig abrufen kann.
Anforderungen an das Feeddateiformat
Für die Feeddatei(en) gelten folgende Anforderungen:
- Die Feeddatei muss die Dateiendung
.json
haben. - Verschlüsseln Sie die Feeddatei nicht.
Codieren Sie Ihre Feeddatei in UTF-8 (überprüfen Sie die Einstellungen für den Dateieditor).
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
odermovies.json
.- Wenn eine dieser Dateien 1 GB überschreitet, teilen Sie die zugehörigen Entitäten in mehrere
Dateien, z. B.
tvepisodes_01.json
odertvepisodes_02.json
. - Solange die Datei 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.
- Wenn eine dieser Dateien 1 GB überschreitet, teilen Sie die zugehörigen Entitäten in mehrere
Dateien, z. B.
Achten Sie darauf, dass die Datei gemäß der JSON-Spezifikation ohne BOM codiert ist. Um nach einem Linux-Betriebssystem zu suchen, darf
hexdump file.json | head -n 1
nicht mitBBEF
bei der Adresse 0x00 beginnen.
Feedarten
Produktionsfeed
- Dies steht für die JSON-Feeddatei(en), die zusammen Ihren gesamten Katalog repräsentiert. die Sie bei Google veröffentlichen möchten. Wie Sie einen Feed erstellen, erfahren Sie im folgenden Abschnitt.
- Dies ist der einzige Feed, den Sie benötigen, wenn Sie zum ersten Mal eine Integration in Google vornehmen.
- Sobald dieser Feed an Google gesendet wurde, wird er anhand einiger um die Qualität der erfassten Informationen und deren bevor sie schließlich aufgenommen und gestartet werden.
Staging-Feed
- In bestimmten Anwendungsfällen muss der Produktionsfeed erweitert werden. Einige Beispiele
der folgenden Szenarien sind:
<ph type="x-smartling-placeholder">
- </ph>
- Der Feed wurde um neue Entitätstypen erweitert, die noch nicht eingeführt wurden.
- Erweiterung des Feeds auf eine große Anzahl neuer Entitäten/Metadaten für die Einführung in neuen Sprachen.
- Ausweitung des Feeds auf neue Plattformtypen. Wenn der Produktionsfeed nur die in der Google Suche eingeführt wurden, und Sie möchten die Einführung jetzt auch auf Google TV ausweiten.
- In diesen Fällen ist ein Staging-Feed erforderlich. Dieser Feed ist eine Kopie des Produktionsfeeds, mit folgenden Ausnahmen: Es enthält zusätzliche Metadaten wie Deeplinks für eine neue Plattform oder Metadaten für eine neue Sprache. und so weiter.
- Ähnlich wie beim Produktionsfeed wird auch dieser intensiv analysiert und einige Male wiederholt, um höhere Qualität bzgl. der erfassten Informationsmenge und deren Richtigkeit. Sobald die Qualitätsstandards erreicht wurden, ersetzt dieser Feed den aktuellen Produktionsfeed und wird Neuer Produktionsfeed.
- Dieser Feed ermöglicht es uns, die Ersteinführung von den zusätzlichen Markteinführungen zu trennen, erforderlichen Tests durchgeführt werden, ohne dass sich dies auf den Produktionsfeed auswirkt. So vermeiden Sie Unterbrechungen am Ende. User Experience ausmacht.
Wenden Sie sich an Ihren Google-Ansprechpartner, um etwaige Fragen zu den oben genannten Punkten zu klären.
Feeddatei erstellen
Beachten Sie beim Erstellen des Feeds die folgenden Best Practices:
Beispielfeed mit einer kleinen Gruppe von Entitäten erstellen
Bevor Sie einen Feed erstellen, der alle Inhalte Ihres Katalogs enthält, sollten Sie ein Beispielfeed mit nur einer kleinen Gruppe von Entitäten. Bei der Arbeit an Ihrem Feed werden Sie wahrscheinlich auf Probleme. Wenn Sie die Größe der Gruppe von Entitäten begrenzen, können Sie diese Fehler beheben und Warnungen leichter erkennen.
-
Wir stellen Ihnen Tools zur Verfügung, mit denen Sie sicherstellen können, dass Ihr Feed den Spezifikationen entspricht. Wir empfehlen, verwenden Sie diese Tools, um alle Fehler und Warnungen in Ihrem Beispielfeed zu beheben.
-
Nachdem Sie sich vergewissert haben, dass Sie eine gute Struktur für die kleine Gruppe Ihrer Entitäten haben, entwickeln Sie einen Feed für Ihren gesamten Katalog.
Beispielfeed erstellen
- 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 jedoch typisch ist.
- Verwenden Sie das Tool zur Datenfeed-Validierung, um nach Syntaxfehlern und fehlenden erforderlichen Eigenschaften 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
Mit den folgenden Tools können Sie einen Beispielfeed mit den strukturierten Daten von Google validieren. Spezifikationen für Medienfeeds.
Tool zur Datenfeed-Validierung
Mit dem Data Feed Validation Tool kann jeweils nur ein Element validiert werden. Mit diesem Tool eine Stichprobe validieren Entität aus Ihrem Katalog auf Strukturfehler und häufige Inhaltsfehler hin. Weitere Informationen Weitere Informationen zum Tool
Tool zur JSON-Schemavalidierung
Mit dem Tool zur JSON-Schemavalidierung können alle Dateien in einem Feed validiert werden. Verwenden Sie dieses Tool während der Entwicklung des Feeds, um häufige Strukturfehler zu vermeiden. Weitere Informationen zu den hier.
Produktionsfeed erstellen
- Sobald alle Fehler und Warnungen im Beispielfeed behoben sind, maximieren Sie den Feed. Entitäten in Ihrem Katalog.
- Datenfeed-Validierungstool verwenden um eine kleine Anzahl von Entitäten in Ihrem Feed gleichzeitig zu validieren. kann der Webbrowser einfrieren.) Prüfen, ob Ihr Feed alle Entitäten enthält in Ihrem Katalog, indem Sie die Anzahl der Entitäten in Ihrem Feed mit der Anzahl der Elemente in Ihrem Katalog.