Objeto de Dados BidOpportunity - Ad Insight

Artigo
11/14/2024

Define um objeto que contém a oferta sugerida com cliques estimados e oportunidades de impressões.

Nota

A oportunidade de licitação é uma estimativa com base nos últimos 7 dias de dados de desempenho e não uma predição ou garantia de desempenho futuro.

<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>

{
  "OpportunityKey": "ValueHere",
  "Type": "BidOpportunity",
  "AdGroupId": "LongValueHere",
  "CampaignId": "LongValueHere",
  "CurrentBid": DoubleValueHere,
  "EstimatedIncreaseInClicks": DoubleValueHere,
  "EstimatedIncreaseInCost": DoubleValueHere,
  "EstimatedIncreaseInImpressions": "LongValueHere",
  "KeywordId": "LongValueHere",
  "MatchType": "ValueHere",
  "SuggestedBid": DoubleValueHere
}

Elementos

O objeto BidOpportunity tem os seguintes elementos: AdGroupId, CampaignId, CurrentBid, EstimatedIncreaseInClicks, EstimatedIncreaseInCost, EstimatedIncreaseInImpressions, KeywordId, MatchType, SuggestedBid.

Elemento	Descrição	Tipo de Dados
AdGroupId	O identificador do grupo de anúncios que detém a palavra-chave.	Longo
CampaignId	O identificador da campanha para o grupo de anúncios que detém a palavra-chave.	Longo
CurrentBid	O valor atual da oferta de palavra-chave especificado para o tipo de correspondência no elemento MatchType .	duplo
EstimatedIncreaseInClicks	As oportunidades estimadas de cliques correspondentes à oferta sugerida.	duplo
EstimatedIncreaseInCost	O aumento estimado dos gastos correspondente à oferta sugerida.	duplo
EstimatedIncreaseInImpressions	As oportunidades de impressões estimadas correspondentes à oferta sugerida.	Longo
KeywordId	O identificador da palavra-chave a que se aplica a oportunidade de licitação.	Longo
Tipo de Correspondência	O tipo de correspondência ao qual se aplica o valor de licitação sugerido. Os valores possíveis são BroadMatch, ExactMatch e PhraseMatch.	cadeia
SuggestedBid	A oferta sugerida com base nos últimos 7 dias do histórico de desempenho do grupo de anúncios correspondente.	duplo

O objeto BidOpportunity tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da Oportunidade

O objeto BidOpportunity deriva do objeto Oportunidade e herda os seguintes elementos: OpportunityKey. As descrições abaixo são específicas de BidOpportunity e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Oportunidade .

Elemento	Descrição	Tipo de Dados
OpportunityKey	Um identificador que identifica exclusivamente a oportunidade.	cadeia

Requisitos

Serviço: AdInsightService.svc v13
Espaço de nomes: https://bingads.microsoft.com/AdInsight/v13

Utilizado Por

GetBidOpportunities

Partilhar via