Mappatura ID per il nuovo Search Ads 360

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API offre maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni e nei processi per la generazione di report. Scopri di più sulla migrazione alla nuova API Search Ads 360 Reporting e su come utilizzarla.

Le entità nel nuovo Search Ads 360 hanno uno spazio ID diverso rispetto al Search Ads 360 precedente. Per ottenere la mappatura degli ID tra la precedente esperienza e il nuovo Search Ads 360, invia una richiesta Reports.getIdMappingFile(). La risposta include le mappature degli ID per la maggior parte delle entità per un inserzionista specificato. Consulta Motivi comuni per cui mancano entità per scoprire di più sul motivo per cui un'entità potrebbe essere omessa dal file di mappatura.

Ecco un esempio del file restituito (formato CSV con codifica UTF-8):

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

Il file CSV contiene tre colonne:

  • Entity Type: tipo di entità di questa riga.

  • Legacy IDs: una stringa JSON del percorso completo dell'entità nella versione precedente di Search Ads 360

  • New IDs: una stringa JSON del percorso completo dell'entità nel nuovo Search Ads 360

La tabella seguente mostra un elenco di entità supportate e mappature di ID di esempio:

Tipo di entità Descrizione ID legacy Nuovi ID
CLIENTE Mappatura degli ID per: Le mappature per gestori e agenzie non sono disponibili. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAGNA Mappatura degli ID per la campagna. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mappatura degli ID per adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
CRITERION Mappatura degli ID per i criteri a livello di gruppo di annunci: 
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 Mappatura ID per annuncio. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Mappatura degli ID per i criteri a livello di campagna: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mappatura degli ID per gruppo di campagne. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mappatura degli ID per l'obiettivo di rendimento del gruppo di campagne. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mappatura ID per la tabella Feed. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mappatura degli ID per feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Motivi comuni per la mancanza di entità

Sebbene il file di mappatura di un inserzionista contenga la maggior parte delle sue entità, in alcuni casi queste potrebbero non essere presenti. Di seguito sono riportati alcuni dei motivi più comuni:

  • Ogni file di mappatura viene aggiornato ogni 3 giorni. Se un file di mappatura viene scaricato immediatamente dopo la creazione di una nuova entità, l'entità probabilmente non sarà presente nel file di mappatura. Probabilmente verrà incluso dopo un'attesa di massimo 3 giorni.
  • L'account a cui appartiene l'entità viene rimosso. In questo caso non supportiamo la mappatura degli ID.

Scarica il report

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()

Unicità dell'ID oggetto

Ogni oggetto nel nuovo Search Ads 360 è identificato dal proprio ID. Alcuni di questi ID sono univoci a livello globale in tutti gli account del nuovo Search Ads 360, mentre altri sono univoci solo in un ambito limitato. Ad esempio, devi utilizzare sia il gruppo di annunci sia gli ID annuncio per identificare in modo univoco gli annunci, poiché gli ID annuncio vengono assegnati in modo univoco per gruppo di annunci, ma non tra gruppi di annunci. Di seguito è riportata l'unicità di ogni ID oggetto nel nuovo Search Ads 360. Queste regole ID possono essere utili per progettare lo spazio di archiviazione locale per i nuovi oggetti Search Ads 360.

ID oggetto Ambito dell'unicità È univoco a livello globale?
ID budget Globale Sì
ID campagna Globale Sì
ID gruppo di annunci Globale Sì
ID annuncio Gruppo di annunci No. La coppia (AdGroupId, AdId) è univoca a livello globale.
ID criterio gruppo di annunci Gruppo di annunci No. La coppia (AdGroupId, CriterionId) è univoca a livello globale.
ID criterio campagna Campagna No. La coppia (CampaignId, CriterionId) è univoca a livello globale.
Estensioni annuncio Campagna No. La coppia (CampaignId, AdExtensionId) è univoca a livello globale.
ID feed Globale Sì
ID elemento del feed Globale Sì
ID attributo feed Feed No
ID mappatura feed Globale Sì
ID etichetta Globale Sì
ID elenco utenti Globale Sì