Google met à disposition des listes agrégées de paramètres éditeur en les important dans un bucket Google Cloud Storage spécifique à un compte (dans un projet appartenant à Google). Vous pouvez les télécharger pour les utiliser pour un ciblage qui ne peut pas être au moment de l'enchère. Pour activer cette fonctionnalité, adressez-vous à votre responsable de compte technique. cette fonctionnalité pour votre compte.
Les fichiers contenant les paramètres de l'éditeur peuvent être téléchargés par programmation à l'aide du module Cloud Storage API, manuellement via la console Google Developers de la console ou à l'aide de l'outil de ligne de commande gsutil. Consultez la documentation Google Cloud Storage pour en savoir plus sur l'accès aux données stockées Google Cloud Storage.
Le fichier est compressé au format gzip, conformément à la norme RFC 1952. Pour extraire le fichier de
Dans la ligne de commande, exécutez gzip -d <filename>
. Pour extraire
de manière automatisée, vous pouvez utiliser zlib ou une bibliothèque de compression similaire
est compatible avec le format gzip. Le résultat est un tampon de protocole sérialisé, semblable à
la charge utile de la requête POST dans un BidRequest
, qui peut être
analysés avec l'extrait 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 des données de référence
. Vous pouvez également demander un fichier
publisher-settings.pb.gz
de votre responsable de compte. Il
contient la définition du "protocol buffer" et un exemple d'éditeur
fichier de paramètres.
L'ordre de PublisherSettingsList
peut changer à tout moment.
Aucun ordre ni tri spécifique n'est garanti. Chaque entrée de l'éditeur
la liste de paramètres contient un identifiant et plusieurs paramètres qui s'appliquent à
BidRequests
a ajouté un tag avec cet identifiant. Vous pouvez ajouter une caractéristique à
vos systèmes d'enchères afin de vérifier régulièrement la présence d'une nouvelle liste de paramètres éditeur.
Lorsque Google reçoit une impression éligible aux enchères en temps réel,
Google inclut dans la demande d'enchère les identifiants correspondant aux entrées dans
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 à un
impression, l'annonce candidate doit respecter toutes les entrées des paramètres éditeur
pour lesquels des identifiants ont été envoyés dans la demande.
Notez que tous les paramètres d'éditeur manquants dans le fichier sont car les identifiants ne sont pas associés à des URL bloquées.
Le fichier des paramètres éditeur est divisé en plusieurs fichiers plus petits pour réduire
la quantité de données qui doivent
être téléchargées en une seule transaction. Fichiers
sont divisés en fragments d'environ 5 Mo et nommés selon
publisher-settings.0.pb.gz
jusqu'à
publisher-settings.n.pb.gz
(où n correspond au nombre de
fichiers moins un.) Contactez votre responsable de compte pour obtenir ces
.