Présentation
Ces pages listent les ressources qui peuvent être interrogées dans l'API à l'aide de SearchAds360Service.SearchStream ou de SearchAds360Service.Search. Les noms des ressources sont associés à leur propre page. Sur chaque page, les listes suivantes s'affichent :
- Artefacts (ressources, segments ou métriques) pouvant être utilisés dans la même clause SELECT avec la ressource
- Ressources attribuées dont les champs ne segmenteront pas les métriques, lorsqu'elles sont incluses dans les mêmes clauses SELECT et WHERE de ces champs de ressources
Après ces listes, vous trouverez les tableaux contenant les noms des champs de ressources, des segments et des métriques pouvant être inclus dans une requête de recherche, lorsque cette ressource est spécifiée dans la clause FROM. Chaque nom est associé à la table qui contient ses métadonnées :
categorydata typetype URLfilterableselectablesortablerepeated
- Filtrable
- Cette ligne indique si le champ peut être utilisé dans les conditions de la clause
WHEREde la requête. - Sélectionnable
- Cette ligne indique si le champ peut être spécifié dans la clause
SELECTde la requête. - Sortable
- Cette ligne indique si le champ peut être trié et utilisé dans la clause
ORDER BYde la requête. - Répété
- Cette ligne indique si le champ est répété, ce qui doit être traité comme une liste.
Liste de toutes les ressources
| Types de ressources | |
|---|---|
| accessible_bidding_strategy | Représente une vue des stratégies d'enchères détenues par le client et partagées avec lui. Contrairement à BiddingStrategy, cette ressource inclut les stratégies appartenant aux administrateurs du client et partagées avec ce client, en plus des stratégies appartenant à ce client. Cette ressource ne fournit pas de métriques et n'expose qu'un sous-ensemble limité des attributs BiddingStrategy. |
| ad_group | Un groupe d'annonces. |
| ad_group_ad | Annonce d'un groupe d'annonces. |
| ad_group_ad_effective_label | Relation entre une annonce de groupe d'annonces et une étiquette effective. Un libellé effectif est un libellé hérité ou directement attribué à cette annonce de groupe d'annonces. |
| ad_group_ad_label | Relation entre une annonce de groupe d'annonces et un libellé. |
| ad_group_asset | Lien entre un groupe d'annonces et un composant. |
| ad_group_asset_set | "AdGroupAssetSet" correspond à l'association entre un groupe d'annonces et un ensemble de composants. La création d'un AdGroupAssetSet associe un ensemble de composants à un groupe d'annonces. |
| ad_group_audience_view | Vue d'une audience de groupe d'annonces. Inclut les données sur les performances des listes de remarketing et des listes d'intérêts pour les annonces sur le Réseau Display et le réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées au niveau de l'audience. |
| ad_group_bid_modifier | Représente un modificateur d'enchère de groupe d'annonces. |
| ad_group_criterion | Critère de groupe d'annonces. Le rapport ad_group_criterion ne renvoie que les critères qui ont été explicitement ajoutés au groupe d'annonces. |
| ad_group_criterion_effective_label | Relation entre un critère de groupe d'annonces et une étiquette effective. Un libellé effectif est un libellé hérité ou directement attribué à ce critère de groupe d'annonces. |
| ad_group_criterion_label | Relation entre un critère de groupe d'annonces et un libellé. |
| ad_group_effective_label | Relation entre un groupe d'annonces et un libellé effectif. Un libellé effectif est un libellé hérité ou directement attribué à ce groupe d'annonces. |
| ad_group_label | Relation entre un groupe d'annonces et un libellé. |
| age_range_view | Vue d'une tranche d'âge. Représente la vue des métriques de performances d'un client (comme les impressions et les clics) agrégées par tranche d'âge. Toutes les statistiques sont agrégées au niveau du groupe d'annonces. Remarque : Bien que vous puissiez segmenter les métriques par tranche d'âge à l'aide de age_range_view ou par genre à l'aide de gender_view, l'API Search Ads 360 ne permet pas de segmenter les métriques à la fois par tranche d'âge et par genre dans une même requête. L'API Search Ads 360 ne permet pas d'analyser les performances en combinant ces deux dimensions. |
| composant | Un composant est une partie d'une annonce qui peut être partagée entre plusieurs annonces. Il peut s'agir d'une image (ImageAsset), d'une vidéo (YoutubeVideoAsset), etc. Les assets sont immuables et ne peuvent pas être supprimés. Pour arrêter la diffusion d'un composant, supprimez-le de l'entité qui l'utilise. |
| asset_group | Un groupe de composants. AssetGroupAsset permet d'associer un composant au groupe de composants. AssetGroupSignal permet d'associer un signal à un groupe de composants. |
| asset_group_asset | AssetGroupAsset est le lien entre un composant et un groupe de composants. L'ajout d'un AssetGroupAsset associe un composant à un groupe de composants. |
| asset_group_listing_group_filter | AssetGroupListingGroupFilter représente un nœud d'arborescence de filtres de groupes de fiches dans un groupe de composants. |
| asset_group_signal | AssetGroupSignal représente un signal dans un groupe de composants. L'existence d'un signal indique à la campagne Performance Max quels utilisateurs sont les plus susceptibles d'effectuer une conversion. Les campagnes Performance Max utilisent le signal pour rechercher d'autres personnes ayant une intention similaire ou plus forte afin de générer des conversions sur les réseaux de Recherche, Display, vidéo, etc. |
| asset_group_top_combination_view | Vue sur l'utilisation des principales combinaisons de composants d'un groupe de composants. |
| asset_set | Ensemble de composants représentant une collection de composants. Utilisez AssetSetAsset pour associer un composant à l'ensemble de composants. |
| asset_set_asset | AssetSetAsset est le lien entre un composant et un ensemble de composants. L'ajout d'un AssetSetAsset associe un composant à un ensemble de composants. |
| audience | L'audience est une option de ciblage efficace qui vous permet de croiser différents attributs de segment, tels que des données démographiques détaillées et des affinités, afin de créer des audiences qui représentent des sections de vos segments cibles. |
| bidding_strategy | Une stratégie d'enchères. |
| campaign | Une campagne. |
| campaign_asset | Lien entre une campagne et un composant. |
| campaign_asset_set | CampaignAssetSet est l'association entre une campagne et un ensemble de composants. L'ajout d'un CampaignAssetSet associe un ensemble de composants à une campagne. |
| campaign_audience_view | Vue d'une audience de campagne. Inclut les données sur les performances des listes de centres d'intérêt et de remarketing pour les annonces sur le Réseau Display et le Réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées par campagne et par critère d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne. |
| campaign_budget | Un budget de campagne. |
| campaign_criterion | Critère de campagne. |
| campaign_effective_label | Représente une relation entre une campagne et une étiquette effective. Un libellé effectif est un libellé hérité ou directement attribué à cette campagne. |
| campaign_label | Représente une relation entre une campagne et un libellé. |
| cart_data_sales_view | Vue des ventes des données du panier. Fournit des informations sur les produits achetés si les conversions avec les données du panier sont implémentées. Les métriques de performances telles que les revenus, la marge brute, les métriques de prospects/ventes croisées, etc., et les attributs Merchant Center tels que la marque, la catégorie, etc., sont disponibles pour les produits définis dans un flux d'inventaire et vendus grâce aux annonces Google. Pour les achats attribués à des clics sur des annonces Shopping, les dimensions des produits cliqués et vendus peuvent être affichées ensemble. |
| conversion | Une conversion. |
| conversion_action | Une action de conversion. |
| conversion_custom_variable | Une variable personnalisée de conversion. Consultez l'article "À propos des métriques et dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" à l'adresse https://support.google.com/sa360/answer/13567857. |
| clientèle | Un client. |
| customer_asset | Lien entre un client et un composant. |
| customer_asset_set | CustomerAssetSet est l'association entre un client et un ensemble de composants. L'ajout d'un CustomerAssetSet associe un ensemble de composants à un client. |
| customer_client | Lien entre le client donné et un client client. Les CustomerClients n'existent que pour les comptes administrateur. Tous les clients directs et indirects sont inclus, ainsi que l'administrateur lui-même. |
| customer_manager_link | Représente la relation de lien client-administrateur. |
| dynamic_search_ads_search_term_view | Vue des termes de recherche pour les annonces dynamiques du Réseau de Recherche. |
| gender_view | Ressource de vue par genre. Représente la vue des métriques de performances d'un client, agrégées par genre. Toutes les statistiques sont agrégées au niveau du groupe d'annonces. Remarque : Bien que vous puissiez segmenter les métriques par tranche d'âge à l'aide de age_range_view ou par genre à l'aide de gender_view, l'API Search Ads 360 ne permet pas de segmenter les métriques à la fois par tranche d'âge et par genre dans une même requête. L'API Search Ads 360 ne permet pas d'analyser les performances en combinant ces deux dimensions. |
| geo_target_constant | Une constante de ciblage géographique. |
| keyword_view | Une vue des mots clés. |
| label | Un libellé. |
| language_constant | Une langue. |
| location_view | Une vue géographique résume les performances des campagnes selon un critère géographique. |
| product_bidding_category_constant | Une catégorie d'enchères de produits. |
| product_group_view | Une vue du groupe de produits. |
| shopping_performance_view | Vue des performances Shopping. Fournit des statistiques sur les campagnes Shopping et Performance Max, agrégées à plusieurs niveaux de dimension de produit. Les valeurs des dimensions de produit de Merchant Center, telles que la marque, la catégorie, les attributs personnalisés, l'état du produit et le type de produit, reflètent l'état de chaque dimension à la date et à l'heure d'enregistrement de l'événement correspondant. Le nombre d'impressions et de clics pour lesquels shopping_performance_view renvoie des statistiques peut être différent de celui des rapports sur les campagnes. shopping_performance_view indique les impressions et les clics sur les produits apparaissant dans les annonces, tandis que les rapports sur les campagnes indiquent les impressions et les clics sur les annonces elles-mêmes. Selon le format, une annonce peut afficher de zéro à plusieurs produits. Les chiffres peuvent donc ne pas correspondre. Dans l'interface utilisateur de Search Ads 360, vous pouvez interroger les impressions et les clics des produits apparaissant dans les annonces en sélectionnant une colonne dans "Attributs de produit" dans l'éditeur de rapports. Par exemple, sélectionner la colonne "Marque" équivaut à sélectionner segments.product_brand. |
| user_list | Une liste d'utilisateurs. Il s'agit d'une liste d'utilisateurs qu'un client peut cibler. La clé unique d'une liste d'utilisateurs se compose des champs suivants : id. Notez que le name doit également être unique pour les listes d'utilisateurs appartenant à un client donné, sauf dans certains cas où access_reason est défini sur SHARED. Le non-respect de la contrainte de nom unique génère l'erreur UserListError.INVALID_NAME. |
| user_location_view | Vue de la position géographique de l'utilisateur. La vue "Emplacement de l'utilisateur" inclut toutes les métriques agrégées au niveau du pays, à raison d'une ligne par pays. Il indique les métriques en fonction de la position physique réelle de l'utilisateur, selon la zone ciblée ou non. Si d'autres champs de segment sont utilisés, vous pouvez obtenir plusieurs lignes par pays. |
| visit | Une visite. |
| webpage_view | Vue d'une page Web. |