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, mettez en correspondance les codes produit et structurez les options de variante.
Recommandations : bonnes pratiques pour la tarification en temps réel, l'actualisation de l'inventaire et la gestion des variantes.

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).

Éligibilité au panier

Le transfert de panier fonctionne selon un modèle de désactivation, ce qui signifie que les produits éligibles sont inclus par défaut, sauf s'ils sont explicitement exclus.

Participation par défaut : les produits approuvés pour les fiches gratuites dans Google Merchant Center sont automatiquement éligibles au transfert de panier une fois que dev.ucp.shopping.cart est déclaré dans votre profil UCP.
Exclusion sélective (désactivation) : pour exclure des produits spécifiques du transfert de panier sur les surfaces Google, définissez l'attribut de produit native_commerce(cart_eligibility) sur FALSE dans votre flux.
Règle d'inclusion : si cet attribut n'est pas renseigné ou s'il est défini sur TRUE, l'article éligible du catalogue reste disponible pour le transfert de panier.

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.

Option de variante

Si votre produit est disponible en plusieurs variantes (taille, couleur ou matière, par exemple), nous vous recommandons vivement d'indiquer l'attribut variant_option en plus de item_group_id et item_group_title.

Google utilise variant_option pour créer le sélecteur d'articles sur la page dans l'UCP et pour permettre aux marchands de personnaliser la sélection des variantes pour les utilisateurs. Le fait de fournir des données complètes sur les variantes permet également d'éviter les incohérences détectées automatiquement concernant l'éligibilité à l'achat, lesquelles peuvent entraîner la suppression du bouton de paiement.

Le groupe variant_option contient deux sous-attributs :

name : dimension de la variante (par exemple, size ou color). 250 caractères maximum.
value : valeur de l'option spécifique (par exemple, medium ou blue). 250 caractères maximum.

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	item_group_id	`native_commerce(checkout_eligibility:cart_eligibility)`	variant_option	consumer_notice
11111	GROUP_TEE	TRUE:TRUE	taille:S,couleur:rouge	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	GROUP_TEE	TRUE:FALSE	taille:M,couleur:bleu
33333		FALSE:TRUE

Format XML :

<item>
  <g:id>11111</g:id>
  <g:item_group_id>GROUP_TEE</g:item_group_id>
  <g:native_commerce>
    <g:checkout_eligibility>TRUE</g:checkout_eligibility>
    <g:cart_eligibility>TRUE</g:cart_eligibility>
  </g:native_commerce>
  <g:variant_option>
    <g:name>size</g:name>
    <g:value>small</g:value>
  </g:variant_option>
  <g:variant_option>
    <g:name>color</g:name>
    <g:value>red</g:value>
  </g:variant_option>
  <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:item_group_id>GROUP_TEE</g:item_group_id>
  <g:native_commerce>
    <g:checkout_eligibility>TRUE</g:checkout_eligibility>
    <g:cart_eligibility>FALSE</g:cart_eligibility>
  </g:native_commerce>
  <g:variant_option>
    <g:name>size</g:name>
    <g:value>medium</g:value>
  </g:variant_option>
  <g:variant_option>
    <g:name>color</g:name>
    <g:value>blue</g:value>
  </g:variant_option>
  <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:cart_eligibility>TRUE</g:cart_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": "cart_eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "variant_option",
    "groupValues": [
      {
        "name": "name",
        "value": "size"
      },
      {
        "name": "value",
        "value": "small"
      }
    ]
  },
  {
    "name": "variant_option",
    "groupValues": [
      {
        "name": "name",
        "value": "color"
      },
      {
        "name": "value",
        "value": "red"
      }
    ]
  },
  {
    "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": "cart_eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "variant_option",
    "groupValues": [
      {
        "name": "name",
        "value": "size"
      },
      {
        "name": "value",
        "value": "small"
      }
    ]
  },
  {
    "name": "variant_option",
    "groupValues": [
      {
        "name": "name",
        "value": "color"
      },
      {
        "name": "value",
        "value": "red"
      }
    ]
  },
  {
    "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"
  }
]

Recommandations

Pour maintenir votre catalogue à jour et assurer la disponibilité du paiement :

Migrez vers Merchant API : utilisez Merchant API pour mettre à jour votre catalogue et synchroniser en temps réel les prix, la disponibilité et les informations détaillées sur les produits.
Envoyez des mises à jour supplémentaires des prix et de l'inventaire : si vous utilisez des flux planifiés au lieu de l'API, envoyez des mises à jour en temps réel des prix et de la disponibilité à l'aide des flux supplémentaires de Merchant API ou de Content API pour éviter les incohérences de prix au moment du paiement.
Fournissez des attributs de variante : transmettez toujours variant_option avec item_group_id pour les articles comportant plusieurs variantes afin d'alimenter le sélecteur de variante et de réduire le risque de problèmes liés à l'éligibilité à l'achat.

Préparer votre profil UCP