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 Search Ads 360 Reporting non è più supportata, pertanto devi eseguire la migrazione dei flussi di lavoro di BigQuery Data Transfer Service in modo che siano compatibili con la nuova API Search Ads 360 Reporting. Questo documento illustra le modifiche del nuovo Search Ads 360 rispetto al precedente e fornisce informazioni sulla mappatura per eseguire la migrazione delle risorse esistenti al nuovo Search Ads 360.

Novità di Search Ads 360

La nuova API Search Ads 360 Reporting 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 ulteriori informazioni, consulta Differenze nella gerarchia dell'account e Informazioni sugli account amministratore.

Spazio di ID

Le entità nel nuovo Search Ads 360 hanno una mappatura dello spazio ID diversa 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 dei 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 dei dati basato su report. Il nuovo connettore API Search Ads 360 crea tabelle BigQuery eseguendo 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 nell'API di reporting del nuovo Search Ads 360. 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 una struttura diversa rispetto a quelli del precedente 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.

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 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 a BigQuery come ad_group_ad_ad_text_ad_description1.

Mappatura degli 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 sulle tabelle di mappatura degli ID per il nuovo 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 Query di esempio.

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.