Une fois que vous avez créé vos flux, Google les évalue.
Créer des flux
-
Générez vos flux. Vous transmettez la plupart de vos données d'inventaire à Google via des flux. Pour commencer, vous devez créer deux types de flux :
- Flux marchands:ce flux décrit vos marchands et les liens d'action au niveau des marchands.
- Un flux services (facultatif): le flux décrit les services et les niveaux de service
action_link
fournis par vos marchands à votre plate-forme.
Champs obligatoires et recommandés
Flux Nom du champ Description Obligatoire ? Marchands merchant_id Identifiant unique du marchand Oui Marchands name Nom du marchand Oui Marchands geo Adresse et coordonnées géographiques du marchand Oui Marchands telephone Numéro de téléphone du marchand Oui Marchands category Type de lieu associé au marchand Souhaitable Marchands action_link Informations concernant les liens profonds spécifiques au marchand Facultatif si des flux de service sont fournis, obligatoires pour les autres Marchand brand_id Chaîne identifiant la marque à utiliser auprès des consommateurs Facultatif Services service_id Identifiant unique du service fourni par le marchand Oui (uniquement si un flux de service est fourni) Services merchant_id Lien vers le marchand qui fournit ce service Oui (uniquement si un flux de service est fourni) Services localized_service_name Nom du service fourni Oui (uniquement si un flux de service est fourni) Services localized_description Description du service visible par l'utilisateur Facultatif Services action_link Fournit des informations sur les liens profonds liés au service Oui (uniquement si un flux de service est fourni) Services type Type de lien profond (par exemple, SERVICE_TYPE_DINING_RESERVATION) Oui (uniquement si un flux de service est fourni) Pour commencer, consultez les exemples de flux
- Exemples de flux (secteur de la restauration)
- Flux de livraison pour commande de repas
- Flux à emporter pour commande de repas
- Flux de commande de repas avec métadonnées
- Flux de commande en magasin
- Flux de commande en magasin avec métadonnées
- Exemples de flux (rendez-vous en personne)
- Exemples de flux (rendez-vous en ligne/virtuels)
Les marchands qui disposent de plusieurs services, mais qui les proposent à l'aide d'un seul lien d'action, ne doivent fournir qu'un seul lien d'action pour tous les services associés à un marchand dans le flux marchands.
Pour en savoir plus sur la spécification de liens d'action dans les anciens flux d'intégration de démarrage, cliquez ici.
Incluez des métadonnées dans chacun de vos flux pour indiquer à Google comment interpréter le flux.
Voici un exemple de métadonnées d'un flux :
"metadata": { "generation_timestamp": "1467993600", "processing_instruction": "PROCESS_AS_COMPLETE", "total_shards": 1 }
-
Exportez vos flux. Le format des flux est décrit à l'aide de la syntaxe du tampon de protocole 3, mais vous pouvez faire référence aux exemples mentionnés ci-dessus pour voir le format JSON. Nous vous recommandons d'importer les flux au format JSON.
Si vous souhaitez vraiment utiliser le format pb3 et obtenir des informations générales sur l'utilisation des tampons de protocole pour générer un fichier pb3, consultez la page Protocol Buffer Basics: Java.
-
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 port19321
.Importez vos fichiers avec des noms uniques (par exemple, un nom comprenant un horodatage). L'utilisation de noms uniques facilite le dépannage et permet d'interroger l'état du flux.
Pour déterminer la taille des flux et la fréquence de diffusion, respectez les consignes suivantes:
- Taille des fichiers et segments du flux :
- La taille du fichier de flux ne doit pas dépasser 200 Mo (après compression). Les compresser avec
gzip
- Si votre fichier peut dépasser 200 Mo (après compression), divisez-le en plusieurs segments en suivant le tutoriel Diviser les fichiers de flux . Toutefois, il est peu probable que l'ancienne intégration de démarrage atteigne la limite de 200 Mo.
- La taille du fichier de flux ne doit pas dépasser 200 Mo (après compression). Les compresser avec
- Fréquence des mises à jour complètes :
- Un flux marchand complet est fourni une fois par jour.
- (Si implémenté) Un flux de service complet est fourni une fois par jour.
- Taille des fichiers et segments du flux :
Google évalue les flux
Une fois que vous avez importé vos flux, Google les traite et les évalue pour en vérifier la qualité et l'exhaustivité. Nous vérifions les éléments suivants :
- Le flux respecte les spécifications.
- Le flux inclut tous les champs obligatoires.
- Chaque marchand dispose d'au moins un
action_link
ou d'un service avec au moinsaction_link
défini(e). - La majorité de vos données marchand correspondent à des adresses sur Google Maps.