Mapeamento de IDs para o novo Search Ads 360

A nova API Search Ads 360 Reporting já está disponível. A nova API oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos e processos relacionados à geração de relatórios. Saiba como migrar e usar a nova API Search Ads 360 Reporting.

As entidades no novo Search Ads 360 têm um espaço de ID diferente do antigo. Para conferir o mapeamento de IDs entre o antigo e o novo Search Ads 360, envie uma solicitação Reports.getIdMappingFile(). A resposta inclui mapeamentos de ID para a maioria das entidades de um anunciante especificado. Consulte Motivos comuns para entidades ausentes para saber mais sobre por que uma entidade pode ser omitida do arquivo de mapeamento.

Confira um exemplo do arquivo retornado (formato CSV codificado em UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

O arquivo CSV tem três colunas:

  • Entity Type: o tipo de entidade desta linha.

  • Legacy IDs: uma string JSON do caminho completo da entidade no Search Ads 360 anterior

  • New IDs: uma string JSON do caminho completo da entidade no novo Search Ads 360

A tabela abaixo mostra uma lista de entidades com suporte e exemplos de mapeamentos de ID:

Tipo da entidade Descrição IDs legados Novos IDs
CLIENTE Mapeamento de ID para: Os mapeamentos para gerentes e agências não estão disponíveis. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPANHA Mapeamento de ID para campanha. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mapeamento de ID para adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
CRITÉRIO Mapeamento de ID para critérios do grupo de anúncios: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Mapeamento de ID para anúncio. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Mapeamento de ID para critérios no nível da campanha: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mapeamento de ID para o grupo de campanhas. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mapeamento de ID para a meta de desempenho do grupo de campanhas. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mapeamento de ID para a tabela de feed. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mapeamento de ID para feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Motivos comuns para entidades ausentes

Embora o arquivo de mapeamento de um anunciante contenha a maioria das entidades, ainda há alguns casos em que elas estão ausentes. Confira alguns motivos comuns:

  • Cada arquivo de mapeamento é atualizado a cada três dias. Se um arquivo de mapeamento for feito imediatamente após a criação de uma nova entidade, ela provavelmente não vai estar no arquivo de mapeamento. Ele provavelmente será incluído após uma espera de até três dias.
  • A conta à qual a entidade pertence é removida. Não oferecemos suporte para mapeamento de ID nesse caso.
  • Não é possível fazer uma atualização em uma entidade (por exemplo, "Campanha") no mecanismo no novo Search Ads 360. As atualizações foram processadas criando uma nova entidade do Search Ads 360, com a atualização e a remoção subsequente da entidade anterior do Search Ads 360.
  • É possível que os mapeamentos anteriores tenham sido removidos como resultado da sincronização entre o antigo e o novo Search Ads 360, em que apenas o mapeamento mais recente é mantido. Vários mapeamentos entre um único ID legado e vários IDs do novo Search Ads 360 são resolvidos, mantendo o que tem o carimbo de data/hora mais recente.
  • A conta do mecanismo não é sincronizada devido a erros de sincronização entre o antigo e o novo Search Ads 360.
  • A conta é removida ou desativada.

Baixe o relatório (em inglês)

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

Exclusividade do ID do objeto

Cada objeto no novo Search Ads 360 é identificado pelo próprio ID. Alguns desses IDs são exclusivos em nível global em todas as contas no novo Search Ads 360, enquanto outros são exclusivos apenas em um escopo limitado. Por exemplo, você precisa usar o grupo de anúncios e os IDs de anúncios para identificar anúncios de forma exclusiva, já que os IDs são atribuídos de forma exclusiva por grupo de anúncios, mas não entre grupos. A exclusividade de cada ID de objeto no novo Search Ads 360 está listada abaixo. Essas regras de ID podem ser úteis ao projetar o armazenamento local para seus novos objetos do Search Ads 360.

ID do objeto Escopo de exclusividade Globalmente exclusivo?
Budget ID Global Sim
Campaign ID Global Sim
AdGroup ID Global Sim
Ad ID Grupo de anúncios Não. O par (AdGroupId, AdId) é globalmente exclusivo.
AdGroupCriterion ID Grupo de anúncios Não. O par (AdGroupId, CriterionId) é globalmente exclusivo.
CampaignCriterion ID Campanha Não. O par (CampaignId, CriterionId) é globalmente exclusivo.
Extensões de anúncio Campanha Não. O par (CampaignId, AdExtensionId) é globalmente exclusivo.
ID de feed Global Sim
Feed Item ID Global Sim
Feed Attribute ID Feed Não
Feed Mapping ID Global Sim
Label ID Global Sim
ID da lista de usuários Global Sim