Mappatura ID per il nuovo Search Ads 360

La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API fornisce Maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni di generazione dei report e processi. Scopri di più sulla migrazione e sull'utilizzo dei nuovi report di Search Ads 360 tramite Google Cloud.

Le entità nel nuovo Search Ads 360 hanno uno spazio ID diverso rispetto alla precedente esperienza. Per ottenere la mappatura degli ID tra la precedente esperienza e il nuovo Search Ads 360, invia un Reports.getIdMappingFile() richiesta. La risposta include le mappature degli ID per tutte le entità di un inserzionista specificato.

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 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 di entità supportate e mappature di ID di esempio:

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

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAGNA Mappatura degli ID per 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 ID per: 
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 degli 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 ID per: 
{
  "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 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

Ciascun oggetto nel nuovo Search Ads 360 viene identificato con un proprio ID. Alcuni di questi ID unici a livello globale in tutti gli account del nuovo Search Ads 360, mentre altri sono solo in un ambito limitato. Ad esempio, devi utilizzare sia l'ID gruppo di annunci sia l'ID annuncio per fare in modo che identificare gli annunci, poiché gli ID vengono assegnati in modo univoco a ogni gruppo di annunci, ma non a più gruppi di annunci. Di seguito è riportata l'unicità di ogni ID oggetto all'interno del nuovo Search Ads 360. Queste regole ID possono essere utili durante la progettazione dell'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. La coppia (AdGroupId, AdId) è unica a livello globale.
ID criterio gruppo di annunci Gruppo di annunci No. La coppia (AdGroupId, CriterionId) è unica a livello globale.
ID criterio campagna Campagna No. La coppia (CampaignId, CriterionId) è unica a livello globale.
Estensioni annuncio Campagna No. La coppia (CampaignId, AdExtensionId) è unica a livello globale.
ID feed Globale Sì
ID elemento del feed Globale Sì
ID attributo del feed Feed No
ID mappatura feed Globale Sì
ID etichetta Globale Sì
ID elenco utenti Globale Sì