Écrire et exécuter des rapports

Créer un rapport

Accédez à l'onglet Requêtes d'Ads Data Hub.
Cliquez sur + Créer une requête. La page Créer un rapport s'ouvre.
(Facultatif) Filtrez les modèles en faisant une recherche, en sélectionnant des icônes et en choisissant des options dans le menu déroulant :
- Source de données
- Cas d'utilisation
- Inventaire
- Accrédité par le MRC
(Facultatif) Prévisualisez les détails du modèle et le code SQL en cliquant sur expand_content Développer.
Sélectionnez le modèle que vous souhaitez utiliser en cliquant sur Utiliser le modèle ou cliquez sur add_circle Ajouter pour partir de zéro.
Attribuez un nom à votre rapport.
Rédigez ou modifiez le rapport à l'aide d'un code SQL compatible avec BigQuery. Vous pouvez rechercher les tables et les champs disponibles, et les insérer dans votre code SQL à partir de l'onglet Tables Google.
(Facultatif) Configurez les paramètres.
(Facultatif) Configurez le récapitulatif des lignes filtrées.
Cliquez sur Enregistrer.

Paramètres

Les paramètres rendent les rapports plus flexibles. Par exemple, vous pouvez exécuter le même rapport dans différentes campagnes. Plutôt que d'effectuer des rapports en double ou de coder en dur les ID des campagnes avant chaque exécution, vous pouvez configurer un paramètre qui accepte un ou plusieurs de ces ID à saisir à partir de la fiche "Exécuter" lorsque vous générez un rapport. Utiliser des paramètres vous permet de garder un code propre, de réduire le risque d'erreurs lorsque vous y apportez des changements et de réutiliser votre rapport sans avoir à le modifier. Les paramètres ne s'appliquent qu'au rapport où ils sont créés. Vous pouvez donc réutiliser un nom de paramètre dans un autre rapport.

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)

Créer un paramètre

Ouvrez un rapport enregistré ou créez-en un.
Cliquez sur Propriétés > Paramètres > Ajouter un paramètre.
Saisissez un nom dans le champ Nom. Il vous servira à référencer le paramètre dans le texte du rapport.
Utilisez le menu déroulant pour sélectionner le type de paramètre.
- Si vous cliquez sur "array", un menu déroulant supplémentaire s'affichera pour que vous sélectionniez le type de tableau.
Facultatif : répétez les étapes 2 à 4 jusqu'à ce que vous ayez ajouté tous les paramètres souhaités.
Cliquez sur "Enregistrer".

Utiliser un paramètre

Dans le texte du rapport, utilisez le format de paramètre SQL standard, en faisant précéder le nom du paramètre par @. Dans l'exemple suivant, le rapport contient un paramètre appelé @campaign_ids :

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

  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

Lorsque vous exécutez la requête, la boîte de dialogue Nouvelle tâche contient un champ Paramètres. Saisissez les valeurs pour chaque paramètre que vous avez défini.

Supprimer un paramètre

Ouvrez le rapport contenant le paramètre que vous souhaitez supprimer.
Ouvrez l'onglet Propriétés.
Dans la fiche Paramètres, cliquez sur Supprimer à côté du paramètre que vous souhaitez supprimer.
Cliquez 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. Conseil : Pour éviter tout écart lorsque vous spécifiez des fuseaux horaires dans votre rapport (comme dans les clauses `WHERE`), vous pouvez utiliser `time_zone` afin que le fuseau horaire corresponde à celui défini dans Nouvelle tâche. Il est également important d'utiliser le même fuseau horaire que celui de la source de données.

Récapitulatif des lignes filtrées

Les récapitulatifs des lignes filtrées regroupent les données filtrées suite à des contrôles de confidentialité. 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.

Modifier un rapport

Accédez à l'onglet Requêtes d'Ads Data Hub.
Cliquez sur le nom du rapport que vous souhaitez modifier.
Modifiez le rapport.
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

Accédez à l'onglet Requêtes d'Ads Data Hub.
Cliquez sur le nom du rapport à exécuter.
Cliquez sur play_arrowExécuter.
- L'estimation de l'espace de stockage (en octets) que le rapport utilisera s'affiche en haut de la page.
Sélectionnez un ID dans le menu déroulant Origine des données d'annonces. Il doit s'agir de l'ID 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 menu déroulant Origine de la table des correspondances.
Indiquez l'emplacement où vous souhaitez enregistrer les résultats du rapport dans le champ Table de destination.
Saisissez les dates de début et de fin pour déterminer la période de votre rapport.
Saisissez un fuseau horaire. Il doit correspondre à celui de la plate-forme d'achat.
Facultatif : saisissez les valeurs de tous les paramètres.
Cliquez sur Exécuter.

Afficher les résultats

Une fois votre rapport exécuté, vous pouvez prévisualiser les résultats sur la page "Tâches". 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.