Partager via


Jeu de valeurs SearchCampaignChangeHistoryReportColumn - Création de rapports

Définit les colonnes d’attribut que vous pouvez inclure dans searchCampaignChangeHistoryReportRequest.

Pour obtenir la liste des colonnes que vous devez inclure, consultez la section Colonnes requises ci-dessous.

Syntaxe

<xs:simpleType name="SearchCampaignChangeHistoryReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="DateTime" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="ChangedBy" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdTitle" />
    <xs:enumeration value="AdDescription" />
    <xs:enumeration value="DisplayUrl" />
    <xs:enumeration value="Keyword" />
    <xs:enumeration value="ItemChanged" />
    <xs:enumeration value="AttributeChanged" />
    <xs:enumeration value="HowChanged" />
    <xs:enumeration value="OldValue" />
    <xs:enumeration value="NewValue" />
    <xs:enumeration value="EntityName" />
    <xs:enumeration value="EntityId" />
    <xs:enumeration value="Tool" />
  </xs:restriction>
</xs:simpleType>

Valeurs

La valeur SearchCampaignChangeHistoryReportColumn définie a les valeurs suivantes : AccountId, AccountName, AccountNumber, AdDescription, AdGroupId, AdGroupName, AdTitle, AttributeChanged, CampaignId, CampaignName, ChangedBy, DateTime, DisplayUrl, EntityId, EntityName, HowChanged, ItemChanged, Keyword, NewValue, OldValue, Tool.

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.
AdDescription Première description de la publicité qui apparaît sous le chemin d’accès dans votre annonce. Cette colonne est vide si ItemChanged n’est pas Ad.
AdGroupId Identificateur attribué par Microsoft Advertising d’un groupe d’annonces. Cette colonne est vide si ItemChanged n’est pas Ad, Groupe d’annonces ou Mot clé.
AdGroupName Nom du groupe d’annonces. Cette colonne est vide si ItemChanged n’est pas Ad, Groupe d’annonces ou Mot clé.
AdTitle Parties du titre de l’annonce. Cette colonne est vide si ItemChanged n’est pas Ad.
AttributeChanged Identifie l’attribut ou la propriété de l’entité à partir de la colonne ItemChanged modifiée. Pour obtenir la liste des éléments dont l’historique des modifications est signalé, consultez la colonne Attribut modifié dans Remarques. Cette colonne est vide si une campagne, un groupe d’annonces ou une entité publicitaire a été ajouté ou supprimé.
CampaignId Identificateur attribué par Microsoft Advertising d’une campagne.
CampaignName Nom de la campagne.
ChangedBy Nom d’utilisateur de l’utilisateur qui a apporté la modification aux paramètres dans le compte. Si le système a apporté la modification, la valeur est Administrateur.
Datetime Date et heure de la modification. La date et l’heure se trouveront dans le fuseau horaire de la campagne.
DisplayUrl URL d’affichage de l’annonce. Cette colonne est vide si ItemChanged n’est pas Ad.
EntityId Identificateur système Microsoft Advertising de l’entité qui a été mise à jour.
EntityName Nom de l’entité qui a été mise à jour.
HowChanged Valeur qui indique si l’élément a été ajouté, mis à jour ou supprimé. Pour connaître les valeurs possibles, consultez ChangeTypeReportFilter Value Set. Pour les ajouts, la colonne NewValue contient l’entité ajoutée. Pour les suppressions, la colonne OldValue contient l’entité supprimée. Pour les mises à jour, la colonne NewValue contient la nouvelle valeur et la colonne OldValue contient l’ancienne valeur. Si une entité qui a une propriété de remise status a été ajoutée, par exemple une campagne, la valeur de HowChanged est Ajoutée. Pour signaler une entité supprimée, le champ ItemChanged est État, le champ HowChanged est Modifié et le champ NewValue est Supprimé. L’association d’une cible à une campagne ou à un groupe d’annonces est signalée comme une modification supplémentaire. La colonne AttributeChanged identifie les types cibles contenus dans l’objet cible. Mises à jour à un objet cible est signalé sous la forme d’une modification de suppression et d’une modification d’ajout. La suppression de l’association d’une campagne ou d’un groupe d’annonces à un objet cible est signalée en tant que modification de suppression.
ItemChanged Valeur qui identifie l’entité qui a changé. Si la modification est une mise à jour d’un élément de l’entité ou est liée à une cible associée à une campagne ou un groupe d’annonces, la colonne AttributeChanged contient l’élément de l’entité qui a changé ou le type de cible qui a été modifié.
Mot clé Texte mot clé. Cette colonne est vide si ItemChanged n’est pas Keyword.
NewValue Valeur après la modification. Pour plus d’informations, consultez la colonne HowChanged .
OldValue Valeur avant la modification. Pour plus d’informations, consultez la colonne HowChanged .
Outil Outil Microsoft Advertising utilisé pour apporter des modifications.

Les valeurs possibles sont « API », « Règles automatisées », « Chargement en bloc », « Imports », « Editor », « Mobile Apps », « Other », « Scripts » et « Web client (manuel) ». De nouvelles valeurs pouvant être ajoutées à l’avenir, vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.

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.

Column
Date/heure

Détails de l’historique des modifications

Voici les types d’entités dont l’historique des modifications est signalé.

Remarque

Si le champ AttributeChanged est vide ou vide et que le champ HowChanged est Ajouté ou Supprimé, le contenu du champ NewValue ou OldValue représente un élément de l’entité qui a été ajoutée ou supprimée, respectivement. Par exemple, si un mot clé est ajouté, le champ NewValue contient le texte mot clé.

Compte

Lorsque la valeur du champ ItemChanged est Account, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au nom du compte qui a été ajouté.

La valeur du champ HowChanged correspondant est Ajoutée.
Compte Fait référence au nom du compte qui a été modifié.
Contact de l’agence Fait référence au nom du contact de l’agence.
Client de la maison de vente Fait référence au client de la maison de vente.
Client de facturation Fait référence au client de facturation
Status financières Fait référence à la status financière
Verrouiller status Fait référence au verrou status
Option de paiement Fait référence à l’option de paiement
Mode de paiement de facturation préféré Fait référence au mode de paiement de facturation par défaut
Langue par défaut Fait référence au langage préféré
Mode de paiement vendu Mode de paiement vendu
Statut Fait référence au compte status.
Utilisateur préféré Fait référence à l’utilisateur préféré
Limite des dépenses Fait référence à la limite de dépense
Modèle de suivi Fait référence au modèle de suivi du compte.

Lorsque la valeur du champ ItemChanged est Ad, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au titre de l’annonce qui a été ajoutée.

La valeur du champ HowChanged correspondant est Ajoutée.
Texte de l’annonce Fait référence à la description de la copie de l’annonce.
Titre de l’annonce Fait référence au titre de l’annonce qui a été modifiée.
Paramètres personnalisés Fait référence aux paramètres personnalisés de l’annonce.
Destination URL Fait référence à l’URL de destination de l’annonce.
URL d'affichage Fait référence à l’URL d’affichage de l’annonce.
Status éditorial Fait référence à la status éditoriale de l’annonce.

Si l’annonce est en attente de révision éditoriale hors connexion, dans un rapport d’historique des modifications téléchargé, le status éditorial est représenté comme En attente - Actif ou En attente - Inactif. Pour plus d’informations, consultez Entités et état de la remise.
URL finale Fait référence à l’URL finale de l’annonce.
Mobile URL Fait référence à l’URL mobile finale de l’annonce.
Statut Fait référence à la status de remise de l’annonce.

Si vous signalez une annonce supprimée, le champ ItemChanged est État, le champ HowChanged est Modifié et le champ NewValue est Supprimé.
Modèle de suivi Fait référence au modèle de suivi de la publicité.

Groupe d’annonces

Lorsque la valeur du champ ItemChanged est Groupe d’annonces, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au nom du groupe d’annonces qui a été ajouté.

La valeur du champ HowChanged correspondant est Ajoutée.
Groupe d’annonces Fait référence au nom du groupe d’annonces qui a été modifié.
Ciblage d’emplacement avancé Fait référence à l’option d’intention de la cible d’emplacement associée au groupe d’annonces.
Âge Fait référence à la cible d’âge.
Paramètres personnalisés Fait référence aux paramètres personnalisés du groupe d’annonces.
Jour Fait référence à la cible de jour qui a été dépréciée après l’API Bing Ads version 9.
Enchère de correspondance étendue par défaut Fait référence à l’enchère de correspondance étendue par défaut
Enchère de correspondance de contenu par défaut Fait référence à l’enchère de correspondance de contenu par défaut
Enchère de correspondance exacte par défaut Fait référence à l’enchère de correspondance exacte par défaut
Enchère de correspondance d’expression par défaut Fait référence à l’enchère de correspondance d’expression par défaut
Appareil Fait référence au defers à la cible de l’appareil.
Distance Fait référence à la distance de la cible de rayon.
Date de fin Fait référence à la date de fin planifiée du groupe d’annonces.
Heure de fin Fait référence à l’heure et à la minute combinées de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir de l’heure par un seul caractère de barre verticale.
Gender Fait référence à la cible de genre.
Heure Fait référence à la cible d’heure qui a été dépréciée après l’API Bing Ads version 9.
Emplacement Fait référence à la cible d’emplacement.
Exclusion d’emplacement Fait référence à l’exclusion d’emplacements d’une cible d’emplacement.
Moyen Fait référence à la distribution d’annonces de recherche ou de contenu.
Mot clé négative Fait référence à un mot clé négatif associé au groupe d’annonces.

Mises à jour aux mots clés négatifs sont signalées sous la forme d’une modification supprimée et ajoutée dans deux lignes. L’enregistrement Supprimé correspond à l’ancienne valeur, et l’enregistrement Ajouté reflète la nouvelle valeur.
Suspendre status Fait référence à l’un des états suspendus du groupe d’annonces.
Groupe de produits Les conditions de produit d’un groupe de produits sont délimitées les unes des autres par une barre oblique vers l’arrière (« ') et séparées de l’enchère par un seul caractère d’espace.
Site Exclusion Fait référence aux URL de site négatives du groupe d’annonces. Un groupe d’annonces peut avoir plusieurs exclusions de site, et chaque exclusion de site est représentée séparément dans sa propre ligne de rapport.
Heure de début Fait référence à la combinaison de l’heure et de la minute de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir de l’heure par un seul caractère de barre verticale.
Statut Fait référence à la status de remise du groupe d’annonces.

Si vous signalez un groupe d’annonces supprimé, le champ ItemChanged est État, le champ HowChanged est Modifié et le champ NewValue est Supprimé.
Jours ciblés Fait référence au jour de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir du jour par un seul caractère de barre verticale.
Modèle de suivi Fait référence au modèle de suivi du groupe d’annonces.

Extension d’appel

Lorsque la valeur du champ ItemChanged est Extension d’appel, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Association Fait référence à l’association d’une extension d’appel à une entité.

Par exemple, si l’extension est associée à une campagne, la valeur du champ CampaignName est le nom de la campagne associée, la valeur du champ ItemChanged est Extension d’appel, la valeur du champ AttributeChanged est Association et la valeur du champ HowChanged est Ajoutée.

Autre exemple, si l’extension est associée ou dissociée à une campagne, la valeur NewValue ou OldValue respective est le nom de la campagne et la colonne EntityName contient le nom de l’extension publicitaire.
Pays/région Fait référence au pays/à la région de l’extension d’appel.
Numéro de téléphone Fait référence au numéro de téléphone de l’extension d’appel.
Afficher le site web ou le téléphone Indique si le site web doit être affiché avec le numéro de téléphone de l’extension d’appel. Les valeurs possibles dans les colonnes OldValue et NewValue sont Téléphone et Site web et Téléphone.
Utiliser le numéro de transfert Indique si le transfert est configuré pour l’extension d’appel. Les valeurs possibles dans les colonnes OldValue et NewValue sont Non et Oui.

Campagne

Lorsque la valeur du champ ItemChanged est Campaign, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au nom de la campagne qui a été ajoutée.

La valeur du champ HowChanged correspondant est Ajoutée.
Ciblage d’emplacement avancé Fait référence à l’option d’intention de la cible d’emplacement associée à la campagne.
Âge Fait référence à la cible d’âge.
Type de budget Fait référence au type de budget de campagne.

Les valeurs possibles dans les colonnes OldValue et NewValue sont les suivantes :

- La valeur de la cible quotidienne (accélérée) correspond au paramètre d’accélération quotidienne de l’application web Microsoft Advertising.

- La valeur de la cible quotidienne (standard) correspond au paramètre Standard quotidien de l’application web Microsoft Advertising.
Priorité de la campagne Fait référence à la priorité d’une campagne Microsoft Shopping.
Paramètres personnalisés Fait référence aux paramètres personnalisés de la campagne.
Budget quotidien Fait référence au montant du budget quotidien de la campagne.
Jour Fait référence à la cible de jour qui a été dépréciée après l’API Bing Ads version 9.
Appareil Fait référence à la cible de l’appareil.
Distance Fait référence à la distance de la cible de rayon.
Date de fin Fait référence à la date de fin planifiée du groupe d’annonces.
Heure de fin Fait référence à l’heure et à la minute combinées de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir de l’heure par un seul caractère de barre verticale.
Gender Fait référence à la cible de genre.
Heure Fait référence à la cible d’heure qui a été dépréciée après l’API Bing Ads version 9.
Exclusion d’adresse IP Fait référence aux exclusions d’adresses IP créées via l’application web Microsoft Advertising.
Emplacement Fait référence à la cible d’emplacement.
Exclusion d’emplacement Fait référence à l’exclusion d’emplacements d’une cible d’emplacement.
Nom Fait référence au nom de la campagne qui a été modifiée.
Mot clé négative Fait référence à un mot clé négatif associé à la campagne.

Mises à jour aux mots clés négatifs sont signalées sous la forme d’une modification supprimée et ajoutée dans deux lignes. L’enregistrement Supprimé correspond à l’ancienne valeur, et l’enregistrement Ajouté reflète la nouvelle valeur.
Suspendre status Fait référence à l’un des états suspendus de la campagne.

Les valeurs possibles dans les colonnes OldValue et NewValue sont « Budget suspendu », « Budget et utilisateur suspendus », « Non suspendu » et « Suspendu ».
Filtre de produit Fait référence à l’étendue ou à la condition du produit d’une campagne Microsoft Shopping. Une campagne Microsoft Shopping peut avoir plusieurs conditions de produit, et chaque condition est représentée séparément dans sa propre ligne de rapport.
Budget partagé Fait référence au budget partagé par plusieurs campagnes.
Site Exclusion Fait référence aux URL de site négatives de la campagne. Une campagne peut avoir plusieurs exclusions de site, et chaque exclusion de site est représentée séparément dans sa propre ligne de rapport.
Date de début Pour un usage interne.
Heure de début Fait référence à la combinaison de l’heure et de la minute de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir de l’heure par un seul caractère de barre verticale.
Statut Fait référence à la status de livraison de la campagne.

Si vous signalez une campagne supprimée, le champ ItemChanged est État, le champ HowChanged est Modifié et le champ NewValue est Supprimé.
Jours ciblés Fait référence au jour de la cible DayTime. L’ajustement de l’enchère est également inclus dans ce champ, délimité à partir du jour par un seul caractère de barre verticale.
Modèle de suivi Fait référence au modèle de suivi de la campagne.

Mot clé

Lorsque la valeur du champ ItemChanged est Mot clé, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au texte du mot clé qui a été ajouté.

La valeur du champ HowChanged correspondant est Ajoutée.
Enchère de correspondance étendue Fait référence au montant de l’offre de correspondance étendue pour l’mot clé.
Enchère de correspondance de contenu Fait référence au montant de l’offre de correspondance de contenu pour l’mot clé.
Paramètres personnalisés Fait référence aux paramètres personnalisés du mot clé.
Status éditorial Fait référence à la status éditoriale du mot clé.

Si le mot clé est en attente de révision éditoriale hors connexion, dans un rapport d’historique des modifications téléchargé, le status éditorial est représenté comme En attente - Actif ou En attente - Inactif. Pour plus d’informations, consultez Entités et état de la remise.
Enchère de correspondance exacte Fait référence au montant exact de l’offre de correspondance pour le mot clé.
URL finale Fait référence à l’URL finale du mot clé.
Mobile URL Fait référence à l’URL mobile finale du mot clé.
Type de correspondance Fait référence au type de correspondance d’enchère pour le mot clé.

Le type de correspondance d’enchère ne peut pas être mis à jour à l’aide de l’API Bing Ads ; Toutefois, il est possible de modifier le type de correspondance d’enchère à l’aide de l’application web Microsoft Advertising.
Enchère de correspondance d’expression Fait référence à l’expression correspondant au montant de l’offre pour le mot clé.
Statut Fait référence à la status de remise du mot clé.

Si vous signalez un mot clé supprimé, le champ ItemChanged est Status, le champ HowChanged est Modifié et le champ NewValue est Supprimé.
Modèle de suivi Fait référence au modèle de suivi du mot clé.

Extension d’emplacement

Lorsque la valeur du champ ItemChanged est l’extension Location, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Association Fait référence à l’association d’une extension d’emplacement à une entité.

Par exemple, si l’extension est associée à une campagne, la valeur du champ CampaignName est le nom de la campagne associée, la valeur du champ ItemChanged est Extension Emplacement, la valeur du champ AttributeChanged est Association et la valeur du champ HowChanged est Ajoutée.

Liste de mots clés négatifs

Lorsque la valeur du champ ItemChanged est Liste de mots clés négatifs, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Association Fait référence à l’association d’une liste de mots clés négatifs à une campagne.

Par exemple, si la liste mot clé négative est associée à une campagne, la valeur du champ CampaignName est le nom de la campagne associée, la valeur du champ ItemChanged est Liste de mots clés négatives, la valeur du champ AttributeChanged est Association et la valeur du champ HowChanged est Ajoutée.
Mot clé négative Fait référence à la mot clé négative qui a été ajoutée ou supprimée de la liste de mot clé négatives.
Nom de la liste de mots clés négatifs Fait référence au nom de la liste de mot clé négative.

Extension sitelink

Lorsque la valeur du champ ItemChanged est l’extension Sitelink, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Association Fait référence à l’association d’une extension sitelink à une entité.

Par exemple, si l’extension est associée à une campagne, la valeur du champ CampaignName est le nom de la campagne associée, la valeur du champ ItemChanged est l’extension Sitelink, la valeur du champ AttributeChanged est Association et la valeur du champ HowChanged est Ajoutée.
Paramètres personnalisés Fait référence aux paramètres personnalisés d’un lien de site.
Destination URL Fait référence à l’URL de destination de l’extension sitelink.
Afficher le texte Fait référence au texte d’affichage de l’extension sitelink.
URL finale Fait référence à l’URL finale d’un lien de site.
Mobile URL Fait référence à l’URL mobile finale d’un lien de site.
Modèle de suivi Fait référence au modèle de suivi d’un lien de site.

Utilisateur

Lorsque la valeur du champ ItemChanged est Utilisateur, l’historique des modifications pour les attributs suivants est disponible.

Attribut modifié Description
Aucun (vide) Fait référence au nom d’utilisateur de l’utilisateur qui a été ajouté.

La valeur du champ HowChanged correspondant est Ajoutée.
Code Pour un usage interne.
E-mail Fait référence à l’adresse e-mail du contact de l’utilisateur.
Prénom Fait référence au prénom de l’utilisateur.
Nom Fait référence au nom de l’utilisateur.
Statut Fait référence au status de l’utilisateur.

Configuration requise

Service : ReportingService.svc v13
Noms: https://bingads.microsoft.com/Reporting/v13

Utilisé par

SearchCampaignChangeHistoryReportRequest