NegativeKeywordConflictReportRequest, objet de données - Création de rapports

Article
11/13/2024

Définit une demande de rapport de conflit mot clé négative. Utilisez ce rapport pour découvrir quels mots clés et mots clés négatifs sont en conflit, et si le conflit est au niveau de la campagne ou du groupe d’annonces. Utilisez cette liste pour déterminer les mots clés négatifs à supprimer.

Vous pouvez demander des mots clés négatifs qui entrent en conflit avec certains de vos mots clés et bloquer l’affichage de votre annonce.

Pour demander un rapport de ce type, transmettez cet objet à l’opération SubmitGenerateReport .

<xs:complexType name="NegativeKeywordConflictReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfNegativeKeywordConflictReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:NegativeKeywordConflictReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "ExcludeColumnHeaders": "ValueHere",
  "ExcludeReportFooter": "ValueHere",
  "ExcludeReportHeader": "ValueHere",
  "Format": "ValueHere",
  "FormatVersion": "ValueHere",
  "ReportName": "ValueHere",
  "ReturnOnlyCompleteData": "ValueHere",
  "Type": "NegativeKeywordConflictReportRequest",
  "Columns": [
    "ValueHere"
  ],
  "Filter": {
    "AccountStatus": "ValueHere",
    "AdGroupStatus": "ValueHere",
    "CampaignStatus": "ValueHere",
    "KeywordStatus": "ValueHere"
  },
  "Scope": {
    "AccountIds": [
      "LongValueHere"
    ],
    "AdGroups": [
      {
        "AccountId": "LongValueHere",
        "AdGroupId": "LongValueHere",
        "CampaignId": "LongValueHere"
      }
    ],
    "Campaigns": [
      {
        "AccountId": "LongValueHere",
        "CampaignId": "LongValueHere"
      }
    ]
  }
}

Éléments

L’objet NegativeKeywordConflictReportRequest contient les éléments suivants : Columns, Filter, Scope.

Élément	Description	Type de données
Columns	Liste des attributs et des statistiques de performances à inclure dans le rapport. Le rapport inclut les colonnes dans l’ordre dans lequel vous les spécifiez.	Tableau NegativeKeywordConflictReportColumn
Filter	Informations de filtre à utiliser pour filtrer les données du rapport.	NegativeKeywordConflictReportFilter
Portée	Étendue de l’entité du rapport. Utilisez cet élément pour limiter les données du rapport à des comptes, des groupes d’annonces ou des campagnes spécifiques.	AccountThroughAdGroupReportScope

L’objet NegativeKeywordConflictReportRequest contient des éléments hérités.

Éléments hérités

Éléments hérités de ReportRequest

L’objet NegativeKeywordConflictReportRequest dérive de l’objet ReportRequest et hérite des éléments suivants : ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. Les descriptions ci-dessous sont spécifiques à NegativeKeywordConflictReportRequest et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet ReportRequest .

Élément	Description	Type de données
ExcludeColumnHeaders	Détermine si le rapport téléchargé doit contenir ou non des descriptions d’en-tête pour chaque colonne. L’en-tête de colonne de rapport correspond au nom de colonne demandé, par exemple Impressions et Clics. Définissez cette propriété sur true si vous souhaitez que les en-têtes de colonne de rapport soient exclus du rapport téléchargé. La valeur par défaut est false.	boolean
ExcludeReportFooter	Détermine si le rapport téléchargé doit contenir ou non des métadonnées de pied de page telles que les droits d’auteur Microsoft (@2020 Microsoft Corporation. Tous droits réservés.). Définissez cette propriété sur true si vous souhaitez que les métadonnées du pied de page de rapport soient exclues du rapport téléchargé. La valeur par défaut est false.	boolean
ExcludeReportHeader	Détermine si le rapport téléchargé doit contenir ou non des métadonnées d’en-tête telles que le nom du rapport, la plage de dates et l’agrégation. Définissez cette propriété true si vous souhaitez que les métadonnées d’en-tête de rapport soient exclues du rapport téléchargé. La valeur par défaut est false.	boolean
Format	Format des données du rapport. Par exemple, vous pouvez demander les données au format de valeurs séparées par des virgules (CSV) ou de valeurs séparées par des tabulations (Tsv). La valeur par défaut est Csv. Tous les fichiers téléchargés sont compressés zip.	ReportFormat
FormatVersion	Détermine le format de certains champs dans le fichier de rapport téléchargé. Le format de données de certains champs peut être mis à jour dans la version actuelle de l’API sans interrompre les applications clientes existantes. Vous pouvez obtenir le format de données le plus récent en définissant ce champ de requête facultatif sur 2.0. Si vous ne définissez pas ce champ, le service est défini par défaut sur la version 1.0. Pour plus d’informations sur les modifications entre les versions de format, consultez Version du format de rapport.	chaîne
ReportName	Nom du rapport. Le nom est inclus dans l’en-tête du rapport. Si vous ne spécifiez pas de nom de rapport, le système génère un nom au format ReportType-ReportDateTime. La longueur maximale du nom du rapport est de 200.	chaîne
ReturnOnlyCompleteData	Non applicable au rapport de conflit négatif mot clé.	boolean

Configuration requise

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

Partager via