Aller au contenu principal

Résoudre les problèmes du connecteur Google Ads

info

Bêta

Cette fonctionnalité est en version Beta.

Découvrez comment résoudre les erreurs courantes avec le connecteur Google Ads géré dans Lakeflow Connect.

Je suis authentifié, mais je ne vois pas mes données Google Ads​

Cause : Vous vous authentifiez peut-être sur le mauvais compte Google. Alternativement, le compte pourrait ne pas avoir accès à Google Ads.

Solutions:

  1. Confirmez que vous vous authentifiez au bon compte Google. Vous pouvez modifier la connexion et vous réauthentifier avec le compte correct, ou recréer la connexion pour réévaluer le flux OAuth.
  2. Confirmez que le compte a accès à Google Ads. Connectez-vous au compte Google et vérifiez qu'il dispose des autorisations nécessaires pour accéder à vos données Google Ads.

Erreur : GOOGLE_ADS_ACTION_NOT_PERMITTED​

Message d'erreur :

Output
The authenticated Google Ads user or the Google Cloud project that owns the OAuth client is not permitted to perform this action on the requested resource or to call this method (authorization_error: ACTION_NOT_PERMITTED or CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION).

Cause : soit l’utilisateur authentifié n’a pas accès au compte, soit le projet Google Cloud propriétaire de votre client OAuth n’a que l’accès Test à l’API Google Ads. Un projet avec accès Test ne peut pas lire des comptes Google Ads de production.

Solutions:

  1. Confirmez que l'utilisateur authentifié a accès au compte Google Ads.
  2. Vérifiez le niveau d’accès du projet Google Cloud qui possède votre client OAuth. Voir Confirmer le niveau d’accès à l’API Google Ads. S’il affiche Test , demandez un accès Basique ou Standard .

Erreur d'URI de redirection lors de la configuration OAuth​

Message d'erreur :

Output
Error: redirect_uri_mismatch

Cause : L'URI de redirection configurée dans votre client OAuth de la Google Cloud Console ne correspond pas à l'URL du workspace Databricks.

Solutions:

  1. Visitez la Google Cloud Console à l'adresse https://console.cloud.google.com.
  2. Accédez à APIs et services /> Identifiants .
  3. Cliquez sur vos informations d’identification du client OAuth.
  4. Sous **URI de redirection autorisés**, confirmez qu'il contient le modèle suivanthttps://<workspace-url>/login/oauth/google.html:. Remplacez <workspace-url> par l'URL de votre Databricks Workspace (par exemple, https://dbc-a1b2c3d4-e5f6.cloud.databricks.com).
  5. Enregistrez les modifications et réessayez de vous authentifier.

Erreur : SAAS_CONNECTION_ERROR.INVALID_CREDENTIALS​

Message d'erreur :

Output
Failed to make a connection to the Google Ads source. Error code: INVALID_OAUTH_CREDENTIALS. Invalid credentials. Ensure the source connection credentials are provided correctly.

Cause : Google Ads a rejeté les identifiants OAuth de la connexion. Par exemple, l'utilisateur a révoqué l'accès de l'application, le mot de passe de l'utilisateur a changé ou le client OAuth a été supprimé.

Solution : Modifiez la connexion et authentifiez-vous à nouveau. Si vous utilisez votre propre client OAuth, vérifiez qu'il existe toujours dans Google Cloud Console.

Erreur : GOOGLE_ADS_USER_PERMISSION_DENIED​

Message d'erreur :

Output
The authenticated Google Ads user does not have permission to access the requested customer account (authorization_error: USER_PERMISSION_DENIED). Verify the authenticated user is linked to the account with at least read access.

Cause : L’utilisateur authentifié ne peut pas accéder au compte client que le pipeline lit. Une cause courante est que manager_account_id n’est pas défini, ou n’est pas le compte manager auquel le compte client est lié. Cela arrive aussi quand le compte a été dissocié du compte manager que le pipeline utilise, a été annulé ou a été déplacé vers un autre compte manager, ou quand l’accès de l’utilisateur a été supprimé.

Solutions:

  1. Dans Google Ads, confirmez que le compte client est associé au compte gestionnaire utilisé par le pipeline et que l’utilisateur authentifié dispose au minimum d’un accès en lecture à celui-ci.
  2. Si le compte n’est plus disponible, supprimez ses tables du pipeline. Dans le cas contraire, réauthentifiez la connexion avec un utilisateur ayant accès.

Erreur : GOOGLE_ADS_QUOTA_EXCEEDED​

Message d'erreur :

Output
The Google Ads API quota has been exhausted (rate name: <rateName>, scope: <rateScope>). ...

Cause : Le pipeline a effectué plus de requêtes d’API Google Ads que le quota ne le permet. Google Ads demande généralement au client d’attendre plus longtemps que la fenêtre de nouvelle tentative du pipeline, donc la mise à jour échoue au lieu de réessayer.

Solutions:

  1. Réduisez le nombre de tables ingérées par le pipeline ou planifiez le pipeline moins souvent.
  2. Attendez avant de réexécuter le pipeline. Si le message d’erreur signale un délai de nouvelle tentative, attendez au moins cette durée. Un délai de 0 signifie que Google Ads n’en a pas signalé.
  3. Si vous utilisez votre propre jeton de développeur et que vous atteignez souvent le quota, demandez un niveau d’accès plus élevé pour le jeton. Voir Limites et quotas de l’API dans la documentation de l’API Google Ads.

Erreur : GOOGLE_ADS_INVALID_CUSTOM_REPORT_CONFIGURATION​

Message d'erreur :

Output
Invalid custom_report configuration. <reason> ...

Cause : La custom_report_options d'une table de rapport personnalisée ne peut pas faire l'objet d'une query. La raison nomme le problème. Les raisons courantes sont :

  • Un nom de champ est invalide ou le champ ne peut pas être sélectionné à partir du resource choisi.
  • Aucun segment de chronologie n’est sélectionné. Chaque rapport personnalisé nécessite segments.date, segments.week ou segments.month.
  • Un champ est sélectionné à partir d'une ressource attribuée sans le resource_name de cette ressource.
  • Le sync_start_date remonte à plus de 37 mois pour un rapport segmenté par segments.date ou segments.week.

Solution : corrigez l’option indiquant les noms de raison. Pour tester la configuration sans déplacer de données, exécutez databricks pipelines start-update <pipeline-id> --validate-only. Voir databricks pipelines start-update. Pour les règles d’option, voir Options de configuration de rapport personnalisé. Pour créer un rapport sur des données de plus de 37 mois, utilisez segments.month.

Erreur : GOOGLE_ADS_API_ERROR​

Message d'erreur :

Output
The Google Ads API returned an error (<googleAdsErrorCode>): <googleAdsErrorMessage> ...

Cause : Google Ads a rejeté une demande avec une erreur que le connecteur ne classifie pas davantage. Le code d’erreur et le message proviennent généralement de Google Ads. Un code provenant du connecteur : UNRECOGNIZED_ACCOUNT_TIME_ZONE signifie que Google Ads n'a retourné aucun fuseau horaire pour le compte, ou un fuseau horaire que le connecteur ne reconnaît pas, de sorte que le connecteur ne peut pas compute les dates des rapports dans le fuseau horaire du compte.

Solution : recherchez le code d’erreur sur la page Erreurs courantes de la documentation de l’API Google Ads et ajustez la connexion ou la table concernée. Pour UNRECOGNIZED_ACCOUNT_TIME_ZONE, qui n’y est pas répertorié, ou si l’erreur persiste, contactez le support Databricks.

Erreur : MANAGED_INGESTION_PIPELINE_SPEC_VALIDATION_ERROR.OBJECT_SETTING_NOT_SUPPORTED​

Message d'erreur :

Output
These settings are not supported on these <sourceType> objects: <violations>. Remove them from these objects. A table_configuration setting on a table can also come from the pipeline's table_configuration.

Cause : le pipeline définit une option sur une table, un schéma ou un catalogue qui ne la prend pas en charge. Par exemple, un row_filter, primary_keys ou sequence_by sur une table de rapport, custom_report_options sur une table qui n’est pas un rapport personnalisé, ou sync_start_date ou lookback_window_days sur une table de ressources ou d’événements. L'erreur répertorie chaque objet avec les paramètres à supprimer, par exemple ad: lookback_window_days, sync_start_date; campaign_report: row_filter.

Solution : Supprimez les paramètres répertoriés de ces objets. Si une table ne définit pas elle-même row_filter, primary_keys ou sequence_by, vérifiez le table_configuration du pipeline, dont la table hérite lorsqu’elle n’a pas les siens. lookback_window_days et sync_start_date proviennent de la table, de son schéma, ou sinon de la première table ou du premier schéma dans la spécification du pipeline qui définit les options de connecteur Google Ads. Pour les règles, voir Limitations de la configuration de table.

Erreur : MANAGED_INGESTION_CONNECTOR_OPTIONS_CHANGED_REQUIRE_FULL_REFRESH​

Message d'erreur :

Output
The <options> connector option(s) of the <sourceType> destination table `<tableName>` cannot be changed during an incremental update. Perform a full refresh of the table, restore the original options, or create a new destination table.

Cause : Vous avez modifié resource, resource_fields, segments ou metrics d’un rapport personnalisé, ou sync_start_date d’une table de rapport. Ces options définissent les lignes que contient la table, de sorte qu’une mise à jour incrémentielle ne peut pas appliquer la modification. L’erreur nomme les options modifiées. Un sync_start_date que la table hérite de son schéma, ou de la première table ou du premier schéma dans la spécification du pipeline qui définit les options du connecteur Google Ads, compte également. La modification de cette valeur peut entraîner l’échec de chaque table de rapport qui en hérite.

Certaines modifications de rapports personnalisés échouent plus tôt avec SAAS_INCOMPATIBLE_SCHEMA_CHANGES_DURING_INIT à la place, par exemple la suppression d'une métrique ou l'ajout d'un segment. Ils ont également besoin d'un refresh complet.

Solution : Effectuez l'une des actions suivantes :

Erreur : CANNOT_FILTER_OUT_REQUIRED_COLUMN ou CANNOT_ADD_COLUMN_TO_INCLUDE_COLUMNS​

Message d'erreur :

Output
Pipeline definition does not include required columns (<columnNames>) in the table <qualifiedTableName> of source <sourceType> for ingestion. Please add them to include_columns or remove them from exclude_columns.
Output
New columns (<columnNames>) are added to include_columns field in pipeline definition for the table <qualifiedTableName>. Please full refresh the table to avoid potential data loss or remove these columns from include_columns.

Cause : la sélection de colonnes supprime une clé primaire ou une colonne de curseur dont la table a besoin, ou ajoute des colonnes à include_columns sur une table qui existe déjà. Les lignes précédentes n'ont pas de valeurs pour les colonnes ajoutées.

Solution : conservez la clé primaire et les colonnes de curseur dans la sélection. Pour ajouter des colonnes à une table existante, exécutez un refresh complet de cette table uniquement ou supprimez les nouvelles colonnes de include_columns. Pour refresh les tables sélectionnées, consultez refresh complètement les tables cibles. Un refresh complet supprime l'historique que Google Ads ne sert plus ; copiez donc cet historique vers une autre table auparavant. Consultez Historique plus ancien absent après un refresh complet.

Une table de rapport contient des valeurs qui ne correspondent plus à Google Ads​

Cause : Google Ads a modifié des données plus anciennes que la fenêtre de rétroactivité ou a restructuré une ligne pour que toutes les métriques soient à zéro. Le connecteur relit uniquement la fenêtre de rétroactivité et ne supprime pas les lignes de rapport, donc la table conserve les valeurs antérieures. Voir Limites concernant les données tardives et les lignes supprimées.

Solutions:

  1. Pour refresh les lignes affectées une fois, exécutez un refresh complet de cette table uniquement. Pour refresh des tables sélectionnées, consultez refresh complètement les tables cibles. Un refresh complet supprime l’historique que Google Ads ne fournit plus, donc copiez cet historique dans une autre table d’abord. Voir L’historique plus ancien est manquant après un refresh complet.
  2. Si les modifications arrivent souvent après la fenêtre rétrospective, augmentez lookback_window_days pour qu’elle corresponde à votre fenêtre de conversion.

L’historique plus ancien est manquant après un refresh complet​

Cause : un refresh complet n’ingère que ce que Google Ads propose encore. Google Ads conserve les données des rapports horaires, quotidiens et hebdomadaires pendant 37 mois, les données de clics pendant 90 jours, et les envois de formulaires de prospects pendant 60 jours. L’historique antérieur à cette période est supprimé du tableau. Consultez les limites de conservation des données.

Solutions:

  • Si vous avez conservé une copie de la table avant le refresh complet, restaurez l’historique plus ancien à partir de cette copie.
  • Si vous n’avez pas de copie, contactez le support Databricks pour évaluer les options de récupération.
  • Avant les futurs refresh complets, copiez l’historique que Google Ads ne sert plus vers une autre table.
  • Pour un rapport personnalisé qui nécessite des données plus anciennes que 37 mois, utilisez segments.month. Cela renvoie des totaux mensuels pour ces périodes. Cela ne restaure pas les lignes horaires, quotidiennes ou hebdomadaires d’origine.

click_report a des clics manquants après la mise en pause du pipeline​

Cause : Google Ads ne fournit des données sur les clics que pour les 90 derniers jours, et le connecteur lit au maximum les 88 derniers jours. Si le pipeline ne s'exécute pas correctement pendant plus de 88 jours, les clics entre la dernière mise à jour réussie et il y a 88 jours ne pourront pas être importés.

Solution : Les dates manquées ne peuvent pas être récupérées. Exécutez le pipeline selon une planification et corrigez une mise à jour échouée avant que 88 jours ne s’écoulent après la dernière mise à jour réussie.