Direktkauf-Einstellungen verwalten

Mit der Direktkauf-Funktion können Kunden, die zum Kauf bereit sind, direkt von Google-Produkteinträgen zur Warenkorb- oder Zahlungsseite Ihrer Website wechseln. So können Sie die Conversion-Rate verbessern und das Einkaufserlebnis optimieren.

Mit der Merchant API können Sie die Einstellungen für diese Funktion über die Ressource CheckoutSettings verwalten.

In dieser Anleitung wird erläutert, wie Sie die Merchant API verwenden, um Ihre Registrierung für die Direktkauf-Funktion programmatisch zu erstellen und zu verwalten.

Weitere Informationen finden Sie unter Direktkauf-Link für Ihre Produkte hinzufügen.

Vorbereitung

Damit Sie die Ressource CheckoutSettings und die zugehörigen Methoden verwenden können, müssen Sie Folgendes tun:

  • Sie müssen für Shopping-Anzeigen, Produkteinträge oder beides zugelassen sein und daran teilnehmen.
  • Ihr Verkaufsland muss die USA sein.

Methoden

Sie können die folgenden Methoden verwenden, um Einstellungen für den Direktkauf zu erstellen, abzurufen, zu aktualisieren und zu löschen:

Einstellungen für den Direktkauf erstellen

Verwenden Sie die Methode checkoutSettings.create, um eine Einstellung für den Direktkauf zu erstellen. Fügen Sie uri_settings mit entweder checkout_uri_template oder cart_uri_template und den ausgewählten eligible_destinations in den Anfragetext ein.

Ein Beispiel für eine Anfrage:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

Ersetzen Sie {ACCOUNT_ID} durch die eindeutige ID Ihres Merchant Center-Kontos.

Hier sehen Sie ein Beispiel für eine Antwort auf einen erfolgreichen Aufruf:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Einstellungen für den Direktkauf abrufen

Verwenden Sie die Methode checkoutSettings.get, um Ihre Einstellungen für den Direktkauf abzurufen, einschließlich der URL-Vorlage, der ausgewählten Ziele, des Registrierungsstatus und des URL-Überprüfungsstatus.

Ein Beispiel für eine Anfrage:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Hier sehen Sie ein Beispiel für eine Antwort auf einen erfolgreichen Aufruf:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Einstellungen für den Direktkauf aktualisieren

Verwenden Sie die Methode checkoutSettings.update, um Ihre Einstellungen für den Direktkauf zu aktualisieren. Fügen Sie die Felder, die Sie ändern möchten, in den Anfragetext ein und geben Sie sie im Abfrageparameter update_mask an.

update_mask unterstützt die folgenden Felder:

  • eligible_destinations
  • uri_settings

Hier sehen Sie ein Beispiel für eine Anfrage, in der die URL aktualisiert und das Ziel „Anzeigen“ entfernt wird:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Hier sehen Sie ein Beispiel für eine Antwort auf einen erfolgreichen Aufruf:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Löschen

Verwenden Sie die Methode checkoutSettings.delete, um die Einstellungen für den Direktkauf zu löschen.

Durch diese Aktion wird Ihre Konfiguration auf Kontoebene entfernt, Sie werden von der Direktkauf-Funktion abgemeldet und Direktkauf-Links werden nicht mehr für Ihre Produkte in Produkteinträgen und Shopping-Anzeigen angezeigt.

Ein Beispiel für eine Anfrage:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Bei einem erfolgreichen Aufruf wird ein leerer Antworttext zurückgegeben.

Sie haben zwei Möglichkeiten, Direktkauf-URLs für Ihre Produkte anzugeben:

  • Kontoebene (Sub-API oder Merchant Center): Wenn Sie eine einzelne URL Vorlage definieren möchten, entweder checkout_uri_template oder cart_uri_template, können Sie die Einstellungen der Sub-API oder des Merchant Center verwenden. Diese Vorlage wird auf alle Ihre infrage kommenden Produkte angewendet. Wir empfehlen, dass Sie für alle Ihre Produkte eine einheitliche URL verwenden. Beispiel: yourstore.com/checkout?id={id}.

  • Produktebene (Feed) : Wenn Sie eine bestimmte Direktkauf-URL für einzelne Produkte angeben möchten, verwenden Sie das Attribut checkout_link_template in Ihrem Produktfeed. So können Sie benutzerdefinierte URLs pro Produkt verwenden oder den Direktkauf nur für eine Teilmenge Ihres Inventars anbieten.

  • Wenn Sie mit dieser Sub-API eine URL-Vorlage auf Kontoebene festlegen, dürfen Sie in Ihrem Feed für diese Produkte keine Werte für das Attribut checkout_link_template einreichen.

  • Wenn Sie das Feedattribut checkout_link_template verwenden, dürfen Sie keine URL-Vorlage auf Kontoebene über die Einstellungen der Sub-API oder des Merchant Center festlegen. Sie können die Sub-API weiterhin verwenden, um die eligible_destinations auszuwählen, ohne uri_settings anzugeben, wenn Sie URLs ausschließlich über den Feed verwalten.

Checkout-URL-Vorlage

Mit der Checkout-URL-Vorlage können Sie eine URL für den Bezahlvorgang in Ihre Produktdaten einfügen, sodass Onlinekäufer von Ihren Produkteinträgen direkt auf die Zahlungsseite gelangen. Sie muss den Platzhalter für den Parameter {ID} enthalten und eine passende Domain haben.

Wenn Sie Direktkauf-Links mit der Sub-API einrichten, verwenden Sie das Feld uri_settings. Dieses Feld akzeptiert eine von zwei Vorlagen:

  • checkout_uri_template:Eine URL-Vorlage, die den Nutzer nach dem Ausfüllen des Platzhalters zu Ihrer Zahlungsseite weiterleitet, wobei der Artikel bereits für den Kauf vorbereitet ist.
  • cart_uri_template:Eine URL-Vorlage, die den Nutzer zu Ihrer Warenkorbseite weiterleitet, wobei der Artikel bereits in den Warenkorb gelegt wurde.

Beispielvorlagen

  • Direktkauf:https://www.your-store.com/checkout?item_id={id}
  • Warenkorb:https://shop.your-store.com/add_to_cart?product_sku={id}

Achten Sie darauf, dass die folgenden Anforderungen erfüllt sind:

  • Ihre URL-Vorlage muss auf eine gültige Seite auf Ihrer Website verweisen, die mit Ihrer registrierten Domain übereinstimmt, mit der Methode HTTP GET funktioniert und keine Anmeldung des Kunden erfordert.
  • Die Domain aus der angegebenen Checkout-Vorlage muss mit der Produktdomain übereinstimmen.

Weitere Informationen