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 conseguir o mapeamento de ID 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 a ausência de entidades 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 antigo Search Ads 360.

  • 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 IDs para critérios no nível 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 ad. 
{
  "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 código 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 as entidades estão ausentes. Confira alguns motivos comuns:

  • Cada arquivo de mapeamento é atualizado a cada três dias. Se um arquivo de mapeamento for transferido por download logo após a criação de uma nova entidade, a entidade provavelmente não estará nesse arquivo. 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.

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 os anúncios de maneira exclusiva, já que os IDs são atribuídos de forma exclusiva por grupo de anúncios, mas não entre grupos. Confira abaixo a exclusividade de cada ID de objeto no novo Search Ads 360. Essas regras de código 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