Flux

Une fois que vous avez créé vos flux, Google les évalue.

Créez des flux :

  1. Générez vos flux. Vous transmettez la plupart de vos données d'inventaire à Google via des flux. Pour commencer, créez votre flux marchand (et votre flux de services, le cas échéant):

    • Flux de marchands : ce flux décrit vos marchands et les liens d'action au niveau du marchand.
    • Flux de services (facultatif / non recommandé) : il est déconseillé d'intégrer des flux de services pour les nouvelles intégrations de démarrage. Si vous souhaitez conserver votre intégration existante, suivez cette ancienne documentation.

    Champs obligatoires et recommandés

    Flux Nom du champ Description Obligatoire ?
    Marchands merchant_id Identifiant unique du marchand Yes
    Marchands name (nom) Nom du marchand Yes
    Marchands geo Adresse et coordonnées géographiques du marchand Yes
    Marchands telephone Téléphone du marchand Yes
    Marchands category Type de lieu du marchand Souhaitable
    Marchands action_link Informations sur les liens profonds propres aux marchands Yes
    Marchand action_link_type [type_lien_action] Type d'action liée au lien. Les partenaires de réservation de restaurant doivent utiliser ACTION_LINK_TYPE_MAKE_DINING_RESERVATION. Les partenaires de commande de repas doivent consulter le guide sur les commandes de plats à emporter ou de livraison. Yes
    Marchand métadonnées_commandes_aliments Indiquez les frais de livraison pour la commande de repas. Recommandé
    Marchand id_marque Chaîne identifiant la marque visible par l'utilisateur Facultative

    Pour commencer, consultez les exemples de flux

    Pour en savoir plus sur la spécification de liens d'action dans les flux d'intégration de démarrage, cliquez ici.

    Ajoutez des métadonnées à chacun de vos flux pour nous indiquer comment les interpréter.

    Voici un exemple de métadonnées d'un flux :

    "metadata": {
     "generation_timestamp": "1467993600",
     "processing_instruction": "PROCESS_AS_COMPLETE",
     "total_shards": 1
    }
    
  2. Exportez vos flux. Le format des flux est décrit avec la syntaxe du tampon de protocole 3. Toutefois, pour voir le format JSON, vous pouvez vous reporter aux exemples mentionnés ci-dessus. Nous vous recommandons d'importer les flux au format JSON.

    Si vous souhaitez vraiment utiliser le format pb3, consultez la page Protocoles de tampon de protocole: Java pour obtenir des informations générales sur l'utilisation de tampons de protocole afin de générer un fichier pb3.

  3. Importez les flux dans votre boîte de dépôt SFTP. Pour importer vos flux, utilisez les informations sur la boîte de dépôt SFTP que Google vous a fournies, ainsi que la clé privée que vous avez créée lors de la configuration. Le serveur SFTP de Google est disponible à l'adresse sftp://partnerupload.google.com sur le port 19321.

    Importez vos fichiers avec des noms uniques (par exemple, un nom comportant un horodatage). Les noms uniques facilitent le dépannage et permettent d'interroger l'état du flux.

    Pour déterminer la taille des flux et la fréquence de diffusion, tenez compte des consignes suivantes:

    • Taille des segments et des fichiers de flux :
      • La taille du fichier de flux doit être inférieure à 200 Mo (après compression). Compressez-les à l'aide de gzip.
      • Si votre fichier peut dépasser 200 Mo (après compression), divisez-les en plusieurs partitions en suivant le tutoriel Partitionner les fichiers de flux. Toutefois, il est peu probable que l'intégration de démarrage atteigne la limite de 200 Mo.
    • Fréquence des mises à jour complètes :
      • Un flux marchand complet est fourni une fois par jour.
      • (S'il est implémenté) Un flux de service complet est fourni une fois par jour.

Google évalue les flux

Une fois que vous avez importé vos flux, Google les évalue et les évalue pour des raisons de qualité et d'exhaustivité. Nous vérifions les éléments suivants :

  • Le flux respecte les spécifications.
  • Le flux inclut tous les champs obligatoires.
  • Chaque marchand possède au moins un action_link ou un service avec au moins action_link défini.
  • La majorité de vos données marchand correspondent à des adresses sur Google Maps.