Partilhar via

Objeto de Dados assetGroup - Gestão de Campanhas

  • Artigo

Define um grupo de ativos numa campanha publicitária.

Sintaxe

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssetGroupSearchThemes" nillable="true" type="tns:ArrayOfAssetGroupSearchTheme">
      <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="AssetGroupUrlTargets" nillable="true" type="tns:ArrayOfAssetGroupUrlTarget">
      <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="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q116:ArrayOfstring" />
    <xs:element xmlns:q117="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q117:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
    <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
      <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 AssetGroup tem os seguintes elementos: AssetGroupSearchThemes, AssetGroupUrlTargets, BusinessName, CallToAction, Descriptions, EditorialStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, Id, Images, LongHeadlines, Name, Path1, Path2, StartDate, Estado, Vídeos.

Elemento Descrição Tipo de Dados
AssetGroupSearchThemes Uma lista de temas de pesquisa de grupos de ativos. Matriz AssetGroupSearchTheme
AssetGroupUrlTargets Reservado. Matriz AssetGroupUrlTarget
Nome da Empresa O nome da empresa.

O nome da sua empresa pode aparecer no seu anúncio, consoante o posicionamento do anúncio.

O comprimento da cadeia está limitado a 25 carateres.

Adicionar: Necessário. Se não for fornecido e a campanha principal associar a uma loja, o nome da loja será utilizado como o nome da empresa.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 cadeia
CallToAction Uma breve razão para os clientes clicarem no seu anúncio neste momento.

Esta opção é apresentada no botão de chamada à ação.

Adicionar: Necessário. Se não for fornecido e a campanha principal associar a uma loja, a predefinição será LearnMore.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 CallToAction
Descrições As descrições apresentadas abaixo do caminho no seu anúncio.

Tem de definir entre 2 a 5 descrições. O Texto de cada descrição tem de conter, pelo menos, uma palavra. O Texto não pode conter o caráter newline (\n).

Se a campanha principal associar a uma loja e especificar Descrições, também tem de especificar Manchetes, LongHeadlines e Imagens.

Adicionar: opcional se a campanha principal associar a uma loja, necessário se a campanha principal não se associar a uma loja.
Atualização: opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir um valor para este elemento, todas as descrições anteriormente associadas a este grupo de recursos serão substituídas. Se a campanha principal associar a uma loja e definir este elemento para uma lista vazia, a definição anterior será eliminada.		 Matriz AssetLink
EditorialStatus O estado de revisão editorial do grupo de activos, que indica se o grupo de activos está pendente de revisão, foi aprovado ou foi desaprovado.

Adicionar: Só de leitura
Atualização: só de leitura		 AssetGroupEditorialStatus
DataDadosEncom efeitos Finais A data em que o grupo de recursos irá expirar.

Se não especificar uma data de fim, o grupo de recursos não irá expirar. A data de fim pode ser prolongada para tornar um grupo de ativos elegível para entrega, mesmo depois de o grupo de ativos expirar.

A data de fim é inclusiva. Por exemplo, se definir EndDate como 31/12/2020, os anúncios no grupo de anúncios expirarão às 23:59 a 31/12/2020. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: opcional. Para não definir uma data de fim ao adicionar um grupo de recursos, defina este elemento como nulo.
Atualização: opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para eliminar a definição de data de fim existente e definir efetivamente nenhuma data de fim ao atualizar um grupo de recursos, defina a data de fim igual ou posterior a 2 de janeiro de 2050. Quando obter o grupo de recursos da próxima vez, este elemento será nulo, ou seja, não será definido como 2 de janeiro de 2050.		 Data
FinalMobileUrls O URL da página de destino móvel.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.
- O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
- Pode especificar até 10 itens para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
- A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo{lpurl}.
- Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://.
- Se especificar FinalMobileUrls, também tem de especificar FinalUrls.

Adicionar: Opcional
Atualização: opcional		 matriz de cadeia
FinalUrls O URL da página de destino.

A parte do domínio do URL em combinação com as cadeias de caminho 1 e caminho 2 não pode exceder os 67 carateres.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.
- O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
- Pode especificar até 10 itens para FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
- A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo{lpurl}.
- Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://.
- Se especificar FinalMobileUrls, também tem de especificar FinalUrls.

Para campanhas de retalho, o URL final tem de corresponder ao domínio da loja associada à campanha.

Adicionar: necessário. Se não for fornecido e a campanha principal associar a uma loja, o URL da loja será utilizado como o URL final.
Atualização: opcional		 matriz de 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
Cabeçalhos Os títulos são o texto mais proeminente que aparece no seu anúncio, pelo que deve tirar o máximo partido dos carateres disponíveis. Precisamos de vários cabeçalhos para que o anúncio possa ser apresentado de forma flexível em vários editores e posicionamentos.

Numa perspetiva de modelo de dados, as descrições e os títulos são armazenados como recursos de texto, ou seja, um TextAsset por AssetLink. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 3 a 15 cabeçalhos. O Texto de cada cabeçalho tem de conter, pelo menos, uma palavra.

O Texto não pode conter o caráter newline (\n).

Se a campanha principal associar a uma loja e especificar Títulos, também tem de especificar LongHeadlines, Descrições e Imagens.

Adicionar: opcional se a campanha principal associar a uma loja, necessário se a campanha principal não se associar a uma loja.
Atualização: opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir um valor para este elemento, quaisquer títulos que tenham sido anteriormente ligados a este grupo de recursos serão substituídos. Se a campanha principal associar a uma loja e definir este elemento para uma lista vazia, a definição anterior será eliminada.		 Matriz AssetLink
ID O ID do grupo de recursos gerado pelo sistema.

Adicionar: Só de leitura
Atualização: só de leitura		 Longo
Imagens Recursos de imagem com diferentes tamanhos e proporções para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

Inclua um ou mais objetos AssetLink que contêm cada um um ImageAsset com o Subtipo e as definições de recorte que correspondem à proporção pretendida.

O ImageAsset contém os campos CropHeight, CropWidth, CropX, CropY e SubType.

Os valores de subtipo possíveis incluem LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1.

Tem de fornecer, pelo menos, 1 LandscapeImageMedia e 1 SquareImageMedia. Um total de até 20 imagens e um total de até 5 logótipos podem ser guardados.

Se a campanha principal associar a uma loja e especificar Imagens, também tem de especificar Manchetes, LongHeadlines e Descrições.

Adicionar: opcional se a campanha principal associar a uma loja, necessário se a campanha principal não se associar a uma loja.
Atualização: opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se incluir imagens durante a atualização, todas as imagens definidas anteriormente serão substituídas. Se a campanha principal associar a uma loja e definir este elemento para uma lista vazia, a definição anterior será eliminada.		 Matriz AssetLink
LongHeadlines Tem de definir entre 1 a 5 títulos longos. O Texto de cada cabeçalho tem de conter, pelo menos, uma palavra. O Texto não pode conter o caráter newline (\n).

Se a campanha principal associar a uma loja e especificar LongHeadlines, também tem de especificar Manchetes, Descrições e Imagens.

Adicionar: opcional se a campanha principal associar a uma loja, necessário se a campanha principal não se associar a uma loja.
Atualização: opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir um valor para este elemento, quaisquer títulos que tenham sido anteriormente ligados a este grupo de recursos serão substituídos. Se a campanha principal associar a uma loja e definir este elemento para uma lista vazia, a definição anterior será eliminada.		 Matriz AssetLink
Nome O nome do grupo de recursos. Os nomes devem ser exclusivos numa campanha e são sensíveis às maiúsculas e minúsculas. O comprimento não pode exceder os 256 carateres.

Adicionar: Necessário
Atualização: opcional		 cadeia
Caminho1 A primeira parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (elemento FinalUrls). Em seguida, se tiver especificado um valor para Path1, este será anexado ao URL de apresentação. Se também tiver especificado um valor para Path2, também será acrescentado ao URL de apresentação após Path1. Por exemplo, se os Seus FinalUrls contiverem https://www.contoso.com, Path1 estiver definido como subdiretório1 e Path2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2.

Não podem ser introduzidos mais de 15 carateres. O anúncio não será apresentado se o comprimento do domínio de URL final e os caminhos combinados excederem os 67 carateres.

Para idiomas com carateres de largura dupla, por exemplo, o chinês tradicional não pode ter mais de 7 carateres finais. O anúncio não será apresentado se o comprimento do domínio de URL final e os caminhos combinados excederem os 33 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de linguagem de campanha. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O caminho não pode conter os carateres de barra (/) ou newline (\n).

Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

Adicionar: Opcional
Atualização: opcional		 cadeia
Caminho2 A segunda parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (elemento FinalUrls). Em seguida, se tiver especificado um valor para Path1, este será anexado ao URL de apresentação. Se também tiver especificado um valor para Path2, também será acrescentado ao URL de apresentação após Path1. Por exemplo, se os Seus FinalUrls contiverem https://www.contoso.com, Path1 estiver definido como subdiretório1 e Path2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2.

Só pode especificar Path2 se Path1 também estiver definido.

Não podem ser introduzidos mais de 15 carateres. O anúncio não será apresentado se o comprimento do domínio de URL final e os caminhos combinados excederem os 67 carateres.

Para idiomas com carateres de largura dupla, por exemplo, o chinês tradicional não pode ter mais de 7 carateres finais. O anúncio não será apresentado se o comprimento do domínio de URL final e os caminhos combinados excederem os 33 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de linguagem de campanha. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O caminho não pode conter os carateres de barra (/) ou newline (\n).

Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

Adicionar: Opcional
Atualização: opcional		 cadeia
Data De Início A data em que o grupo de ativos pode começar a servir; caso contrário, o serviço pode começar a servir anúncios no dia em que o grupo de ativos se tornar ativo.

A data de início é inclusiva. Por exemplo, se definir a data de início para 05/05/2021, os anúncios criados a partir do grupo de ativos começarão às 00:00 a 5/05/2021. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: opcional. Se não definir a data de início, a predefinição será a data de hoje e o serviço pode começar a servir anúncios assim que o estado do grupo de ativos estiver ativo.
Atualização: opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não é possível atualizar a data de início depois de o grupo de recursos ser submetido, ou seja, depois de chegar a data de início.		 Data
Estado O estado do grupo Ativos. Os valores possíveis são Ativo, Expirado e Em Pausa. O estado Expirado é só de leitura.

Adicionar: opcional. A predefinição é Em Pausa.
Atualização: opcional		 AssetGroupStatus
Vídeos Reservado. Matriz AssetLink

Requisitos

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

Utilizado Por

AddAssetGroups
CreateAssetGroupRecommendation
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
RefineAssetGroupRecommendation
UpdateAssetGroups