Concepts fondamentaux

Cette page présente l'architecture de l'API Google Ad Manager, ainsi que les concepts et termes généraux liés à Ad Manager.

Architecture des API

Voici un diagramme simplifié des principales classes de l'API Ad Manager, ainsi que de la façon dont elles sont liées:

Commande

Un objet Order contient des informations générales sur la campagne, comme la devise ou le commercial, et contient une ou plusieurs instances LineItem. Dans le code, chaque LineItem contient l'ID de l'élément Order qui le contient, plutôt que Order contenant une liste d'objets LineItem.

LineItem

Un objet LineItem décrit un ensemble d'exigences pour la diffusion d'une annonce, y compris quand et comment l'annonce doit s'afficher, les tailles des créations à diffuser et l'ordre dans lequel elles doivent s'afficher (par ordre, pondérée ou en fonction de leurs performances), la priorité de ces annonces et de nombreuses propriétés décrivant le type de facturation. Un LineItem comporte un objet InventoryTargeting qui décrit les objets AdUnit et Placement qu'il peut cibler, ainsi que des objets de sous-classe Targeting supplémentaires facultatifs qui représentent des critères géographiques, personnalisés ou autres.

LineItemCreativeAssociation

Une LineItemCreativeAssociation (souvent appelée LICA) associe un LineItem à un Creative. Les éléments de campagne peuvent être associés à plusieurs créations. Selon votre type de compte, vous pouvez associer une création à plusieurs éléments de campagne. Lorsque vous créez un LineItemCreativeAssociation, Ad Manager vérifie d'abord si la création et l'élément de campagne sont compatibles. Par exemple, si les tailles diffèrent, un message d'erreur s'affiche lorsque vous essayez de créer ou de mettre à jour l'association. Cet objet vous permet également de remplacer certaines valeurs dans le LineItem associé, comme les dates de début/fin ou la taille (si l'une de vos créations ne correspond pas tout à fait à la taille spécifiée par l'élément de campagne, mais que vous êtes prêt à laisser Ad Manager ajuster cette taille pour qu'elle s'adapte au bloc d'annonces à la volée). Les LICA ne figurent pas dans l'interface utilisateur d'Ad Manager. Il s'agit d'une convention d'API.

Créations

Un Creative représente l'annonce réelle. Si l'annonce est hébergée par Ad Manager, cet objet contient les octets d'image, les fichiers Flash ou les tags HTML personnalisés stockés sur les serveurs d'Ad Manager. Si la création est hébergée sur un site tiers, la création est une URL ou un extrait de code HTML qui envoie la demande au serveur tiers.

Ciblage d'inventaire et sous-classes de ciblage

L'objet InventoryTargeting liste les blocs d'annonces associés à un LineItem spécifique. Vous pouvez spécifier d'autres critères de ciblage facultatifs en utilisant des instances supplémentaires d'une sous-classe appropriée de Targeting.

Emplacement

Un objet Placement est un ensemble d'un ou de plusieurs objets AdUnit.

AdUnit

Une AdUnit représente un emplacement d'annonce sur une ou plusieurs pages. Un AdUnit peut être une cible d'un objet InventoryTargeting d'un LineItem ou d'un objet Placement. Un objet AdUnit comporte une taille, un identifiant et un nom unique. L'ID permet d'identifier les autres objets AdUnit dans l'API. Le nom est utilisé comme identifiant unique dans les balises HTML afin d'identifier un objet AdUnit spécifique, et est renvoyé à Ad Manager dans le cadre de la demande de page.