Zarządzanie ustawieniami płatności

Funkcja płatności przyspiesza proces zakupu dla klientów gotowych do zakupu, ponieważ umożliwia im przejście bezpośrednio z informacji o produktach w Google na stronę koszyka lub płatności w Twojej witrynie. Może to zwiększyć współczynniki konwersji i ułatwić zakupy.

Za pomocą interfejsu Merchant API możesz zarządzać ustawieniami tej funkcji za pomocą zasobu CheckoutSettings.

Z tego przewodnika dowiesz się, jak za pomocą interfejsu Merchant API tworzyć i zarządzać rejestracją w programie funkcji płatności.

Więcej informacji znajdziesz w artykule Dodawanie linku do płatności za produkty.

Wymagania wstępne

Aby korzystać z zasobu CheckoutSettings i powiązanych z nim metod, wykonaj te czynności:

  • Musisz mieć zatwierdzone reklamy produktowe, bezpłatne informacje lub oba te rodzaje informacji o produktach i z nich korzystać.
  • Kraj sprzedaży musi być Stanami Zjednoczonymi.

Metody

Aby tworzyć, pobierać, aktualizować i usuwać ustawienia płatności, możesz użyć tych metod:

Tworzenie ustawień płatności

Aby utworzyć ustawienie płatności, użyj metody checkoutSettings.create. W treści żądania umieść właściwość uri_settings z właściwością checkout_uri_template lub cart_uri_template oraz wybraną właściwością eligible_destinations.

Przykładowe żądanie:

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

Zastąp {ACCOUNT_ID} unikalnym identyfikatorem konta Merchant Center.

Oto przykładowa odpowiedź po udanym wywołaniu:

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

Pobieranie ustawień płatności

Aby pobrać ustawienia płatności, w tym szablon adresu URL, wybrane miejsca docelowe, stan rejestracji i stan weryfikacji adresu URL, użyj metody checkoutSettings.get.

Przykładowe żądanie:

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

Oto przykładowa odpowiedź po udanym wywołaniu:

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

Aktualizowanie ustawień procesu płatności

Aby zaktualizować ustawienia płatności, użyj metody checkoutSettings.update. W treści żądania uwzględnij pola, które chcesz zmienić, i określ je w parametrze zapytania update_mask.

update_mask obsługuje te pola:

  • eligible_destinations
  • uri_settings

Oto przykładowe żądanie aktualizacji adresu URL i usunięcia miejsca docelowego reklam:

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

Oto przykładowa odpowiedź po udanym wywołaniu:

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

Usuń

Aby usunąć ustawienia płatności, użyj metody checkoutSettings.delete.

To działanie spowoduje usunięcie konfiguracji na poziomie konta, wyrejestrowanie Cię z programu płatności i wstrzymanie wyświetlania linków do płatności przy Twoich produktach w bezpłatnych informacjach i reklamach produktowych.

Przykładowe żądanie:

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

W przypadku powodzenia wywołanie zwraca pustą treść odpowiedzi.

Adresy URL płatności za produkty możesz podać na 2 sposoby:

  • Na poziomie konta (subinterfejs API lub Merchant Center): aby zdefiniować pojedynczy szablon adresu URL checkout_uri_template lub cart_uri_template, możesz użyć subinterfejsu API lub ustawień Merchant Center. Ten szablon jest stosowany do wszystkich kwalifikujących się produktów. Zalecamy, aby adres URL był spójny we wszystkich produktach. Na przykład:yourstore.com/checkout?id={id}.

  • Na poziomie produktu (plik danych): aby podać konkretny adres URL płatności dla poszczególnych produktów, użyj atrybutu checkout_link_template w pliku danych o produktach. Umożliwia to dostosowanie adresów URL do poszczególnych produktów lub oferowanie płatności tylko w przypadku części asortymentu.

  • Jeśli za pomocą tego interfejsu API ustawisz szablon URL na poziomie konta, upewnij się, że w pliku danych nie przesyłasz wartości atrybutu checkout_link_template dla tych produktów.

  • Jeśli używasz atrybutu pliku danych checkout_link_template, sprawdź, czy nie masz ustawionego szablonu URL na poziomie konta za pomocą sub-API lub ustawień Merchant Center. Możesz nadal używać interfejsu sub-API do wybierania eligible_destinations bez podawania uri_settings, jeśli zarządzasz adresami URL wyłącznie za pomocą pliku danych.

Szablon URL płatności

Szablon adresu URL strony płatności pozwala umieścić adres URL strony płatności w danych produktów, dzięki czemu kupujący online mogą z Twoich informacji przejść bezpośrednio na stronę płatności. Musi zawierać zmienną {ID} i pasującą domenę.

Podczas konfigurowania linków do płatności za pomocą interfejsu sub-API użyj pola uri_settings. To pole akceptuje jeden z 2 szablonów:

  • checkout_uri_template: szablon adresu URL, który po wypełnieniu symbolu zastępczego kieruje użytkownika na stronę płatności z konkretnym produktem gotowym do zakupu.
  • cart_uri_template: szablon adresu URL, który kieruje użytkownika na stronę koszyka w Twoim sklepie z dodanym do niego konkretnym produktem.

Przykładowe szablony

  • Płatność: https://www.your-store.com/checkout?item_id={id}
  • Koszyk: https://shop.your-store.com/add_to_cart?product_sku={id}

Upewnij się, że spełniasz te wymagania:

  • Szablon adresu URL musi prowadzić do prawidłowej strony w Twojej witrynie, która jest zgodna z zarejestrowaną domeną, działa przy użyciu metody HTTP GET i nie wymaga od klienta logowania.
  • Domena z podanego szablonu płatności musi być zgodna z domeną produktu.

Więcej informacji