A maioria das entidades do Google Ads expõe um método getId() que retorna o
identificador delas. Embora não seja estritamente necessário na maioria dos casos, os documentos de identificação podem ser úteis
quando
- Como trabalhar com relatórios
- Os IDs são 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 com base 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 de campanha e de grupo de anúncios são exclusivos: nenhuma campanha ou grupo de anúncios vai
compartilhar o mesmo ID. No entanto, anúncios e palavras-chave têm IDs compostos: o identificador exclusivo de uma palavra-chave é uma combinação do ID do grupo de anúncios e da palavra-chave.
Da mesma forma, um identificador exclusivo de um anúncio é uma combinação do ID do grupo de anúncios e do ID do anúncio. Isso tem implicações para a forma como selector.withIds() é chamada.
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);
No entanto, para anúncios e palavras-chave, selector.withIds() precisa de uma matriz de
matrizes de dois elementos, sendo 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]
]);
O mesmo conceito se aplica ao buscar anúncios.