Créer une requête
- Accédez à l'onglet Requêtes d'Ads Data Hub.
- Cliquez sur + Créer une requête. La page Modèles de requête d'analyse s'ouvre.
- (Facultatif) Prévisualisez le code SQL d'un modèle en cliquant sur Développer.
- Sélectionnez le modèle que vous souhaitez utiliser en cliquant sur Utiliser le modèle ou cliquez sur Vide pour démarrer de zéro.
- Attribuez un nom à votre rapport.
- Rédigez ou modifiez la requête à 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 permettent de rendre les requêtes plus flexibles. Par exemple, vous pouvez exécuter la même requête dans différentes campagnes. Plutôt que d'effectuer des requêtes 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" lors d'une requête. 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 requête sans avoir à la modifier. Les paramètres ne s'appliquent qu'à la requête où ils sont créés. Vous pouvez donc réutiliser un nom de paramètre dans une autre.
Types de paramètres
Les types de paramètres suivants sont autorisés :
int64float64boolstringdatetimestamparray(tous les types autorisés)
Créer un paramètre
- Ouvrez une requête enregistrée ou créez-en une.
- 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 de la requête.
- 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 de la requête, utilisez le format de paramètre SQL standard, en faisant précéder le nom du paramètre par @. Dans l'exemple suivant, la requête 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 la requête 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
Le tableau suivant liste les paramètres réservés par Ads Data Hub. Vous pouvez les utiliser dans vos requêtes, 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 requête. 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 requête. 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 requête. 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 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 une requête
- Accédez à l'onglet Requêtes d'Ads Data Hub.
- Cliquez ensuite sur le nom de la requête à modifier.
- Modifiez la requête.
- Cliquez sur Enregistrer.
Exécuter une requête
Avant d'exécuter une requête, 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 de la requête à exécuter.
- Cliquez sur Exécuter.
- L'estimation de l'espace de stockage (en octets) que la requête 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 de la requête dans le champ Table de destination.
- Saisissez les dates de début et de fin pour déterminer la période de votre requête.
- 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 requête exécutée, 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.