Direktkauf-Einstellungen verwalten

Mit der Direktkauf-Funktion können kaufbereite Kunden den Kauf beschleunigen, da sie direkt von den Google-Produkteinträgen zum Einkaufswagen oder zur Zahlungsseite Ihrer Website gelangen. So lassen sich die Conversion-Raten verbessern und der Kaufvorgang optimieren.

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

In dieser Anleitung wird beschrieben, wie Sie mit der Merchant API Ihre Registrierung für die Zahlungsfunktion programmatisch erstellen und verwalten.

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

Vorbereitung

Wenn Sie die CheckoutSettings-Ressource 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 sie verwenden.
  • Ihr Absatzland muss die USA sein.

Methoden

Sie haben folgende Möglichkeiten, Zahlungseinstellungen zu erstellen, abzurufen, zu aktualisieren und zu löschen:

Direktkauf-Einstellungen erstellen

Verwenden Sie die Methode checkoutSettings.create, um eine Zahlungseinstellung zu erstellen. Füge den uri_settings mit checkout_uri_template oder cart_uri_template und der 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"
}

Direktkauf-Einstellungen abrufen

Mit der Methode checkoutSettings.get können Sie Ihre Direktkaufeinstellungen abrufen, einschließlich der URL-Vorlage, der ausgewählten Ziele, des Registrierungsstatus und des Status der URL-Überprüfung.

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"
}

Direktkaufeinstellungen aktualisieren

Verwenden Sie die Methode checkoutSettings.update, um Ihre Zahlungseinstellungen zu aktualisieren. Fügen Sie die Felder, die Sie ändern möchten, in den Anfragetext ein und geben Sie diese Felder im Abfrageparameter 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 Zahlungseinstellungen zu löschen.

Dadurch wird Ihre Konfiguration auf Kontoebene entfernt, Sie werden vom Direktkaufprogramm abgemeldet und Direktkauflinks werden nicht mehr in Ihren Produkten 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 infrage kommenden Produkte angewendet. Wir empfehlen, für alle Produkte dieselbe URL zu 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 URLs pro Produkt anpassen 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 keine Werte für das Attribut checkout_link_template in Ihrem Feed einreichen.

  • Wenn Sie das Feedattribut checkout_link_template verwenden, dürfen Sie keine URL-Vorlage auf Kontoebene über die untergeordnete API oder die Merchant Center-Einstellungen festlegen. Wenn du URLs ausschließlich über den Feed verwaltest, kannst du die eligible_destinations auch über die untergeordnete API auswählen, ohne uri_settings anzugeben.

Direktkauf-URL-Vorlage

Mit der Direktkauf-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 Parameterplatzhalter {ID} enthalten und eine übereinstimmende Domain haben.

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

  • checkout_uri_template:Eine URL-Vorlage, über die der Nutzer, wenn der Platzhalter ausgefüllt ist, zur Zahlungsseite mit dem entsprechenden Artikel weitergeleitet wird, der zum Kauf bereitsteht.
  • cart_uri_template:Eine URL-Vorlage, über die der Nutzer zur Einkaufswagenseite mit dem hinzugefügten Artikel weitergeleitet 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 Ihrer Website verweisen, die mit Ihrer registrierten Domain übereinstimmt, mit der HTTP GET-Methode funktioniert und bei der sich der Kunde nicht anmelden muss.
  • Die Domain aus der bereitgestellten Direktkaufvorlage muss mit der Produktdomain übereinstimmen.

Weitere Informationen