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 :

    • 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

    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
}

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

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

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 moins action_link défini(e).
  • La majorité de vos données marchand correspondent à des adresses sur Google Maps.