Merchant Center-Konto vorbereiten

Sie benötigen ein Merchant Center-Konto mit einem guten Ruf und genehmigte Produkte für Produkteinträge in Ihrem Konto. Weitere Informationen finden Sie in diesen Hilfeartikeln:

Nachdem Sie Ihr Merchant Center mit Produkten eingerichtet haben, müssen Sie die Anforderungen in diesem Abschnitt erfüllen, bevor Sie die API-Integration erstellen.

1. Merchant Center-Einstellungen

Achten Sie darauf, dass in Ihrem Google Merchant Center-Konto die folgenden Einstellungen konfiguriert sind:

1.1 Rückgabebedingungen

Sie müssen Ihre Rückgabebedingungen im Merchant Center festlegen, da dies eine Anforderung für den eingetragenen Händler ist und auf dem Bildschirm für die Kaufabwicklung darauf verwiesen wird. Die konfigurierten Richtlinien gelten weltweit für Ihr Konto. Sie können jedoch das Feedattribut return_policy_label verwenden, um eine bestimmte Rückgabebedingung auf eine Teilmenge von Produkten zu beschränken.

Wenn Ihr Merchant Center-Konto ein erweitertes Konto ist, müssen Ihre Rückgabebedingungen für jedes Unterkonto einzeln konfiguriert werden.

Sie müssen die Rücksendekosten, die Rücksendegeschwindigkeit (Frist) und einen Link zur vollständigen Richtlinie angeben. Weitere Informationen zum Konfigurieren von Rückgaben

1.2. Informationen zum Kundensupport

Sie müssen Ihre Kundensupportinformationen im Merchant Center angeben. Sie wird verwendet, um den Link „Händler kontaktieren“ auf der Bestellbestätigungsseite zu generieren. Weitere Informationen zum Festlegen von Kundensupportinformationen

2. Produktdaten

Sie müssen Ihren Produktfeed aktualisieren, um die Berechtigung zu signalisieren und Compliance-Daten anzugeben. Diese Informationen sind erforderlich, um die Abrechnung über UCP mit Google zu ermöglichen. So können Kundenservicemitarbeiter die Produktberechtigung ermitteln, die genauen Gesamtkosten berechnen und dem Nutzer die erforderlichen rechtlichen Warnungen anzeigen.

2.1. Voraussetzungen für den agentischen Checkout

Dadurch wird ein Produkt für die Zahlungsabwicklung auf Google aktiviert.

Dies wird über ein Produktattribut native_commerce mit einem einzelnen booleschen Wert angegeben. Wenn der Wert auf „false“ gesetzt ist oder fehlt, kann das Produkt nicht für den Bezahlvorgang verwendet werden.

2.2. Produktwarnungen

Dies ist für Artikel mit gesetzlichen Warnanforderungen erforderlich (z.B. California Proposition 65). Sie sind für die Einhaltung aller anwendbaren Gesetze verantwortlich, einschließlich der Anforderungen an Produktwarnungen. Diese Warnungen werden auf dem Bildschirm „Kasse“ gut sichtbar angezeigt, wenn Sie sie angeben.

Geben Sie die Attributgruppe consumer_notice mit zwei Unterattributen an:

  • consumer_notice_type: Muss legal_disclaimer, safety_warning oder prop_65 sein.
  • consumer_notice_message: String (max. 1.000 Zeichen). Die HTML-Tags <b>, <br> und <i> werden akzeptiert.

2.3. Produktkennzeichnung

Die id in Ihrem Produktfeed muss mit der Produkt-ID übereinstimmen, die von Ihrer Checkout API erwartet wird. Wenn sie übereinstimmen, müssen Sie nichts weiter tun. Andernfalls verwenden Sie das benutzerdefinierte Attribut merchant_item_id, um sie zuzuordnen.

2.4 Attribute Ihren Produkten hinzufügen

In den folgenden Beispielen werden verschiedene Möglichkeiten beschrieben, das Produkt im Merchant Center anzugeben.

2.4.1. Feeds

Wir empfehlen, eine zusätzliche Datenquelle zu erstellen (Anleitung). Sie können diese Informationen Ihrem primären Feed hinzufügen. Gehen Sie jedoch mit Vorsicht vor, da eine falsche Formatierung die reguläre Produktaufnahme beeinträchtigen kann.

Hinweis zur Syntax:Achten Sie darauf, dass komplexe Strings (z. B. die Prop 65-Mitteilung) keine Zeichen enthalten, die Ihr Dateiformat beschädigen (z. B. zusätzliche Kommas in einer CSV-Datei), es sei denn, sie werden richtig maskiert.

Textdateiformat:

ID native_commerce consumer_notice
11111 TRUE prop_65:This product can expose you...
22222 TRUE
33333 FALSE

XML-Format:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. Content API

Geben Sie die Attribute als benutzerdefinierte Attribute an. Sie müssen in eine products.insert-Anfrage mit dem vollständigen Produkt aufgenommen werden, da products.update keine Aktualisierung von „customAttributes“ unterstützt.

Beispiel:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. Merchant API

Geben Sie die Attribute als benutzerdefinierte Attribute an. Sie können sie zu Ihren vorhandenen accounts.productInputs.insert hinzufügen oder direkt mit accounts.productInputs.patch aktualisieren.

Beispiel für insert:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Beispiel für update:

Typ Name Wert
Pfadparameter productInput.name accounts/{account}/productInputs/en~US~11111
Suchparameter updateMask customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id
dataSource dataSources/{datasource} 
{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Produkteinschränkungen

Die folgenden Produktkategorien sind nicht für den Direktkauf geeignet. Achten Sie darauf, dass für diese Elemente native_commerce leer ist oder auf false gesetzt ist.

Finanzprodukte und Modelle für wiederkehrende Zahlungen

  • Abos: Produkte, für die wiederkehrende Abrechnungszeiträume erforderlich sind.
  • Ratenzahlungen: Transaktionen, für die vom Händler vorgeschriebene Zahlungspläne oder Finanzierungen erforderlich sind.

Personalisierte Produkte und Versandoptionen

  • Personalisierte Artikel: Artikel, die eine individuelle Gestaltung erfordern (z.B. Gravuren, Monogramme).
  • Nicht neue oder endgültige Verkaufsartikel: generalüberholte Produkte, gebrauchte Artikel und Artikel, die als „Final Sale“ (keine Rückgaben) gekennzeichnet sind.
  • Vorbestellartikel: Produkte mit zukünftigen Veröffentlichungsdaten und verzögerter Ausführung.
  • Gebündelte Dienste: Artikel, für die zusätzliche Verträge erforderlich sind, z. B. Garantien, Installation oder Einrichtung.
  • Sonderversand: Artikel, für die nicht standardmäßige Versandgebühren anfallen (z.B. Fracht, Premiumversand).
  • Geschenke: Transaktionen, für die eine geteilte Rechnung oder eine verborgene Preisgestaltung für Empfänger erforderlich ist.
  • Aktivierung im Geschäft: Produkte, die an einem Einzelhandelsstandort physisch aktiviert werden müssen.

Richtlinien- und Sicherheitseinschränkungen

  • Mit Altersbeschränkung: Artikel, für die ein Identitätsnachweis erforderlich ist (z.B. Alkohol, Tabak).
  • Unzulässige Inhalte: Waffen, Inhalte für Erwachsene, Gesundheitswesen/Arzneimittel, Fälschungen oder andere Kategorien, die durch die Standardrichtlinien für Google Shopping blockiert werden.

Digitale Waren und Dienstleistungen

  • Dienste: Kurse, Onlinekurse und Pauschalreisen (sofern nicht über bestimmte Travel-Rails integriert).
  • Vermietung: Filmverleih, Geräteverleih oder Leasing.
  • Virtuelle Artikel: In‑Game-Währung, MMORPG-Artikel oder Skins
  • Softwareabhängigkeiten: Waren, für die der Nutzer vor dem Abschluss des Kaufs bestimmte Software installieren muss.