La boîte de dépôt de flux générique permet d'importer plusieurs types de flux dans une seule boîte de dépôt par environnement. Ce guide explique comment utiliser la boîte de dépôt générique et fournit des liens vers le guide correspondant au flux que vous prévoyez d'utiliser.
Le compte "Envoi sécurisé" générique repose sur deux importations distinctes:
- Fichier de descripteur:décrit le type de flux que vous allez importer
- Fichier(s) de flux : contenu du flux
Structurer le champ de descripteur
Le fichier descripteur est importé pour indiquer à notre système le type de flux que vous importez. Cela nous permet de valider et de traiter correctement le flux. Le fichier descripteur doit être importé avant le contenu du flux et doit respecter les règles de dénomination suivantes:
- Utiliser l'extension de fichier .filesetdesc.json
- Chaque nom de fichier descripteur doit être unique et ne peut pas être réutilisé d'une importation à l'autre. Nous vous recommandons d'inclure l'horodatage de génération dans le nom du fichier.
- Exemple: offers_1524606581.filesetdesc.json
message FilesetDescriptor {
// The timestamp at which this feed was generated, in Unix time format
// (seconds since the epoch). (required)
int64 generation_timestamp = 1;
// Identifies the name of this feed. (required)
string name = 2;
// Paths (relative to the dropbox root) specifying data files included in this
// feed. (required)
repeated string data_file = 3;
}
Les valeurs possibles du champ name sont les suivantes:
- reservewithgoogle.conversion_data
Vous trouverez ci-dessous un exemple de fichier descripteur JSON pour un flux d'offres comportant deux segments:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
Structurer le contenu du flux
Après avoir importé le fichier descripteur, vous importerez ensuite tous les fichiers de flux correspondant au type de données correspondant au fichier de configuration de flux nommé par votre fichier descripteur. Les noms de fichiers et les emplacements des chemins d'accès (relatifs dans le compte "Envoi sécurisé") doivent correspondre exactement à ceux inclus dans le champ data_file. S'il manque un fichier, qu'il porte un nom incorrect ou qu'il a été importé à un autre emplacement, l'intégralité du flux ne sera pas traitée.
Le contenu de ces fichiers de données de flux doit être conforme aux spécifications pertinentes du flux spécifiées dans le fichier descripteur.
Le nom de chaque fichier de flux doit être unique et ne peut pas être réutilisé pour plusieurs importations. Nous vous recommandons d'inclure l'horodatage de génération et le numéro de segment (identifiant incrémentiel) dans le nom de fichier.
- Exemple: offers_1524606581_1.json
Tailles de fichier de flux et fréquence d'importation
- La taille du fichier de flux ne doit pas dépasser 200 Mo (après compression).
- La plupart des intégrations ne nécessitent qu'un seul segment. Utilisez le moins de segments possible. Un flux est limité à 1 000 segments.
- Les enregistrements individuels envoyés dans un segment ne doivent pas nécessairement être envoyés avec le même numéro de segment dans les futurs flux.
- Pour de meilleures performances, répartissez les données de manière égale entre les segments afin que la taille de tous les fichiers segmentés soit similaire.
- Si nécessaire, utilisez gzip pour compresser les flux. Toutefois, faites-le pour chaque segment de flux.
Dépannage et débogage
Après avoir importé vos fichiers (fichiers de descripteurs et de flux), accédez au tableau de bord de l'historique des flux (documentation) sur le portail des partenaires (accédez à Historique > Flux) pour suivre la progression de l'ingestion de votre flux.
Pour trouver votre flux, recherchez le name que vous avez saisi dans le fichier descripteur de la colonne "Nom du flux".
Une fois le flux ingéré (état Success ou Fail), vous pouvez cliquer sur sa ligne pour afficher les détails des erreurs et des avertissements.