Trasferimenti dei rapporti di Google Ad Manager

Il connettore BigQuery Data Transfer Service per Google Ad Manager consente di creare e gestire automaticamente i job di caricamento ricorrenti per i dati dei report di Google Ad Manager (in precedenza DoubleClick for Publishers).

Report supportati

Il connettore BigQuery Data Transfer Service per Google Ad Manager supporta le seguenti funzionalità: opzioni dei report:

• File Data Transfer (Google Ad Manager DT)
• Campi di Data Transfer
• Tabelle delle corrispondenze fornite da BigQuery Data Transfer Service. Vengono creati e aggiornati automaticamente.
• Tabelle delle corrispondenze recuperate con PQL
• Tabelle delle corrispondenze di CompanyService (v201908)
• Tabelle delle corrispondenze di OrderService (v201908)
• Tabelle delle corrispondenze di PositionService (v201908)

Per informazioni su come i report di Google Ad Manager vengono trasformati per le tabelle e le viste BigQuery, consulta Trasformazioni dei report di Google Ad Manager.

Importazione dei dati dai trasferimenti di Google Ad Manager

Aggiornare le finestre

Una finestra di aggiornamento indica il numero di giorni in cui un trasferimento di dati recupera i dati. quando avviene un trasferimento di dati. Ad esempio, se la finestra di aggiornamento è di tre giorni e un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati da nella tabella di origine degli ultimi tre giorni. In questo esempio, quando si verifica un trasferimento giornaliero, BigQuery Data Transfer Service crea una nuova partizione della tabella di destinazione BigQuery con una copia dei dati della tabella di origine del giorno corrente, quindi attiva automaticamente le esecuzioni di backfill per aggiornare le partizioni della tabella di destinazione BigQuery con i dati della tabella di origine degli ultimi due giorni. Le esecuzioni di backfill attivate automaticamente sovrascriveranno o aggiornare in modo incrementale la tabella di destinazione BigQuery a seconda che gli aggiornamenti incrementali siano supportati o meno Connettore BigQuery Data Transfer Service.

Quando esegui un trasferimento di dati per la prima nel tempo, il trasferimento dei dati recupera tutti i dati di origine disponibili finestra. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Le finestre di aggiornamento sono mappate al campo dell'API TransferConfig.data_refresh_window_days.

Per recuperare dati al di fuori della finestra di aggiornamento, ad esempio dati storici, o per i dati da eventuali interruzioni o lacune dei trasferimenti, puoi avviare o pianificare esecuzione di backfill.

Prima di iniziare

Prima di creare un trasferimento di dati Google Ad Manager:

• Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati di Google Ad Manager.

• Assicurarsi che l'organizzazione abbia accesso ai dati di Google Ad Manager Trasferisci i file (DT di Google Ad Manager). Questi file vengono pubblicati a un bucket Cloud Storage. Per ottenere l'accesso a File DT di Google Ad Manager, revisione Report Data Transfer di Ad Manager. Potrebbero essere applicati costi aggiuntivi da parte del team di Google Ad Manager.

  Dopo aver completato questo passaggio, riceverai simile al seguente:

      gdfp-12345678
    

  Il team di Google Cloud NON ha di generare o concedere l'accesso ai file DT di Google Ad Manager sul tuo per conto tuo. Contatto, Google Ad Manager assistenza, per accedere ai file DT di Google Ad Manager.

• Attivare l'accesso API alla tua rete Google Ad Manager.
• Se intendi configurare notifiche relative al trasferimento di dati, devi avere Autorizzazioni pubsub.topics.setIamPolicy per Pub/Sub. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche email. Per ulteriori informazioni, vedi Notifiche di esecuzione di BigQuery Data Transfer Service.

Autorizzazioni obbligatorie

• BigQuery: assicurati che la persona che crea il trasferimento di dati abbia le seguenti autorizzazioni in BigQuery:

  • bigquery.transfers.update autorizzazioni per creare il trasferimento di dati
  • Entrambe le autorizzazioni bigquery.datasets.get e bigquery.datasets.update sul set di dati di destinazione

  Il ruolo IAM predefinito bigquery.admin include le autorizzazioni bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.

• Google Ad Manager: accesso in lettura ai file DT di Google Ad Manager archiviati in di archiviazione ideale in Cloud Storage. Le autorizzazioni per i file DT di Google Ad Manager sono gestite dal team di Google Ad Manager. Oltre ai file DT di Google Ad Manager, la persona che crea il trasferimento dei dati deve essere aggiunta alla rete Google Ad Manager con accesso in lettura a tutte le entità necessarie per creare le varie tabelle di corrispondenza (elemento pubblicitario, ordine, unità pubblicitaria e così via). A questo scopo, puoi aggiungere L'utente di Ad Manager che ha autenticato il trasferimento di dati al team Tutte le entità. in Ad Manager.

Configurare un trasferimento da Google Ad Manager

L'impostazione di un trasferimento di dati BigQuery per Google Ad Manager richiede A:

• Bucket Cloud Storage: l'URI del bucket Cloud Storage dell'annuncio Google. Gestisce i file DT come descritto in Prima di iniziare. Il nome del bucket dovrebbe essere simile al seguente:

  gdfp-12345678

• Codice di rete: il codice di rete Google Ad Manager si trova nell'URL quando hai eseguito l'accesso alla tua rete. Ad esempio, nell'URLhttps://admanager.google.com/2032576#delivery, 2032576 è il codice della rete. Per ulteriori informazioni, vedi Inizia a utilizzare Google Ad Manager.

Per creare un trasferimento di dati di BigQuery Data Transfer Service per Google Ad Manager:

bq mk --transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source \
--service_account_name=service_account_name

bq mk --transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"bucket": "gdfp-12345678","network_code": "12345678"}' \
--data_source=dfp_dt

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create a ad manager(formerly DFP) transfer config
public class CreateAdManagerTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    String bucket = "gs://cloud-sample-data";
    // the network_code can only be digits with length 1 to 15
    String networkCode = "12345678";
    Map<String, Value> params = new HashMap<>();
    params.put("bucket", Value.newBuilder().setStringValue(bucket).build());
    params.put("network_code", Value.newBuilder().setStringValue(networkCode).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Ad Manager Config Name")
            .setDataSourceId("dfp_dt")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createAdManagerTransfer(projectId, transferConfig);
  }

  public static void createAdManagerTransfer(String projectId, TransferConfig transferConfig)
      throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println("Ad manager transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Ad manager transfer was not created." + ex.toString());
    }
  }
}

Risolvere i problemi di configurazione del trasferimento di Google Ad Manager

Se riscontri problemi durante la configurazione del trasferimento di dati, vedi Problemi di trasferimento da Google Ad Manager in Risoluzione dei problemi relativi alle configurazioni di trasferimento.

Eseguire query sui dati

Quando vengono trasferiti in BigQuery, i dati vengono vengono scritte in tabelle partizionate in fase di importazione. Per ulteriori informazioni, vedi Introduzione alle tabelle partizionate.

Se esegui una query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, deve utilizzare la pseudocolonna _PARTITIONTIME nella query. Per ulteriori informazioni, consulta Esecuzione di query su tabelle partizionate.

Esempi di query di Google Ad Manager

Puoi utilizzare le query di esempio di Google Ad Manager riportate di seguito per analizzare dati trasferiti. Puoi anche utilizzare le query in uno strumento di visualizzazione come Looker Studio. Queste query vengono fornite per aiutarti a iniziare a eseguire query sul tuo annuncio Google Gestisce i dati con BigQuery. Per ulteriori domande su che cosa puoi fare con questi rapporti, contatta il tuo team come rappresentante tecnico.

In ciascuna delle seguenti query, sostituisci le variabili come dataset con i tuoi valori. Ad esempio, sostituisci network_code con il tuo annuncio Google Codice di rete del gestore.

Impressioni e utenti unici per città

La seguente query SQL di esempio analizza il numero di impressioni e dati utenti per città negli ultimi 30 giorni.

# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY)
# END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)
SELECT
  City,
  _DATA_DATE AS Date,
  count(*) AS imps,
  count(distinct UserId) AS uniq_users
FROM `dataset.NetworkImpressionsnetwork_code`
WHERE
  _DATA_DATE BETWEEN start_date AND end_date
GROUP BY City, Date

Impressioni e utenti unici per tipo di elemento pubblicitario

La seguente query SQL di esempio analizza il numero di impressioni e dati utenti per tipo di elemento pubblicitario negli ultimi 30 giorni.

# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY)
# END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)
SELECT
  MT.LineItemType AS LineItemType,
  DT._DATA_DATE AS Date,
  count(*) AS imps,
  count(distinct UserId) AS uniq_users
FROM `dataset.NetworkImpressionsnetwork_code` AS DT
LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT
ON
  DT.LineItemId = MT.Id
WHERE
  DT._DATA_DATE BETWEEN start_date AND end_date
GROUP BY LineItemType, Date
ORDER BY Date desc, imps desc

Impressioni per unità pubblicitaria

La seguente query SQL di esempio analizza il numero di impressioni per unità pubblicitaria negli ultimi 30 giorni.

# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY)
# END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)
SELECT
  MT.AdUnitCode AS AdUnitCode,
  DT.DATA_DATE AS Date,
  count(*) AS imps
FROM `dataset.NetworkImpressionsnetwork_code` AS DT
LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT
ON
  DT.AdUnitId = MT.Id
WHERE
  DT._DATA_DATE BETWEEN start_date AND end_date
GROUP BY AdUnitCode, Date
ORDER BY Date desc, imps desc

Impressioni per elemento pubblicitario

La seguente query di esempio SQL analizza il numero di impressioni per elemento pubblicitario negli ultimi 30 giorni.

# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY)
# END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)
SELECT
  MT.Name AS LineItemName,
  DT._DATA_DATE AS Date,
  count(*) AS imps
FROM `dataset.NetworkImpressionsnetwork_code` AS DT
LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT
ON
  DT.LineItemId = MT.Id
WHERE
  DT._DATA_DATE BETWEEN start_date AND end_date
GROUP BY LineItemName, Date
ORDER BY Date desc, imps desc