Partilhar via

Objeto de Dados BiddableAdGroupCriterion - Gestão de Campanhas

  • Artigo

Define um critério bidível que pretende aplicar ao grupo de anúncios especificado.

Sintaxe

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q81:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <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>

Elementos

O objeto BiddableAdGroupCriterion tem os seguintes elementos: CriterionBid, CriterionCashback, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrição Tipo de Dados
CritérioBid A oferta para usar no leilão.

Se o Critério herdado for um critério de página Web , tem de utilizar um FixedBid. Se o Critério herdado for um ProductPartition, tem de utilizar um FixedBid , a menos que o BidOption de Produtos Patrocinados esteja definido como BidBoost (para obter detalhes, consulte Utilização de ProductPartition abaixo). Para todos os outros critérios de grupo de anúncios 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 for incluída para Critérios AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion, RadiusCriterion, AudienceCriterion e Página Web . A oferta não é aplicável a LocationIntentCriterion (o serviço não devolverá nenhum erro e a oferta será ignorada mesmo que a inclua). Quando adiciona um ProductPartition com a operação ApplyProductPartitionActions , a oferta é necessária, a menos que o tipo de partição do produto seja Subdivisão, caso em que a oferta não é permitida.
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 (o serviço não devolverá nenhum erro e a oferta será ignorada mesmo que a inclua). Para critérios audienceCriterion e página Web , a oferta é opcional e Se não estiver definido nenhum valor para a atualização, esta definição não é alterada. Quando atualiza uma ProductPartition com a operação ApplyProductPartitionActions , a oferta é opcional e Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 CritérioBid
CriterionCashback Reservado. CriterionCashback
DestinationUrl O URL da página Web para a qual o utilizador é levado quando clica no anúncio.

Este elemento só é utilizado se o Critério herdado for um critério ProductPartition . Para obter detalhes, veja ProductPartition Usage (Utilização da ProductPartition ) abaixo.		 cadeia
EditorialStatus Reservado para utilização futura. AdGroupCriterionEditorialStatus
FinalAppUrls Reservado para utilização futura. Matriz appUrl
FinalMobileUrls Reservado para utilização futura. matriz de cadeia
FinalUrls Reservado para utilização futura. matriz de cadeia
FinalUrlSuffix O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Este elemento só é utilizado se o Critério herdado for um critério ProductPartition ou De página Web . Para obter detalhes, veja Utilização de ProductPartition e Utilização da Página Web abaixo.		 cadeia
TrackingUrlTemplate Os modelos de controlo são onde pode especificar parâmetros de controlo de URL que são utilizados em conjunto com o URL final ou a página de destino.

Recomendamos que adicione o modelo de controlo ao nível da conta e, em seguida, que seja aplicado a todos os URLs para entidades de nível inferior, como campanhas, grupos de anúncios e anúncios. Para saber mais, consulte os artigos de ajuda do Microsoft Advertising Controlo de URLs com URLs Atualizados.

Este elemento só é utilizado se o Critério herdado for um critério ProductPartition ou De página Web . Para obter detalhes, veja Utilização de ProductPartition e Utilização da Página Web abaixo.		 cadeia
UrlCustomParameters A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

Este elemento só é utilizado se o Critério herdado for um critério ProductPartition ou De página Web . Para obter detalhes, veja Utilização de ProductPartition e Utilização da Página Web abaixo.		 CustomParameters

O objeto BiddableAdGroupCriterion tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdGroupCriterion

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

Elemento Descrição Tipo de Dados
AdGroupId O identificador do grupo de anúncios ao qual aplicar o critério.

Adicionar: Necessário
Atualização: Necessário		 long
Critério O critério a aplicar ao grupo de anúncios. O critério ajuda a determinar se os anúncios no grupo de anúncios são servidos.

Para obter uma lista dos tipos de critério disponíveis, veja AdGroupCriterionType.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 Critério
ID O identificador exclusivo do Microsoft Advertising para o critério do grupo de anúncios.

Adicionar: Só de leitura
Atualização: Necessário		 long
Estado Um valor de estado que determina se o critério se aplica ao grupo de anúncios.

Para a maioria dos critérios de grupo de anúncios bidíveis, o único valor de estado suportado é Ativo. Para obter exceções, veja Utilização de páginas Web abaixo.

Adicionar: Só de leitura
Atualização: Só de leitura		 AdGroupCriterionStatus
Tipo O tipo de critério do grupo de anúncios. Este valor é BiddableAdGroupCriterion quando obtém um critério de grupo de anúncios bidível. Para obter mais informações sobre os tipos de critérios de grupo de anúncios, veja AdGroupCriterion Data Object Remarks (Observações de Objetos de Dados do AdGroupCriterion).

Adicionar: Só de leitura
Atualização: Só de leitura		 cadeia

Observações

Utilização do ProductPartition

Se o Critério herdado for um critério ProductPartition , tenha em atenção a seguinte utilização das propriedades BiddableAdGroupCriterion .

CritérioBid

Por predefinição, o leilão utilizará um FixedBid para grupos de produtos. Tem de utilizar um FixedBid, a menos que a BidOption de Produtos Patrocinados esteja definida como BidBoost. Se a BidOption de Produtos Patrocinados estiver definida como BidBoost, o BidMultiplier representa a percentagem (superior a zero) utilizada para ampliar a oferta do seu parceiro.

Por exemplo, digamos que o seu parceiro oferece 5 USD no respetivo grupo de produtos (FixedBid via CriterionBid). Se o ajuste da oferta (BidMultiplier via CriterionBid) estiver definido como 20 (por cento) e o BidMaxValue do seu grupo de anúncios for de 0,50 (50 cêntimos), a sua ação será de 50 cêntimos e não de 1 USD.

DestinationUrl

Se estiver a utilizar atualmente URLs de Destino, terá eventualmente de substituí-los por Modelos de Controlo. Para obter mais informações, veja Controlo de URLs com URLs Atualizados.

O URL pode conter parâmetros dinâmicos, como {MatchType}. Para obter uma lista dos parâmetros suportados, veja o artigo ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?.

O URL pode conter um máximo de 1024 carateres. Se o URL não especificar um protocolo, o sistema utiliza o protocolo HTTP quando um utilizador clica no anúncio. Se o URL especificar o protocolo HTTP ao adicionar um anúncio, o serviço removerá a cadeia de protocolo http:// (a cadeia de protocolo HTTP não conta com o limite de 1024 carateres); no entanto, o serviço não removerá uma cadeia de protocolo HTTPS (https://) do URL.

O URL de destino é utilizado se especificado; caso contrário, o URL de destino é determinado pelo valor correspondente da "Ligação" que especificou para a oferta de produto no catálogo do Microsoft Merchant Center.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.

FinalUrlSuffix

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.

TrackingUrlTemplate

Os modelos de controlo podem ser utilizados em conjunto com o URL especificado no campo "Ligação" da oferta de produto que submeteu através da API de Conteúdo. Ao combinar o URL do feed com o modelo de controlo, o URL da página de destino é montado onde um utilizador é direcionado depois de clicar no anúncio. Quando utiliza o elemento TrackingUrlTemplate para atualizar os parâmetros do URL em vez de os atualizar no URL do feed, o URL do feed não precisa de passar pela revisão editorial e os anúncios continuarão a servir ininterruptamente. Por exemplo, se o URL da oferta do produto no feed de catálogo for https://contoso.com/, pode especificar o seguinte modelo de controlo: {lpurl}?matchtype={matchtype}&device={device}.

As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?

  • Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

  • O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

  • O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

  • O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.

UrlCustomParameters

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

O Microsoft Advertising aceitará os primeiros 8 objetos CustomParameter que incluir no objeto CustomParameters e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada CustomParameter inclui elementos Chave e Valor .

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina o elemento UrlCustomParameters como nulo ou vazio para manter quaisquer parâmetros personalizados existentes. Para remover todos os parâmetros personalizados, defina o elemento Parâmetros do objeto CustomParameters como nulo ou vazio. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter no elemento Parâmetros do objeto CustomParameters .

Utilização de Páginas Web

Se o Critério herdado for um critério de página Web , tenha em atenção a seguinte utilização das propriedades BiddableAdGroupCriterion .

FinalUrlSuffix

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.

Estado

Um valor de estado que determina se o critério se aplica ao grupo de anúncios.

Pode definir o estado como Ativo ou Em Pausa. Não é possível definir o estado como Eliminado.

Adicionar: Opcional.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.

TrackingUrlTemplate

Para critérios de página Web , os modelos de controlo podem ser utilizados em conjunto com o URL da página de destino que é gerado dinamicamente a partir do domínio que especificou para a sua campanha de Anúncios de Pesquisa Dinâmica. Ao combinar o domínio com o modelo de controlo, o URL da página de destino é montado onde um utilizador é direcionado depois de clicar no anúncio. Eis um modelo de controlo de exemplo: {lpurl}?matchtype={matchtype}&device={device}.

As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?

  • Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

  • O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

  • O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

  • O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.

UrlCustomParameters

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

O Microsoft Advertising aceitará os primeiros 8 objetos CustomParameter que incluir no objeto CustomParameters e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada CustomParameter inclui elementos Chave e Valor .

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina o elemento UrlCustomParameters como nulo ou vazio para manter quaisquer parâmetros personalizados existentes. Para remover todos os parâmetros personalizados, defina o elemento Parâmetros do objeto CustomParameters como nulo ou vazio. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter no elemento Parâmetros do objeto CustomParameters .

Requisitos

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