Objeto de Dados BiddableCampaignCriterion – Gestão de Campanhas

Artigo
11/13/2024

Define um critério bidível que pretende aplicar à campanha especificada.

Sintaxe

XML
JSON

<xs:complexType name="BiddableCampaignCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:CampaignCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "CampaignId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableCampaignCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  }
}

Elementos

O objeto BiddableCampaignCriterion tem os seguintes elementos: CriterionBid, CriterionCashback.

Elemento	Descrição	Tipo de Dados
CritérioBid	A oferta para usar no leilão. Se o Critério herdado for um critério ProductScope , pode utilizar um FixedBid. Para todos os outros critérios de campanha bidíveis, utilize o BidMultiplier. Se não utilizar o tipo de objeto correto, a oferta pedida será ignorada: se a oferta for necessária, a operação falhará; Se a oferta for opcional, será utilizada a oferta predefinida. Adicionar: Os requisitos variam consoante o tipo de Critério herdado. A oferta é opcional e será definida como a predefinição de 0 se não estiver incluída para AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion e RadiusCriterion. A oferta não é aplicável a LocationIntentCriterion e ProductScope (o serviço não devolverá nenhum erro e a oferta será ignorada mesmo que a inclua). Atualização: Os requisitos variam consoante o tipo de Critério herdado. A oferta é necessária para AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion e RadiusCriterion. A oferta não é aplicável a LocationIntentCriterion e ProductScope (o serviço não devolverá nenhum erro e a oferta será ignorada mesmo que a inclua).	CritérioBid
CriterionCashback	Define o objeto de dados CriterionCashback.	CriterionCashback

O objeto BiddableCampaignCriterion tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da CampaignCriterion

O objeto BiddableCampaignCriterion deriva do objeto CampaignCriterion e herda os seguintes elementos: CampaignId, Critério, ForwardCompatibilityMap, ID, Estado, Tipo. As descrições abaixo são específicas de BiddableCampaignCriterion e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto CampaignCriterion .

Elemento	Descrição	Tipo de Dados
CampaignId	O identificador da campanha a que aplicar o critério. Adicionar: Necessário Atualização: Necessário	Longo
Critério	O critério a aplicar à campanha. O critério ajuda a determinar se os anúncios na campanha são servidos. Para obter uma lista dos tipos de critério disponíveis, veja CampaignCriterionType. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Critério
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API.	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising para o critério de campanha. Adicionar: Só de leitura Atualização: Necessário	Longo
Estado	Um valor de estado que determina se o critério se aplica à campanha. Atualmente, o único estado suportado para critérios de campanha bidíveis é Ativo. Adicionar: Só de leitura Atualização: Só de leitura	CampaignCriterionStatus
Tipo	O tipo de critério de campanha. Este valor é BiddableCampaignCriterion quando obtém um critério de campanha bidível. Para obter mais informações sobre os tipos de critérios de campanha, veja CampaignCriterion Data Object Remarks (Comentários de Objetos de Dados campaignCriterion). Adicionar: Só de leitura Atualização: Só de leitura	cadeia

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Partilhar via