Préparer votre compte Merchant Center

Vous devez disposer d'un compte Merchant Center en règle et de produits approuvés pour les fiches gratuites dans votre compte. Pour commencer, consultez les articles suivants du centre d'aide :

Une fois que vous avez configuré vos produits dans Merchant Center, vous devez satisfaire aux exigences énoncées dans cette section avant de passer à la création de l'intégration de l'API.

Paramètres Merchant Center : configurez les conditions de retour et les informations sur le service client.
Restrictions relatives aux produits : passez en revue les catégories de produits qui ne sont pas éligibles au paiement.
Données produit : indiquez l'éligibilité au paiement UCP, fournissez des avis aux consommateurs et mettez en correspondance les codes produit.

Paramètres de Merchant Center

Assurez-vous que les paramètres suivants sont configurés dans votre compte Google Merchant Center :

Conditions de retour

Vous devez définir vos conditions de retour dans Merchant Center. Il s'agit d'une exigence du marchand officiel et elles seront référencées sur l'écran de paiement. Les conditions configurées s'appliquent globalement à votre compte. Toutefois, vous pouvez utiliser l'attribut de flux return_policy_label pour limiter une condition de retour donnée à un sous-ensemble de produits. Vous pouvez également envoyer des conditions de retour à l'aide de l'attribut returns pour fournir des informations sur les conditions de retour au niveau du produit. L'attribut returns vous permet de définir des conditions de retour entièrement dans votre flux de produits, sans qu'il soit nécessaire de créer une entrée correspondante dans les paramètres de retour de Merchant Center.

Si votre compte Merchant Center est un compte avancé, vous devez configurer vos conditions de retour dans chaque sous-compte.

Vous devez inclure les frais de retour, le délai de retour (période) et un lien vers les conditions complètes. Découvrez comment configurer les retours au niveau du compte ou envoyer des retours dans votre flux de produits à l'aide de l'attribut returns.

Infos sur le service client

Vous devez configurer les informations sur votre service client dans Merchant Center. Ces informations permettent de générer le lien "Contacter le marchand" sur la page de confirmation de commande.

Vous devez fournir au moins une méthode de contact :

URL du site Web du service client
Adresse e-mail du service client
Numéro de téléphone du service client

Pour en savoir plus, consultez l'article du centre d'aide Ajouter les informations sur le service client à Merchant Center.

Restrictions relatives aux produits

Les catégories de produits suivantes ne sont pas éligibles au paiement. Assurez-vous que native_commerce(checkout_eligibility) est vide ou défini sur FALSE pour ces éléments.

Produits financiers et modèles de facturation récurrente

Abonnements : produits nécessitant des cycles de facturation récurrente.
Versements : transactions nécessitant des plans de paiement ou des financements imposés par le marchand.

Produits personnalisés et options de traitement des commandes

Produits personnalisés : articles nécessitant des décisions de conception personnalisées (par exemple, gravures, monogrammes).
Articles d'occasion ou en vente finale : produits reconditionnés, articles d'occasion et articles marqués comme "Vente finale" (aucun retour).
Articles en précommande : produits dont la date de sortie est à venir et dont le traitement est différé.
Services groupés : articles nécessitant des contrats supplémentaires, tels que des garanties, une installation ou une configuration.
Livraison spéciale : articles nécessitant des frais de livraison non standards (par exemple, fret, livraison premium).
Cadeaux : transactions nécessitant une facturation séparée ou le masquage des prix pour les destinataires.
Activation en magasin : produits qui doivent être activés physiquement dans un magasin.

Restrictions liées aux règles et à la sécurité

Articles soumis à une limite d'âge : articles nécessitant une validation de l'identité (alcool ou tabac, par exemple).
Contenus interdits : armes, contenus réservés aux adultes, produits de santé/pharmaceutiques, contrefaçons ou toute autre catégorie bloquée par le règlement standard de Google Shopping.

Produits et services numériques

Services : cours, cours en ligne et offres de voyage (sauf s'ils sont intégrés à l'aide de rails Voyages spécifiques)
Locations : location de films, de matériel ou de véhicules.
Articles virtuels : monnaie en jeu, produits MMORPG ou skins
Dépendances logicielles : produits qui nécessitent l'installation d'un logiciel spécifique avant de finaliser l'achat.

Données produit

Vous devez mettre à jour votre flux de produits pour indiquer l'éligibilité et fournir des données de conformité. Ces informations sont requises pour activer le paiement par le biais de l'UCP avec Google, car elles permettent aux agents de déterminer l'éligibilité des produits, de calculer les coûts totaux exacts et d'afficher les avertissements légaux obligatoires pour l'utilisateur.

Éligibilité au paiement agentique

Elle permet d'activer l'expérience de paiement sur Google pour un produit.

Cette information est fournie à l'aide d'un attribut de produit native_commerce(checkout_eligibility) contenant une seule valeur booléenne. S'il est défini sur FALSE ou qu'il n'est pas configuré, le produit ne sera pas éligible au paiement (la valeur par défaut est FALSE).

Avis aux consommateurs

Obligatoire pour les articles soumis à des exigences réglementaires liées aux avertissements (par exemple, la Proposition 65 de Californie). Vous êtes responsable du respect de toutes les lois applicables, y compris les exigences liées aux avis aux consommateurs. Ces avertissements s'affichent de manière bien visible sur l'écran de paiement lorsque vous les fournissez.

Fournissez l'attribut de groupe consumer_notice avec deux sous-attributs :

notice_type : doit être défini sur legal_disclaimer, safety_warning ou prop_65.
notice_message : chaîne (1 000 caractères maximum). Les balises HTML <b>, <br>, <i> et <a href> sont acceptées.

Remarque : Lorsque vous utilisez <a href> dans un fichier de flux, insérez le caractère d'échappement barre oblique inversée devant le deux-points de l'URL (http\://) pour éviter les erreurs de validation d'attribut.

Si vous avez plusieurs avis aux consommateurs pour le même produit, envoyez chacun d'eux sous la forme d'une paire type:text sous un en-tête consumer_notice répété.

Code produit

L'id de votre flux de produits doit correspondre à l'ID produit attendu par votre Checkout API. Si c'est le cas, aucune action n'est requise. Sinon, utilisez l'attribut personnalisé merchant_item_id pour les faire correspondre.

Lorsque merchant_item_id est défini, il est prioritaire sur id dans les requêtes agentiques.

Ajouter les attributs à vos produits

Les exemples suivants présentent différentes options permettant de transmettre le produit à Merchant Center.

Flux

Il est recommandé de créer une source de données supplémentaire. Vous pouvez ajouter ces données à votre flux principal, mais procédez avec prudence, car toute erreur de formatage pourrait perturber l'importation habituelle de vos produits.

Format du fichier texte :

ID	`native_commerce(checkout_eligibility)`	consumer_notice
11111	TRUE	prop_65:Cet exemple contient <b>tous</b> les <i>styles</i> de texte autorisés. <br> Consultez <a href="http\://developers.google.com/merchant/ucp/guides/overview/merchant-center#consumer-notices">cet exemple</a> pour connaître le format à utiliser.
22222	TRUE
33333	FALSE

Format XML :

<item>
  <g:id>11111</g:id>
  <g:native_commerce>
     <g:checkout_eligibility>TRUE</g:checkout_eligibility>
  </g:native_commerce>
  <g:consumer_notice>
    <g:notice_type>prop_65</g:notice_type>
    <g:notice_message>
      This product can expose you to chemicals...
    </g:notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>
    <g:checkout_eligibility>TRUE</g:checkout_eligibility>
  </g:native_commerce>
  <g:consumer_notice>
    <g:notice_type>safety_warning</g:notice_type>
    <g:notice_message>Click here to see the &lt;a href=https://www.example.com&gt;Safety Warning&lt;/a&gt; for this product.</g:notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>
      <g:checkout_eligibility>FALSE</g:checkout_eligibility>
  </g:native_commerce>
</item>

Merchant API

Fournissez les attributs en tant qu'attributs personnalisés. Vous pouvez les ajouter à votre accounts.productInputs.insert existant.

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

Content API (obsolète)

Fournissez les attributs en tant qu'attributs personnalisés. Ils doivent être inclus dans une requête products.insert contenant le produit complet, car products.update ne permet pas de mettre à jour les customAttributes.

Exemple :

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

Premiers pas

Préparer votre profil UCP