Partilhar via

Chamar o Registo da Extensão do Ad - Em massa

  • Artigo

Define uma extensão de anúncio de chamada que pode ser carregada e transferida num ficheiro em massa.

Pode associar uma extensão de anúncio de chamada a campanhas na conta. Cada entidade (campanha) pode ser associada a uma extensão de anúncio de chamada. Utilize o registo Extensão de Anúncio de Chamada de Campanha para gerir associações de extensão de anúncios de chamadas.

Pode transferir todos os registos da Extensão do Call Ad na conta ao incluir o valor DownloadEntity de CallAdExtensions no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria uma nova Extensão de Anúncio de Chamada à biblioteca partilhada da conta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Country Code,Call Only,Call Tracking Enabled,Toll Free
Format Version,,,,,,,,,,,,6.0,,,,,,
Call Ad Extension,Active,-12,0,,,ClientIdGoesHere,,,12/31/2020,2065550100,,,(Monday[09:00-21:00]),FALSE,US,TRUE,TRUE,FALSE

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkCallAdExtension , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCallAdExtension
var bulkCallAdExtension = new BulkCallAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // CallAdExtension object of the Campaign Management service.
    CallAdExtension = new CallAdExtension
    {
        // 'Country Code' column header in the Bulk file
        CountryCode = "US",
        // 'Id' column header in the Bulk file
        Id = callAdExtensionIdKey,
        // 'Call Only' column header in the Bulk file
        IsCallOnly = true,
        // 'Call Tracking Enabled' column header in the Bulk file
        IsCallTrackingEnabled = true,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "2065550100",
        // 'Toll Free' column header in the Bulk file
        RequireTollFreeTrackingNumber = false,
                    
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkCallAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para um registo de Extensão do Ad de Chamada , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Agenda de Anúncios

A lista de intervalos de dia e hora que pretende que a extensão de anúncios seja apresentada com os seus anúncios. Cada dia e intervalo de tempo inclui o dia agendado da semana, a hora de início/fim e o minuto de início/fim. Cada dia e intervalo de tempo é colocado entre parênteses esquerdo e direito e separado de outros intervalos de dia e hora com um delimitador de ponto e vírgula (;). Dentro de cada dia e intervalo de tempo, o formato é Day[StartHour:StartMinue-EndHour:EndMinute].

Os valores possíveis de StartHour variam entre 00 e 23, em que 00 é equivalente a 00:00 e 12 é 12:00PM.

Os valores possíveis de EndHour variam entre 00 e 24, em que 00 é equivalente a 12:00 E 12 é 12:00PM.

Os valores possíveis de StartMinute e EndMinute variam entre 00 e 60.

O exemplo seguinte demonstra os intervalos de dias e horas durante os dias úteis das 9:00 às 21:00: (Segunda-feira[09:00-21:00]);( Terça-feira[09:00-21:00]); (Quarta-feira[09:00-21:00]); (Quinta-feira[09:00-21:00]); (Sexta-feira[09:00-21:00])

Adicionar: Opcional. Se não definir este campo, a extensão de anúncios será elegível para agendamento em qualquer altura durante as datas de início e de fim do calendário.
Atualização: Opcional. Não é possível atualizar os intervalos de dia e de tempo individuais. Pode atualizar efetivamente os intervalos de dia e hora ao enviar um novo conjunto que deve substituir o conjunto anterior. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

Apenas chamada

A opção para mostrar o seu número de telefone e site, ou apenas o seu número de telefone, às pessoas que veem os seus anúncios num smartphone. Poderá querer mostrar apenas o seu número de telefone se a sua empresa exigir que fale com cada cliente.

Defina esta propriedade como VERDADEIRO se pretender que a extensão de anúncio mostre apenas o número de telefone sem uma ligação para o seu site e, caso contrário, se quiser que a extensão de anúncio inclua uma ligação para o seu site, além do número de telefone definido como FALSO.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido e a extensão de anúncio incluirá uma ligação para o seu site, além do número de telefone.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Controlo de Chamadas Ativado

Determina se o controlo de chamadas está ativado para a extensão de anúncio de chamada.

Defina esta propriedade como VERDADEIRO para ativar o controlo de chamadas e, caso contrário, defina-a como FALSO.

Nota

O controlo de chamadas só é suportado no Estados Unidos e no Reino Unido.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

Código do País

O indicativo do país/região onde o número de telefone está registado.

O código de país tem de conter um código de país de 2 carateres. Os valores de código de país/região suportados incluem AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE e VN.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Localização Editorial

O componente ou propriedade da extensão de anúncio que falhou na revisão editorial.

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

Código do Motivo Editorial

Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.

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

Estado Editorial

O estado editorial da extensão de anúncios.

Os valores possíveis estão descritos na tabela abaixo.

Valor Descrição
Ativo A extensão de anúncios passou na revisão editorial.
ActiveLimited A extensão de anúncios aprovou uma revisão editorial em um ou mais mercados, e um ou mais elementos da extensão de anúncios estão a ser analisados editorialmente noutro mercado. Por exemplo, a extensão de anúncios passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado A extensão de anúncio falhou na revisão editorial.
Inativo Um ou mais elementos da extensão de anúncios estão a ser submetidos a uma revisão editorial.

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

Termo Editorial

O termo que falhou na revisão editorial.

Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.

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

Data de Fim

A cadeia de data de fim agendada da extensão de anúncio formatada como MM/DD/AAAA.

A data de fim é inclusiva. Por exemplo, se definir este campo como 31/12/2020, as extensões de anúncio deixarão de ser apresentadas às 23:59 a 31/12/2020.

Adicionar: Opcional. Se não especificar uma data de fim, a extensão de anúncios continuará a ser entregue, a menos que coloque em pausa as campanhas, grupos de anúncios ou anúncios associados.
Atualização: Opcional. A data de fim pode ser abreviada ou prolongada, desde que a data de início seja nula ou ocorra antes da nova data de fim. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de fim. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema da extensão de anúncios.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a extensão de anúncios pode, em seguida, ser referenciado no campo ID de tipos de registo dependentes, como Extensão de Anúncio de Chamada de Campanha. Isto é recomendado se estiver a adicionar novas extensões de anúncios e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

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

ID principal

O identificador gerado pelo sistema da conta que contém a extensão de anúncios.

Este campo em massa mapeia para o campo ID do registo conta .

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

Número de Telefone

O número de telefone clicável a incluir no anúncio.

O número de telefone pode conter um máximo de 35 carateres e tem de ser válido para o país ou região especificado.

Se a campanha incluir extensões de anúncios de chamada e localização, este número de telefone substituirá o número de telefone especificado nas extensões de anúncios de localização.

O número de telefone pode ser reformatado. Por exemplo, se definir o número de telefone para 4255551212, este será reformatado para (425) 555-1212.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Países do Publisher

A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.

Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).

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

Data de Início

A cadeia de data de início agendada da extensão de anúncio formatada como MM/DD/AAAA.

A data de início é inclusiva. Por exemplo, se definir StartDate como 5/05/2020, as extensões de anúncios começarão a ser apresentadas às 00:00 a 5/05/2020.

Adicionar: Opcional. Se não especificar uma data de início, a extensão de anúncio é imediatamente elegível para ser agendada.
Atualização: Opcional. A data de início pode ser abreviada ou prolongada, desde que a data de fim seja nula ou ocorra após a nova data de início. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de início e a extensão de anúncio é imediatamente elegível para ser agendada. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

Estado

O estado da extensão de anúncios.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Gratuito

Pode utilizar o seu próprio número de telefone ou utilizar um número de telefone de reencaminhamento do Microsoft Advertising. Um número de telefone de reencaminhamento do Microsoft Advertising é um número de telefone exclusivo que é encaminhado para o seu número de telefone da empresa. Com um número de reencaminhamento do Microsoft Advertising, pode controlar todas as chamadas do seu anúncio para que possa analisar o desempenho do anúncio. Este campo determina se deve ser criado um número de telefone de reencaminhamento gratuito do Microsoft Advertising para controlo de chamadas. Este campo só pode ser definido se o campo Controlo de Chamadas Ativado também for VERDADEIRO.

Antes de agosto de 2017, os clientes podiam definir esta propriedade como VERDADEIRO se um número de telefone de reencaminhamento do Microsoft Advertising fosse criado para controlo de chamadas. Desde agosto de 2017 que os clientes já não podem criar um novo número de telefone de reencaminhamento gratuito do Microsoft Advertising. Se definir este valor COMO VERDADEIRO , a operação será bem-sucedida; no entanto, não será criado um número gratuito e, quando obter a extensão de anúncio de chamada, esta propriedade será definida como FALSO. Se um número de reencaminhamento gratuito tiver sido aprovisionado antes de agosto de 2017, esta propriedade será VERDADEIRO se o número ainda estiver ativo quando obter a extensão de anúncio de chamada.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Utilizar Fuso Horário do Searcher

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 VERDADEIRO se quiser que as extensões de anúncios sejam apresentadas no fuso horário do utilizador de pesquisa e, caso contrário, defina-a como FALSO.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido e o fuso horário da conta será utilizado.
Atualização: Opcional. Se definir este campo para a cadeia de delete_value, está efetivamente a repor para o valor predefinido falso. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

Versão

O número de vezes que o conteúdo da extensão de anúncios foi atualizado. A versão é definida como 1 quando adiciona a extensão e é incrementada sempre que é revista.

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