Si les résultats d'une requête donnée présentent des lignes qui ne sont pas correctement agrégées pour protéger la confidentialité des utilisateurs finaux ou qui ne respectent pas les autres contrôles de confidentialité d'Ads Data Hub, ces lignes seront supprimées. Vous pouvez configurer un récapitulatif des lignes filtrées dans les requêtes d'analyse afin de renvoyer une seule ligne contenant les constantes et les sommes des lignes supprimées. Cela permet d'éviter les écarts au niveau des totaux de vos données, tels que le nombre total d'impressions ou de clics. Un récapitulatif des lignes filtrées est activé par défaut pour les nouvelles requêtes d'analyse créées via l'UI. Les récapitulatifs de ce type ne s'appliquent pas aux requêtes d'audience. Par défaut, ils ne sont pas activés pour les requêtes créées via l'API.
Exemple
Dans l'exemple ci-dessous, les lignes contenant les campagnes 124 et 125 seraient filtrées, car elles ne répondent pas aux exigences d'agrégation d'au moins 50 utilisateurs.
| ID de campagne | Utilisateurs |
|---|---|
| 123 | 400 |
| 124 | 45 |
| 125 | 6 |
Toutefois, un récapitulatif des lignes filtrées permet de combiner les données filtrées pour répondre aux exigences d'agrégation du minimum de 50 utilisateurs. Dans cet exemple, le système utilise une somme pour calculer le nombre de données filtrées, et une constante pour ajouter un libellé à la ligne :
- Une somme qui agrège les données filtrées de la colonne
Users. - Une constante (utilisée pour ajouter un libellé au récapitulatif des lignes filtrées), définie sur "Récapitulatif des lignes filtrées" dans la colonne
Campaign ID.
| ID de campagne | Utilisateurs |
|---|---|
| Récapitulatif des lignes filtrées | 51 |
| 123 | 400 |
Mode automatique
Par défaut, Ads Data Hub active et configure automatiquement un récapitulatif des lignes filtrées pour les nouvelles requêtes créées via l'UI. Lorsque vous modifiez la requête, Ads Data Hub ajuste automatiquement la configuration en fonction des colonnes sélectionnées.
- Pour afficher les paramètres configurés automatiquement, accédez à Propriétés > Récapitulatif des lignes filtrées. La configuration est en lecture seule.
- Pour désactiver le mode automatique, cliquez sur le bouton Automatique. La configuration actuelle est conservée et le mode automatique est désactivé.
- Pour activer le mode automatique, cliquez sur le bouton Automatique. Dans la boîte de dialogue Passer au mode automatique ? qui s'affiche, cliquez sur Oui, rétablir. La configuration actuelle est supprimée et le mode automatique est activé.
- Pour activer/désactiver le mode automatique via l'API, utilisez
generateFilteredRowSummaryAutomatically.
Mode manuel
Pour ajouter manuellement un récapitulatif des lignes filtrées à une requête enregistrée, ou après avoir désactivé le mode automatique :
- Identifiez la colonne à agréger.
- Cliquez sur Ajouter une règle sous Propriétés > Récapitulatif des lignes filtrées à droite de l'éditeur de requête.
- Saisissez le nom de la colonne à agréger dans le champ Nom de la colonne.
- Sélectionnez Somme dans le menu déroulant Type. Si la somme est inférieure aux seuils d'agrégation, le récapitulatif des lignes filtrées est supprimé.
- (Facultatif) Ajoutez d'autres règles comme vous l'avez fait aux étapes précédentes.
- (Facultatif) À l'aide d'une constante, attribuez un identifiant au récapitulatif des lignes filtrées.
Votre constante doit correspondre à un type de données valide pour la ligne sélectionnée.
- Saisissez le nom de la colonne dans le champ Nom de la colonne.
- Sélectionnez Constante dans le menu déroulant Type.
- Saisissez un identifiant pour la ligne dans le champ Spécifier une valeur constante.
- Pour supprimer une règle, cliquez sur Supprimer.
- Pour supprimer toutes les règles, cliquez sur Tout supprimer.
Si vous exportez plusieurs tables à l'aide de la syntaxe in-sql présentée dans la section Exporter plusieurs tables, vous pouvez ajouter un récapitulatif des lignes filtrées dans les options de la colonne :
CREATE TABLE `myproject.mydataset.mytable` (
campaign_id INT64 OPTIONS(merge_constant=0),
ct INT64 OPTIONS(merge_type="SUM")
)
OPTIONS(privacy_checked_export=true) AS
SELECT campaign_id, COUNT(*) AS ct GROUP BY campaign_id;
Cette commande génère une table de résultats avec un récapitulatif des lignes filtrées, où campaign_id est 0 et ct correspondra à la somme des lignes filtrées du résultat en raison de contrôles de confidentialité.
Voici les options de colonnes actuellement disponibles pour le récapitulatif des lignes filtrées :
merge_type="SUM": génère la somme des valeurs filtrées dans la ligne récapitulative. Valable uniquement pour les types numériques.merge_constant=<value>: définit une valeur constante dans la ligne récapitulative. Doit être du même type que la colonne.- Si aucune option n'est spécifiée pour une colonne, la valeur de la ligne récapitulative sera NULL.
Vous ne pouvez spécifier qu'un seul merge_type ou merge_constant.
Toutes les règles concernant les récapitulatifs des lignes filtrées s'appliquent également ici (par exemple, si la somme est inférieure aux seuils d'agrégation, le récapitulatif des lignes filtrées est supprimé).