Direktkauf-Einstellungen verwalten

Mit der Direktkauf-Funktion können kaufbereite Kunden schneller einkaufen, da sie direkt von Google-Produkteinträgen zur Warenkorb- oder Zahlungsseite Ihrer Website weitergeleitet werden. Das kann die Conversion-Raten verbessern und den Einkaufsprozess optimieren.

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

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

Weitere Informationen

Vorbereitung

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

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

Methoden

Sie können die folgenden Methoden verwenden, um Checkout-Einstellungen zu erstellen, abzurufen, zu aktualisieren und zu löschen:

Einstellungen für den Direktkauf erstellen

Verwenden Sie zum Erstellen einer Checkout-Einstellung die Methode checkoutSettings.create. Fügen Sie uri_settings mit checkout_uri_template oder cart_uri_template und dem ausgewählten eligible_destinations in den Anfragetext ein.

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-Prüfstatus.

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 Einstellungen für die Zahlungsabwicklung zu aktualisieren. Geben Sie die Felder, die Sie ändern möchten, im Anfragetext an und geben Sie diese Felder im Abfrageparameter update_mask an.

update_mask unterstützt die folgenden Felder:

  • eligible_destinations
  • uri_settings

Hier ist ein Beispiel für eine Anfrage, 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

Wenn Sie die Einstellungen für die Zahlungsabwicklung löschen möchten, verwenden Sie die Methode checkoutSettings.delete.

Durch diese Aktion wird Ihre Konfiguration auf Kontoebene entfernt, Sie werden vom Direktkaufprogramm 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

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

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

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

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

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

  • Wenn Sie das Feed-Attribut 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 Unter-API weiterhin verwenden, um eligible_destinations auszuwählen, ohne uri_settings anzugeben, wenn Sie URLs ausschließlich über den Feed verwalten.

Direktkauf-URL-Vorlage

Mit der Vorlage für die Direktkauf-URL 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 Parameter-Platzhalter {ID} enthalten und eine passende Domain haben.

Wenn Sie Check-out-Links mit der 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 nach dem Ausfüllen des Platzhalters zu Ihrer Zahlungsseite mit dem jeweiligen Artikel weiterleitet, der zum Kauf bereit ist.
  • cart_uri_template:Eine URL-Vorlage, die den Nutzer zur Einkaufswagenseite Ihres Geschäfts weiterleitet, wobei der entsprechende Artikel dem Einkaufswagen hinzugefügt wird.

Beispielvorlagen

  • Checkout: 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, mit der HTTP GET-Methode funktioniert und für die sich der Kunde nicht anmelden muss.
  • Die Domain aus der bereitgestellten Vorlage für den Direktkauf muss mit der Produktdomain übereinstimmen.

Weitere Informationen