Ensemble de valeurs AdDynamicTextPerformanceReportColumn - Création de rapports

Article
12/21/2023

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

Utilisé par

AdDynamicTextPerformanceReportRequest

Partager via