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 ou mis à jour que dans l'UI.
Cette page explique comment utiliser l'API Display & Video 360 pour identifier les ressources YouTube et partenaires et récupérer le ciblage pertinent. Elle explique également 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'UI.
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 la valeur LineItemType est définie sont des éléments de campagne YouTube et partenaires. Vous ne pouvez pas les créer ni les modifier :
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_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 à partir du champ youtubeAndPartnersSettings de la ressource LineItem.
Groupes d'annonces et annonces YouTube
Les groupes d'annonces et les annonces YouTube sont des ressources enfants des éléments de campagne YouTube et partenaires qui permettent d'affiner les spécifications.
Un élément de campagne YouTube et partenaires peut comporter plusieurs ressources AdGroup, chacune ayant sa propre stratégie d'enchères et son propre ciblage supplémentaire. 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 le cas pour les ressources non YouTube et partenaires.
Pour récupérer tous les critères de ciblage pertinents 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 renverra une erreur :
- Ciblage attribué à n'importe quel niveau des types de ciblage suivants :
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNELetTARGETING_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 des données à l'aide de l'UI d'importation de fichiers 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 en important des fichiers de données structurées (SDF) dans l'UI Display & Video 360.
Ces ressources sont représentées dans les fichiers SDF au format É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 apporter des modifications aux ressources existantes ou ajoutez de nouvelles lignes pour créer des ressources. Ensuite, importez les fichiers mis à jour dans l'UI Display & Video 360.