Gestire le impostazioni di pagamento

La funzionalità Acquisto rapido velocizza l'acquisto per i clienti pronti ad acquistare consentendo loro di passare direttamente dalle schede di prodotto 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 al programma della funzionalità di pagamento in modo programmatico.

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

Prerequisiti

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

  • Devi essere approvato 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 una risposta di esempio di 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 di 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. Includi i campi che vuoi modificare nel corpo della richiesta 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 di 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 di pagamento e interrompe 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.

Hai 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 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 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 API secondaria, assicurati di non inviare valori per l'attributo checkout_link_template nel tuo feed per questi prodotti.

  • Se utilizzi l'attributo feed checkout_link_template, assicurati di non impostare un modello di URL a livello di account utilizzando l'API secondaria o le impostazioni di Merchant Center. Puoi comunque utilizzare l'API secondaria per selezionare 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 di 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, una volta compilato il segnaposto, 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

  • Checkout: 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 indirizzare a una pagina valida del tuo sito che corrisponda al tuo dominio registrato, funzioni con il metodo HTTP GET e non richieda l'accesso del cliente.
  • Il dominio del modello di pagamento fornito deve corrispondere a quello del prodotto.

Scopri di più