Objet de données BidOpportunity - Ad Insight

Article
12/21/2023

Définit un objet qui contient l’enchère suggérée avec des clics estimés et des opportunités d’impressions.

Remarque

L’opportunité d’offre est une estimation basée sur les 7 derniers jours de données de performances, et non une prédiction ou une garantie de performances futures.

Syntaxe

<xs:complexType name="BidOpportunity" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Opportunity">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdGroupId" type="xs:long" />
        <xs:element minOccurs="0" name="CampaignId" type="xs:long" />
        <xs:element minOccurs="0" name="CurrentBid" type="xs:double" />
        <xs:element minOccurs="0" name="EstimatedIncreaseInClicks" type="xs:double" />
        <xs:element minOccurs="0" name="EstimatedIncreaseInCost" type="xs:double" />
        <xs:element minOccurs="0" name="EstimatedIncreaseInImpressions" type="xs:long" />
        <xs:element minOccurs="0" name="KeywordId" type="xs:long" />
        <xs:element minOccurs="0" name="MatchType" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="SuggestedBid" type="xs:double" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet BidOpportunity a les éléments suivants : AdGroupId, CampaignId, CurrentBid, EstimatedIncreaseInClicks, EstimatedIncreaseInCost, EstimatedIncreaseInImpressions, KeywordId, MatchType, SuggestedBid.

Élément	Description	Type de données
AdGroupId	Identificateur du groupe d’annonces propriétaire du mot clé.	Long
CampaignId	Identificateur de la campagne pour le groupe d’annonces propriétaire du mot clé.	Long
CurrentBid	Le montant d’enchère mot clé actuel spécifié pour le type de correspondance dans l’élément MatchType.	Double
EstimatedIncreaseInClicks	L’estimation clique sur les opportunités correspondant à l’offre suggérée.	Double
EstimatedIncreaseInCost	Augmentation estimée des dépenses correspondant à l’offre suggérée.	Double
EstimatedIncreaseInImpressions	Les opportunités d’impressions estimées correspondant à l’offre suggérée.	Long
KeywordId	Identificateur du mot clé auquel l’opportunité d’offre s’applique.	Long
Matchtype	Type de correspondance auquel s’applique la valeur d’enchère suggérée. Les valeurs possibles sont BroadMatch, ExactMatch et PhraseMatch.	chaîne
SuggestedBid	Offre suggérée basée sur les 7 derniers jours de l’historique des performances pour le groupe d’annonces correspondant.	Double

L’objet BidOpportunity a des éléments hérités.

Éléments hérités

Éléments hérités de l’opportunité

L’objet BidOpportunity dérive de l’objet Opportunity et hérite des éléments suivants : OpportunityKey. Les descriptions ci-dessous sont spécifiques à BidOpportunity et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Opportunity .

Élément	Description	Type de données
OpportunityKey	Identificateur qui identifie de façon unique l’opportunité.	chaîne

Configuration requise

Service : AdInsightService.svc v13
Noms: https://bingads.microsoft.com/AdInsight/v13

Utilisé par

GetBidOpportunities

Partager via