Modèle de service de rapports

Le service de création de rapports contient les opérations que vous utilisez pour envoyer des demandes de rapport et interroger leur status. Les rapports fournissent des statistiques détaillées sur les comptes, les campagnes et les groupes d’annonces Microsoft Advertising. Ces informations peuvent vous aider à effectuer un suivi financier, à mesurer les performances des annonces et à ajuster les paramètres pour optimiser votre budget ou votre campagne. Par exemple, vous pouvez utiliser le rapport de performances des mots clés pour voir quels mots clés fonctionnent bien et ceux qui ne le sont pas.

Vue d’ensemble de Reporting Service

Lorsque vous soumettez une demande de rapport, vous choisissez les attributs de rapport et les statistiques de performances pour déterminer le contenu du rapport. Par exemple, vous pouvez inclure les impressions, les clics et le taux de clics. Le rapport utilise les noms des colonnes comme en-têtes de colonne. Le rapport inclut les colonnes dans le même ordre que vous les avez incluses dans l’élément Colonnes de la demande de rapport. Pour plus d’informations sur la façon dont les colonnes affectent la sortie des données, consultez Colonnes qui regroupent les données ci-dessous. Pour plus d’informations sur les restrictions sur les combinaisons de colonnes dans la même demande de rapport, consultez Restrictions de colonne ci-dessous.

Vous allez également spécifier les paramètres de rapport qui restreignent ou limitent l’ensemble des données renvoyées. Par exemple, vous pouvez définir le niveau d’agrégation pour regrouper les données par jour ou par mois ; spécifiez la période des données à inclure dans le rapport à l’aide de dates spécifiques ou de plages de dates prédéfinies, telles que aujourd’hui ou les sept derniers jours ; spécifier l’étendue des données en identifiant les comptes, les campagnes et les groupes d’annonces à inclure dans le rapport ; et définir des critères de filtre pour filtrer les données du rapport. Pour plus d’informations sur les périodes que vous pouvez spécifier pour chaque valeur d’agrégation, consultez Agrégation et temps ci-dessous.

Pour obtenir la liste des rapports que vous pouvez demander, voir Types de rapports. Pour obtenir la liste complète des paramètres de rapport que vous pouvez définir, consultez chaque objet de demande de rapport et l’objet de base ReportRequest .

Pour plus d’informations sur la façon de demander et de télécharger un rapport, consultez Demander et télécharger un rapportUne fois le rapport terminé, vous pouvez télécharger le rapport à partir de l’URL renvoyée par le service. Le fichier de rapport étant compressé, vous devez le décompresser pour lire le rapport. Il n’y a pas de limite au nombre de rapports que le système peut stocker ; Toutefois, la durée de stockage des rapports n’est pas définie. Il ne vérifie pas la présence de demandes de rapport en case activée en double.

Pour plus d’informations sur la façon dont le fuseau horaire affecte la disponibilité des rapports, consultez Fuseaux horaires dans les rapports ci-dessous.

Schéma du fichier du rapport

Vous pouvez demander des données de rapport Csv, Tsv ou XML. Par défaut, si vous ne choisissez pas un autre format , les données téléchargées sont séparées par des virgules (Csv).

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 10:15:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 10:15:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 5"

"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"

"@2020 Microsoft Corporation. All rights reserved. "

Les métadonnées d’en-tête de rapport suivantes sont incluses par défaut. Si vous ne souhaitez pas que les métadonnées de l’en-tête soient définies avec la valeur true du paramètre ExcludeReportHeadin.

Les noms de colonne du rapport, par exemple, « AccountId », « CampaignId », « Keyword », « KeywordId », « DeviceType », « Clicks », sont inclus par défaut. Si vous ne souhaitez pas que les colonnes du rapport s’affichent correctement, définissez ExcludeColumnHeaders sur true.

Métadonnées de pied de page, par exemple, @2020 Microsoft Corporation. Tous droits réservés. est inclus par défaut. Si vous ne souhaitez pas que les métadonnées du pied de page soient définies sur ExcludeReportFooter sur true.

Version du format de rapport

Le format de données de certains champs peut être mis à jour dans la version actuelle de l’API sans affecter les applications clientes existantes. Vous pouvez obtenir le dernier format de données en définissant le champ facultatif de demande FormatVersion . Le tableau ci-dessous résume les différences entre les versions de format 1.0 et 2.0.

Colonnes qui regroupent les données

Les colonnes d’attribut que vous incluez dans un rapport affectent les valeurs des colonnes de statistiques, ainsi que le nombre ou les lignes. Par exemple, si vous demandez un rapport récapitulatif qui inclut uniquement AccountId, CampaignId, Keyword, KeywordId et Clics, la colonne Clics contient le nombre de clics pour le mot clé, quels que soient les attributs exclus tels que l’appareil, le type de correspondance et le réseau.

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 3"

"AccountId","CampaignId","Keyword","KeywordId","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","95"
"YourAccountId","YourCampaignId","shoes delivered","234","1"
"YourAccountId","YourCampaignId","shoe sale","345","98"

"@2020 Microsoft Corporation. All rights reserved. "

Si vous incluez ensuite la colonne DeviceType, le rapport contient une ligne pour chaque combinaison unique de valeurs de type de mot clé et d’appareil, et la valeur de la colonne clics pour chaque ligne est décomposée en conséquence.

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 7"

"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","red shoes","123","Tablet","10"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"YourAccountId","YourCampaignId","shoe sale","345","Tablet","13"

"@2020 Microsoft Corporation. All rights reserved. "

Pour plus d’informations sur chaque type de colonnes disponibles, voir Attributs de rapport et statistiques de performances.

L’attribut TimePeriod est obligatoire pour la plupart des rapports. Vous devez donc également tenir compte du fait que la spécification d’une période d’agrégation plus granulaire, par exemple mensuelle dans l’élément d’agrégation de la demande de rapport, décomposerait davantage les données de clics par mois. Par exemple, le rapport contiendra alors une ligne pour chaque combinaison unique de mot clé, appareil et mois. La ligne est incluse uniquement pour les mois qui contiennent des clics.

Restrictions de colonne

Pour les rapports qui incluent des colonnes de statistiques de performances de partage d’impression, vous ne pouvez pas inclure d’attributs contraints dans la même demande de rapport. Si vous incluez l’une des colonnes de statistiques de performances du partage d’impression, vous devez exclure toutes les colonnes d’attribut ci-dessous. De même, si vous incluez l’une des colonnes d’attribut ci-dessous, vous devez exclure toutes les colonnes de statistiques de performances du partage d’impression.

Les colonnes suivantes des statistiques de performances de l’attribut et du partage d’impression s’excluent mutuellement lors de l’envoi de AccountPerformanceReportRequest et AdGroupPerformanceReportRequest.

Les colonnes de statistiques de performances d’attribut et de partage d’impression suivantes s’excluent mutuellement lors de l’envoi de CampaignPerformanceReportRequest.

Les attributs suivants sont restreints lors de l’envoi de HotelDimensionPerformanceReportRequest.

Les attributs suivants sont restreints lors de l’envoi de HotelGroupPerformanceReportRequest.

Les colonnes de statistiques de performances d’attribut et de partage d’impression suivantes s’excluent mutuellement lors de l’envoi de ProductDimensionPerformanceReportRequest.

Les colonnes de statistiques de performances d’attribut et de partage d’impression suivantes s’excluent mutuellement lors de l’envoi de ProductPartitionPerformanceReportRequest.

Colonne Période

Si vous incluez la colonne Période , le format des valeurs dans le rapport téléchargé varie en fonction du niveau d’agrégation de rapport que vous spécifiez dans la demande de rapport. Par exemple, si le niveau d’agrégation est Quotidien, chaque champ de la colonne PériodePériode contient le jour au format aaaa-mm-jj.

Agrégation et heure

Pour la plupart des demandes de rapport, vous devez définir les éléments Agrégation et Heure . Voici les périodes que vous pouvez spécifier pour chaque valeur d’agrégation.

Aucune impression

Les données du rapport peuvent inclure des lignes avec zéro impression si l’impression s’est produite avant la période demandée, puis qu’une action ultérieure telle qu’un clic, une conversion ou un appel téléphonique se produit pendant la période demandée. De même, même au cours de la période demandée, si vous téléchargez un rapport quotidien pour les performances de la semaine dernière, il est possible que toutes les impressions aient eu lieu le dimanche, puis que des clics ou d’autres performances aient eu lieu, par exemple lundi ou mardi. Les données du rapport du lundi ou du mardi peuvent comporter des clics sans aucune impression. Vous pouvez utiliser le service en bloc ou le service de gestion des campagnes pour obtenir toutes les entités de votre compte, qu’elles aient ou non des données de performances associées.

Fuseaux horaires dans les rapports

Les données du rapport téléchargé sont toujours relatives à l’heure UTC. Par exemple, un rapport horaire peut attribuer 5 clics à l’heure 7. Dans ce cas, les 5 clics ont eu lieu entre 07:00 et 08:00 UTC.

L’élément de demande ReportTimeZone détermine le fuseau horaire utilisé pour établir la date du jour. Lorsque vous envoyez la demande de rapport, la date du jour peut varier dans le monde en fonction du fuseau horaire. La période du rapport que vous choisissez, par exemple, « Hier », est alors relative à la date d’aujourd’hui. Si vous ne choisissez pas de fuseau horaire, le service de création de rapports utilise par défaut PacificTimeUSCanadaTijuana. Par exemple, un rapport demandé sans un fuseau horaire spécifié à 2 h du matin Heure de l’EstUSACanada le 02/02/2020 pour « Hier » sera interprété comme une demande pour le 31/01/2020. Un rapport demandé en même temps pour « Hier » avec le fuseau horaire défini sur EasternTimeUSCanada sera interprété comme une demande pour le 01/02/2020.

L’élément de demande ReturnOnlyCompleteData détermine si le service doit ou non s’assurer que toutes les données ont été traitées et sont disponibles. Si la valeur est True et si le système n’a pas terminé le traitement de toutes les données en fonction de l’agrégation, de l’étendue et de l’heure demandées, le service renvoie le code d’erreur NoCompleteDataAvaliable (2004). Sinon, par défaut, la demande peut réussir, il n’y a aucune indication quant à l’exhaustivité des données et le rapport contiendra uniquement les données que le système a terminé de traiter au moment de la demande. Bien qu’aujourd’hui soit encore en cours, vous pouvez obtenir les données les plus récentes sans demander de données complètes. Ensuite, après la fermeture des livres pour la journée, vous voudrez peut-être mettre ce drapeau en place et revenir à ce qui est maintenant « hier » et obtenir les données du rapport final.

Lorsqu’un utilisateur clique sur une annonce, le système peut prendre jusqu’à deux heures pour traiter le clic (3 heures pour les conversions) et la rendre disponible pour la création de rapports. Les données sont généralement considérées comme complètes avec des livres fermés après 3 heures. Dans certains cas exceptionnels dus à un trafic non valide, des ajustements inattendus peuvent prendre une semaine ou plus. Par exemple, si une plainte d’un annonceur identifie une activité de clic non valide qui s’est échappée du système de filtration automatisé, les équipes de qualité du trafic et de support traiteront un crédit sur le compte de l’annonceur et s’associeront aux équipes internes pour déterminer si elles peuvent mettre à jour les systèmes automatisés afin d’améliorer la détection à l’avenir. Pour plus d’informations, consultez le Centre de qualité du trafic.

Métriques accréditées par le MRC

La mesure des clics sur les annonces de recherche est accréditée par le Media Rating Council (MRC) ; Cette accréditation ne s’applique à aucune autre mesure. Pour plus d’informations, consultez la description de la méthodologie de mesure du clic .

Voir aussi

Attributs de rapport et statistiques de performances
Types de rapport
Demander et télécharger un rapport
Adresses du service web de l’API Microsoft Advertising