URLs atualizados

URLs atualizados são uma forma mais inteligente de gerenciar URLs no Google AdWords. É possível especificar a parte da sua URL que determina a página de destino e a parte usada para monitoramento. Este guia apresenta esse recurso para você.

No momento, URLs de destino são usadas para especificar a parte do seu website acessada pelos usuários ao clicar no anúncio e para codificar informações adicionais para a atribuição de desempenho do clique do anúncio. Com modelos de acompanhamento compartilhados, os URLs atualizados permitem a atualização das informações de acompanhamento dos seus URLs sem acionar a revisão editorial.

URLs atualizados permitem especificar as partes de acompanhamento e da página de destino do seu URL por meio de campos separados.

  • URL final: representa uma lista das páginas de destino reais do seu anúncio, palavra-chave ou sitelink. O URL final será o que o usuário vê na barra de navegação depois de clicar em um anúncio.
  • URL final para dispositivos móveis: representa uma lista de possíveis URLs finais para dispositivos móveis para seu anúncio, palavra-chave ou sitelink depois de todos os redirecionamentos entre domínios.
  • URL final do aplicativo: representa uma lista de URLs finais do aplicativo que serão usadas em dispositivos móveis se o usuário tiver o aplicativo específico instalado.
  • Modelo de acompanhamento: modelo opcional para especificar parâmetros ou redirecionamentos adicionais de acompanhamento. Usaremos este modelo para criar o URL de destino real a ser associado ao anúncio.
  • Parâmetros personalizados: parâmetros ValueTrack opcionais que também podem ser atribuídos aos seus próprios IDs.

Entidades compatíveis

A tabela a seguir resume o suporte a campos individuais de URLs atualizados em várias entidades do Google AdWords.

Entidade do Google AdWords URL final URL final para dispositivos móveis URL final do aplicativo Parâmetros personalizados Modelo de acompanhamento
Customer Marca de seleção
Campaign Marca de seleção Marca de seleção
AdGroup Marca de seleção Marca de seleção
Ad Marca de seleção Marca de seleção Marca de seleção Marca de seleção Marca de seleção
AdGroupCriterion Marca de seleção Marca de seleção Marca de seleção Marca de seleção Marca de seleção
FeedItem (Sitelink) Marca de seleção Marca de seleção Marca de seleção Marca de seleção Marca de seleção

Detalhes técnicos

URL final

O URL final representa a página de destino real do seu anúncio, palavra-chave ou sitelink. Ele é o URL que o usuário vê na barra de navegação depois de clicar no seu anúncio. Não deve ter redirecionamentos fora do domínio.

O snippet de código C# a seguir mostra como criar um anúncio de texto com URLs finais.

// Create the text ad.
TextAd textAd = new TextAd();
textAd.headline = "Luxury Cruise to Mars";
textAd.description1 = "Visit the Red Planet in style.";
textAd.description2 = "Low-gravity fun for everyone!";
textAd.displayUrl = "www.example.com";

// Specify a list of final URLs. This field cannot be set if URL field
// is set. This may be specified at ad, criterion and feed item levels.
textAd.finalUrls = new string[] {
   "http://www.example.com/cruise/space/"
};

// Specify a list of final mobile URLs. This field cannot be set if URL
// field is set, or finalUrls is unset. This may be specified at ad,
// criterion and feed item levels.
textAd.finalMobileUrls = new string[] {
    "http://mobile.example.com/cruise/space/"
};

AdGroupAd textAdGroupAd = new AdGroupAd();
textAdGroupAd.adGroupId = adGroupId;
textAdGroupAd.ad = textAd;

// Create your Ad.
...

Os URLs finais seguem as mesmas regras de modificação que os URLs de destino. Por exemplo, um URL final no nível da palavra-chave modifica um URL final no nível de um anúncio.

Todas as regras de validação de URL existentes para URLs de destino se aplicam a URLs finais. É possível ter tags de URL em URLs finais. Todas as tags precisam ser tags ValueTrack válidas ou parâmetros personalizados. É possível ter até quatro níveis de aninhamento ao especificar tags de URL, por exemplo:

{ifmobile:{ifsearch:{keyword:cp={_customP}}}}

Na maioria das vezes, é necessário especificar somente um URL final ou URL final para dispositivos móveis. No raro caso em que um modelo de acompanhamento possa redirecionar o usuário para uma das páginas de destino (por exemplo, ao testá-las) que não passam por uma página de destino comum no domínio do anunciante, é possível especificar essas páginas de destino usando vários URLs finais.

URLs finais para dispositivos móveis

Se você quiser enviar o usuário para uma página de destino diferente em dispositivos móveis, é possível fornecer um URL final para dispositivos móveis separado da sua preferência. No entanto, se você preferir usar os parâmetros ValueTrack, poderá optar pelos existentes, {device} e {ifmobile}, em vez de usar este campo.

URLs finais do aplicativo

Se você tiver anúncios que vinculam diretamente ao conteúdo de um aplicativo usando links diretos ou anúncios clique para fazer download, poderá especificar esses URLs no campo URLs finais do aplicativo.

Modelo de acompanhamento

Também é possível especificar quais parâmetros de acompanhamento ou redirecionamentos são necessários usando o modelo de acompanhamento. Quando especificado, esse parâmetro será usado em vez dos URLs finais para criar o URL de destino real usado para seu anúncio. O serviço de acompanhamento pode rastrear o clique e redirecionar o usuário para uma página de destino. O URL da página de destino precisa ser correspondente ao URL final. Esse modelo pode conter o URL final usando parâmetros ValueTrack especiais, como {lpurl}.

Para alterar os parâmetros de acompanhamento em qualquer entidade compatível, exceto um Ad, basta atualizar o modelo de acompanhamento. Isso não acionará nenhuma ação de análise por parte do Google, permitindo que seus anúncios continuem sendo veiculados ininterruptamente. Para alterar o modelo de acompanhamento de um Ad, remova o Ad existente e crie um novo Ad com o novo modelo de acompanhamento.

O seguinte snippet de código mostra como definir o modelo de acompanhamento no nível da campanha:

Campaign campaign = new Campaign();
campaign.id = 12345678;

// Specify a tracking URL for 3rd party tracking provider. You may
// specify one at customer, campaign, ad group, ad, criterion or
// feed item levels.
campaign.trackingUrlTemplate =
    "http://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}";

// Update your campaign.
...

Assim como nos URLs finais, um modelo de acompanhamento específico em uma entidade de nível mais baixo modificará a configuração específica em uma entidade de nível mais alto. Por exemplo, um modelo de acompanhamento no nível da campanha modifica a configuração no nível da conta.

Parâmetros personalizados

Os parâmetros personalizados possibilitam essencialmente criar seus próprios parâmetros ValueTrack, que podem ser úteis quando você quiser usar seus próprios IDs, por exemplo, na identificação de palavras-chave. Anteriormente, era necessário fixar isso no código nos URLs de destino de palavra-chave. Agora, é possível especificar o ID da palavra-chave, usar um parâmetro personalizado para cada palavra-chave e consultar o parâmetro personalizado no URL final e/ou modelo de acompanhamento, assim como faria em qualquer outro parâmetro ValueTrack.

Um exemplo de snippet de código que adiciona parâmetros personalizados a uma campanha é mostrado abaixo. Ele pressupõe que o modelo de URL de acompanhamento é definido como

http://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}

conforme explicado anteriormente.

Campaign campaign = new Campaign();
campaign.id = 12345678;

// Since the tracking URL has two custom parameters, provide their
// values too. This can be provided at campaign, ad group, ad, criterion
// or feed item levels.
CustomParameter seasonParameter = new CustomParameter();
seasonParameter.key = "season";
seasonParameter.value = "spring";

CustomParameter promoCodeParameter = new CustomParameter();
promoCodeParameter.key = "promocode";
promoCodeParameter.value = "NYC123";

campaign.urlCustomParameters = new CustomParameters();
campaign.urlCustomParameters.parameters =
     new CustomParameter[] { seasonParameter, promoCodeParameter };

// Update your campaign.
...

O nome de uma parâmetro personalizado pode conter somente caracteres alfanuméricos. Ao se referir ao parâmetro personalizado nos URLs finais e no modelo de acompanhamento, é necessário inserir colchetes antes e depois dele e prefixar um sublinhado no nome dele, por exemplo, {_promoCode}.

Assim como nos URLs finais, os parâmetros personalizados em uma entidade de nível mais baixo modificam os valores definidos em entidades de nível mais alto. É possível ter até três parâmetros personalizados para uma entidade. A chave e o valor não podem ultrapassar 16 e 200 bytes, respectivamente.

Novos parâmetros ValueTrack

Os seguintes parâmetros ValueTrack podem ser usados com URLs atualizados:

  • {ignore}: este parâmetro pode ser inserido em um URL final para indicar que o conteúdo da parte subsequente do URL não é alterado. É possível usar este parâmetro para reduzir o volume de atividade de rastreamento no URL.

    Por exemplo, se você tiver um URL final deste tipo:

    http://cars.example.com/sedan{ignore}?promocode=NYC123&udv={device}
    

    Ele informa ao Google que o conteúdo da página é determinado somente por http://cars.example.com/sedan e que a página não precisa ser rastreada novamente em busca de mudanças no promocode ou diferentes instanciações de {device}.

  • {lpurl}, {lpurl+2}, {lpurl+3}: estes parâmetros são inicializador com o URL final da página, com escape de acordo com as especificações padrão do URL. Se você precisar do URL sem escape, poderá usar {unescapedurl}, {unescapedurl+2} ou {unescapedurl+3}. Isso só é compatível com URLs de acompanhamento.

Saiba mais sobre parâmetros ValueTrack no nosso artigo da Central de Ajuda.

Sitelinks são compatíveis com URLs atualizados usando atributos FeedItem. Os marcadores de posição relevantes são:

Tipo de marcador de posição Código Campo do marcador de posição Tipo de dados Código
SITELINKS 1 URLS FINAIS REPEATED_URL 5
URLS FINAIS PARA DISPOSITIVOS MÓVEIS REPEATED_URL 6
MODELO DE ACOMPANHAMENTO URL 7

A propriedade urlCustomParameters permite definir parâmetros personalizados.

Relatórios

Modelos de acompanhamento, URLs finais, URLs finais para dispositivos móveis e parâmetros personalizados são todos indicados como atributos em vários relatórios de desempenho. No relatório, lembre-se de que os URLs finais e os URLs finais para dispositivos móveis serão renderizados como uma lista de valores separados por ponto e vírgula, como neste exemplo:

http://www.example.com/cruise/space/;http://www.example.com/locations/mars/

De forma semelhante, os parâmetros personalizados serão retornados como um conjunto de pares de valores-chave separados por ponto e vírgula:

{_season}=spring;{_promocode}=NYC123

Para que as estatísticas sejam resumidas pelo URL final efetivo de cada impressão, use o FINAL_URL_REPORT.

Preparar-se para URLs atualizados

É possível atualizar entidades existentes para usar URLs atualizados limpando os campos de URL de destino e definindo os campos de URL atualizado adequados. No entanto, essa abordagem não funcionará com anúncios porque não é possível atualizar o URL de destino de um anúncio depois de ele ser criado. Em vez disso, é necessário usar o método upgradeUrl de AdGroupAdService para atualizar os anúncios. O método upgradeUrl atualizará seus anúncios sem perder as estatísticas do histórico.

AdGroupAdService adGroupAdService = (AdGroupAdService) user.GetService(
    AdWordsService.v201702.AdGroupAdService);

AdUrlUpgrade upgrade = new AdUrlUpgrade() {
  adId = adId,
  finalUrl = "http://example.com",
};
try {
  adGroupAdService.upgradeUrl(new AdUrlUpgrade[] { upgrade });
} catch (Exception ex) {
  throw new System.ApplicationException("Failed to upgrade ad.", ex);
}

Lembre-se de que a alteração do URL de um anúncio, palavra-chave ou sitelink acionará um análise editorial.

Ao trabalhar com configurações antigas e novas, lembre-se de que:

  • Parâmetros personalizados e novos parâmetros ValueTrack não funcionam com URLs de destino legados, apenas com campos de URL atualizado.
  • Os modelos de acompanhamento não afetam URLs de destino legados. Funcionam somente com campos de URL atualizado.
  • Os modelos de acompanhamento no nível da conta, campanha ou grupo de anúncios precisam ter {lpurl} ou uma tag equivalente.
  • Não é possível combinar configurações antigas e novas no mesmo nível. No entanto, é possível combinar configurações dentro de uma hierarquia de objetos. Configurações de um nível mais baixo modificam as configurações de um nível mais alto. Por exemplo, caso seus anúncios de um grupo de anúncios tiverem URLs finais, mas suas palavras-chave tiverem URLs de destino, os URLs de destino das palavras-chave terão precedência sobre os URLs finais.

Consulte Migrar para URLs atualizados para mais detalhes.

Como atualizar URLs atualizados

Dependendo do tipo de entidade, mudanças nos atributos do URL atualizado podem acionar uma análise editorial que impedirá que seus anúncios sejam veiculados enquanto a análise não for concluída.

Entidade do Google AdWords URL final URL final para dispositivos móveis URL final do aplicativo Parâmetros personalizados Modelo de acompanhamento
Customer N/D N/D N/D N/D

Veiculação

Campaign N/D N/D N/D

Veiculação

Veiculação

AdGroup N/D N/D N/D

Veiculação

Veiculação

Criterion

Interrompido

Interrompido

Interrompido

Interrompido

Interrompido

FeedItem

Interrompido

Interrompido

Interrompido

Interrompido

Interrompido

Ad

Interrompido

Interrompido

Interrompido

Interrompido

Interrompido

Exemplos de código

A pasta AdvancedOperations de cada biblioteca cliente contém um exemplo de código que mostra como configurar URLs atualizados.

Biblioteca Exemplo AddTextAdWithUpgradedUrls
Java AddTextAdWithUpgradedUrls.java
Perl add_text_ad_with_upgraded_urls.pl
PHP AddTextAdWithUpgradedUrls.php
Python add_text_ad_with_upgraded_urls.py
Ruby add_text_ad_with_upgraded_urls.rb
.NET (C#) AddTextAdWithUpgradedUrls.cs
.NET (VB) AddTextAdWithUpgradedUrls.vb

Migrar para URLs atualizados

O restante deste guia explica como atualizar seus URLs de destino para URLs atualizados usando a Google AdWords API.

Se você optar por não fazer upgrade agora e seu URL de destino não contiver um domínio diferente do URL de visualização, seu URL de destino será atualizado automaticamente a partir de julho de 2015. Se ele tiver um domínio diferente, a veiculação dos seus anúncios será interrompida até você fazer upgrade manual do URL.

Se usa um serviço de gerenciamento de campanhas ou de acompanhamento de cliques de terceiros, além de você mesmo fazer chamadas à API, entre em contato com seu provedor de serviços para aproveitar o suporte ou a documentação referentes ao upgrade que ele oferece específico para a plataforma e serviço dele.

Identificar URLs de destino a serem migrados

Anúncios ativados e pausados com URLs de destino são candidatos a migração (exceto anúncios dinâmicos da Rede de Display, Promoções Patrocinadas no Gmail e anúncios lightbox). É possível consultar anúncios candidatos com:

AdGroupAdPage page = adGroupAdService.query("Select AdGroupId, Id where " +
    "Url starts_with 'http' and Status in [ENABLED, PAUSED]");

Para os critérios, use esta consulta:

AdGroupCriterionPage page = adGroupCriterionService.query("SELECT AdGroupId, Id where " +
    "DestinationUrl starts_with 'http' and Status in [ENABLED, PAUSED]");

Não há nenhum filtro de URL para extensões, portanto, é necessário recuperar todos os itens do feed ativos e visualmente identificar o campo de URL.

Fazer o download de entidades

Para migrar sua conta para usar URLs atualizados, comece recuperando estas entidades:

Anúncios

AdGroupAdService service =
    (AdGroupAdService) user.GetService(AdWordsService.v201702.AdGroupAdService);

AdGroupAdPage page = service.query("Select AdGroupId, Id, Url where " +
    "Status in [ENABLED, PAUSED]");

Critérios

AdGroupCriterionService service = (AdGroupCriterionService) user.GetService(
    AdWordsService.v201702.AdGroupCriterionService);

AdGroupCriterionPage page = service .query("Select AdGroupId, Id, " +
    "DestinationUrl where Status in [ENABLED, PAUSED]");
CampaignExtensionSettingService service = (CampaignExtensionSettingService)
    user.GetService(AdWordsService.v201702.CampaignExtensionSettingService);

CampaignExtensionSettingPage page = service.query(
    "Select CampaignId, Extensions where ExtensionType=SITELINK");

A migração será mais simples se você agrupar por campanha ou grupo de anúncios. Consulte nossos exemplos de código para ver como filtrar os downloads.

Tipos de URL

Todos os URLs de destino do Google AdWords são amplamente enquadrados em um destes dois tipos:

Tipo 1 Tipo 2
Descrição Não é usada nenhuma forma de acompanhamento nos URLs. Parâmetros de acompanhamento ou um servidor de acompanhamento é usado para monitorar o desempenho do anúncio ou você redireciona para outro domínio.
Exemplos de URL http://example.com/shoes
http://example.com/dresses?color=red
http://example.com/shoes?color=red&kwid=12345&ad={creative}
http://tracker.example.com/redir?kwid=12345&ad={creative}&url=http%3A%2F%2Fwww.example.com%2Fshoes%3Fcolor%3Dred

Estratégias de migração

Apresentamos três estratégias de migração que abordam os dois tipos de URL de destino.

Estratégia 1 Estratégia 2 Estratégia 3
Resumo Copiar URL de destino no URL final O URL de destino é dividido em duas partes: acompanhamento e página de destino. A parte do acompanhamento é copiada no modelo de URL de acompanhamento e o URL da página de destino é copiado no URL final. O URL de destino é dividido em duas partes: acompanhamento e página de destino. Parâmetros comuns são identificados e usados para definir o modelo de acompanhamento compartilhado e os parâmetros personalizados. O URL da página de destino é copiado no URL final.
Aplicável a Tipo 1, Tipo 2 Tipo 2 Tipo 2
Vantagens durante o upgrade
Estatísticas de desempenho do anúncio mantidas Marca de seleção Marca de seleção Sinal de proibido
Nenhuma revisão de política foi acionada para anúncios, palavras-chave e sitelinks Marca de seleção Marca de seleção Sinal de proibido
Recursos disponíveis depois do upgrade
Carga reduzida no website quando novos anúncios ou palavras-chave estão em revisão Sinal de proibido Marca de seleção Marca de seleção
Gerenciamento de acompanhamento de URLs centralizado Sinal de proibido Sinal de proibido Marca de seleção
As alterações futuras nos modelos de acompanhamento compartilhados não redefinirão seus dados de desempenho do anúncio nem interromperão a veiculação dele Sinal de proibido Sinal de proibido Marca de seleção
O novo ValueTrack e os parâmetros personalizados podem ser adicionados durante o processo de upgrade Sim (com revisão) Sim (com revisão) Sim (com revisão)

Agora, discutiremos cada estratégia em detalhes.

Estratégia 1: cópia direta

Esta estratégia de migração é recomendada para entidades Tipo 1. Nessa abordagem, fazemos upgrade das entidades copiando o URL de destino no URL final e apagando o URL de destino.

Anúncios

Como URLs de destino de anúncios não podem ser atualizadas depois de serem criadas, use o seguinte método migração ao atualizar os anúncios:

List<AdUrlUpgrade> operations = new List<AdUrlUpgrade>();
foreach (AdGroupAd adGroupAd in page.entries) {
  AdUrlUpgrade upgradeUrl = new AdUrlUpgrade();
  upgradeUrl.adId = adGroupAd.ad.id;
  upgradeUrl.finalUrl = adGroupAd.ad.url;
  operations.Add(upgradeUrl);
}
service.upgradeUrl(operations.ToArray());

Dessa forma, seus anúncios são atualizados e as estatísticas deles não são redefinidas.

Critérios

foreach (AdGroupCriterion adGroupCriterion in page.entries) {
  if (adGroupCriterion is BiddableAdGroupCriterion) {
    BiddableAdGroupCriterion biddableAdGroupCriterion =
       (BiddableAdGroupCriterion) adGroupCriterion;
    biddableAdGroupCriterion.finalUrls = new UrlList() {
      urls = new string[] {
        biddableAdGroupCriterion.destinationUrl
      }
    };
    biddableAdGroupCriterion.destinationUrl = null;

    AdGroupCriterionOperation operation = new AdGroupCriterionOperation() {
      @operator = Operator.SET,
      operand = biddableAdGroupCriterion
    };
    operations.Add(operation);
  }
}
service.mutate(operations.ToArray());
List<CampaignExtensionSettingOperation> operations =
    new List<CampaignExtensionSettingOperation>();
foreach (CampaignExtensionSetting campaignExtensionSetting in page.entries) {
  foreach (ExtensionFeedItem feedItem in
      campaignExtensionSetting.extensionSetting.extensions) {
    if (feedItem is SitelinkFeedItem) {
      SitelinkFeedItem sitelinkFeedItem = (SitelinkFeedItem) feedItem;
      if (String.IsNullOrWhiteSpace(sitelinkFeedItem.sitelinkUrl)) {
        sitelinkFeedItem.sitelinkUrl = null; //No update to this field
      } else {
        sitelinkFeedItem.sitelinkFinalUrls = new string[] {
          sitelinkFeedItem.sitelinkUrl
        };
        sitelinkFeedItem.sitelinkUrl = "";
      }
    }
  }
  CampaignExtensionSettingOperation operation =
      new CampaignExtensionSettingOperation() {
    operand = campaignExtensionSetting,
    @operator = Operator.SET
  };
  operations.Add(operation);
}
service.mutate(operations.ToArray());

Estratégia 2: use o modelo de URL de acompanhamento

Esta estratégia de migração pode ser usada para fazer upgrade de entidades Tipo 2. Ela migra para URLs atualizados sem usar modelos de acompanhamento compartilhado nem parâmetros ValueTrack personalizados. Esta abordagem tem precedência quando parâmetros personalizados permanecem estáticos durante toda a campanha.

Analisar URLs

Primeiro, divida o URL de destino nas suas duas partes: modelo de acompanhamento e página de destino. Insira {lpurl} no modelo de acompanhamento, no qual o URL da página de destino original foi exibido no URL de destino original.

URL de destino Modelo de acompanhamento Página de destino
http://example.com/shoes?color=red&kwid=12345&ad={creative} {lpurl}&kwid=12345&ad={creative} http://example.com/shoes?color=red
http://tracker.example.com/redir?kwid=12345&ad={creative}&url= http%3A%2F%2Fwww.example.com%2Fshoes%3Fcolor%3Dred http://tracker.example.com/redir?kwid=12345&ad={creative}&url={lpurl} http://example.com/shoes?color=red

Atualizar entidades

Agora, você pode fazer upgrade dessas entidades como na Estratégia 1. Também é necessário definir o modelo de acompanhamento da sua entidade para o modelo de URL de acompanhamento recém-avaliado:

Anúncios
List operations = new List();
foreach (AdGroupAd adGroupAd in page.entries) {
  AdUrlUpgrade upgradeUrl = new AdUrlUpgrade();
  upgradeUrl.adId = adGroupAd.ad.id;
  upgradeUrl.finalUrl = landingPageUrl;

  upgradeUrl.trackingUrlTemplate = trackingUrlTemplate;
  operations.Add(upgradeUrl);
}
service.upgradeUrl(operations. ToArray());
Critérios
foreach (AdGroupCriterion adGroupCriterion in page.entries) {
  if (adGroupCriterion is BiddableAdGroupCriterion) {
    BiddableAdGroupCriterion biddableAdGroupCriterion =
       (BiddableAdGroupCriterion) adGroupCriterion;
    biddableAdGroupCriterion.finalUrls = new UrlList() {
      urls = new string[] {
        landingPageUrl
      }
    };
    biddableAdGroupCriterion.destinationUrl = null;

    biddableAdGroupCriterion.trackingUrlTemplate = trackingUrlTemplate;

    AdGroupCriterionOperation operation = new AdGroupCriterionOperation() {
      @operator = Operator.SET,
      operand = biddableAdGroupCriterion
    };
    operations.Add(operation);
  }
}
service.mutate(operations. ToArray());
List operations =
    new List();
foreach (CampaignExtensionSetting campaignExtensionSetting in page.entries) {
  foreach (ExtensionFeedItem feedItem in
      campaignExtensionSetting.extensionSetting.extensions) {
    if (feedItem is SitelinkFeedItem) {
      SitelinkFeedItem sitelinkFeedItem = (SitelinkFeedItem) feedItem;

      sitelinkFeedItem.sitelinkFinalUrls = new string[] {
        landingPageUrl
      };
      sitelinkFeedItem.sitelinkUrl = null;
      sitelinkFeedItem.sitelinkTrackingUrlTemplate = trackingUrlTemplate;
    }
  }
  CampaignExtensionSettingOperation operation =
      new CampaignExtensionSettingOperation() {
    operand = campaignExtensionSetting,
    @operator = Operator.SET
  };
  operations.Add(operation);
}
service.mutate(operations. ToArray());

Estratégia 3: usar o modelo de acompanhamento compartilhado

Esta estratégia pode ser usada para migrar entidades Tipo 2. Ela usa modelos de acompanhamento compartilhado e parâmetros ValueTrack personalizados. Essa abordagem terá precedência se você usar um ou mais servidores de acompanhamento de terceiros ou caso seus parâmetros de acompanhamento forem alterados com frequência.

Analisar URLs

Primeiro, divida seu URL de destino nas suas duas partes: modelo de acompanhamento e página de destino.

URL de destino Modelo de acompanhamento Página de destino
http://example.com/shoes?color=red& kwid=12345&ad={creative} {lpurl}&kwid=12345&ad={creative} http://example.com/shoes?color=red
http://tracker.example.com/redir? kwid=12345&ad={creative} &url=http%3A%2F%2Fwww.example.com%2F shoes%3Fcolor%3Dred http://tracker.example.com/redir? kwid=12345&ad={creative}&url={lpurl} http://example.com/shoes?color=red

Em seguida, tente identificar o URL de acompanhamento reutilizável e os parâmetros personalizados do seu modelo de acompanhamento. Dependendo da estrutura da sua conta, procure por valores reutilizáveis no nível do grupo de anúncios, campanha ou conta.

Modelo de acompanhamento URL de rastreamento Parâmetros de acompanhamento
{lpurl}&kwid=12345&ad={creative}   kwid=
ad=
http://tracker.example.com/redir?kwid=12345&ad={creative}&url={lpurl} http://tracker.example.com/redir kwid=
ad=
url=

Defina os parâmetros personalizados para conter os valores de cada parâmetro de acompanhamento identificado. Observe o sublinhado pré-demarcado.

Parâmetro personalizado Valor
_kwid 12345
_ad {creative}

Modifique seu modelo de acompanhamento para usar os novos parâmetros personalizados.

URL de destino Modelo de acompanhamento Parâmetros personalizados Valores do parâmetro Página de destino
http://example.com/shoes? color=red&kwid=12345&ad={creative} {lpurl}&kwid={_kwid}&ad={_ad} _kwid 12345 http://example.com/shoes? color=red
_ad {creative}
http://tracker.example.com/redir? kwid=12345&ad={creative}&url=http%3A%2F%2F www.example.com%2Fshoes%3Fcolor%3Dred http://tracker.example.com/redir? kwid={_kwid}&ad={_ad}&url={lpurl} _kwid 12345 http://example.com/shoes? color=red
_ad {creative}

Identificar o nível compartilhado

Você precisa identificar o nível hierárquico no qual cada entidade compartilhada pode ser posicionada. Por exemplo, o modelo de URL de acompanhamento pode ser compartilhado no nível da campanha ou da conta. Já um parâmetro personalizado pode fazer sentido no nível da palavra-chave. O snippet de código deste guia pressupõe que o modelo de URL de acompanhamento e os parâmetros personalizados podem ser compartilhados no nível da campanha.

Atualizar entidades

Depois de identificar as partes compartilháveis dos seus URLs de destino e a posição deles na hierarquia, é possível definir os parâmetros na sua conta:

Campanha
CampaignService service =
    (CampaignService) user.GetService(AdWordsService.v201702.CampaignService);

Campaign campaign = new Campaign();
campaign.id = 12345678;

// Specify a tracking URL for 3rd party tracking provider. You can
// specify one at customer, campaign, ad group, ad, criterion or
// feed item levels.
campaign.trackingUrlTemplate =
    "http://tracker.example.com/?kwid={_kwid}&ad={_ad}&url={lpurl}";

// Since your tracking URL has two custom parameters, provide their
// values too. This can be provided at campaign, ad group, ad, criterion
// or feed item levels.
CustomParameter seasonParameter = new CustomParameter();
seasonParameter.key = "kwid";
seasonParameter.value = "12345";

CustomParameter promoCodeParameter = new CustomParameter();
promoCodeParameter.key = "ad";
promoCodeParameter.value = "{creative}";

campaign.urlCustomParameters = new CustomParameters();
campaign.urlCustomParameters.parameters =
     new CustomParameter[] { seasonParameter, promoCodeParameter };

// Create the operation.
CampaignOperation operation = new CampaignOperation();
operation.@operator = Operator.SET;
operation.operand = campaign;

CampaignReturnValue retVal = service.mutate(new CampaignOperation[] { operation });
Anúncios

Como o Google AdWords não é capaz de inferir o URL de destino completo do anúncio apenas com base nos seus campos de modelo de URL de acompanhamento e de URL final, o método upgradeUrl não pode ser utilizado nesse caso. Em vez disso, é necessário excluir o anúncio antigo e criar um novo. Isso acionará uma revisão de anúncio para o novo anúncio, e as estatísticas dele serão reiniciadas. As estatísticas do anúncio excluído continuarão disponíveis.

List operations = new List();

foreach (AdGroupAd adGroupAd in page.entries) {
  // Delete the existing ad.
  AdGroupAd adToDelete = new AdGroupAd() {
    adGroupId = adGroupAd.adGroupId,
    ad = new Ad() {
      id = adGroupAd.ad.id
    }
  };

  AdGroupAdOperation removeOperation = new AdGroupAdOperation() {
    operand = adToDelete,
    @operator = Operator.REMOVE
  };
  operations.Add(removeOperation);

  // Make a copy of the ad.
  AdGroupAd adToAdd = new AdGroupAd() {
    adGroupId = adGroupAd.adGroupId,
    ad = adGroupAd.ad
  };

  // Clear the ID to tell AdWords that this is a new ad.
  adToAdd.ad.idSpecified = false;

  // Set the final URL to the newly evaluated landing page URL.
  adToAdd.ad.finalUrls = new string[] {
    landingPageUrl
  };

  // Clear the destination URL.
  adToAdd.ad.url = null;

  AdGroupAdOperation addOperation = new AdGroupAdOperation() {
    operand = adToAdd,
    @operator = Operator.ADD
  };
  operations.Add(addOperation);
}

service.mutate(operations. ToArray());
Critérios
foreach (AdGroupCriterion adGroupCriterion in page.entries) {
  if (adGroupCriterion is BiddableAdGroupCriterion) {
    BiddableAdGroupCriterion biddableAdGroupCriterion =
       (BiddableAdGroupCriterion) adGroupCriterion;
    biddableAdGroupCriterion.finalUrls = new UrlList() {
      urls = new string[] {
        landingPageUrl
      }
    };
    biddableAdGroupCriterion.destinationUrl = null;

    AdGroupCriterionOperation operation = new AdGroupCriterionOperation() {
      @operator = Operator.SET,
      operand = biddableAdGroupCriterion
    };
    operations.Add(operation);
  }
}
service.mutate(operations. ToArray());
List operations =
    new List();
foreach (CampaignExtensionSetting campaignExtensionSetting in page.entries) {
  foreach (ExtensionFeedItem feedItem in
      campaignExtensionSetting.extensionSetting.extensions) {
    if (feedItem is SitelinkFeedItem) {
      SitelinkFeedItem sitelinkFeedItem = (SitelinkFeedItem) feedItem;

      sitelinkFeedItem.sitelinkFinalUrls = new string[] {
        landingPageUrl
      };
      sitelinkFeedItem.sitelinkUrl = null;
    }
  }
  CampaignExtensionSettingOperation operation =
      new CampaignExtensionSettingOperation() {
    operand = campaignExtensionSetting,
    @operator = Operator.SET
  };
  operations.Add(operation);
}
service.mutate(operations. ToArray());

URLs para dispositivos móveis

Se você quiser enviar o usuário para uma página de destino diferente em dispositivos móveis, é possível fornecer um URL final para dispositivos móveis de preferência. Isso é feito definindo o campo finalMobileUrls da entidade. Também é possível continuar usando os parâmetros ValueTrack existentes: {device} e {ifmobile}.

Upgrade parcial

É possível fazer upgrade de parte de uma conta sem afetar o restante dela. Campos de URL atualizado não têm nenhum efeito sobre uma entidade se o URL final não é especificado. Por exemplo, se você especificou um modelo de URL de acompanhamento no nível de uma campanha, mas não fez upgrade dos URLs de destino dos anúncios de um grupo de anúncios, esses anúncios não são afetados pelo modelo de URL de acompanhamento no nível da campanha.

Vários URLs de acompanhamento

Se você tiver mais de um servidor de acompanhamento, poderá usar {lpurl}, {lpurl+2} e {lpurl+3} para criar seu URL de destino. Além disso, pode ter até quatro níveis de aninhamento ao especificar as tags de URL. Por exemplo:

{ifmobile:{ifsearch:{keyword:cp={_customP}}}}

Relatórios

Depois de fazer upgrade dos seus URLs, será necessário atualizar seu código para usar as colunas de URL atualizado, em vez da coluna de URL de destino ao recuperar relatórios. Consulte esta seção para mais detalhes.

As estatísticas de veiculação do seu anúncio permanecerão inalteradas, exceto ao usar a Estratégia 3. Ao usar essa estratégia, é necessário excluir seus anúncios antigos e criar novas cópias. Isso acionará uma revisão de anúncio para o novo anúncio, e suas estatísticas serão reiniciadas. No entanto, as estatísticas antigas do anúncio excluído continuarão disponíveis.

Exemplos de código de migração

Consulte os seguintes exemplos de código nas nossas bibliotecas cliente para ajudar você no processo de migração.

Biblioteca Exemplo de operação básica Exemplo UpgradeAdUrl
Java basicoperations UpgradeAdUrl.java
Perl basic_operations upgrade_ad_url.pl
PHP BasicOperations UpgradeAdUrl.php
Python basic_operations upgrade_ad_url.py
Ruby basic_operations upgrade_ad_url.rb
.NET (C#) BasicOperations UpgradeAdUrl.cs
.NET (VB) BasicOperations UpgradeAdUrl.vb

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.