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 alla precedente. Per ottenere la mappatura degli ID tra il nuovo Search Ads 360 e quello precedente, invia una richiesta Reports.getIdMappingFile() . La risposta include mappature degli ID per tutte le entità di un inserzionista specificato.

Ecco un esempio del file restituito (formato CSV codificato in UTF-8):

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

Il file CSV contiene 3 colonne:

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

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

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

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

Tipo di entità Descrizione ID legacy Nuovi ID
CLIENTE Mappatura degli ID per: 
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"
}
CRITERIO Mappatura degli ID per: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Mappatura degli ID per l'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: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mappatura degli ID per il 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 degli ID per la tabella del 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"
}

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 nella nuova esperienza Search Ads 360 è identificato da un proprio ID. Alcuni di questi ID sono univoci a livello globale in tutti gli account nella nuova esperienza 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 vengono assegnati in modo univoco per gruppo di annunci, ma non tra gruppi di annunci. L'unicità di ogni ID oggetto all'interno del nuovo Search Ads 360 è elencata di seguito. Queste regole ID possono essere utili durante la progettazione dello spazio di archiviazione locale per gli oggetti del nuovo Search Ads 360.

ID oggetto Ambito dell'univocità Univoco a livello globale?
ID budget Globale Sì
ID campagna Globale Sì
ID gruppo di annunci Globale Sì
ID annuncio Gruppo di annunci No. (AdGroupId, AdId) è univoca a livello globale.
ID criteri del gruppo di annunci Gruppo di annunci No. (AdGroupId, CriterionId) è univoca a livello globale.
ID criterio campagna Priorità No. (CampaignId, CriterionId) è univoca a livello globale.
Estensioni annuncio Priorità No. (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ì