Aller au contenu principal

Limites du connecteur Google Ads

info

Bêta

Cette fonctionnalité est en version bêta.

Découvrez les limitations connues lors de l'utilisation du connecteur géré Google Ads dans Lakeflow Connect.

Limitations générales​

  • Lorsque vous exécutez un pipeline planifié, les alertes ne se Trigger pas immédiatement. Au lieu de cela, ils Trigger lors de l’exécution de la prochaine mise à jour.
  • Lorsqu’une table source est supprimée, la table de destination n’est pas automatiquement supprimée. Vous devez supprimer la table de destination manuellement. Ce comportement n'est pas cohérent avec le comportement de Spark Declarative Pipelines sur Lakeflow.
  • Pendant les périodes de maintenance de la source, Databricks pourrait ne pas être en mesure d'accéder à vos données.
  • Si un nom de table source entre en conflit avec un nom de table de destination existant, la mise à jour du pipeline échoue.
  • La prise en charge des pipelines multi-destination est uniquement via l'API.
  • Vous pouvez éventuellement renommer une table que vous ingérez. Si vous renommez une table dans votre pipeline, il devient un pipeline API uniquement, et vous ne pouvez plus modifier le pipeline dans l'interface utilisateur.
  • Si vous sélectionnez une colonne après qu'un pipeline a déjà start, le connecteur ne renseigne pas automatiquement les données historiques pour la nouvelle colonne. Pour ingérer des données historiques, exécutez manuellement un refresh complet sur la table.
  • Databricks ne peut pas ingérer deux tables ou plus portant le même nom dans le même pipeline, même si elles proviennent de schémas sources différents.
  • Le système source suppose que les colonnes du curseur augmentent de façon monotone.
  • Le connecteur ingère des données brutes sans transformations. Utilisez les Spark Declarative Pipelines en aval sur les Lakeflow Pipelines pour les transformations.

Tables prises en charge​

Le connecteur prend en charge les tables prédéfinies répertoriées dans la référence du connecteur Google Ads, ainsi que les tables de rapport personnalisées que vous définissez à l'aide des champs de ressources, des segments et des métriques de Google Ads.

Limitations de l'ingestion incrémentielle​

  • Les tables de ressources (telles que customer, campaign, ad_group et ad) sont entièrement actualisées à chaque mise à jour du pipeline. Seules les tables de rapport prennent en charge l'ingestion incrémentielle.
  • Le suivi de l’historique (SCD de type 2) n’est pris en charge pour aucune table. Seul l’état actuel est stocké.
  • Les options sync_start_date et lookback_window_days s’appliquent uniquement aux tables de rapport. Un pipeline qui les définit sur une table de ressources ou d’événements est rejeté lorsque vous l’enregistrez.
  • Les dates des rapports sont dans le fuseau horaire du compte Google Ads, et chaque mise à jour lit les dates jusqu'à la date actuelle dans ce fuseau horaire.
  • Pour un rapport personnalisé segmenté par segments.week ou segments.month, le sync_start_date et la fenêtre de rétrospection sont arrondis au start de la semaine (lundi) ou du mois, afin que chaque mise à jour relise des périodes entières.
  • Si une mise à jour échoue en cours de route dans une table de rapport, la prochaine mise à jour start à partir de la dernière période entièrement ingérée, moins la fenêtre de retour en arrière. Les dates ne sont pas ignorées.
  • Les tables d'événements (call_view, lead_form_submission, local_services_lead et local_services_lead_conversation) sont entièrement actualisées à chaque mise à jour du pipeline et ne contiennent que les lignes retournées par Google Ads. Par exemple, l’API Google Ads renvoie les soumissions de formulaires de prospects pour les 60 derniers jours uniquement ; les soumissions plus anciennes sont donc supprimées de la table de destination lors de la mise à jour suivante. Pour plus de détails, consultez l’article À propos des assets de formulaires de prospects dans le centre d’aide Google Ads.

Limitations concernant les modifications de données tardives et les lignes supprimées​

  • Chaque mise à jour du pipeline relit uniquement la fenêtre de rétroaction des données de rapport. Les modifications que Google Ads apporte aux données antérieures à la fenêtre de rétroaction ne sont pas capturées. Pour les capturer, lancez un refresh complet de la table.
  • L’API Google Ads omet les lignes de rapport dont les métriques sélectionnées sont toutes égales à zéro. Les tableaux de rapports ne contiennent pas de lignes pour les périodes sans activité. Pour plus de détails, consultez Métriques nulles dans la documentation de l’API Google Ads.
  • Le connecteur ne supprime pas les lignes des tables de rapport. Si Google Ads rétablit ultérieurement une ligne ingérée avec des métriques à zéro, l’API cesse de renvoyer cette ligne et la table de destination conserve ses valeurs antérieures. Pour supprimer ces lignes, exécutez un refresh complet de la table.

Limites de conservation des données​

  • Google Ads conserve les données de performance segmentées par heure, par jour et par semaine pendant 37 mois. Le connecteur ne peut pas ingérer les données que Google Ads ne fournit plus, donc un refresh complet supprime tout historique plus ancien contenu dans la table de destination. Un rapport personnalisé segmenté par segments.date ou segments.week est rejeté si son sync_start_date date de plus de 37 mois. Pour plus de détails, consultez l' annonce de la politique de rétention des données de Google Ads. Pour les rapports personnalisés qui ont besoin de données plus anciennes, utilisez segments.month.
  • La table click_report ne peut ingérer que les 88 derniers jours de clics, car Google Ads ne sert les données de clic que pour les 90 derniers jours. Une synchronisation initiale ou un refresh complet ne start pas avant 88 jours, même si sync_start_date est plus tôt. Si le pipeline ne s’exécute pas avec succès pendant plus de 88 jours, les clics entre la dernière mise à jour réussie et il y a 88 jours ne sont pas ingérés, car Google Ads ne les sert plus.

Limitations de la configuration de table​

  • Les resource, resource_fields, segments et metrics d’un rapport personnalisé, et les sync_start_date d’une table de rapport, ne peuvent pas être modifiés sur une table existante. Après avoir modifié l'un d'eux, la mise à jour suivante de la table échoue et demande un refresh complet ; la table conserve ses données existantes jusqu'à ce que vous en exécutiez un. Un refresh complet réingère la table avec la nouvelle configuration. La réorganisation des champs n’est pas une modification. Supprimer une option est une modification, tout comme modifier une sync_start_date dont la table hérite de son schéma ou de la première table ou schéma dans la spécification de pipeline qui définit les options de connecteur Google Ads.
  • Les filtres de ligne ne sont pas pris en charge sur les tables de rapport. La fenêtre de rétrospection relit les lignes pour mettre à jour leurs métriques, et un filtre de ligne sur une colonne de métrique peut empêcher l’ingestion d’une ligne mise à jour, ce qui laisse ses anciennes valeurs dans la table.
  • La substitution de sequence_by n'est prise en charge sur aucune table, et la substitution de primary_keys n'est pas prise en charge sur les tables de rapport ou de ressource. Les clés default et le séquencement du connecteur permettent aux relectures de recherche d'actualiser les lignes existantes et de garder chaque ressource indexée sur son propre ID.
  • custom_report_options s'applique uniquement à la table custom_report.
  • Un schéma ou un catalog dans la spécification de pipeline ne peut pas définir row_filter, primary_keys, sequence_by ou custom_report_options, car ces paramètres s’appliqueraient aux tables de rapport qu’il contient. Un catalogue ne peut pas non plus définir lookback_window_days ou sync_start_date. Définissez-les plutôt sur un schéma ou sur des tables de rapport individuelles.
  • Un pipeline qui définit l’un de ces paramètres non pris en charge est rejeté lors de sa création ou de sa modification, et l’erreur répertorie chaque objet avec les paramètres à supprimer. Une table, un schéma ou un catalogue qui ne définit pas ses propres table_configuration hérite du table_configuration au niveau du pipeline. Par conséquent, row_filter, primary_keys et sequence_by peuvent également provenir de là. Les options de connecteur n’ont pas de paramètre au niveau du pipeline. Une table de rapport qui ne définit pas lookback_window_days ou sync_start_date elle-même, et dont le schéma ne le définit pas non plus, utilise la valeur de la première table ou du premier schéma dans la spécification de pipeline qui définit les options de connecteur Google Ads. Pour que les valeurs de chaque table soient prévisibles, définissez-les sur chaque table ou schéma de rapport. custom_report_options provient toujours de la table elle-même.
  • La sélection de colonnes ne permet pas de supprimer la clé primaire ou les colonnes de curseur d’une table. L’ajout de colonnes à include_columns sur une table existante nécessite un refresh complet de la table.