Preparare l'account Merchant Center

Devi avere un account Merchant Center in regola e prodotti approvati per le schede senza costi nel tuo account. Per iniziare, consulta questi articoli del Centro assistenza:

Una volta configurato Merchant Center con i prodotti, devi completare i requisiti di questa sezione prima di creare l'integrazione API.

1. Impostazioni di Merchant Center

Assicurati che nel tuo account Google Merchant Center siano configurate le seguenti impostazioni:

1.1. Norme sui resi

Devi definire le norme sui resi in Merchant Center, in quanto si tratta di un requisito del Merchant of Record e verrà fatto riferimento a queste norme nella schermata del pagamento. Le norme configurate si applicano a livello globale al tuo account, anche se puoi utilizzare l'attributo return_policy_label del feed per limitare una determinata norma sui resi a un sottoinsieme di prodotti.

Se il tuo account Merchant Center è un account avanzato, le norme sui resi devono essere configurate in ogni singolo subaccount.

Devi includere il costo del reso, la velocità (finestra) del reso e un link alle norme complete. Scopri di più sulla configurazione dei resi qui.

1.2. Informazioni sull'assistenza clienti

Devi impostare i dati dell'assistenza clienti in Merchant Center. Verrà utilizzato per generare il link "Contatta il commerciante" nella pagina di conferma dell'ordine. Scopri di più su come impostare le informazioni per l'assistenza clienti qui.

2. Dati di prodotto

Devi aggiornare il feed dei prodotti per indicare l'idoneità e fornire i dati di conformità. Queste informazioni sono necessarie per attivare il pagamento tramite UCP con Google, in quanto consentono agli agenti di determinare l'idoneità del prodotto, calcolare i costi totali accurati e mostrare all'utente gli avvisi legali obbligatori.

2.1. Idoneità al pagamento agentico

In questo modo, un prodotto viene incluso nell'esperienza di pagamento su Google.

Questo valore viene fornito utilizzando un attributo del prodotto native_commerce contenente un singolo valore booleano. Se è impostato su false o non è presente, il prodotto non sarà idoneo al pagamento.

2.2. Avvisi sui prodotti

Questo è obbligatorio per gli articoli con requisiti di avviso normativo (ad es. California Proposition 65). È tua responsabilità rispettare tutte le leggi vigenti, inclusi i requisiti relativi agli avvisi sui prodotti. Questi avvisi vengono visualizzati in modo ben visibile nella schermata di pagamento quando li fornisci.

Fornisci il gruppo di attributi consumer_notice con due attributi secondari:

  • consumer_notice_type: deve essere uno dei seguenti valori: legal_disclaimer, safety_warning o prop_65.
  • consumer_notice_message: stringa (max 1000 caratteri). Sono accettati i tag HTML <b>, <br> e <i>.

2.3. ID prodotto

L'attributo id nel feed dei prodotti deve corrispondere all'ID prodotto previsto dall'API Checkout. Se corrispondono, non è richiesta alcuna azione. In caso contrario, utilizza l'attributo personalizzato merchant_item_id per mapparli.

2.4. Come aggiungere gli attributi ai prodotti

I seguenti esempi descrivono diverse opzioni per fornire il prodotto a Merchant Center.

2.4.1. Feed

Ti consigliamo di creare un'origine dati supplementare (istruzioni qui). Puoi aggiungerlo al feed principale, ma procedi con cautela, in quanto una formattazione errata potrebbe influire sull'importazione regolare dei prodotti.

Nota sulla sintassi: assicurati che le stringhe complesse (come il messaggio della Proposta 65) non contengano caratteri che interrompono il formato del file (come virgole aggiuntive in un file CSV) a meno che non venga eseguito l'escape correttamente.

Formato file di testo:

ID native_commerce consumer_notice
11111 VERO prop_65:This product can expose you...
22222 VERO
33333 FALSO

Formato XML:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. API Content

Fornisci gli attributi come attributi personalizzati. Devono essere inclusi in un'operazione products.insert contenente il prodotto completo, perché products.update non supporta l'aggiornamento di customAttributes.

Esempio:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. API Merchant

Fornisci gli attributi come attributi personalizzati. Puoi aggiungerli ai tuoi accounts.productInputs.insert esistenti o aggiornarli direttamente utilizzando accounts.productInputs.patch.

Esempio per insert:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Esempio per update:

Tipo Nome Valore
Parametri del percorso productInput.name accounts/{account}/productInputs/en~US~11111
Parametri di query updateMask customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id
dataSource dataSources/{datasource} 
{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Limitazioni dei prodotti

Le seguenti categorie di prodotti non sono idonee al pagamento. Assicurati che questi elementi abbiano native_commerce vuoto o impostato su false.

Prodotti finanziari e modelli di fatturazione ricorrente

  • Abbonamenti: prodotti che richiedono cicli di fatturazione ricorrenti.
  • Rate: transazioni che richiedono piani di pagamento o finanziamenti imposti dal commerciante.

Opzioni di articoli personalizzati e completamento degli ordini

  • Articoli personalizzati: articoli che richiedono decisioni di progettazione personalizzate (ad es. incisioni, monogrammi).
  • Articoli non nuovi o in vendita finale: articoli ricondizionati, usati e contrassegnati come "Vendita finale" (nessun reso).
  • Articoli in prenotazione: prodotti con date di uscita future e evasione differita.
  • Servizi in bundle: articoli che richiedono contratti aggiuntivi, come garanzie, installazione o configurazione.
  • Spedizione speciale: articoli che richiedono tariffe di consegna non standard (ad es. trasporto merci, consegna premium).
  • Regali: transazioni che richiedono la logistica della fattura divisa o prezzi nascosti per i destinatari.
  • Attivazione in negozio: prodotti che devono essere attivati fisicamente in un punto vendita.

Norme e limitazioni di sicurezza

  • Con limitazioni di età: articoli che richiedono la verifica dell'identità (ad es. alcol, tabacco).
  • Contenuti vietati: armi, contenuti per adulti, prodotti farmaceutici/sanitari, contraffazioni o qualsiasi altra categoria bloccata dalle norme standard di Google Shopping.

Servizi e beni digitali

  • Servizi: lezioni, corsi online e pacchetti viaggio (se non integrati utilizzando binari di viaggio specifici).
  • Noleggi: noleggio di film, attrezzature o leasing.
  • Articoli virtuali: valuta in-game, articoli MMORPG o skin.
  • Dipendenze software: prodotti che richiedono all'utente di installare software specifici prima di completare l'acquisto.
Indietro
Panoramica
Avanti
Pubblicare il profilo della tua attività