Partilhar via

Objeto de Dados de Campanha - Gestão de Campanhas

  • Artigo

Define uma campanha.

Nota

Já não pode adicionar, atualizar ou obter campanhas que apenas suportam anúncios de pesquisa dinâmicos. O tipo de campanha das suas campanhas existentes foi atualizado de "DynamicSearchAds" para "Pesquisa". Os grupos de anúncios são agora considerados grupos de anúncios "dinâmicos", mas não existem alterações estruturais, ou seja, contêm os mesmos destinos automáticos e anúncios de pesquisa dinâmicos como anteriormente.

Nota

A partir de abril de 2021, a estratégia de licitação manual da CPC só pode ser utilizada com campanhas de audiência e campanhas de alojamento (anteriormente campanhas hoteleiras). Se tentar definir o CPC manual para qualquer outro tipo de campanha, o pedido será ignorado sem erros e a estratégia de licitação será definida como CPC melhorado.

A partir de abril de 2021, não pode definir estratégias de licitação para grupos de anúncios ou palavras-chave. As estratégias de licitação só podem ser definidas ao nível da campanha. Se tentar definir estratégias de licitação para grupos de anúncios ou palavras-chave, o pedido será ignorado sem erros. Grupos de anúncios e palavras-chave herdarão a estratégia de licitação da sua campanha.

Sintaxe

<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
    <xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q8:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ExperimentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q9="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q9:ArrayOfKeyValuePairOfstringstring" />
    <xs:element xmlns:q10="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q10:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
    <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
    <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="CampaignType" nillable="true" type="tns:CampaignType" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
    <xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q11:ArrayOfstring" />
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BidStrategyId" nillable="true" type="xs:long">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

O objeto Campanha tem os seguintes elementos: AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BidScheme, BidStrategyId, BudgetId, BudgetType, CampaignType, DailyBudget, DealIds, ExperimentId, FinalUrlSuffix, ForwardCompatibilityMap, GoalIds, Id, Languages, MultimediaAdsBidAdjustment, Nome, Definições, Estado, Subtipo, Fuso Horário, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrição Tipo de Dados
AdScheduleUseSearcherTimeZone Determina se deve utilizar o fuso horário da conta ou o fuso horário do utilizador de pesquisa onde os anúncios podem ser entregues.

Defina esta propriedade como true se pretender que os anúncios sejam apresentados no fuso horário do utilizador de pesquisa e, caso contrário, defina-o como falso.

Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor AdScheduleUseSearcherTimeZone no elemento ReturnAdditionalFields quando chamar as operações do serviço GetCampaignsByAccountId e GetCampaignsByIds .

Adicionar: Opcional. Se não especificar este elemento ou o deixar vazio, o valor predefinido de falso será definido e o fuso horário da conta será utilizado.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 booleano
AudienceAdsBidAdjustment O valor percentual pelo qual ajustar a sua oferta para anúncios de audiência acima ou abaixo do grupo de anúncios base ou oferta de palavras-chave.

Esta propriedade está disponível em campanhas Pesquisa se o cliente estiver ativado para a Rede de Audiências da Microsoft. Esta propriedade não está disponível com campanhas de compras inteligentes.

Os valores suportados são negativos de cem (-100) até 900 positivos. Definir o ajuste da oferta para -100 impedirá que os anúncios de audiência sejam apresentados para esta campanha.

Defina este elemento como zero (0) se quiser utilizar o grupo de anúncios base ou a oferta de palavras-chave em vez de especificar qualquer ajuste de licitação para anúncios de audiência.

Como melhor prática, deve sempre especificar um valor de ajuste da oferta. Se definir este elemento como nulo, será utilizado o ajuste da oferta predefinida do sistema. O ajuste da oferta predefinida do sistema é atualmente zero (0) e está sujeito a alterações.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 int
BidõesScheme O tipo de estratégia de oferta para a forma como pretende gerir as suas ofertas.

Para obter detalhes sobre estratégias de licitação suportadas por tipo de campanha, veja Estratégias de Orçamento e Licitação.

IMPORTANTE: Para alguns tipos de estratégia de oferta, as suas definições de oferta e rotação de anúncios são ignoradas e o controlo de conversão (através da etiqueta Deteção de Eventos Universal e um objetivo de conversão) é necessário. Para obter mais informações, incluindo localizações suportadas, consulte Permitir que o Microsoft Advertising faça a gestão das suas ofertas com estratégias de licitação.

Este elemento estará nulo ou vazio por predefinição se a campanha utilizar a estratégia de licitação MaxConversionValueBiddingScheme ou TargetImpressionShareBiddingScheme . Para obter os objetos MaxConversionValueBiddingScheme ou TargetImpressionShareBiddingScheme , inclua os respetivos valores MaxConversionValueBiddingScheme e TargetImpressionShareBiddingScheme no elemento ReturnAdditionalFields quando chama as operações do serviço GetCampaignsByAccountId e GetCampaignsByIds .

Adicionar: Opcional. O tipo de estratégia de oferta predefinido para campanhas Pesquisa e DynamicSearchAds é EnhancedCpcBiddingScheme. O tipo de estratégia de oferta predefinido para a maioria das campanhas de Compras é EnhancedCpcBiddingScheme; No entanto, os únicos tipos de estratégia de oferta suportados para campanhas de compras inteligentes são MaxConversionsBiddingScheme e MaxConversionValueBiddingScheme. Os tipos de estratégia de oferta suportados para campanhas de Audiência são EnhancedCpcBiddingScheme, ManualCpcBiddingScheme, ManualCpmBiddingScheme e TargetCpaBiddingScheme. Os tipos de estratégia de oferta suportados para campanhas de alojamento são CommissionBiddingScheme, ManualCpcBiddingScheme e PercentCpcBiddingScheme. As estratégias de oferta suportadas para as campanhas Performance Max são MaxConversionsBiddingScheme (com TCPA opcional) e MaxConversionValueBiddingScheme (com TROAS opcional). As estratégias de licitação suportadas para novas campanhas de Vídeo são ManualCpmBiddingScheme e ManualCpvBiddingScheme. NOTA: A partir de maio de 2024, já não pode utilizar a estratégia de licitação manual do CPC para campanhas nativas de audiência. Só pode utilizar o CPC manual para campanhas de exibição e vídeo da audiência e para campanhas de alojamento. Converteremos automaticamente quaisquer campanhas nativas manuais do público CPC em CPC melhorado. Se tentar definir o CPC manual para qualquer outro tipo de campanha, o pedido será ignorado sem erros e a estratégia de licitação será definida como CPC melhorado. A partir de abril de 2021, não pode definir estratégias de licitação para grupos de anúncios ou palavras-chave. As estratégias de licitação só podem ser definidas ao nível da campanha. Se tentar definir estratégias de licitação para grupos de anúncios ou palavras-chave, o pedido será ignorado sem erros. Grupos de anúncios e palavras-chave herdarão a estratégia de licitação da sua campanha.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 BidõesScheme
BidStrategyId O identificador gerado pelo sistema da BidStrategy que esta campanha partilha com outras campanhas na conta.

Se o campo estiver vazio, a campanha não está a utilizar uma estratégia de oferta de portefólio. Se o campo não estiver vazio e o valor for superior a zero, a campanha está a utilizar uma estratégia de oferta de portefólio. Se a campanha estiver a utilizar uma estratégia de oferta de portefólio e preferir que utilize a sua própria estratégia de licitação, defina este campo como "0" (zero).

Nota: As estratégias de oferta de portefólio não são suportadas com campanhas de compras inteligentes ou campanhas Performance Max.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 long
BudgetId O identificador exclusivo do Microsoft Advertising do Orçamento que esta campanha partilha com outras campanhas na conta.

Se o valor não for nulo e for superior a zero, a campanha está a utilizar um orçamento partilhado. Se o valor for nulo, a campanha não está a utilizar um orçamento partilhado. Se a campanha estiver a utilizar um orçamento partilhado e preferir que utilize o seu próprio orçamento, por exemplo, o valor DailyBudget , defina este elemento como "0" (zero) e defina DailyBudget para um montante orçamental válido.

Nota: Os orçamentos partilhados não são suportados com campanhas de compras inteligentes ou campanhas Performance Max. Com campanhas de compras inteligentes, tem de definir o valor DailyBudget .

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 long
BudgetType O tipo de orçamento determina como o orçamento é gasto.

Os valores possíveis são DailyBudgetAccelerated e DailyBudgetStandard. O tipo de orçamento DailyBudgetAccelerated só está disponível para campanhas de Audiência que utilizam orçamentos de nível de campanha não partilhados.

No contexto dos orçamentos partilhados, o tipo de orçamento é uma propriedade só de leitura que é sempre devolvida independentemente de a campanha utilizar ou não um orçamento partilhado. Para determinar se a campanha utiliza um orçamento partilhado, verifique o valor do elemento BudgetId , conforme descrito acima.

Com as campanhas de experimentação, não pode definir o Orçamento, o BudgetType ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Necessário se o BudgetId não estiver definido. Só de leitura se a campanha utilizar um orçamento partilhado.
Atualização: Opcional se o BudgetId não estiver definido. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não permitido se a campanha utilizar um orçamento partilhado. Se tentar atualizar o tipo de orçamento de uma campanha com um orçamento partilhado, o serviço devolverá o código de erro CampaignServiceCannotUpdateSharedBudget .		 BudgetLimitType
CampaignType O tipo de campanha determina se a campanha é uma Audiência, Anúncios Pesquisa Dinâmicos, Pesquisa, Campanha de compras, Anúncios de Hotel ou Performance Max.

Adicionar: Opcional. Se não for especificado, é utilizado o valor predefinido de Pesquisa.
Atualização: Não permitido.		 CampaignType
DailyBudget O montante a gastar diariamente na campanha.

Tem de definir o montante do orçamento diário se BudgetId não estiver definido.

O seu orçamento é um destino; os gastos reais podem ser superiores ou inferiores. As variações são causadas por vários fatores, como diferentes volumes de tráfego em dias diferentes da semana, ou deteção automática e reembolso de cliques de fraude que podem devolver dinheiro a uma campanha dentro de algumas horas após o clique. O Microsoft Advertising antecipa e compensa automaticamente as flutuações e, normalmente, mantém a utilização excessiva inferior a 100% acima do limite diário.

Tenha também em atenção que o Microsoft Advertising não requer que o orçamento da sua campanha seja superior ao grupo de anúncios e às ofertas de palavras-chave. Por outras palavras, as propostas de grupo de anúncios e palavras-chave são validadas independentemente do orçamento da campanha.

No contexto dos orçamentos partilhados, o montante do orçamento é uma propriedade só de leitura que é sempre devolvida independentemente de a campanha utilizar ou não um orçamento partilhado. Quando uma campanha está associada a um orçamento partilhado, o montante devolvido é o do orçamento partilhado. Para determinar se a campanha utiliza um orçamento partilhado, verifique o valor do elemento BudgetId , conforme descrito acima.

Com as campanhas de experimentação, não pode definir o Orçamento, o BudgetType ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Necessário se o BudgetId não estiver definido. Só de leitura se a campanha utilizar um orçamento partilhado.
Atualização: Opcional se o BudgetId não estiver definido. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não permitido se a campanha utilizar um orçamento partilhado. Se tentar atualizar o montante orçamental de uma campanha com um orçamento partilhado, o serviço devolverá o código de erro CampaignServiceCannotUpdateSharedBudget .		 duplo
DealIds Uma lista de identificadores de sistema exclusivos correspondentes aos negócios que foram adicionados.

A lista de identificadores corresponde diretamente à lista de negócios no pedido. Os itens da lista podem ser devolvidos como nulos. Para cada índice de lista em que um negócio não foi adicionado, o elemento correspondente será nulo.		 matriz longa
ExperimentId O identificador gerado pelo sistema da Experimentação.

Este elemento só está definido para campanhas de experimentação, ou seja, campanhas que foram criadas para testes A/B com base noutra campanha Pesquisa.

As campanhas base não irão conter um ID de experimentação. Da mesma forma, depois de uma experiência ter sido licenciada para uma campanha independente, este elemento estará vazio, apesar de a campanha ter sido anteriormente uma campanha de experimentação.

Com as campanhas de experimentação, não pode definir o Orçamento, o BudgetType ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base. Se quiser alterar o orçamento de uma experimentação, terá de alterar o orçamento da campanha base. A alteração do valor será dividida com base na definição TrafficSplitPercent da experimentação.

Adicionar: Só de leitura
Atualização: Só de leitura		 long
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.		 cadeia
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.

As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.		 Matriz KeyValuePairOfstringstring
GoalIds Reservado. matriz longa
ID O identificador exclusivo do Microsoft Advertising da campanha.

Adicionar: Só de leitura
Atualização: Necessário		 long
Idiomas A definição de idioma de anúncios determina o idioma que irá utilizar quando escrever os seus anúncios e deve ser o idioma dos seus clientes.

IMPORTANTE: Se os idiomas estiverem definidos ao nível do grupo de anúncios e da campanha, o idioma ao nível do grupo de anúncios substituirá o idioma ao nível da campanha.

Pode especificar múltiplos idiomas individualmente na lista ou incluir apenas um item de lista definido como Todos se pretender direcionar todos os idiomas.

As cadeias linguísticas suportadas para campanhas de Pesquisa e Compras são: albanês, búlgaro, croata, checo, dinamarquês, neerlandês, inglês, estónio, finlandês, francês, alemão, grego, húngaro, italiano, japonês, letão, lituano, maltês, norueguês, polaco, português, romeno, eslovaco, esloveno, espanhol, sueco e tradicionalchinês.

NOTA: Os seguintes idiomas ainda não estão disponíveis para todos: búlgaro, croata, checo, estónio, grego, húngaro, japonês, letão, lituano, maltês, polaco, romeno, esloveno.

Para campanhas de Audiência, tem de incluir todos os idiomas, ou seja, definir este elemento como Todos.

Para campanhas de Anúncios de Pesquisa Dinâmicos, as definições de idioma ao nível da campanha e do grupo de anúncios são ignoradas a favor do idioma do domínio do site. Deve definir os idiomas de campanha como "Todos" e deixar o idioma ao nível do grupo de anúncios vazio.

Adicionar: Necessário para campanhas de Audiência e, caso contrário, este elemento é opcional. Se não existir nenhum idioma de campanha definido, será necessário o idioma de cada grupo de anúncios na campanha.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Assim que os idiomas de campanha estiverem definidos, não pode eliminá-los todos. A lista de idiomas que especificar durante a atualização substitui as definições anteriores, ou seja, não acrescenta ao conjunto de idiomas existente.		 matriz de cadeia
MultimediaAdsBidAdjustment Reservado. int
Nome O nome da campanha. O nome tem de ser exclusivo entre todas as campanhas ativas ou em pausa na conta. O nome pode conter um máximo de 128 carateres.

O serviço efetua uma comparação não sensível a maiúsculas e minúsculas quando compara o nome com os nomes de campanha existentes.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 cadeia
Definições As definições suportadas que variam consoante o tipo de campanha.

Nota: VerifiedTrackingSetting não está atualmente disponível.

Pode incluir um máximo de um objeto por tipo de definição na lista de definições, por exemplo, um TargetSetting.

Se o CampaignType estiver definido como Pesquisa e se o elemento ExperimentId não estiver definido, esta lista pode opcionalmente incluir um objeto DynamicSearchAdsSetting. As campanhas de experimentação e as campanhas base de experimentações não podem incluir definições de anúncios de pesquisa dinâmica. Se pretender utilizar esta campanha para experimentações, não inclua definições de anúncios de pesquisa dinâmica. Se uma experimentação existente já se basear nesta campanha, não poderá atualizar a campanha para incluir definições de anúncios de pesquisa dinâmica.

Se o CampaignType estiver definido como Compras, esta lista tem de incluir um objeto ShoppingSetting .

Se o CampaignType estiver definido como Audiência, esta lista pode ou não incluir um objeto ShoppingSetting, dependendo se a campanha Audiência suporta ou não anúncios de produtos.

Se o CampaignType estiver definido como DynamicSearchAds, esta lista tem de incluir um objeto DynamicSearchAdsSetting .

Se o CampaignType estiver definido como Hotel, esta lista tem de incluir um objeto HotelSetting .

Se o CampaignType estiver definido como PerformanceMax, esta lista tem de incluir um objeto PerformanceMaxSetting . Se a campanha Performance Max associar a uma loja, também suporta shoppingSetting.

O TargetSetting pode ser utilizado com qualquer tipo de campanha, exceto Performace Max, e determina se os critérios de Audiência associados a esta campanha utilizam a opção "destino e licitação" ou a opção de destino "apenas licitação". No TargetSetting , pode ter um objeto TargetSettingDetail , ou seja, um por CriterionTypeGroup suportado. O único valor do tipo de critério atualmente suportado para a definição de destino de nível de campanha é "Audiência". O objeto TargetSetting não é devolvido por predefinição. Para obter este objeto, inclua o valor TargetSetting no elemento ReturnAdditionalFields quando chama as operações do serviço GetCampaignsByAccountId e GetCampaignsByIds .

Adicionar: Necessário se o CampaignType estiver definido como DynamicSearchAds ou Shopping e, caso contrário, este elemento for opcional. Se este elemento não incluir um objeto TargetSetting , a opção de licitação predefinida para todos os grupos de tipos de critério é efetivamente "apenas licitação".
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Os objetos DynamicSearchAdsSetting e ShoppingSetting não podem ser removidos durante a atualização.		 Definir matriz
Estado O estado da campanha.

Os valores possíveis estão Ativos e em Pausa.

O serviço colocará automaticamente a campanha em pausa se o orçamento estiver esgotado.

Com as campanhas de experimentação, não pode definir o Orçamento, BudgetType ou Estado O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Opcional. O valor predefinido é Pausado.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 CampaignStatus
Subtipo O subtipo de campanha.

Se o subtipo não estiver definido, a campanha é criada de acordo com o tipo de campanha.

Se o subtipo estiver definido como AudienceVideoAds e o tipo de campanha for Audiência, a campanha é uma campanha de audiência de vídeo.

Se o subtipo estiver definido como ShoppingSmartAds, a campanha é uma campanha do Microsoft Smart Shopping.

Se o subtipo estiver definido como ShoppingSponsoredProductAd, a campanha é uma campanha de compras da Microsoft para marcas.

Adicionar: Opcional e não aplicável para a maioria dos tipos de campanha. Para campanhas de compras inteligentes da Microsoft, tem de definir o subtipo como ShoppingSmartAds. Para campanhas de compras da Microsoft para marcas , tem de definir o subtipo como ShoppingSponsoredProductAd.
Atualização: Só de leitura		 cadeia
Fuso Horário Esta coluna foi preterida.

O fuso horário onde a campanha funciona.

O fuso horário é utilizado para comunicar e aplicar a data de início e de fim de um grupo de anúncios.

Para valores possíveis, veja Fusos Horários.

Com as campanhas de experimentação, não pode definir o Orçamento, BudgetType, Estado ou Fuso Horário. O orçamento, o estado e o fuso horário de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não poderá atualizar o fuso horário se a campanha contiver ou alguma vez tiver contido grupos de anúncios no estado Ativo ou Em Pausa .		 cadeia
TrackingUrlTemplate O modelo de controlo a utilizar como predefinição para todos os URLs na sua campanha.

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?
- 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.		 cadeia
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 .		 CustomParameters

Requisitos

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

Utilizado Por

AdicionarCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns