Trasferimenti dei rapporti di Google Ad Manager

BigQuery Data Transfer Service per Google Ad Manager consente di creare e gestire automaticamente job di caricamento ricorrenti per i dati dei report di Google Ad Manager (precedentemente noto come DoubleClick for Publishers).

Report supportati

BigQuery Data Transfer Service per Google Ad Manager attualmente supporta le seguenti opzioni di generazione di report:

• File Data Transfer (Google Ad Manager DT)
• Campi Data Transfer
• Tabelle delle corrispondenze fornite da BigQuery Data Transfer Service. Questi 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 PlacementService (v201908)

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

Importazione dati dai trasferimenti di Google Ad Manager

Prima di iniziare

Prima di creare un trasferimento Google Ad Manager:

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

• Assicurati che la tua organizzazione abbia accesso ai file Data Transfer (DT di Google Ad Manager) di Google Ad Manager. Questi file vengono inviati dal team di Google Ad Manager in un bucket Cloud Storage. Per ottenere l'accesso ai file DT di Google Ad Manager, esamina i report Data Transfer di Ad Manager. Potrebbero essere addebitati costi aggiuntivi dal team di Google Ad Manager.

  Dopo aver completato questo passaggio, riceverai un bucket Cloud Storage simile al seguente:

  gdfp-12345678

  Il team di Google Cloud NON ha la possibilità di generare o concedere l'accesso a file DT di Google Ad Manager per tuo conto. Contatta l'assistenza di Google Ad Manager per accedere ai file DT di Google Ad Manager.

• Attiva l'accesso API alla tua rete Google Ad Manager.

Autorizzazioni obbligatorie

• BigQuery: assicurati che la persona che crea il trasferimento disponga delle seguenti autorizzazioni in BigQuery:

  • bigquery.transfers.update autorizzazioni per creare il trasferimento
  • Sia le autorizzazioni bigquery.datasets.get che bigquery.datasets.update per il 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 Cloud Storage. Le autorizzazioni per i file DT di Google Ad Manager vengono gestite dal team di Google Ad Manager. Oltre ai file DT di Google Ad Manager, la persona che crea il trasferimento deve essere aggiunta alla rete Google Ad Manager, con accesso in lettura a tutte le entità necessarie per creare le varie tabelle delle corrispondenze (elemento pubblicitario, ordine, unità pubblicitaria e così via). Questo è possibile facilmente aggiungendo l'utente di Ad Manager che ha autenticato il trasferimento al team Tutte le entità in Ad Manager.

Configurare un trasferimento di Google Ad Manager

La configurazione di un trasferimento di dati BigQuery per Google Ad Manager richiede:

• Bucket Cloud Storage: l'URI del bucket Cloud Storage per i file DT di Google Ad Manager, come descritto nella sezione Prima di iniziare. Il nome del bucket dovrebbe avere il seguente aspetto:

  gdfp-12345678

• Codice di rete: troverai il codice di rete Google Ad Manager nell'URL quando hai eseguito l'accesso alla tua rete. Ad esempio, nell'URL https://admanager.google.com/2032576#delivery, 2032576 è il tuo codice di rete. Per ulteriori informazioni, consulta la guida introduttiva a Google Ad Manager.

Per creare un trasferimento 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 hai problemi durante la configurazione del trasferimento, consulta Problemi di trasferimento Google Ad Manager in Risoluzione dei problemi relativi alle configurazioni di trasferimento.

Esegui query sui dati

Quando i dati vengono trasferiti in BigQuery, vengono scritti in tabelle partizionate per la fase di importazione. Per ulteriori informazioni, consulta Introduzione alle tabelle partizionate.

Se esegui query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudo-colonna _PARTITIONTIME nella query. Per ulteriori informazioni, consulta la pagina relativa all'esecuzione di query sulle tabelle partizionate.

Query di esempio di Google Ad Manager

Puoi utilizzare i seguenti esempi di query di Google Ad Manager per analizzare i 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 sui tuoi dati di Google Ad Manager con BigQuery. Per ulteriori domande su cosa puoi fare con questi report, contatta il tuo rappresentante tecnico Google Ad Manager.

In ciascuna delle seguenti query, sostituisci variabili come dataset con i tuoi valori. Ad esempio, sostituisci network_code con il tuo codice di rete Google Ad Manager.

Impressioni e utenti unici per città

La seguente query SQL di esempio analizza il numero di impressioni e di utenti unici 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 di utenti unici 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 SQL di esempio 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