Google met à disposition des listes agrégées de paramètres éditeur en les important dans un bucket Google Cloud Storage spécifique au compte (dans le cadre d'un projet appartenant à Google). Vous pouvez les télécharger pour les utiliser à des fins de ciblage qui ne peuvent pas être définies au moment des enchères. Pour activer cette fonctionnalité, contactez votre responsable de compte technique.
Les fichiers contenant les paramètres éditeur peuvent être téléchargés de manière automatisée à l'aide de l'API Cloud Storage, manuellement via l'interface utilisateur de Google Developers Console ou de l'outil de ligne de commande gsutil. Consultez la documentation de Google Cloud Storage pour en savoir plus sur l'accès aux données stockées dans Google Cloud Storage.
Le fichier est compressé au format gzip, conformément à la norme RFC 1952. Pour extraire le fichier de la ligne de commande, exécutez gzip -d <filename>. Pour extraire le fichier par programmation, vous pouvez utiliser zlib ou une bibliothèque de compression similaire compatible avec le format gzip. Il en résulte un tampon de protocole sérialisé, semblable à la charge utile de la requête POST dans un BidRequest, qui peut être analysé avec l'extrait de code suivant:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
La définition du tampon de protocole pour PublisherSettingsList peut être téléchargée à partir de la page de données de référence. Vous pouvez également demander un fichier publisher-settings.pb.gz compressé à votre responsable de compte. Il contient la définition du tampon de protocole ainsi qu'un exemple de fichier de paramètres éditeur.
L'ordre des PublisherSettingsList peut être modifié à tout moment.
Aucun ordre ni tri spécifique n'est garanti. Chaque entrée de la liste des paramètres éditeur contient un identifiant et plusieurs paramètres qui s'appliquent à BidRequests tagués avec cet identifiant. Vous pouvez ajouter une fonctionnalité à vos systèmes d'enchères pour rechercher régulièrement une nouvelle liste de paramètres éditeur.
Lorsque Google reçoit une impression éligible aux enchères en temps réel, il inclut dans la demande d'enchère des identifiants qui correspondent aux entrées de la liste des paramètres éditeur. Votre système d'enchères peut utiliser les paramètres de l'éditeur pour filtrer les annonces candidates pour cette impression. Pour être éligible à une impression donnée, l'annonce candidate doit respecter toutes les entrées de paramètre d'éditeur pour lesquelles des identifiants ont été envoyés dans la demande.
Notez que les paramètres d'éditeur manquants dans le fichier sont dus à l'absence d'URL bloquées associées aux identifiants.
Le fichier des paramètres éditeur est divisé en plusieurs fichiers plus petits afin de réduire la quantité de données à télécharger en une seule transaction. Les fichiers sont divisés en morceaux d'environ 5 Mo et nommés de publisher-settings.0.pb.gz à publisher-settings.n.pb.gz (où n correspond au nombre de fichiers moins un). Contactez votre responsable de compte pour obtenir ces fichiers.