Transferts Google Ads

Le service de transfert de données BigQuery pour Google Ads (anciennement connu sous le nom de Google AdWords) vous permet de programmer et de gérer automatiquement les tâches de chargement récurrentes pour les données de rapports Google Ads.

Rapports acceptés

Le service de transfert de données BigQuery pour Google Ads accepte actuellement les options de création de rapports ci-dessous.

Pour en savoir plus sur la transformation des rapports Google Ads en tables et vues BigQuery, consultez la page Transformer des rapports Google Ads.

Pour mapper les rapports Google Ads sur le contenu de l'UI de Google Ads, consultez la page Mapper les rapports sur l'UI de Google Ads.

Option de création de rapports Compatibilité
Version d'API compatible

v201809

Pour en savoir plus sur la migration de l'API Google Ads (API AdWords), consultez le guide de migration (v201809).

Programmation

Quotidienne, au moment de la création du transfert (par défaut)

Vous pouvez configurer une heure spécifique.

Fenêtre d'actualisation

7 derniers jours (par défaut)

Configurable jusqu'à 30 jours

Les instantanés des tables de correspondance sont réalisés une fois par jour, puis stockés dans la partition pour la dernière date d'exécution. Ils NE sont PAS mis à jour pour les remplissages ni pour les jours chargés via l'intervalle d'actualisation. Pour en savoir plus sur les tables de correspondance qui ne sont pas mises à jour par l'intervalle d'actualisation, consultez la section Configurer un remplissage.

Durée maximale du remplissage

Aucune limite

Même si aucune restriction connue n'est appliquée à la conservation des données dans Google Ads, le service de transfert de données BigQuery limite le nombre de jours couverts par chaque requête de remplissage. Pour en savoir plus sur les remplissages, consultez la page Configurer un remplissage.

Nombre de numéros client par compte administrateur

1 000

Le service de transfert de données BigQuery accepte jusqu'à 1 000 numéros client par compte administrateur Google Ads (CM).

Avant de commencer

Avant de créer un transfert Google Ads, procédez comme suit :

  • Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
  • Créez un ensemble de données BigQuery où stocker les données Google Ads.
  • Si vous envisagez de créer des transferts à l'aide de l'UI Web classique de BigQuery, autorisez les pop-ups de bigquery.cloud.google.com pour pouvoir afficher la fenêtre des autorisations. Pour que le transfert aboutisse, vous devez autoriser le service de transfert de données BigQuery à gérer vos campagnes Google Ads.
  • Les notifications d'exécution de transfert sont actuellement en version alpha. Si vous souhaitez configurer des notifications d'exécution de transfert pour Cloud Pub/Sub, vous devez disposer des autorisations pubsub.topics.setIamPolicy. Si vous ne configurez que des notifications par e-mail, les autorisations Cloud Pub/Sub ne sont pas requises. Pour en savoir plus, consultez la page Notifications d'exécution du service de transfert de données BigQuery.

Autorisations requises

Assurez-vous que la personne qui crée le transfert dispose des autorisations requises suivantes :

  • BigQuery :

    • autorisations bigquery.transfers.update permettant de créer le transfert et autorisations bigquery.datasets.update sur l'ensemble de données cible.

    Le rôle IAM prédéfini bigquery.admin au niveau du projet comprend les autorisations bigquery.transfers.update et bigquery.transfers.update. Pour en savoir plus sur les rôles IAM dans BigQuery, consultez la page Contrôle des accès.

  • Google Ads : accès en lecture au numéro client Google Ads ou au compte administrateur (CM) utilisé dans la configuration de transfert.

Configurer un transfert de données Google Ads

Pour configurer un transfert de données pour Google Ads, vous devez disposer des éléments suivants :

  • Numéro client : votre numéro client Google Ads ou votre compte administrateur (CM) tel qu'il vous a été fourni par Google Ads. Pour en savoir plus sur la récupération de votre numéro client Google Ads, consultez la page Localiser votre numéro client.

Pour créer un transfert de données pour les rapports Google Ads, procédez comme suit :

Console

  1. Accédez à l'interface utilisateur Web de BigQuery.

    Accéder à l'interface utilisateur Web de BigQuery

  2. Cliquez sur Transferts.

  3. Cliquez sur + CRÉER.

  4. Sur la page Créer un transfert :

    • Dans la section Source type (Type de source), choisissez Cloud Storage comme Source.

      Source de transfert

    • Dans la section Transfer config name (Nom de la configuration du transfert), sous Display name (Nom à afficher), entrez un nom pour le transfert, tel que My Transfer. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.

      Nom du transfert

    • Dans la section Schedule options (Options de programmation), pour le champ Schedule (Programmation), laissez la valeur par défaut : Start now (Commencer), ou cliquez sur Start at a set time (Démarrer à l'heure définie).

      • Pour le champ Repeats (Périodicité), choisissez une option pour la fréquence d'exécution du transfert.

        • Daily (Tous les jours) (par défaut)
        • Weekly (Toutes les semaines)
        • Monthly (Tous les mois)
        • Custom (Personnalisée)
        • On-demand (À la demande)
      • Pour Start date and run time (Date de début et heure d'exécution), entrez la date et l'heure de début du transfert. Cette option est désactivée si vous choisissez Start now (Commencer).

        Planning de transfert

    • Dans la section Destination settings (Paramètres de destination), pour le champ Destination dataset (Ensemble de données de destination), choisissez l'ensemble de données que vous avez créé pour stocker vos données.

      Transférer un ensemble de données

    • Dans la section Data source details (Détails de la source de données) :

      • Pour Customer ID (Numéro client), saisissez votre numéro client ou votre compte administrateur.
      • Cochez Exclude removed/disabled Items (Exclure les éléments supprimés/désactivés) pour empêcher le transfert des entités et des métriques supprimées ou désactivées.

        Informations sur la source Google Ads

    • (Facultatif) Dans la section Options de notification :

      • Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail en cas d'échec de l'exécution du transfert.
      • Pour le champ Sélectionner un sujet Cloud Pub/Sub, choisissez votre nom de sujet ou cliquez sur Créer un sujet. Cette option configure les notifications d'exécution Cloud Pub/Sub pour votre transfert. Les notifications d'exécution de transfert sont actuellement en version alpha.
  5. Cliquez sur Enregistrer.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.

    Accéder à l'UI Web de BigQuery

  2. Cliquez sur Transferts.

  3. Cliquez sur Ajouter un transfert.

  4. Sur la page Nouveau transfert :

    • Pour Source, sélectionnez Google Ads (anciennement AdWords).
    • Pour Nom à afficher, saisissez le nom du transfert, par exemple My Transfer. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.
    • Pour Intervalle d'actualisation, saisissez le nombre de jours à inclure dans le transfert de données. Si vous saisissez "1", aucun remplissage quotidien ne sera effectué. Si vous indiquez "0", l'intervalle d'actualisation est défini par défaut sur "7 jours". La valeur maximale est 30. Pour en savoir plus, consultez la page Déterminer l'actualisation de vos données.
    • Pour Schedule (Programmation), laissez la valeur par défaut (toutes les 24 heures, à l'heure de création du transfert) ou cliquez sur Modifier pour changer le délai.

      Programmation Google Ads

    • Pour Destination dataset (Ensemble de données de destination), sélectionnez l'ensemble de données que vous avez créé pour stocker vos données Google Ads.

    • Pour Customer ID (Numéro client), saisissez votre numéro client ou votre compte administrateur.

    • Cochez Exclude removed/disabled Items (Exclure les éléments supprimés/désactivés) pour empêcher le transfert des entités et des métriques supprimées ou désactivées.

      Transfert Google Ads

    • (Facultatif) Développez la section Advanced (Avancé), puis configurez les notifications d'exécution pour votre transfert. Les notifications d'exécution de transfert sont actuellement en version alpha.

      • Pour le paramètre Cloud Pub/Sub topic (Sujet Cloud Pub/Sub), saisissez le nom de votre sujet (par exemple, projects/myproject/topics/mytopic).
      • Cochez la case Send email notifications (Envoyer des notifications par e-mail) pour autoriser les notifications par e-mail en cas d'échec de l'exécution des transferts.
      • Ne cochez pas la case Disabled (Désactivé) lorsque vous configurez un transfert. Pour désactiver les transferts existants, consultez la page Utiliser les transferts.

        Sujet Cloud Pub/Sub

  5. Cliquez sur Ajouter.

  6. Lorsque vous y êtes invité, cliquez sur Autoriser pour autoriser le service de transfert de données BigQuery à gérer vos données de rapports Google Ads, ainsi qu'à accéder aux données dans BigQuery et à les gérer. Vous devez autoriser les fenêtres pop-up de bigquery.cloud.google.com pour afficher la fenêtre des autorisations.

    Autoriser le transfert

Ligne de commande

Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config. Les paramètres suivants sont également requis :

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Vous pouvez également ajouter le paramètre --project_id pour spécifier un projet particulier. Si --project_id n'est pas indiqué, le projet par défaut est utilisé.

    bq mk --transfer_config --project_id=[PROJECT_ID] --target_dataset=[DATASET] --display_name=[NAME] --params='[PARAMETERS]' --data_source=[DATA_SOURCE]

où :

  • --project_id est l'ID du projet.
  • --target_dataset est l'ensemble de données cible pour la configuration de transfert.
  • --display_name est le nom à afficher pour la configuration de transfert. Ce nom peut correspondre à toute valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.
  • --params contient les paramètres de la configuration de transfert créée au format JSON. Par exemple : --params='{"param":"param_value"}'. Pour Google Ads, vous devez fournir le paramètre customer_id. Vous pouvez éventuellement définir le paramètre exclude_removed_items sur true pour empêcher le transfert d'entités et de métriques supprimées ou désactivées.
  • --data_source est la source de données (adwords).

Par exemple, la commande suivante crée un transfert Google Ads nommé My Transfer à l'aide du numéro client 123-123-1234 et de l'ensemble de données cible mydataset. Le transfert est créé dans le projet par défaut :

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' --data_source=adwords

La première fois que vous exécutez la commande, vous recevez un message de ce type :

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Suivez les instructions du message et collez le code d'authentification sur la ligne de commande.

API

Exécutez la méthode projects.locations.transferConfigs.create, puis indiquez une instance de la ressource TransferConfig.

Compatibilité des comptes administrateur Google Ads

Les clients existants qui disposent de plusieurs transferts Google Ads propres à un numéro client sont invités à configurer un transfert Google Ads unique au niveau du compte administrateur (CM), à programmer un remplissage et à désactiver les transferts Google Ads individuels qui sont propres au numéro client.

L'utilisation des comptes administrateur Google Ads présente plusieurs avantages par rapport à l'utilisation de numéros client individuels :

  • Vous n'avez plus besoin de gérer de multiples transferts pour générer des rapports relatifs à différents numéros client.
  • Les requêtes multiclients sont beaucoup plus simples à écrire, car tous les numéros client sont stockés dans la même table.
  • L'utilisation des CM permet de résoudre les problèmes liés aux quotas de chargement BigQuery, car plusieurs numéros client sont chargés dans la même tâche.

Pour en savoir plus sur les comptes administrateur Google Ads (CM), consultez les pages Utiliser les comptes gérés et Associer des comptes à votre compte administrateur.

Exemple

La liste suivante répertorie les numéros client associés à certains comptes administrateur Google Ads :

  • 1234567890 : compte administrateur racine
    • 1234 : sous-compte administrateur
      • 1111 : numéro client
      • 2222 : numéro client
      • 3333 : numéro client
      • 4444 : numéro client
      • 567 : sous-compte administrateur
        • 5555 : numéro client
        • 6666 : numéro client
        • 7777 : numéro client
    • 89 : sous-compte administrateur
      • 8888 : numéro client
      • 9999 : numéro client
    • 0000 : numéro client

Chaque numéro client associé à un compte administrateur apparaît dans chacun des rapports. Pour en savoir plus sur la structure des rapports Google Ads dans BigQuery, consultez la page Transformer des rapports Google Ads.

Configurer un transfert pour le numéro client 1234567890

Configurer un transfert pour le compte administrateur racine (numéro client 1234567890) générerait des exécutions de transfert comprenant les numéros client suivants :

  • 1111 (via le sous-compte administrateur 1234)
  • 2222 (via le sous-compte administrateur 1234)
  • 3333 (via le sous-compte administrateur 1234)
  • 4444 (via le sous-compte administrateur 1234)
  • 5555 (via les sous-comptes administrateur 567 et 1234)
  • 6666 (via les sous-comptes administrateur 567 et 1234)
  • 7777 (via les sous-comptes administrateur 567 et 1234)
  • 8888 (via le sous-compte administrateur 89)
  • 9999 (via le sous-compte administrateur 89)
  • 0000 (numéro client individuel)

Configurer un transfert pour le numéro client 1234

Configurer un transfert pour le sous-compte administrateur 123 (numéro client 1234) générerait des exécutions de transfert comprenant les numéros client suivants :

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (via le sous-compte administrateur 567)
  • 6666 (via le sous-compte administrateur 567)
  • 7777 (via le sous-compte administrateur 567)

Configurer un transfert pour le numéro client 567

Configurer un transfert pour le sous-compte administrateur 567 (numéro client 567) générerait des exécutions de transfert comprenant les numéros client suivants :

  • 5555
  • 6666
  • 7777

Configurer un transfert pour le numéro client 89

Configurer un transfert pour le sous-compte administrateur 89 (numéro client 89) générerait des exécutions de transfert comprenant les numéros client suivants :

  • 8888
  • 9999

Configurer un transfert pour le numéro client 0000

Configurer un transfert pour le numéro client 0000 générerait des exécutions de transfert comprenant les numéros client suivants :

  • 0000

Migrer les données Google Ads vers les CM

Pour migrer vos données Google Ads existantes dans BigQuery vers la structure CM, vous pouvez configurer un remplissage afin d'ajouter vos données existantes aux tables créées par la configuration de transfert associée au compte administrateur. Veuillez noter que lorsque vous programmez un remplissage, les tables de correspondance ne sont pas mises à jour.

Résoudre les problèmes de configuration de transfert Google Ads

Si vous rencontrez des problèmes lors de la configuration de votre transfert, consultez la section Problèmes de transfert sur Google Ads de la page Dépannage des configurations de transferts dans le service de transfert de données BigQuery.

Interroger les données

Lorsque les données sont transférées vers BigQuery, elles sont écrites dans des tables partitionnées avec date d'ingestion. Pour en savoir plus, consultez la page Présentation des tables partitionnées.

Si vous interrogez directement les tables au lieu d'utiliser les vues générées automatiquement, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la page Interroger des tables partitionnées.

Vous pouvez analyser les données que vous avez transférées à l'aide des exemples de requêtes Google Ads suivants. Vous avez également la possibilité d'utiliser les requêtes dans un outil de visualisation tel que Cloud Datalab ou Google Data Studio. Ces requêtes sont fournies pour vous guider dans l'interrogation des données Google Ads avec BigQuery. Si vous avez d'autres questions sur ce que vous pouvez faire avec ces rapports, contactez votre représentant technique Google Ads.

Dans chacune des requêtes suivantes, remplacez [DATASET] par le nom de votre ensemble de données. Remplacez [CUSTOMER_ID] par votre numéro client Google Ads.

Ces exemples utilisent le langage SQL standard compatible avec BigQuery. À l'aide du tag #standardSQL, indiquez à BigQuery que vous souhaitez utiliser le langage SQL standard. Pour en savoir plus sur le préfixe #standardSQL, consultez la section Définir un préfixe de requête.

Si vous interrogez directement les tables au lieu de vous servir des vues générées automatiquement, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la page Interroger des tables partitionnées.

Performances des campagnes

L'exemple de requête ci-dessous permet d'analyser les performances des campagnes Google Ads au cours des 30 derniers jours.

Console

#standardSQL
SELECT
  c.ExternalCustomerId,
  c.CampaignName,
  c.CampaignStatus,
  SUM(cs.Impressions) AS Impressions,
  SUM(cs.Interactions) AS Interactions,
  (SUM(cs.Cost) / 1000000) AS Cost
FROM
  `[DATASET].Campaign_[CUSTOMER_ID]` c
LEFT JOIN
  `[DATASET].CampaignBasicStats_[CUSTOMER_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

Ligne de commande

bq query --use_legacy_sql=false '
SELECT
  c.ExternalCustomerId,
  c.CampaignName,
  c.CampaignStatus,
  SUM(cs.Impressions) AS Impressions,
  SUM(cs.Interactions) AS Interactions,
  (SUM(cs.Cost) / 1000000) AS Cost
FROM
  `[DATASET].Campaign_[CUSTOMER_ID]` c
LEFT JOIN
  `[DATASET].CampaignBasicStats_[CUSTOMER_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'

Nombre de mots clés

L'exemple de requête suivant analyse les mots clés par campagne, par groupe d'annonces et par état de mots clé. Cette requête utilise la fonction KeywordMatchType. Grâce aux différents types de correspondance des mots clés, vous pouvez mieux contrôler quelles recherches déclencheront la diffusion de votre annonce. Pour en savoir plus sur les options de ciblage par mots-clés, consultez la page À propos des options de correspondance des mots-clés.

Console

#standardSQL
SELECT
  c.CampaignStatus AS CampaignStatus,
  a.AdGroupStatus AS AdGroupStatus,
  k.Status AS KeywordStatus,
  k.KeywordMatchType AS KeywordMatchType,
  COUNT(*) AS count
FROM
  `[DATASET].Keyword_[CUSTOMER_ID]` k
  JOIN
  `[DATASET].Campaign_[CUSTOMER_ID]` c
ON
  (k.CampaignId = c.CampaignId AND k.DATA_DATE = c._DATA_DATE)
JOIN
  `[DATASET].AdGroup[CUSTOMER_ID]` a
ON
  (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
WHERE
  k._DATA_DATE = k._LATEST_DATE
GROUP BY
  1, 2, 3, 4

Ligne de commande

bq query --use_legacy_sql=false '
SELECT
  c.CampaignStatus AS CampaignStatus,
  a.AdGroupStatus AS AdGroupStatus,
  k.Status AS KeywordStatus,
  k.KeywordMatchType AS KeywordMatchType,
  COUNT(*) AS count
FROM
  `[DATASET].Keyword_[CUSTOMER_ID]` k
JOIN
  `[DATASET].Campaign_[CUSTOMER_ID]` c
ON
  (k.CampaignId = c.CampaignId AND k._DATA_DATE = c._DATA_DATE)
JOIN
  `[DATASET].AdGroup_[CUSTOMER_ID]` a
ON
  (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
WHERE
  k._DATA_DATE = k._LATEST_DATE
GROUP BY
  1, 2, 3, 4'
Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.