As entidades no novo Search Ads 360 têm um espaço de ID diferente do antigo.
Para ver o mapeamento de IDs entre a experiência anterior e a nova do Search Ads 360, envie uma solicitação
Reports.getIdMappingFile()
. A resposta inclui mapeamentos de IDs para todas as entidades de um anunciante especificado.
Veja 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 compatíveis e exemplos de mapeamentos de IDs:
| Tipo da entidade | Descrição | IDs legados | Novos IDs |
|---|---|---|---|
| CLIENTE | Mapeamento de ID para: |
advertiser:
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345"
}
account:
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345",
"engineAccountId": "700000000042205"
}
|
{
"customerId": "200001235"
}
|
| CAMPANHA | Mapeamento de ID da 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: |
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345",
"engineAccountId": "700000000042205",
"campaignId": "71700000068948065",
"adGroupId": "58700006123995025",
"AdGroupCriterionId": "46700015332504045"
}
|
{
"customerId": "200001235",
"campaignId": "14660344555",
"adGroupId":"105138634255",
"criterionId":"948710340465"
}
|
| AD | Mapeamento de ID do 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: |
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345",
"engineAccountId": "700000000042205",
"campaignId": "71700000084403015",
"campaignTargetId": "38700011011700285"
}
|
{
"customerId": "200001235",
"campaignId": "13467100745",
"campaignCriterionId": "2125"
}
|
| CAMPAIGN_GROUP | Mapeamento de ID do grupo de campanhas. |
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345",
"budgetGroupId": "87700002234256082"
}
|
{
"customerId": "200001235",
"campaignGroupId": "1000665659"
}
|
| CAMPAIGN_GROUP_PERFORMANCE_TARGET | Mapeamento de IDs para a meta de performance do grupo de campanhas. |
{
"agencyId": "20700000000000125",
"advertiserId": "2170000012345",
"budgetGroupId": "87700002234256082",
"budgetPlanId": "88700007187391026"
}
|
{
"customerId": "200001235",
"campaignGroupId": "1000665659"
"campaignGroupPerformanceTargetId": "7624175"
}
|
| FEED_TABLE | Mapeamento de IDs para a tabela de feeds. |
{
"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"
}
|
Fazer o download do relatório
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 dentro de um escopo limitado. Por exemplo, é preciso usar o grupo de anúncios e os IDs de anúncio para identificar os anúncios de maneira exclusiva, já que os IDs são atribuídos de maneira exclusiva por grupo, 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 criar armazenamento local para seus objetos do novo Search Ads 360.
| ID do objeto | Escopo de exclusividade | Globalmente exclusivo? |
|---|---|---|
| Budget ID | Global | Sim |
| ID da campanha | 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 |