A maioria das entidades do Google Ads expõe um método getId()
que retorna o identificador. Embora não sejam estritamente necessários na maioria dos casos, os IDs podem ser úteis ao
- Trabalhar com relatórios
- Os IDs oferecem uma boa maneira de vincular uma linha de relatório à entidade real do Google Ads.
- Manter um mapeamento com um armazenamento de dados externo
- Talvez você já tenha informações baseadas em ID armazenadas no seu próprio banco de dados.
- Procurar uma otimização no desempenho
A busca de IDs normalmente é mais rápida do que as alternativas. O código para buscar uma única entidade também é um pouco mais fácil:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Exclusividade
Os IDs das campanhas e dos grupos de anúncios são exclusivos: duas campanhas ou grupos de anúncios nunca compartilham o mesmo ID. Anúncios e palavras-chave, no entanto, têm IDs compostos: um identificador exclusivo de uma palavra-chave é uma combinação dos IDs do grupo de anúncios e da palavra-chave.
Da mesma forma, um identificador exclusivo de um anúncio é uma combinação dos IDs do grupo de anúncios e do ID do anúncio. Isso tem implicações na forma como o selector.withIds()
é chamado.
Para campanhas e grupos de anúncios, selector.withIds()
espera uma matriz de números:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Para anúncios e palavras-chave, no entanto, selector.withIds()
precisa de uma matriz de dois elementos. O primeiro elemento é o ID do grupo de anúncios. O snippet a seguir recupera três palavras-chave de um grupo de anúncios:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
A mesma construção se aplica ao buscar anúncios.