Guida alla migrazione di Search Ads 360
Il connettore Search Ads 360 (precedentemente noto come Doubleclick Search) si basa sulla nuova API Search Ads 360 Reporting. La versione precedente dell'API Search Ads 360 Reporting non è più supportata, quindi devi eseguire la migrazione dei flussi di lavoro di BigQuery Data Transfer Service in modo che siano compatibili con la nuova API di reporting di Search Ads 360. Questo documento mostra le modifiche del nuovo Search Ads 360 rispetto alla versione precedente e fornisce informazioni di mappatura per eseguire la migrazione delle risorse esistenti al nuovo Search Ads 360.
Le novità di Search Ads 360
La nuova API di reporting di Search Ads 360 offre diverse modifiche che potrebbero influire sui flussi di lavoro esistenti di BigQuery Data Transfer Service.
Struttura dell'account
La nuova API di reporting di Search Ads 360 organizza gli account in una gerarchia di account amministratore, account amministratore secondario e account cliente. Per saperne di più, consulta Differenze nella gerarchia degli account e Informazioni sugli account amministratore.
Spazio ID
Le entità nel nuovo Search Ads 360 hanno una mappatura degli spazi ID diversa rispetto alle versioni precedenti di Search Ads 360. Per informazioni sulla mappatura tra gli ID precedenti e i nuovi ID, consulta la sezione Mappatura degli ID.
Reporting basato sulle risorse
Il modello dei dati dell'API Search Ads 360 del nuovo Search Ads 360 utilizza un modello dei dati basato sulle risorse, anziché l'API Search Ads 360 precedente, che utilizza un modello dei dati basato su report. Il nuovo connettore API Search Ads 360 crea tabelle BigQuery eseguendo una query sulle risorse in Search Ads 360. Per ulteriori informazioni sulla struttura delle risorse nella nuova API Search Ads 360, consulta Struttura dell'API Search Ads 360 Reporting.
Esegui la migrazione delle configurazioni di trasferimento
Non esiste un metodo automatico per convertire le configurazioni di trasferimento esistenti di Search Ads 360 alla nuova API di reporting di Search Ads 360. Devi creare un nuovo trasferimento di dati Search Ads 360 utilizzando la nuova API Search Ads 360 Reporting come origine dati.
Rivedi le informazioni di mappatura
Esamina le seguenti informazioni sulla mappatura per mappare le risorse Search Ads 360 esistenti all'API di reporting del nuovo Search Ads 360.
Mappatura dei report
I report del nuovo Search Ads 360 si basano sulle risorse e hanno una struttura diversa rispetto ai report della versione precedente di Search Ads 360. Per una mappatura completa dei report vecchi e nuovi, consulta Mappature dei report per l'API Search Ads 360 Reporting.
Nella tabella seguente sono elencate le tabelle supportate da BigQuery Data Transfer Service insieme alle risorse utilizzate per generare le tabelle.
| Vecchio report sugli annunci della rete di ricerca | Nuova risorsa Search Ads | Nuovo nome tabella BigQuery |
|---|---|---|
| adGroup | ad_group | p_sa_AdGroupStats_customer_id p_sa_AdGroup_customer_id p_sa_AdGroupDeviceStats_customer_id p_sa_AdGroupConversionActionAndDeviceStats_customer_id |
| annuncio | ad_group_ad | p_sa_AdConversionActionAndDeviceStats_customer_id p_sa_AdDeviceStats_customer_id p_sa_Ad_customer_id |
| N/D | ad_group_asset | p_sa_AdGroupAssetStats_customer_id p_sa_AdGroupConversionActionAndAssetStats_customer_id |
| N/D | ad_group_asset_set | p_sa_AdGroupAssetSet_customer_id |
| adGroupTarget | ad_group_audience_view | p_sa_AdGroupAudienceDeviceStats_customer_id p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id |
| adGroupTarget | ad_group_criterion | p_sa_DenyAdGroupCriterion_customer_id p_sa_DenyAdGroupKeyword_customer_id p_sa_AdGroupCriterion_customer_id |
| adGroupTarget | age_range_view | p_sa_AgeRangeDeviceStats_customer_id p_sa_AgeRangeConversionActionAndDeviceStats_customer_id |
| N/D | risorsa | p_sa_Asset_customer_id |
| bidStrategy | bidding_strategy | p_sa_BidStrategy_customer_id p_sa_BidStrategyStats_customer_id", |
| campagna | campagna | p_sa_CampaignConversionActionAndDeviceStats_customer_id p_sa_Campaign_customer_id p_sa_CampaignDeviceStats_customer_id p_sa_CampaignStats_customer_id |
| N/D | campaign_asset | p_sa_CampaignAssetStats_customer_id p_sa_CampaignConversionActionAndAssetStats_customer_id |
| N/D | campaign_asset_set | p_sa_CampaignAssetSet_customer_id |
| campaignTarget | campaign_audience_view | p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id p_sa_CampaignAudienceDeviceStats_customer_id |
| campaignTarget | campaign_criterion | p_sa_CampaignCriterion_customer_id p_sa_DenyCampaignKeyword_customer_id p_sa_DenyCampaignCriterion_customer_id |
| productLeadAndCrossSell | cart_data_sales_view | p_sa_CartDataSalesStats_customer_id |
| conversione | conversione | p_sa_Conversion_customer_id |
| floodlightActivity | conversion_action | p_sa_ConversionAction_customer_id |
| account | cliente | p_sa_Account_customer_id p_sa_AccountDeviceStats_customer_id p_sa_AccountConversionActionAndDeviceStats_customer_id p_sa_AccountStats_customer_id |
| N/D | customer_asset | p_sa_CustomerAssetStats_customer_id p_sa_CustomerConversionActionAndAssetStats_customer_id |
| N/D | customer_asset_set | p_sa_CustomerAssetSet_customer_id |
| adGroupTarget | gender_view | p_sa_GenderDeviceStats_customer_id p_sa_GenderConversionActionAndDeviceStats_customer_id |
| parola chiave | keyword_view | p_sa_Keyword_customer_id p_sa_KeywordDeviceStats_customer_id p_sa_KeywordStats_customer_id p_sa_KeywordConversionActionAndDeviceStats_customer_id |
| adGroupTarget | location_view | p_sa_LocationDeviceStats_customer_id p_sa_LocationConversionActionAndDeviceStats_customer_id |
| productAdvertised | shopping_performance_view | p_sa_ProductAdvertisingd_customer_id p_sa_ProductAdvertisingdConversionActionAndDeviceStats_customer_id p_sa_ProductAdvertisingdDeviceStats_customer_id |
| productGroup | product_group_view | p_sa_ProductGroupStats_customer_id p_sa_ProductGroup_customer_id |
| visita | visita | p_sa_Visit_customer_id |
| adGroupTarget | webpage_view | p_sa_WebpageDeviceStats_customer_id p_sa_WebpageConversionActionAndDeviceStats_customer_id |
Mappatura campi
BigQuery Data Transfer Service supporta un sottoinsieme di campi dei report di Search Ads 360 elencati nella trasformazione dei report di Search Ads 360.
BigQuery non supporta . nei nomi delle colonne, pertanto tutti i report trasferiti sostituiscono . con _. Ad esempio, il campo ad_group_ad.ad.text_ad.description1 in una risorsa Search Ads 360 viene trasferito in BigQuery come ad_group_ad_ad_text_ad_description1.
Mappatura ID
Le entità nel nuovo Search Ads 360, ad esempio clienti, campagne e gruppi di annunci, hanno uno spazio ID diverso rispetto alla precedente esperienza. Per saperne di più sulle tabelle di mappatura degli ID per il nuovo Search Ads 360, consulta le tabelle di mappatura degli ID.
Esempi di query migrate
I seguenti esempi mostrano l'aspetto che potrebbe avere una query BigQuery prima e dopo essere stata mappata alla nuova API di reporting di Search Ads 360.
Considera la seguente query di esempio che analizza il rendimento della campagna Search Ads degli ultimi 30 giorni utilizzando la precedente API di reporting di Search Ads 360.
SELECT c.accountId, c.campaign, C.status, SUM(cs.impr) AS Impressions, SUM(cs.clicks) AS Clicks, (SUM(cs.cost) / 1000000) AS Cost FROM `previous_dataset.Campaign_advertiser_id` c LEFT JOIN `previous_dataset.CampaignStats_advertiser_id` cs ON (c.campaignId = cs.campaignId AND cs._DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)) WHERE c._DATA_DATE = c._LATEST_DATE GROUP BY 1, 2, 3 ORDER BY Impressions DESC
Se mappata per essere compatibile con la nuova API di reporting di Search Ads 360, la stessa query viene convertita nella seguente:
SELECT c.customer_id, c.campaign_name, C.campaign_status, SUM(cs.metrics_impressions) AS Impressions, SUM(cs.metrics_clicks) AS Clicks, (SUM(cs.metrics_cost_micros) / 1000000) AS Cost FROM `new_dataset.sa_Campaign_customer_id` c LEFT JOIN `new_dataset.sa_CampaignStats_customer_id` cs ON (c.campaign_id = cs.campaign_id AND cs._DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)) WHERE c._DATA_DATE = c._LATEST_DATE GROUP BY 1, 2, 3 ORDER BY Impressions DESC
Per altri esempi di query compatibili con la nuova esperienza Search Ads 360, consulta Esempi di query.
Passaggi successivi
- Per scoprire come pianificare e gestire i job di caricamento ricorrenti da Search Ads 360, consulta Trasferimenti di Search Ads 360.
- Per scoprire come trasformare i report di Search Ads 360, consulta Trasformazione dei report di Search Ads 360.