Zarządzanie ustawieniami płatności

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

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

Z tego przewodnika dowiesz się, jak za pomocą interfejsu Merchant API automatycznie utworzyć i zarządzać rejestracją w 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 metod, wykonaj te czynności:

  • Musisz mieć zatwierdzone konto i korzystać z reklam produktowych, bezpłatnych informacji lub obu tych funkcji.
  • Kraj sprzedaży musi być ustawiony na Stany Zjednoczone.

Metody

Aby utworzyć, pobrać, zaktualizować i usunąć ustawienia płatności, możesz użyć tych metod:

Tworzenie ustawień procesu płatności

Aby utworzyć ustawienie płatności, użyj metody checkoutSettings.create. W treści żądania uwzględnij uri_settings z checkout_uri_template lub cart_uri_template oraz wybraną wartość eligible_destinations.

Oto przykładowa treść wiadomości:

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 swojego konta Merchant Center.

Oto przykładowa odpowiedź na udane wywołanie:

{
  "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 URL, wybrane miejsca docelowe, stan rejestracji i stan sprawdzania adresu URL, użyj metody checkoutSettings.get.

Oto przykładowa treść wiadomości:

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

Oto przykładowa odpowiedź na udane wywołanie:

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

Zaktualizuj ustawienia 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ź na udane wywołanie:

{
  "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 z programu płatności i zatrzymanie wyświetlania linków do płatności w bezpłatnych informacjach i reklamach produktowych.

Oto przykładowa treść wiadomości:

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

Pomyślne wywołanie zwraca pustą treść odpowiedzi.

Adresy URL płatności dla produktów możesz podać na 2 sposoby:

  • Poziom konta (sub-API lub Merchant Center): aby zdefiniować pojedynczy szablon URL (checkout_uri_template lub cart_uri_template), możesz użyć sub-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 dla poszczególnych produktów lub oferowanie płatności tylko w przypadku części asortymentu.

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

  • Jeśli używasz atrybutu pliku danych checkout_link_template, nie ustawiaj szablonu URL na poziomie konta za pomocą podrzędnego interfejsu API ani ustawień Merchant Center. Jeśli zarządzasz adresami URL wyłącznie za pomocą pliku danych, możesz nadal używać podrzędnego interfejsu API do wybierania eligible_destinations bez podawania uri_settings.

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ć obiekt zastępczy parametru {ID} i mieć pasującą domenę.

Gdy konfigurujesz linki do płatności za pomocą podrzędnego interfejsu API, użyj pola uri_settings. To pole akceptuje jeden z 2 szablonów:

  • checkout_uri_template: szablon URL, który po wypełnieniu obiektu 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 z konkretnym produktem dodanym do koszyka.

Przykładowe szablony

  • Wymeldowanie: 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 URL musi wskazywać prawidłową stronę w Twojej witrynie, która pasuje do zarejestrowanej domeny, działa przy użyciu metody HTTP GET i nie wymaga logowania się klienta.
  • Domena z podanego szablonu płatności musi być zgodna z domeną produktu.

Więcej informacji

Wstecz
Manage online return policies
Dalej
Enable automatic improvements