Feeds

Zuerst erstellst du deine Feeds. Danach wertet Google sie aus.

Feeds erstellen

  1. Feeds erstellen Die meisten deiner Inventardaten werden über Feeds an Google gesendet. Erstellen Sie zuerst Ihren Merchant-Feed (und gegebenenfalls Ihren Dienstleistungsfeed):

    • Händlerfeed:Hier werden deine Händlerlinks und Aktionslinks für Händler beschrieben.
    • Dienstleistungsfeed (optional / nicht empfohlen): Es wird nicht empfohlen, Dienstleistungsfeeds für neue Einbindungen zu implementieren. Wenn Sie Ihre vorhandene Integration beibehalten möchten, folgen Sie dieser Legacy-Dokumentation.

    Pflicht- und empfohlene Felder

    Feed Feldname Beschreibung Erforderlich?
    Händler merchant_id Eindeutige Kennung für den Händler Ja
    Händler name Name des Händlers Ja
    Händler geo Adresse und geografische Koordinaten des Händlers Ja
    Händler Telefon Telefonnummer des Händlers Ja
    Händler category Ortstyp des Händlers Empfohlen
    Händler action_link Informationen zu händlerspezifischen Deeplinks Ja
    Händler brand_id [Marken-ID] String, der die zu verwendende Marke für Nutzer identifiziert Optional

    Sehen Sie sich zuerst die Beispielfeeds an.

    Weitere Informationen zur Angabe von Aktionslinks in Startintegrationsfeeds findest du hier.

    Füge in jeden deiner Feeds Feedmetadaten ein, die Google anweisen, wie der Feed zu interpretieren ist.

    Im Folgenden siehst du ein Feedmetadaten-Snippet:

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
    
  2. Feeds exportieren: Das Feedformat wird mit der Protobuf-3-Syntax beschrieben. Sie können jedoch in den oben genannten Beispielen auf das JSON-Format verweisen. Wir empfehlen Ihnen, die Feeds im JSON-Format hochzuladen.

    Wenn Sie wirklich mit dem PB3-Format fortfahren möchten, finden Sie allgemeine Informationen zur Verwendung von Protokollpuffern zum Generieren einer PB3-Datei unter Grundlagen des Protokollzwischenspeichers: Java.

  3. Feeds in deine SFTP-Dropbox hochladen: Verwende zum Hochladen deiner Feeds die SFTP-Dropbox-Informationen, die du von Google erhalten hast, und den privaten Schlüssel, den du bei der Einrichtung erstellt hast. Der SFTP-Server von Google ist unter sftp://partnerupload.google.com auf Port 19321 verfügbar.

    Laden Sie Ihre Dateien mit eindeutigen Namen hoch, z. B. mit einem Namen, der einen Zeitstempel enthält. Eindeutige Namen erleichtern die Fehlerbehebung und ermöglichen Abfragen des Feedstatus.

    Beachte die folgenden Richtlinien, um die Größe der Feeds und die Auslieferungshäufigkeit zu bestimmen:

    • Größe von Feeddateien und Shards:
      • Die Feeddatei darf nach der Komprimierung unter 200 MB liegen. Mit gzip komprimieren
      • Wenn Ihre Datei nach der Komprimierung mehr als 200 MB erreichen kann, teilen Sie sie anhand der Anleitung Feeddateien fragmentieren in mehrere Fragmente auf. Die Startintegration allein wird jedoch wahrscheinlich nicht das Limit von 200 MB erreichen.
    • Häufigkeit der vollständigen Aktualisierungen:
      • Einmal täglich wird ein vollständiger Händlerfeed bereitgestellt.
      • (Falls implementiert) Einmal täglich wird ein vollständiger Dienstleistungsfeed bereitgestellt.

Google wertet Feeds aus

Nachdem du deine Feeds hochgeladen hast, verarbeitet und bewertet Google sie in Bezug auf Qualität und Vollständigkeit. Dabei werden verschiedene Faktoren berücksichtigt:

  • Feeds müssen die Spezifikationen erfüllen.
  • Feeds müssen alle erforderlichen Felder enthalten.
  • Für jeden Händler ist mindestens ein action_link- oder ein Servicedienst mit mindestens action_link definiert.
  • Der Großteil deiner Händlerdaten muss mit Google Maps-Standorten übereinstimmen.