Ensemble de valeurs AdDynamicTextPerformanceReportColumn - Création de rapports
Définit les attributs et les colonnes de statistiques de performances que vous pouvez inclure dans l’objet de données AdDynamicTextPerformanceReportRequest.
Les colonnes d’attribut que vous incluez dans un rapport peuvent affecter la façon dont les statistiques sont agrégées. En d’autres termes, le nombre de lignes augmente d’un facteur des attributs uniques. Pour plus d’informations, consultez Colonnes qui regroupent les données.
Pour obtenir la liste des colonnes que vous devez inclure, consultez la section Colonnes requises ci-dessous.
Pour voir à quel point les données agrégées toutes les heures, quotidiennes, hebdomadaires, mensuelles, annuelles et récapitulatives peuvent être récupérées pour un rapport, consultez Périodes de conservation des données de rapport.
Syntaxe
<xs:simpleType name="AdDynamicTextPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="TimePeriod" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="AdId" />
<xs:enumeration value="AdTitle" />
<xs:enumeration value="AdType" />
<xs:enumeration value="DestinationUrl" />
<xs:enumeration value="Param1" />
<xs:enumeration value="Param2" />
<xs:enumeration value="Param3" />
<xs:enumeration value="CurrencyCode" />
<xs:enumeration value="AdDistribution" />
<xs:enumeration value="Impressions" />
<xs:enumeration value="Clicks" />
<xs:enumeration value="Ctr" />
<xs:enumeration value="AverageCpc" />
<xs:enumeration value="Spend" />
<xs:enumeration value="AveragePosition" />
<xs:enumeration value="Conversions" />
<xs:enumeration value="ConversionRate" />
<xs:enumeration value="CostPerConversion" />
<xs:enumeration value="DeviceType" />
<xs:enumeration value="Language" />
<xs:enumeration value="AccountStatus" />
<xs:enumeration value="AdGroupStatus" />
<xs:enumeration value="AdStatus" />
<xs:enumeration value="KeywordStatus" />
<xs:enumeration value="TitlePart1" />
<xs:enumeration value="TitlePart2" />
<xs:enumeration value="TitlePart3" />
<xs:enumeration value="Path1" />
<xs:enumeration value="Path2" />
<xs:enumeration value="FinalUrl" />
<xs:enumeration value="FinalMobileUrl" />
<xs:enumeration value="FinalAppUrl" />
<xs:enumeration value="AdDescription" />
<xs:enumeration value="AdDescription2" />
<xs:enumeration value="AdLabels" />
<xs:enumeration value="AllConversions" />
<xs:enumeration value="AllConversionRate" />
<xs:enumeration value="AllCostPerConversion" />
<xs:enumeration value="ViewThroughConversions" />
<xs:enumeration value="Goal" />
<xs:enumeration value="GoalType" />
<xs:enumeration value="AbsoluteTopImpressionRatePercent" />
<xs:enumeration value="TopImpressionRatePercent" />
<xs:enumeration value="AverageCpm" />
<xs:enumeration value="ConversionsQualified" />
<xs:enumeration value="AllConversionsQualified" />
<xs:enumeration value="ViewThroughConversionsQualified" />
<xs:enumeration value="ViewThroughRevenue" />
</xs:restriction>
</xs:simpleType>
Values
Le jeu de valeurs AdDynamicTextPerformanceReportColumn a les valeurs suivantes : AbsoluteTopImpressionRatePercent, AccountId, AccountName, AccountNumber, AccountStatus, AdDescription, AdDescription2, AdDistribution, AdGroupId, AdGroupName, AdGroupStatus, AdId, AdLabels, AdStatus, AdTitle, AdType, AllConversionRate, AllConversions, AllConversionsQualified, AllCostPerConversion, AverageCpc, AverageCpm, AveragePosition, Clicks, ConversionRate, ConversionsQualified, CostPerConversion, Ctr, CurrencyCode, DestinationUrl, DeviceType, FinalAppUrl, FinalMobileUrl, FinalUrl, Goal, GoalType, Impressions, KeywordStatus, Language, Param1, Param2, Param3, Path1, Path2, Spend, TimePeriod, TitlePart1, TitlePart2, TitlePart3, TopImpressionRatePercent, ViewThroughConversions, ViewThroughConversionsQualified, ViewThroughRevenue.
| Valeur | Description |
|---|---|
| AbsoluteTopImpressionRatePercent | La fréquence à laquelle votre annonce était en première position de tous les résultats, en pourcentage de vos impressions totales. Un nombre plus élevé indique que votre annonce s’affiche souvent dans la meilleure position publicitaire. La valeur de cette colonne est vide si les données ne sont pas disponibles. Ni l’agrégation Hourly ni HourOfDay ne sont prises en charge. Si vous incluez cette colonne avec l’agrégation Hourly ou HourOfDay , le service ne retourne pas d’erreur et vous devez ignorer toutes les données de performances retournées pour cette colonne. |
| AccountId | Identificateur attribué par Microsoft Advertising d’un compte. |
| AccountName | Nom du compte. |
| Numéro de compte | Numéro attribué par Microsoft Advertising d’un compte. |
| AccountStatus | État du compte. |
| AdDescription | Première description de la publicité qui apparaît sous le chemin d’accès dans votre annonce. |
| AdDescription2 | Deuxième description de l’annonce qui apparaît sous le chemin d’accès dans votre annonce. La description de l’annonce 2 peut ne pas apparaître dans votre annonce. |
| AdDistribution | Réseau sur lequel vous souhaitez que vos annonces s’affichent. Il peut s’agir de l’ensemble du réseau Microsoft Advertising Network, des sites Microsoft et du trafic de sélection, ou uniquement du trafic partenaire (ce type de réseau est déconseillé à compter de juillet 2024). |
| AdGroupId | Identificateur attribué par Microsoft Advertising d’un groupe d’annonces. |
| AdGroupName | Nom du groupe d’annonces. |
| AdGroupStatus | État du groupe d’annonces. |
| AdId | Identificateur attribué par Microsoft Advertising d’une publicité. |
| AdLabels | Étiquettes appliquées à l’annonce. Les étiquettes sont délimitées par un point-virgule (;) dans le téléchargement du rapport. |
| AdStatus | État de la publicité. |
| AdTitle | Titre de l’annonce. |
| AdType | Type d’annonce. |
| AllConversionRate | Taux de conversion sous forme de pourcentage. Nombre de conversions, divisé par le nombre total de clics. Par exemple, si les publicités de votre campagne ont obtenu 300 clics et quatre conversions, le taux de conversion est de 1,33 (%). La formule pour calculer le taux de conversion est (Conversions /Clics) x 100. Les données sont exclues de la colonne de rapport ConversionRate pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversionRate inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . |
| AllConversions | Nombre de conversions. Une conversion est l’achèvement d’une action par un client après avoir consulté votre annonce. L’action peut être l’achat de votre produit, l’inscription à votre webinaire, l’adhésion à une organisation ou tout ce que vous considérez comme votre objectif et la meilleure mesure du succès de l’annonce. Les conversions sont mesurées en ajoutant un petit peu de code aux pages de votre site web afin que la progression d’un visiteur dans votre site puisse être suivie. Les données sont exclues de la colonne de rapport Conversions pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversions inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . Cette colonne étant déconseillée à partir de 2022, vous devez utiliser la colonne AllConversionsQualified à la place. À l’avenir, les rapports de performances retournent « 0 » (zéro) dans cette colonne. Les données historiques pour les périodes antérieures à la date de dépréciation sont toujours disponibles en fonction de la période de conservation des données publiées. |
| AllConversionsQualified | Nombre de conversions. Une conversion est l’achèvement d’une action par un client après avoir consulté votre annonce. L’action peut être l’achat de votre produit, l’inscription à votre webinaire, l’adhésion à une organisation ou tout ce que vous considérez comme votre objectif et la meilleure mesure du succès de l’annonce. Les conversions sont mesurées en ajoutant un petit peu de code aux pages de votre site web afin que la progression d’un visiteur dans votre site puisse être suivie. Les données sont exclues de la colonne de rapport Conversions pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversions inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . Vous devez vous attendre à ce que le type de données soit le double , qu’il y ait ou non des conversions hors connexion partiellement attribuées en externe. Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, il sera bientôt disponible ! |
| AllCostPerConversion | Coût par conversion. La formule pour calculer le coût par conversion est (Dépenses/Conversions). Seules les publicités des campagnes qui activent le suivi des conversions contribuent au numéro de conversion. Par conséquent, à moins que toutes les campagnes du compte n’activent le suivi des conversions, le nombre ne sera pas exact. Les données sont exclues de la colonne de rapport CostPerConversion pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllCostPerConversion inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . |
| AverageCpc | Coût moyen par clic (CPC). Coût total de tous les clics sur une annonce divisé par le nombre de clics. Il s’agit du montant moyen qui vous est facturé à chaque fois que l’utilisateur clique sur votre annonce. Par exemple, si vous avez payé un total de 48,35 pour 300 clics, votre CPC moyen est de 0,16. La formule permettant de calculer le NOMBRE MOYEN DEC est (Spend /Clicks). |
| AverageCpm | Le coût publicitaire total divisé par le nombre d’impressions (en milliers).<Br/ En latin, mille signifie mille. Aussi, parfois appelé coût moyen par milliers (CPT). Il s’agit d’une métrique de performance standard du secteur de la publicité que nous calculons en fonction de vos dépenses et du nombre d’impressions. L’objectif de la budgétisation publicitaire basée sur CPM est de faire connaître votre marque à de larges audiences. CPM vous indique le coût de l’obtention d’une publicité pour le type d’utilisateurs que vous ciblez. |
| AveragePosition | Position moyenne de l’annonce sur une page web. Cette colonne est déconseillée depuis le 31 mars 2021. À l’avenir, les rapports sur les performances retourneront la position moyenne de « 0 » (zéro). Les données de position moyenne historiques pour les périodes antérieures à la date de dépréciation sont toujours disponibles en fonction de la période de conservation des données publiées par type de rapport. |
| Clics | Les clics sont ce que vous payez. Les clics incluent généralement un client qui clique sur une annonce sur une page de résultats de recherche ou sur un site web sur le réseau de recherche. Les clics peuvent également provenir d’autres sources (par exemple, des araignées, des robots et des serveurs de test). Pour plus d’informations, consultez Mesure des clics Microsoft Advertising : description de la méthodologie. |
| Taux de conversion | Taux de conversion sous forme de pourcentage. Nombre de conversions, divisé par le nombre total de clics. Par exemple, si les publicités de votre campagne ont obtenu 300 clics et quatre conversions, le taux de conversion est de 1,33 (%). La formule pour calculer le taux de conversion est (Conversions /Clics) x 100. Les données sont exclues de la colonne de rapport ConversionRate pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversionRate inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . |
| Conversions | Nombre de conversions. Une conversion est l’achèvement d’une action par un client après avoir consulté votre annonce. L’action peut être l’achat de votre produit, l’inscription à votre webinaire, l’adhésion à une organisation ou tout ce que vous considérez comme votre objectif et la meilleure mesure du succès de l’annonce. Les conversions sont mesurées en ajoutant un petit peu de code aux pages de votre site web afin que la progression d’un visiteur dans votre site puisse être suivie. Les données sont exclues de la colonne de rapport Conversions pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversions inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . Cette colonne étant déconseillée à partir de 2022, vous devez utiliser la colonne ConversionsQualified à la place. À l’avenir, les rapports de performances retournent « 0 » (zéro) dans cette colonne. Les données historiques pour les périodes antérieures à la date de dépréciation sont toujours disponibles en fonction de la période de conservation des données publiées. |
| ConversionsQualified | Nombre de conversions. Une conversion est l’achèvement d’une action par un client après avoir consulté votre annonce. L’action peut être l’achat de votre produit, l’inscription à votre webinaire, l’adhésion à une organisation ou tout ce que vous considérez comme votre objectif et la meilleure mesure du succès de l’annonce. Les conversions sont mesurées en ajoutant un petit peu de code aux pages de votre site web afin que la progression d’un visiteur dans votre site puisse être suivie. Les données sont exclues de la colonne de rapport Conversions pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllConversions inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . Vous devez vous attendre à ce que le type de données soit le double , qu’il y ait ou non des conversions hors connexion partiellement attribuées en externe. Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, il sera bientôt disponible ! |
| CostPerConversion | Coût par conversion. La formule pour calculer le coût par conversion est (Dépenses/Conversions). Seules les publicités des campagnes qui activent le suivi des conversions contribuent au numéro de conversion. Par conséquent, à moins que toutes les campagnes du compte n’activent le suivi des conversions, le nombre ne sera pas exact. Les données sont exclues de la colonne de rapport CostPerConversion pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllCostPerConversion inclut des données pour tous les objectifs de conversion, quel que soit leur paramètre ExcludeFromBidding . Disponible pour les comptes configurés pour utiliser l’analytique avec le suivi des événements universels Microsoft Advertising. Pour plus d’informations, consultez la rubrique d’aide Suivre les ventes et autres conversions . |
| Ctr | Le taux de clics (CTR) correspond au nombre de clics sur une annonce, divisé par le nombre de fois où l’annonce a été affichée (impressions). Par exemple, si vos annonces ont reçu 50 clics pour 2 348 impressions, votre CTR est de 2,13 (%). La formule de calcul du CTR est (Clics / Impressions) x 100. |
| CurrencyCode | Type de devise du compte. Pour connaître les valeurs possibles, consultez Devises. |
| DestinationUrl | Attribut d’URL de destination du critère de l’annonce, du mot clé ou du groupe d’annonces. Si l’URL de destination contient des paramètres de substitution de texte dynamique (par exemple, {param1}), le rapport contient l’URL après la substitution. |
| DeviceType | Attribut de nom d’appareil d’une enchère cible du système d’exploitation de l’appareil. Type d’appareil qui affichait des publicités. Les valeurs possibles sont Ordinateur, Smartphone, Tablette et Inconnu. |
| FinalAppUrl | Réservé à une utilisation future. |
| FinalMobileUrl | URL mobile finale de la publicité, du mot clé ou du critère. Seule la première URL de la liste est signalée. Si l’URL contient des paramètres de substitution de texte dynamique (par exemple, {param1}), le rapport contient l’URL avant la substitution. |
| FinalUrl | URL finale de l’annonce, du mot clé ou du critère. Seule la première URL de la liste est signalée. Si l’URL contient des paramètres de substitution de texte dynamique (par exemple, {param1}), le rapport contient l’URL avant la substitution. |
| Objectif | Nom de l’objectif que vous définissez pour les conversions souhaitées, ce qui signifie que les clients effectuent les actions effectuées après avoir cliqué sur votre annonce. |
| GoalType | Type d’objectif de conversion. Les valeurs possibles incluent AppInstall, Duration, Event, InStoreTransaction, OfflineConversion, PagesViewedPerVisit et Url. |
| Impressions | Nombre de fois où une annonce a été affichée sur les pages de résultats de recherche. Sans impressions, il n’y a pas de clics ni de conversions. |
| Mot clé | Texte du mot clé. |
| KeywordStatus | État du mot clé. |
| Langue | Langue de l’éditeur où l’annonce a été affichée. Pour connaître les valeurs possibles, consultez la colonne Language de Ad Languages. Le nom complet de la langue sera fourni dans le rapport, par exemple , anglais. |
| Param1 | Premier paramètre de substitution dynamique (Param1) d’un mot clé ou d’un critère de groupe d’annonces biddable. |
| Param2 | Deuxième paramètre de substitution dynamique (Param2) d’un mot clé ou d’un critère de groupe d’annonces biddable. |
| Param3 | Troisième paramètre de substitution dynamique (Param3) d’un mot clé ou d’un critère de groupe d’annonces biddable. |
| Chemin d’accès1 | Attribut chemin d’accès 1 d’une publicité. |
| Chemin d’accès 2 | Attribut chemin d’accès 2 d’une annonce. |
| Dépenser | Coût par clic (CPC) totalisé pour chaque clic. |
| TimePeriod | Période de chaque ligne de rapport. Vous ne pouvez pas inclure cette colonne si l’élément Aggregation de l’objet de requête est défini sur Summary. Pour plus d’informations, consultez Colonne de période. |
| TitlePart1 | Attribut titre partie 1 d’une annonce. |
| TitlePart2 | Attribut titre partie 2 d’une annonce. |
| TitlePart3 | Attribut titre partie 3 d’une annonce. |
| TopImpressionRatePercent | Pourcentage de fois où votre annonce s’est affichée dans la ligne principale, l’emplacement le plus élevé où les annonces apparaissent au-dessus des résultats de la recherche, par rapport à vos impressions totales. Cela indique comment les modifications apportées à la position de la publicité peuvent avoir un impact sur les performances. La valeur de cette colonne est vide si les données ne sont pas disponibles. Ni l’agrégation Hourly ni HourOfDay ne sont prises en charge. Si vous incluez cette colonne avec l’agrégation Hourly ou HourOfDay , le service ne retourne pas d’erreur et vous devez ignorer toutes les données de performances retournées pour cette colonne. |
| ViewThroughConversions | Les conversions d’affichage sont des conversions effectuées par des personnes après avoir vu votre annonce, même si elles n’ont pas cliqué sur la publicité. Les conversions en mode affichage n’ont pas de clic associé, mais une impression est associée dans la fenêtre de conversion définie par l’annonceur. Si l’utilisateur a également cliqué sur une annonce qui a été remise via le réseau de recherche ou d’audience Microsoft, aucune conversion d’affichage n’est comptabilisée. Seule la conversion basée sur un clic est comptabilisée. Les conversions d’affichage sont comptabilisées uniquement pour les publicités dans le réseau d’audience Microsoft. Cette colonne étant déconseillée à partir de 2022, vous devez utiliser la colonne ViewThroughConversionsQualified à la place. À l’avenir, les rapports de performances retournent « 0 » (zéro) dans cette colonne. Les données historiques pour les périodes antérieures à la date de dépréciation sont toujours disponibles en fonction de la période de conservation des données publiées. |
| ViewThroughConversionsQualified | Les conversions d’affichage sont des conversions effectuées par des personnes après avoir vu votre annonce, même si elles n’ont pas cliqué sur la publicité. Les conversions en mode affichage n’ont pas de clic associé, mais une impression est associée dans la fenêtre de conversion définie par l’annonceur. Si l’utilisateur a également cliqué sur une annonce qui a été remise via le réseau de recherche ou d’audience Microsoft, aucune conversion d’affichage n’est comptabilisée. Seule la conversion basée sur un clic est comptabilisée. Les conversions d’affichage sont comptabilisées uniquement pour les publicités dans le réseau d’audience Microsoft. Vous devez vous attendre à ce que le type de données soit le double , qu’il y ait ou non des conversions hors connexion partiellement attribuées en externe. Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, il sera bientôt disponible ! |
| ViewThroughRevenue | Chiffre d’affaires éventuellement déclaré par l’annonceur à la suite de conversions d’affichage. |
Remarques
Colonnes requises
Le rapport doit inclure au minimum les colonnes suivantes. En règle générale, chaque rapport doit inclure au moins une colonne d’attribut et au moins une colonne de statistiques de performances de partage sans impression. Pour plus d’informations, consultez Attributs de rapport et statistiques de performances.
Notes
La colonne TimePeriod est attendue pour tous les types d’agrégation, à l’exception de Summary. Il est important de noter que si vous n’incluez pas TimePeriod, l’agrégation que vous avez choisie sera ignorée et l’agrégation Résumé sera utilisée indépendamment.
| Column |
|---|
| AdTitle |
| DestinationUrl |
| Param1 |
| Param2 |
| Param3 |
| TimePeriod |
Configuration requise
Service : ReportingService.svc v13
Espace de noms: https://bingads.microsoft.com/Reporting/v13