Récupérer des éléments de campagne YouTube et partenaires

Vous pouvez récupérer les éléments de campagne YouTube et partenaires, leurs groupes d'annonces et leurs ressources publicitaires, ainsi que le ciblage pertinent pour la diffusion d'annonces YouTube et partenaires à l'aide de l'API Display & Video 360. Les ressources et le ciblage YouTube et partenaires ne peuvent être créés ni mis à jour que via l'interface utilisateur.

Cette page explique comment utiliser l'API Display & Video 360 pour identifier les ressources YouTube et partenaires et récupérer le ciblage pertinent, et comment créer et mettre à jour des ressources YouTube et partenaires de manière groupée à l'aide de fichiers de données structurées (SDF) dans l'interface utilisateur.

Identifier les ressources YouTube et partenaires

Les ressources YouTube et partenaires se composent de certains types d'éléments de campagne, de groupes d'annonces et d'annonces.

Éléments de campagne

Les éléments de campagne dont les valeurs LineItemType sont les suivantes sont des éléments de campagne YouTube et partenaires et ne peuvent pas être créés ni mis à jour:

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Les paramètres spécifiques aux éléments de campagne YouTube et partenaires peuvent être récupérés dans le champ youtubeAndPartnersSettings de la ressource LineItem.

Annonces et groupes d'annonces YouTube

Les annonces et les groupes d'annonces YouTube sont des ressources enfants des éléments de campagne YouTube et partenaires qui permettent d'effectuer des spécifications supplémentaires.

Un élément de campagne YouTube et partenaires peut comporter plusieurs ressources AdGroup, chacune avec son propre ciblage supplémentaire et sa propre stratégie d'enchères. Chaque ressource AdGroup peut contenir plusieurs ressources AdGroupAd du même format d'annonce, chacune avec ses propres informations sur la création et sa propre liste d'URL de suivi supplémentaires.

Récupérer le ciblage

Le ciblage utilisé pour diffuser des annonces YouTube et partenaires est attribué au niveau de l'annonceur, de l'élément de campagne et du groupe d'annonces.

Le ciblage YouTube et partenaires hérité des ressources parentes n'est pas reflété dans les paramètres de ciblage des ressources enfants, comme c'est standard pour les ressources autres que YouTube et partenaires.

Pour récupérer tout le ciblage pertinent pour la diffusion d'une annonce YouTube et partenaires, vous devez:

• récupérer le ciblage attribué à son annonceur parent à l'aide de advertisers.listAssignedTargetingOptions ;
• récupérer le ciblage attribué à son élément de campagne parent à l'aide de advertisers.lineItems.bulkListAssignedTargetingOptions ;
• et récupérer le ciblage attribué à son groupe d'annonces parent à l'aide de advertisers.adGroups.bulkListAssignedTargetingOptions.

Tentative de modification du ciblage YouTube

Comme pour les ressources YouTube et partenaires, vous ne pouvez pas modifier le ciblage YouTube et partenaires à l'aide de l'API Display & Video 360. Toute tentative de modification du ciblage suivant renvoie une erreur:

• Ciblage attribué à n'importe quel niveau des types de ciblage suivants : TARGETING_TYPE_SESSION_POSITION, TARGETING_TYPE_YOUTUBE_CHANNEL et TARGETING_TYPE_YOUTUBE_VIDEO.
• Ciblage attribué aux ressources d'éléments de campagne YouTube et partenaires.
• Ciblage attribué aux ressources AdGroup.

Créer et mettre à jour à l'aide de l'importation de l'UI SDF

Bien que vous ne puissiez pas créer ni mettre à jour de ressources YouTube et partenaires à l'aide de l'API Display & Video 360, vous pouvez créer ou mettre à jour des éléments de campagne, des groupes d'annonces et des annonces YouTube et partenaires de manière groupée à l'aide de l'importation de fichiers de données structurées (SDF) via l'interface utilisateur de Display & Video 360.

Ces ressources sont représentées dans le format SDF par les formats de fichiers Élément de campagne, Groupe d'annonces YouTube et Annonce YouTube.

Vous pouvez générer et télécharger des fichiers de données structurées à l'aide de l'API Display & Video 360. Modifiez les lignes existantes pour modifier les ressources existantes ou ajoutez des lignes pour créer des ressources, puis importez les fichiers mis à jour via l'interface utilisateur de Display & Video 360.