Gestire le impostazioni di pagamento

La funzionalità Acquisto rapido velocizza l'acquisto per i clienti pronti a comprare, consentendo loro di passare direttamente dalle schede di prodotto di Google alla pagina del carrello o di pagamento del tuo sito web, il che può migliorare i tassi di conversione e semplificare l'esperienza di acquisto.

Con l'API Merchant, puoi gestire le impostazioni di questa funzionalità utilizzando la risorsa CheckoutSettings.

Questa guida spiega come utilizzare l'API Merchant per creare e gestire la registrazione alla funzionalità Acquisto rapido a livello di programmazione.

Per saperne di più, consulta Aggiungere un link al pagamento per i tuoi prodotti.

Prerequisiti

Per utilizzare la risorsa CheckoutSettings e i metodi associati, assicurati di:

  • Avere l'approvazione per gli annunci Shopping, le schede senza costi o entrambi e partecipare a questi programmi.
  • Avere gli Stati Uniti come paese di vendita.

Metodi

Per creare, recuperare, aggiornare ed eliminare le impostazioni di pagamento, puoi utilizzare i seguenti metodi:

Creare le impostazioni di pagamento

Per creare un'impostazione di Acquisto rapido, utilizza il metodo checkoutSettings.create. Nel corpo della richiesta, includi uri_settings con checkout_uri_template o cart_uri_template e le eligible_destinations selezionate.

Ecco una richiesta di esempio:

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

Sostituisci {ACCOUNT_ID} con l'identificatore univoco del tuo account Merchant Center.

Ecco una risposta di esempio a una chiamata riuscita:

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

Recuperare le impostazioni di pagamento

Per recuperare le impostazioni di pagamento, inclusi il modello di URL, le destinazioni selezionate, lo stato di registrazione e lo stato di revisione dell'URL, utilizza il metodo checkoutSettings.get.

Ecco una richiesta di esempio:

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

Ecco una risposta di esempio a una chiamata riuscita:

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

Aggiornare le impostazioni di pagamento

Per aggiornare le impostazioni di pagamento, utilizza il metodo checkoutSettings.update. Nel corpo della richiesta, includi i campi che vuoi modificare e specificali nel parametro di query update_mask.

update_mask supporta i seguenti campi:

  • eligible_destinations
  • uri_settings

Ecco una richiesta di esempio che aggiorna l'URL e rimuove la destinazione degli annunci:

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

Ecco una risposta di esempio a una chiamata riuscita:

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

Elimina

Per eliminare le impostazioni di pagamento, utilizza il metodo checkoutSettings.delete.

Questa azione rimuove la configurazione a livello di account, annulla la registrazione al programma Acquisto rapido e impedisce la visualizzazione dei link per il pagamento sui tuoi prodotti nelle schede senza costi e negli annunci Shopping.

Ecco una richiesta di esempio:

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

Una chiamata riuscita restituisce un corpo della risposta vuoto.

Hai due modi per fornire gli URL di pagamento per i tuoi prodotti:

  • A livello di account (sub-API o Merchant Center): per definire un singolo modello di URL, checkout_uri_template o cart_uri_template, puoi utilizzare le impostazioni della sub-API o di Merchant Center. Questo modello viene applicato a tutti i tuoi prodotti idonei. Ti consigliamo di utilizzare un URL coerente per tutti i tuoi prodotti. Ad esempio, yourstore.com/checkout?id={id}.

  • A livello di prodotto (feed): per fornire un URL di pagamento specifico per i singoli prodotti, utilizza l'attributo checkout_link_template nel feed dei prodotti. In questo modo, puoi personalizzare gli URL per prodotto o offrire il pagamento solo per un sottoinsieme del tuo inventario.

  • Se imposti un modello di URL a livello di account utilizzando questa sub-API, assicurati di non inviare valori per l'attributo checkout_link_template nel feed per questi prodotti.

  • Se utilizzi l'attributo del feed checkout_link_template, assicurati di non impostare un modello di URL a livello di account utilizzando le impostazioni della sub-API o di Merchant Center. Puoi comunque utilizzare la sub-API per selezionare le eligible_destinations senza fornire uri_settings se gestisci gli URL esclusivamente tramite il feed.

Modello di URL di pagamento

Il modello di URL di pagamento ti consente di includere un URL di pagamento nei tuoi dati di prodotto per offrire agli acquirenti online la possibilità di accedere direttamente alla pagina di pagamento dalle schede. Deve contenere il segnaposto del parametro {ID} e avere un dominio corrispondente.

Quando configuri i link per il pagamento utilizzando la sub-API, utilizza il campo uri_settings. Questo campo accetta uno dei due modelli:

  • checkout_uri_template: un modello di URL che, quando il segnaposto viene compilato, indirizza l'utente alla pagina di pagamento con l'articolo specifico pronto per l'acquisto.
  • cart_uri_template: un modello di URL che indirizza l'utente alla pagina del carrello con l'articolo specifico aggiunto al carrello.

Modelli di esempio

  • Pagamento: https://www.your-store.com/checkout?item_id={id}
  • Carrello: https://shop.your-store.com/add_to_cart?product_sku={id}

Assicurati di soddisfare i seguenti requisiti:

  • Il modello di URL deve rimandare a una pagina valida del tuo sito che corrisponda al dominio registrato, funzioni utilizzando il metodo HTTP GET e non richieda all'utente di accedere.
  • Il dominio del modello di pagamento fornito deve corrispondere al dominio del prodotto.

Scopri di più