Direktkauf-Einstellungen verwalten

Mit der Direktkauf-Funktion können kaufbereite Kunden direkt von Google-Produkteinträgen zum Einkaufswagen oder zur Zahlungsseite Ihrer Website gelangen. Das kann die Conversion-Rate verbessern und den Kaufvorgang vereinfachen.

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

In diesem Leitfaden wird erläutert, wie Sie die Merchant API verwenden, um sich programmatisch für die Direktkauf-Funktion zu registrieren und Ihre Registrierung zu verwalten.

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

Vorbereitung

Wenn Sie die Ressource CheckoutSettings und die zugehörigen Methoden verwenden möchten, müssen Sie Folgendes tun:

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

Methoden

Mit den folgenden Methoden können Sie Kasseneinstellungen erstellen, abrufen, aktualisieren und löschen:

Einstellungen für den Direktkauf erstellen

Verwenden Sie die Methode checkoutSettings.create, um eine Kassen-Einstellung zu erstellen. Geben Sie im Anfragetext die uri_settings mit entweder checkout_uri_template oder cart_uri_template und die ausgewählte eligible_destinations an.

Hier 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 Kennung Ihres Merchant Center-Kontos.

Hier ist eine Beispielantwort für 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 Bezahlvorgang abrufen

Mit der Methode checkoutSettings.get können Sie Ihre Einstellungen für den Direktkauf abrufen, einschließlich der URL-Vorlage, der ausgewählten Ziele, des Registrierungsstatus und des URL-Überprüfungsstatus.

Hier ein Beispiel für eine Anfrage:

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

Hier ist eine Beispielantwort für 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 Kasseneinstellungen zu aktualisieren. Fügen Sie die Felder, die Sie ändern möchten, in den Anfragetext ein und geben Sie diese Felder im Suchparameter update_mask an.

update_mask unterstützt die folgenden Felder:

  • eligible_destinations
  • uri_settings

Hier ist eine Beispielanfrage, mit der die URL aktualisiert und das Anzeigenziel 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 ist eine Beispielantwort für 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 Kasseneinstellungen zu löschen.

Dadurch wird die Konfiguration auf Kontoebene entfernt, Sie werden vom Direktkauf-Programm abgemeldet und Direktkauf-Links werden nicht mehr für Ihre Produkte in Produkteinträgen und Shopping-Anzeigen angezeigt.

Hier ein Beispiel für eine Anfrage:

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

Ein erfolgreicher Aufruf gibt einen leeren Antworttext zurück.

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 Sub-API oder die Merchant Center-Einstellungen verwenden. Diese Vorlage wird auf alle Ihre infrage kommenden Produkte angewendet. Wir empfehlen, für alle Produkte eine einheitliche URL zu verwenden. Beispiel: yourstore.com/checkout?id={id}.

  • Produktebene (Feed): Wenn Sie für einzelne Produkte eine bestimmte Direktkauf-URL 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 einen Teil 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 Sub-API oder die Merchant Center-Einstellungen 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.

Direktkauf-URL-Vorlage

Mit der URL-Vorlage für den Bezahlvorgang 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 Parameterplatzhalter {ID} enthalten und eine übereinstimmende Domain haben.

Wenn Sie Direktkauf-Links über die Sub-API einrichten, verwenden Sie das Feld uri_settings. In dieses Feld kann eine von zwei Vorlagen eingegeben werden:

  • checkout_uri_template: Eine URL-Vorlage, die den Nutzer, wenn der Platzhalter ausgefüllt ist, auf Ihre Zahlungsseite weiterleitet, auf der der jeweilige Artikel zum Kauf bereitsteht.
  • cart_uri_template: Eine URL-Vorlage, die den Nutzer zu Ihrer Einkaufswagenseite weiterleitet, wobei der jeweilige Artikel dem Einkaufswagen hinzugefügt wird.

Beispielvorlagen

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

Sie müssen die folgenden Anforderungen erfüllen:

  • Ihre URL-Vorlage muss auf eine gültige Seite auf Ihrer Website verweisen, die mit Ihrer registrierten Domain übereinstimmt, die HTTP GET-Methode verwendet und für die sich der Kunde nicht anmelden muss.
  • Die Domain aus der angegebenen Vorlage für den Direktkauf muss mit der Produktdomain übereinstimmen.

Weitere Informationen

Zurück
Manage online return policies
Weiter
Enable automatic improvements