Flux de démarrage (anciens)

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

Créer des flux

  1. 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 :

    • Un flux marchands : ce flux décrit vos marchands et les liens action_link à leur niveau.
    • Flux services (facultatif) : ce flux décrit les services et les action_link au niveau des services que vos marchands fournissent à votre plate-forme.

    Champs obligatoires et recommandés

    Flux Nom du champ Description Obligatoire ?
    Marchands merchant_id Identifiant unique du marchand Oui
    Marchands nom 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 catégorie Type de lieu du marchand Nice to Have (Souhaitable)
    Marchands action_link Informations concernant les liens profonds spécifiques aux marchands Facultatif si des flux de services sont fournis, obligatoire dans le cas contraire
    Marchand brand_id Chaîne qui identifie la marque à présenter aux utilisateurs Facultatif
    Services service_id Identifiant unique du service fourni par le marchand Oui (uniquement si le flux de services est fourni)
    Services merchant_id Lien vers le marchand qui fournit ce service Oui (uniquement si le flux de services est fourni)
    Services localized_service_name Nom du service fourni Oui (uniquement si le flux de services est fourni)
    Services localized_description Description du service visible par l'utilisateur Facultatif
    Services action_link Fournit des informations sur les liens profonds associés aux services Oui (uniquement si le flux de services est fourni)
    Services type Type de lien profond (par exemple, SERVICE_TYPE_DINING_RESERVATION) Oui (uniquement si le flux de services est fourni)

    Pour commencer, consultez les exemples de flux.

    Si un marchand dispose de plusieurs services, mais ne les propose que via un seul lien d'action, vous devez fournir un lien d'action unique pour tous les services associés à ce marchand dans le flux marchands.

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

    Incluez des métadonnées de flux 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
}

  2. Exportez vos flux. Le format des flux est décrit à l'aide de la syntaxe du Protocol Buffer 3. Toutefois, vous pouvez consulter les 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, consultez Principes de base des Protocol Buffers : Java pour obtenir des informations générales sur l'utilisation des Protocol Buffers pour générer un fichier pb3.

  3. Importez les flux sur votre serveur SFTP. Pour importer vos flux, utilisez les informations sur le serveur 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, incluez un horodatage dans le nom). L'utilisation de noms uniques vous permettra de résoudre plus facilement tout problème éventuel et d'envoyer des requêtes pour connaître l'état de vos flux.

    Pour déterminer la taille de vos flux et la fréquence à laquelle les publier, tenez compte des consignes suivantes :

    • Taille des fichiers et de la segmentation des flux :
      • Assurez-vous que la taille du fichier de flux ne dépasse pas 200 Mo (après compression). Compressez-les à l'aide de gzip.
      • Si la taille de vos fichiers est susceptible de dépasser 200 Mo (après compression), scindez-les en plusieurs segments en suivant le tutoriel Scinder les fichiers de flux . Toutefois, l'ancienne intégration de démarrage seule est peu susceptible d'atteindre la limite de 200 Mo.
    • Fréquence des mises à jour complètes :
      • Un flux marchands complet est fourni une fois par jour.
      • (Si implémenté) Un flux services complet est fourni une fois par jour.

Google évalue les flux

Une fois vos flux importés, Google les traite et les évalue pour en vérifier la qualité et s'assurer qu'ils comportent tous les éléments requis. Nous vérifions les éléments suivants :

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