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 360New 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ì |