Ensemble de valeurs AdExtensionByAdReportColumn - Création de rapports

Article
12/21/2023

Définit les colonnes des attributs et des statistiques de performances que vous pouvez inclure dans adExtensionByAdReportRequest.

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="AdExtensionByAdReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdTitle" />
    <xs:enumeration value="AdId" />
    <xs:enumeration value="AdExtensionType" />
    <xs:enumeration value="DeviceType" />
    <xs:enumeration value="DeviceOS" />
    <xs:enumeration value="ClickType" />
    <xs:enumeration value="Impressions" />
    <xs:enumeration value="Clicks" />
    <xs:enumeration value="TotalClicks" />
    <xs:enumeration value="Conversions" />
    <xs:enumeration value="Ctr" />
    <xs:enumeration value="AverageCpc" />
    <xs:enumeration value="ConversionRate" />
    <xs:enumeration value="Spend" />
    <xs:enumeration value="AdExtensionId" />
    <xs:enumeration value="AdExtensionVersion" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="BidMatchType" />
    <xs:enumeration value="DeliveredMatchType" />
    <xs:enumeration value="Network" />
    <xs:enumeration value="TopVsOther" />
    <xs:enumeration value="Assists" />
    <xs:enumeration value="Revenue" />
    <xs:enumeration value="ReturnOnAdSpend" />
    <xs:enumeration value="CostPerConversion" />
    <xs:enumeration value="CostPerAssist" />
    <xs:enumeration value="RevenuePerConversion" />
    <xs:enumeration value="RevenuePerAssist" />
    <xs:enumeration value="AccountStatus" />
    <xs:enumeration value="CampaignStatus" />
    <xs:enumeration value="AdGroupStatus" />
    <xs:enumeration value="AdStatus" />
    <xs:enumeration value="TitlePart1" />
    <xs:enumeration value="TitlePart2" />
    <xs:enumeration value="TitlePart3" />
    <xs:enumeration value="AllConversions" />
    <xs:enumeration value="AllRevenue" />
    <xs:enumeration value="AllConversionRate" />
    <xs:enumeration value="AllCostPerConversion" />
    <xs:enumeration value="AllReturnOnAdSpend" />
    <xs:enumeration value="AllRevenuePerConversion" />
    <xs:enumeration value="Goal" />
    <xs:enumeration value="GoalType" />
    <xs:enumeration value="AverageCpm" />
    <xs:enumeration value="ConversionsQualified" />
    <xs:enumeration value="AllConversionsQualified" />
    <xs:enumeration value="GoalId" />
  </xs:restriction>
</xs:simpleType>

Values

La valeur AdExtensionByAdReportColumn définie a les valeurs suivantes : AccountId, AccountName, AccountNumber, AccountStatus, AdExtensionId, AdExtensionType, AdExtensionVersion, AdGroupId, AdGroupName, AdGroupStatus, AdId, AdStatus, AdTitle, AllConversionRate, AllConversions, AllConversionsQualified, AllCostPerConversion, AllReturnOnAdSpend, AllRevenue, AllRevenuePerConversion, Assists, AverageCpc, AverageCpm, BidMatchType, CampaignId, CampaignName, CampaignStatus, Clicks, ClickType, ConversionRate, ConversionsQualified, CostPerAssist, CostPerConversion, Ctr, DeliveredMatchType, DeviceOS, DeviceType, GoalId, GoalType, Impressions, Network, ReturnOnAdSpend, Revenue , RevenuePerAssist, RevenuePerConversion, Spend, TimePeriod, TitlePart1, TitlePart2, TitlePart3, TopVsOther, TotalClicks.

Valeur	Description
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.
AdExtensionId	Identificateur attribué par Microsoft Advertising d’une extension d’annonce.
AdExtensionType	Nom de type qui correspond à la colonne AdExtensionTypeId .
AdExtensionVersion	Attribut de version d’une extension d’annonce.
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é.
AdStatus	État de la publicité.
AdTitle	Titre de l’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 .
AllReturnOnAdSpend	Retour sur les dépenses publicitaires (ROAS). La formule de calcul du ROAS est (Revenue/Spend). Les données sont exclues de la colonne de rapport ReturnOnAdSpend pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllReturnOnAdSpend 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 .
AllRevenue	Chiffre d’affaires éventuellement déclaré par l’annonceur à la suite de conversions. Les données sont exclues de la colonne Rapport sur le chiffre d’affaires pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllRevenue 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 .
AllRevenuePerConversion	Chiffre d’affaires par conversion. La formule pour calculer le chiffre d’affaires par conversion est (Revenue/Conversions). Les données sont exclues de la colonne de rapport RevenuePerConversion pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllRevenuePerConversion 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 .
Aide	Nombre de conversions à partir d’autres annonces au sein du même compte qui ont été précédées d’un ou plusieurs clics à partir de cette annonce. Une publicité est considérée comme ayant aidé la conversion si elle a été cliquée avant la dernière annonce qui a été créditée pour la conversion. En outre, le clic correspondant à l’assistance doit se produire pendant la période de conversion de l’objectif.
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.
BidMatchType	Type de correspondance d’enchère de mot clé. Cela peut être différent de la colonne DeliveredMatchType , par exemple si vous enchériez sur une correspondance large et que le terme de recherche correspondait exactement. Pour plus d’informations, consultez Stratégies de budget et d’enchère. Les valeurs possibles sont Broad, Exact, Phrase et Unknown.
CampaignId	Identificateur attribué par Microsoft Advertising d’une campagne.
CampaignName	Nom de la campagne.
CampaignStatus	État de la campagne.
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.
ClickType	Le type de clic fait référence à chaque composant d’une annonce sur laquelle un client peut cliquer. Les types de clics possibles sont le titre de l’annonce, l’image, le numéro de téléphone, l’itinéraire, le lien de site et la révision.
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 !
CostPerAssist	Coût par assistance. La formule de calcul du coût par assistance est (Dépenses / Assistances).
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.
DeliveredMatchType	Type de correspondance utilisé pour remettre une annonce. Cela peut être différent de la colonne BidMatchType , par exemple si vous enchériez sur une correspondance large et que le terme de recherche correspondait exactement. Pour plus d’informations, consultez Stratégies de budget et d’enchère. Les valeurs possibles sont Broad, Exact, Phrase et Unknown.
DeviceOS	Système d’exploitation de l’appareil signalé dans la colonne DeviceType . Les valeurs possibles incluent Android, Blackberry, iOS, Other, Unknown et Windows. Si le système d’exploitation de l’appareil ne peut pas être déterminé ou ne fait pas partie des systèmes d’exploitation que vous pouvez cibler, la valeur de cette colonne est Inconnu.
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.
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.
GoalId	Identificateur attribué par Microsoft Advertising d’un objectif de conversion.
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.
Réseau	L’ensemble de Microsoft Advertising Network composé des sites Microsoft et du trafic sélectionné, et uniquement le trafic des partenaires (ce type de réseau est déconseillé à compter de juillet 2024). Utilisez ces données pour prendre la meilleure décision sur la sélection du réseau pour vos groupes d’annonces. Les valeurs possibles incluent la recherche AOL, l’audience, les sites Microsoft et le trafic sélectionné, le contenu et les partenaires de recherche syndiqués. Remarque : Tout le monde ne peut pas encore utiliser la valeur sites Microsoft et sélectionner le trafic . Si vous ne pouvez pas, ne vous inquiétez pas - il sera bientôt disponible !
ReturnOnAdSpend	Retour sur les dépenses publicitaires (ROAS). La formule de calcul du ROAS est (Revenue/Spend). Les données sont exclues de la colonne de rapport ReturnOnAdSpend pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllReturnOnAdSpend 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 .
Revenu	Chiffre d’affaires éventuellement déclaré par l’annonceur à la suite de conversions. Les données sont exclues de la colonne Rapport sur le chiffre d’affaires pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllRevenue 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 .
RevenuePerAssist	Chiffre d’affaires par assistance. La formule de calcul du chiffre d’affaires par assistance est (Chiffre d’affaires/Assistances).
RevenuePerConversion	Chiffre d’affaires par conversion. La formule pour calculer le chiffre d’affaires par conversion est (Revenue/Conversions). Les données sont exclues de la colonne de rapport RevenuePerConversion pour tout objectif de conversion avec la propriété ExcludeFromBidding définie sur true. La colonne AllRevenuePerConversion 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 .
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.
TopVsOther	Indique si l’impression publicitaire s’est affichée en position supérieure ou ailleurs. Les valeurs possibles incluent AOL search - Top, AOL search - Other, Audience network, Bing et Yahoo ! search - Top, Bing et Yahoo ! search - Autres, Partenaires de recherche syndiqués - Top, Partenaires de recherche syndiquée - Autre, Réseau de contenu et Inconnu.
TotalClicks	Nombre de fois facturables et non facturables où l’extension d’annonce a été cliquée.

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
AdExtensionType
TimePeriod

Configuration requise

Service : ReportingService.svc v13
Espace de noms: https://bingads.microsoft.com/Reporting/v13

Utilisé par

AdExtensionByAdReportRequest

Partager via