Zarządzanie ustawieniami płatności

Funkcja płatności przyspiesza proces zakupu dla klientów gotowych do dokonania zakupu, umożliwiając 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 usprawnić proces zakupu.

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

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

Więcej informacji znajdziesz w artykule Dodawanie linku do płatności w przypadku produktów.

Wymagania wstępne

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

  • Musisz mieć zatwierdzone i aktywne reklamy produktowe, bezpłatne informacje lub obie te opcje.
  • 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 uwzględnij uri_settings z wybranymi eligible_destinations oraz checkout_uri_template lub cart_uri_template.

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 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 adresu URL, wybrane miejsca docelowe, stan rejestracji i stan weryfikacji 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"
}

Aktualizowanie ustawień 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 te pola w parametrze zapytania update_mask.

update_mask obsługuje te pola:

  • eligible_destinations
  • uri_settings

Oto przykładowa treść wiadomości, która aktualizuje adres URL i usuwa miejsce docelowe reklamy:

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.

Ta czynność spowoduje usunięcie konfiguracji na poziomie konta, wyrejestrowanie z programu funkcji płatności i zatrzymanie wyświetlania linków do płatności w przypadku Twoich produktów 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

Udane wywołanie zwraca pustą treść odpowiedzi.

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

  • Na poziomie konta (sub-API lub Merchant Center): aby zdefiniować pojedynczy szablon adresu URL, czyli 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 w przypadku 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 ustawisz szablon URL na poziomie konta za pomocą tego sub-API, upewnij się, że w pliku danych nie przesyłasz wartości atrybutu checkout_link_template w przypadku tych produktów.

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

Szablon adresu URL płatności

Szablon adresu URL 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ę.

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

  • checkout_uri_template: szablon URL, który po wypełnieniu zmiennej przekierowuje użytkownika na stronę płatności z konkretnym produktem gotowym do zakupu.
  • cart_uri_template: szablon adresu URL, który przekierowuje użytkownika na stronę koszyka z konkretnym produktem dodanym do koszyka.

Przykładowe szablony

  • Do kasy: 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 prowadzić do prawidłowej strony w Twojej witrynie, która jest zgodna z zarejestrowaną domeną, działa za pomocą 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