Gestire le impostazioni di pagamento

La funzionalità Acquisto rapido velocizza l'acquisto per i clienti che sono pronti a procedere all'acquisto consentendo loro di passare direttamente dalle schede di prodotto di Google alla pagina di pagamento o del carrello 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 in modo programmatico la registrazione alla funzionalità di pagamento.

Per ulteriori informazioni, consulta la sezione Aggiungere un link al pagamento per i prodotti.

Prerequisiti

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

  • Devi aver ottenuto l'approvazione per gli annunci Shopping, le schede senza costi o entrambi e partecipare a questi programmi.
  • Il paese di vendita deve essere gli Stati Uniti.

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 pagamento, utilizza il metodo checkoutSettings.create. Includi uri_settings con checkout_uri_template o cart_uri_template e eligible_destinations selezionato nel corpo della richiesta.

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 un esempio di risposta di una chiamata andata a buon fine:

{
  "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, tra cui il modello di URL, le destinazioni selezionate, lo stato della registrazione e lo stato della 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 un esempio di risposta di una chiamata andata a buon fine:

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

Aggiorna le impostazioni di pagamento

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

update_mask supporta i seguenti campi:

  • eligible_destinations
  • uri_settings

Di seguito è riportata 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 un esempio di risposta di una chiamata andata a buon fine:

{
  "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 di pagamento e impedisce la visualizzazione dei link di 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.

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

  • A livello di account (API secondaria o Merchant Center): per definire un singolo modello di URL, checkout_uri_template o cart_uri_template, puoi utilizzare l'API secondaria o le impostazioni di Merchant Center. Questo modello viene applicato a tutti i tuoi prodotti idonei. Ti consigliamo di avere 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 singoli prodotti, utilizza l'attributo checkout_link_template nel feed dei prodotti. In questo modo, puoi creare URL personalizzati 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 sottoAPI, 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 dell'API secondaria o di Merchant Center. Puoi comunque utilizzare la sottoAPI per selezionare eligible_destinations senza fornire uri_settings se gestisci gli URL solo 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 tue schede. Deve contenere il segnaposto del parametro {ID} e avere un dominio corrispondente.

Quando configuri i link al pagamento utilizzando la sottoAPI, utilizza il campo uri_settings. Questo campo accetta uno dei due modelli:

  • checkout_uri_template: un modello di URL che, quando il segnaposto è 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 degli acquisti 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 puntare a una pagina valida del tuo sito che corrisponda al tuo dominio registrato, funzioni utilizzando il metodo HTTP GET e non richieda al cliente di accedere.
  • Il dominio del modello di pagamento fornito deve corrispondere a quello del prodotto.

Scopri di più