Créer et exécuter des rapports

Ce guide vous explique comment créer et exécuter des rapports, ainsi que consulter vos résultats.

Créer un rapport

Les analystes et les super-utilisateurs peuvent créer et modifier des rapports. En savoir plus sur le contrôle des accès dans Ads Data Hub

  1. Dans Ads Data Hub, ouvrez la page Rapports.
  2. Cliquez sur + Créer un rapport. La page Créer un rapport s'ouvre.
    • Vous pouvez filtrer les modèles en effectuant une recherche, en sélectionnant des icônes de produits et en choisissant des options dans les menus déroulants.
  3. Choisissez un modèle, puis cliquez sur Utiliser le modèle ou sur SQL pour partir de zéro.
    • Prévisualisez les détails du modèle et le code SQL en cliquant sur expand_content Développer.
  4. Pour modifier le rapport, cliquez sur Modifier la requête. Utilisez l'éditeur de requête pour :
    • Personnalisez le rapport à l'aide d'un code SQL compatible avec BigQuery.
    • Configurez les paramètres dans l'onglet Propriétés.
    • Affichez la liste des tables et des champs disponibles dans l'onglet Tables Google.
    • Affichez la liste des tables propriétaires importées et leurs schémas dans l'onglet "Table propriétaire".
    • Exécutez la requête SQL en cliquant sur Exécuter. Notez que les exécutions lancées depuis l'éditeur de requêtes SQL ne sont pas incluses dans l'historique d'exécution d'un rapport et ne figurent pas dans la section Activité récente de la page Accueil.
    • Cliquez sur OK pour confirmer les modifications apportées à la requête et revenir à la page de configuration du rapport.
  5. Attribuez un nom à votre rapport.
  6. Le cas échéant, définissez les valeurs des paramètres dans la fiche de configuration.
  7. Configurez l'entrée et la sortie des tâches exécutées sur ce rapport :
    • Sélectionnez une source de données dans le champ Origine des données d'annonces. Il doit s'agir de l'ID de compte Ads Data Hub associé aux données d'annonces que vous souhaitez interroger. (Si vous souhaitez interroger des données de bac à sable, sélectionnez "Compte client "sandbox" ADH".)
    • Si vous utilisez une table des correspondances, sélectionnez-la dans le champ Compte de la table des correspondances.
    • Sélectionnez une plage de dates et un fuseau horaire pour le rapport. Le fuseau horaire du rapport doit correspondre à celui du compte publicitaire associé, par exemple un compte Google Ads. Remarque: La plage de dates personnalisée pour le test des requêtes n'est prise en charge que lorsque vous exécutez la requête depuis l'écran de l'éditeur SQL.
    • Facultatif: modifiez vos paramètres de confidentialité et configurez le récapitulatif des lignes filtrées.
    • Choisissez le projet, l'ensemble de données et la table BigQuery dans lesquels enregistrer les résultats de votre rapport.
  8. (Facultatif) Planifiez l'exécution de votre rapport.
  9. Cliquez sur Enregistrer.

Paramètres

Les paramètres vous permettent de spécifier comment un rapport donné doit être exécuté. Lorsque vous utilisez SQL pour créer un rapport (ou lorsque vous modifiez le code SQL à partir d'un modèle de rapport), les paramètres vous permettent de réutiliser le même code SQL dans plusieurs rapports et de définir des valeurs de paramètre différentes pour chaque copie du rapport. Par exemple, vous pouvez exécuter deux rapports qui partagent la même requête ou le même modèle SQL sur différents ensembles d'ID de campagne en configurant un paramètre et en définissant sa valeur dans la section "Configuration" de la page d'informations du rapport. Utiliser des paramètres vous permet de garder un code SQL propre, de réduire le risque d'erreurs lorsque vous y apportez des changements et de réutiliser la même requête SQL dans les rapports sans avoir à modifier les valeurs dans le code SQL lui-même.

Dans l'exemple suivant, le rapport contient un paramètre appelé campaign_ids, qui accepte un array d'ID de campagne int64:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

Types de paramètre

Les types de paramètres suivants sont autorisés :

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array (tous les types autorisés)

Ajouter un paramètre à un rapport

  1. Ouvrez un rapport enregistré ou créez-en un.
  2. Cliquez sur Modifier la requête.
  3. Sous Propriétés, cliquez sur Ajouter un paramètre.
  4. Saisissez un nom dans le champ Nom. Il vous servira à référencer le paramètre dans le texte du rapport.
  5. Utilisez le menu déroulant pour sélectionner le type de paramètre.
    • Si vous choisissez le type de tableau, un menu déroulant supplémentaire s'affiche. Sélectionnez le type de tableau dans ce menu déroulant.
  6. Dans la requête SQL, ajoutez le paramètre à l'aide du format de paramètre SQL standard : @PARAMETER_NAME. Consultez l'exemple qui suit ces étapes.
  7. Cliquez sur OK, puis sur Enregistrer.

Utiliser un paramètre

  1. Ouvrez un rapport pour lequel des paramètres sont configurés.
  2. Dans le volet Configuration, saisissez les valeurs pour chaque paramètre que vous avez défini.
  3. Cliquez sur Enregistrer pour conserver les valeurs des paramètres.

Supprimer un paramètre

  1. Ouvrez un rapport pour lequel des paramètres sont configurés.
  2. Cliquez sur Modifier la requête pour ouvrir l'éditeur SQL.
  3. Sous Properties (Propriétés), cliquez sur Delete (Supprimer) à côté du paramètre que vous souhaitez supprimer.
  4. Cliquez sur OK, puis sur Enregistrer.

Paramètres réservés

La table suivante liste les paramètres réservés par Ads Data Hub. Vous pouvez les utiliser dans vos rapports, mais vous ne pouvez pas créer de paramètre ayant le même nom qu'un paramètre réservé.

start_date date

Date de début (incluse) de la tâche de rapport. Un paramètre défini par l'utilisateur et portant ce nom sera ignoré, et remplacé par les valeurs spécifiées dans la boîte de dialogue Nouvelle tâche.
end_date date

Date de fin (incluse) de la tâche de rapport. Un paramètre défini par l'utilisateur et portant ce nom sera ignoré, et remplacé par les valeurs spécifiées dans la boîte de dialogue Nouvelle tâche.
time_zone string

Fuseau horaire de la tâche de rapport. Un paramètre défini par l'utilisateur et portant ce nom sera ignoré, et remplacé par les valeurs spécifiées dans la boîte de dialogue Nouvelle tâche.

Récapitulatif des lignes filtrées

Les récapitulatifs des lignes filtrées regroupent les données filtrées suite à des vérifications de différence. Les données des lignes filtrées sont additionnées et ajoutées à une ligne collectrice. Bien que les données filtrées ne puissent pas être analysées plus en détail, elles fournissent un récapitulatif du volume de données exclu des résultats. Pour les requêtes qui utilisent le mode de confidentialité des vérifications des différences, Ads Data Hub active et configure automatiquement un récapitulatif des lignes filtrées. Lorsque vous modifiez la requête, Ads Data Hub ajuste automatiquement la configuration en fonction des colonnes sélectionnées. Pour en savoir plus sur les récapitulatifs des lignes filtrées ou pour en configurer un manuellement, consultez Récapitulatif des lignes filtrées.

Modifier un rapport

  1. Dans Ads Data Hub, ouvrez la page Rapports.
  2. Cliquez sur le nom du rapport que vous souhaitez modifier.
  3. Modifiez le rapport. Par exemple, modifiez le code SQL, gérez les valeurs de paramètre ou définissez un calendrier.
  4. Cliquez sur Enregistrer.

Générer un rapport

Avant d'exécuter un rapport, assurez-vous d'avoir accordé au compte de service l'autorisation dataEditor sur l'ensemble de données qui contiendra le résultat de vos jointures. En savoir plus sur le contrôle des accès dans BigQuery

  1. Dans Ads Data Hub, ouvrez la page Rapports.
  2. Cliquez sur le nom du rapport à exécuter.
  3. Cliquez sur Exécuter.

Exécuter un rapport selon un calendrier

  1. Dans Ads Data Hub, ouvrez la page Rapports.
  2. Cliquez sur le nom du rapport pour lequel vous souhaitez définir une planification.
    • Pour définir une planification pour un nouveau rapport, créez-le, puis cliquez sur Enregistrer.
  3. Cliquez sur + Définir un planning.
  4. Dans le volet Planifier, activez l'option Planifier l'exécution de ce rapport avec les informations ci-dessous.
  5. Sous Fréquence, sélectionnez un intervalle et une heure de la journée, puis saisissez un fuseau horaire.
    • Pour utiliser une expression Cron à la place, activez l'option Définir un calendrier à l'aide d'une expression Cron, puis saisissez l'expression dans le champ.
  6. Cliquez sur OK.
  7. Cliquez sur Enregistrer pour appliquer les modifications au rapport.

Pour afficher les tâches planifiées sur la page Accueil, sélectionnez Tout le monde dans la liste des filtres Propriétaire.

Afficher les résultats

Une fois votre rapport exécuté, vous pouvez prévisualiser les résultats sur la page d'informations du rapport. Pour consulter les résultats ultérieurement, ouvrez le rapport depuis la page Accueil. Vous pouvez également parcourir les données dans BigQuery, Sheets ou Data Studio.

Aperçu

Cliquez sur Aperçu dans la tâche terminée. Les 20 premiers résultats s'affichent sous la tâche.

BigQuery

Vos résultats sont exportés vers BigQuery par défaut. Cliquez sur Afficher la table pour ouvrir BigQuery dans une nouvelle fenêtre.

Sheets et Data Studio

Ouvrez le menu déroulant Explorer, puis sélectionnez Explorer avec Sheets ou Explorer avec Data Studio dans les options. Les données s'affichent dans une nouvelle fenêtre.