Paramètres éditeur du système d'enchères en temps réel

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 .