Guida alla migrazione di Search Ads 360

Il connettore Search Ads 360 (in precedenza DoubleClick Search) si basa sulla nuova API Search Ads 360 Reporting. La vecchia API di reporting di Search Ads 360 non è più supportato, quindi devi eseguire la migrazione di BigQuery Data Transfer Service. compatibili con la nuova API Search Ads 360 Reporting. Questo documento mostra le modifiche del nuovo Search Ads 360 da la precedente esperienza Search Ads 360 e fornisce il mapping informazioni per eseguire la migrazione delle risorse esistenti in Search Ads 360.

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 nella gerarchia di account amministratore, account amministratore secondario e account cliente. Per ulteriori informazioni, consulta Differenze nella gerarchia dell'account e Informazioni sugli account amministratore.

Spazio ID

Le entità nel nuovo Search Ads 360 hanno uno spazio ID diverso rispetto alle versioni precedenti di Search Ads 360. Per informazioni sulla mappatura tra gli ID precedenti e i nuovi ID, consulta Mappatura degli ID.

Report basati sulle risorse

Il nuovo modello di dati dell'API Search Ads 360 utilizza un modello di dati basato su risorse, a differenza della precedente API Search Ads 360 che utilizza un modello di dati basato su report. Il nuovo connettore dell'API Search Ads 360 crea tabelle BigQuery con query 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 i trasferimenti di Search Ads 360 esistenti alla nuova API Search Ads 360 Reporting. Devi creare un nuovo trasferimento dei dati di Search Ads 360 con l'API di generazione di report del nuovo Search Ads 360 come origine dati.

Controllare le informazioni sulla mappatura

Esamina le seguenti informazioni di mappatura per mappare le risorse Search Ads 360 esistenti alla nuova API Search Ads 360 Reporting.

Mappatura dei report

I report del nuovo Search Ads 360 si basano sulle risorse e hanno un diversa da quella dei report della precedente esperienza Search Ads 360. Per una mappatura completa dei report vecchi e nuovi, consulta Mappature dei report per l'API Search Ads 360 Reporting.

La tabella seguente elenca le tabelle supportate da BigQuery Data Transfer Service, nonché le risorse su cui è stata eseguita la query per generarle.

Vecchio report sugli annunci della rete di ricerca Nuova risorsa per gli annunci della rete di ricerca Nuovo nome della 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 annuncio_gruppo_annunci p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
p_sa_Ad_customer_id
N/D asset_gruppo_annunci 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 criterio_gruppo_annunci p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
p_sa_AdGroupCriterion_customer_id
adGroupTarget age_range_view p_sa_AgeRangeDeviceStats_customer_id
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
N/D asset p_sa_Asset_customer_id
bidStrategy bidding_strategy p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
campaign 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_NegativeCampaignKeyword_customer_id
p_sa_NegativeCampaignCriterion_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_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_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 dei campi

BigQuery Data Transfer Service supporta un sottoinsieme di campi dei report di Search Ads 360 elencati in Trasformazione dei report di Search Ads 360. BigQuery non supporta . nei nomi delle colonne, pertanto sono stati tutti trasferiti i report sostituiscono . con _. Ad esempio, il campo ad_group_ad.ad.text_ad.description1 in una risorsa di Search Ads 360 è trasferito in BigQuery come ad_group_ad_ad_text_ad_description1.

Mappatura ID

Le entità nel nuovo Search Ads 360, come clienti, campagne e gruppi di annunci, hanno uno spazio ID diverso rispetto al vecchio Search Ads 360. Per ulteriori informazioni sull'ID per la nuova esperienza Search Ads 360, consulta Tabelle di mappatura degli ID.

Esempi di query migrate

I seguenti esempi mostrano l'aspetto di una query BigQuery prima e dopo la mappatura all'API di generazione di report della nuova esperienza Search Ads 360.

Prendi in considerazione la seguente query di esempio che analizza il rendimento delle campagne di annunci sulla rete di ricerca negli ultimi 30 giorni utilizzando la vecchia API di generazione di report 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 l'API di reporting del nuovo Search Ads 360, la stessa query viene convertita nel seguente modo:

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 il nuovo Search Ads 360, consulta gli esempi di query.

Passaggi successivi