Objet de données BudgetOpportunity - Ad Insight

Article
12/18/2024

Définit un objet qui contient le budget suggéré avec des clics estimés et des opportunités d’impressions. En outre, l’objet contient une liste de points budgétaires avec des impressions hebdomadaires, des clics et des estimations de coût pour le montant budgétaire donné.

Remarque

L’opportunité budgétaire est une estimation basée sur les 15 derniers jours de données de performances, et non une prédiction ou une garantie des performances futures.

<xs:complexType name="BudgetOpportunity" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Opportunity">
      <xs:sequence>
        <xs:element minOccurs="0" name="BudgetPoints" nillable="true" type="tns:ArrayOfBudgetPoint" />
        <xs:element minOccurs="0" name="BudgetType" type="tns:BudgetLimitType" />
        <xs:element minOccurs="0" name="CampaignId" type="xs:long" />
        <xs:element minOccurs="0" name="CurrentBudget" type="xs:double" />
        <xs:element minOccurs="0" name="IncreaseInClicks" type="xs:double" />
        <xs:element minOccurs="0" name="IncreaseInImpressions" type="xs:long" />
        <xs:element minOccurs="0" name="PercentageIncreaseInClicks" type="xs:int" />
        <xs:element minOccurs="0" name="PercentageIncreaseInImpressions" type="xs:int" />
        <xs:element minOccurs="0" name="RecommendedBudget" type="xs:double" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "OpportunityKey": "ValueHere",
  "Type": "BudgetOpportunity",
  "BudgetPoints": [
    {
      "BudgetAmount": DoubleValueHere,
      "BudgetPointType": "ValueHere",
      "EstimatedWeeklyClicks": DoubleValueHere,
      "EstimatedWeeklyCost": DoubleValueHere,
      "EstimatedWeeklyImpressions": DoubleValueHere
    }
  ],
  "BudgetType": "ValueHere",
  "CampaignId": "LongValueHere",
  "CurrentBudget": DoubleValueHere,
  "IncreaseInClicks": DoubleValueHere,
  "IncreaseInImpressions": "LongValueHere",
  "PercentageIncreaseInClicks": IntValueHere,
  "PercentageIncreaseInImpressions": IntValueHere,
  "RecommendedBudget": DoubleValueHere
}

Éléments

L’objet BudgetOpportunity contient les éléments suivants : BudgetPoints, BudgetType, CampaignId, CurrentBudget, IncreaseInClicks, IncreaseInImpressions, PercentageIncreaseInClicks, PercentageIncreaseInImpressions, RecommendedBudget.

Élément	Description	Type de données
Points de budget	Liste des points budgétaires avec des impressions hebdomadaires, des clics et des estimations de coût pour le montant du budget donné.	Tableau BudgetPoint
BudgetType	Type de budget utilisé par la campagne.	BudgetLimitType
CampaignId	Identificateur de la campagne à laquelle le budget suggéré s’applique.	long
CurrentBudget	Le budget actuel de la campagne.	double
IncreaseInClicks	L’estimation clique sur les opportunités correspondant au budget suggéré.	double
IncreaseInImpressions	Les opportunités d’impressions estimées correspondant au budget suggéré.	long
PercentageIncreaseInClicks	Pourcentage estimé d’augmentation en clics correspondant au budget suggéré.	int
PercentageIncreaseInImpressions	Pourcentage estimé d’augmentation des impressions correspondant au budget suggéré.	int
RecommendedBudget	Budget suggéré basé sur les 15 derniers jours de l’historique des performances pour la campagne correspondante.	double

L’objet BudgetOpportunity possède des éléments hérités.

Éléments hérités

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

L’objet BudgetOpportunity dérive de l’objet Opportunity et hérite des éléments suivants : OpportunityKey. Les descriptions ci-dessous sont spécifiques à BudgetOpportunity 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
Namespace: https://bingads.microsoft.com/AdInsight/v13

Utilisé par

GetBudgetOpportunities

Partager via