Copier des données à partir de Google Ads avec Azure Data Factory ou Synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Cet article explique comment utiliser l'activité de copie dans Azure Data Factory ou Synapse Analytics pour copier des données de Google Ads. Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.

Fonctionnalités prises en charge

Ce connecteur Google Ads est pris en charge pour les capacités suivantes :

① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé

Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs, consultez le tableau Magasins de données pris en charge.

Le service fournit un pilote intégré qui permet la connexion. Vous n’avez donc pas besoin d’installer manuellement un pilote à l’aide de ce connecteur.

Prise en main

Pour effectuer l’activité Copie avec un pipeline, vous pouvez vous servir de l’un des outils ou kits SDK suivants :

• L’outil Copier des données
• Le portail Azure
• Le kit SDK .NET
• Le kit SDK Python
• Azure PowerShell
• L’API REST
• Le modèle Azure Resource Manager

Créer un service lié à Google Ads à l'aide de l'interface utilisateur

Suivez les étapes suivantes pour créer un service lié à Google Ads dans l'interface utilisateur du portail Microsoft Azure.

1. Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse et sélectionnez Services liés, puis cliquez sur Nouveau :

   • Azure Data Factory.
   • Azure Synapse

   

2. Recherchez Google Ads et sélectionnez le connecteur Google Ads.

   

3. Configurez les informations du service, testez la connexion et créez le nouveau service lié.

   

Informations de configuration des connecteurs

Les sections suivantes fournissent des informations détaillées sur les propriétés utilisées pour définir les entités Data Factory spécifiques du connecteur Google Ads.

Propriétés du service lié

Les propriétés prises en charge pour le service lié Google Ads sont les suivantes :

Exemple :

{
    "name": "GoogleAdsLinkedService",
    "properties": {
        "type": "GoogleAdWords",
        "typeProperties": {
            "clientCustomerID": "<clientCustomerID>",
            "loginCustomerID": "<loginCustomerID>",
            "developerToken": {
                "type": "SecureString",
                "value": "<developerToken>"
            },
            "authenticationType": "UserAuthentication",
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            },
            "clientId": {
                "type": "SecureString",
                "value": "<clientId>"
            },
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "googleAdsApiVersion": "v14"
        }
    }
}

Propriétés du jeu de données

Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données. Cette section fournit une liste des propriétés prises en charge par le jeu de données Google Ads.

Pour copier des données à partir de Google Ads, définissez la propriété type du jeu de données sur GoogleAdWordsObject. Les propriétés prises en charge sont les suivantes :

Exemple

{
    "name": "GoogleAdsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAds linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriétés de l’activité de copie

Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines. Cette section fournit une liste des propriétés prises en charge par la source Google Ads.

Google Ads comme source

Pour copier des données à partir de Google Ads, définissez le type de source sur GoogleAdWordsSource dans l'activité de copie. Les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :

Exemple :

"activities":[
    {
        "name": "CopyFromGoogleAds",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<GoogleAds input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GoogleAdWordsSource",
                "query": "SELECT campaign.id FROM campaign"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Propriétés de l’activité Lookup

Pour en savoir plus sur les propriétés, consultez Activité Lookup.

Mettre à niveau la version du pilote Google Ads

Pour mettre à niveau votre version du pilote Google Ads, vous devez mettre à jour votre service lié et apprendre à migrer de SQL vers Google Ads Query Language (GAQL).

Mettre à jour la configuration du service lié

Dans la page Modifier le service lié, sélectionnez Recommandé sous Version du pilote et configurez le service lié en vous référant aux propriétés du service lié.

Migrer de SQL vers GAQL

Convertissez vos instructions de requête et vos noms de champs lors de la migration de SQL vers GAQL.

Instructions de requête

Si vous utilisez une requête SQL dans la source de l'activité de copie ou dans l'activité de recherche qui fait référence à l'ancien service lié hérité Google Ads, vous devez la mettre à jour avec la requête GAQL.

Contrairement à SQL, la requête en GAQL est constituée de six types de clauses :

• SELECT
• FROM
• WHERE
• ORDER BY
• LIMIT
• PARAMETERS

Consultez Google Ads Query Language Grammar pour l'introduction de GAQL.

Prenons l'exemple de l'instruction SQL suivante :

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Vous pouvez suivre les instructions ci-dessous pour convertir l'instruction SQL en instruction GAQL correspondante :

1. Si le symbole * (astérisque) est utilisé après la clause SELECT, vous devez spécifier tous les champs requis à la place de l'astérisque, car GAQL ne prend pas en charge le symbole SELECT *. Consultez cet article pour découvrir tous les champs sélectionnables dans la ressource spécifique.
2. Si le nom du champ est utilisé après la clause SELECT, vous devez convertir le nom en nom de champ correspondant dans GAQL, car les conventions d'affectations de noms sont différentes. Par exemple, le nom du champ campaign_id dans l'instruction de requête SQL doit être converti en campaign.id dans GAQL. Consultez Nom du champ pour plus d'informations sur la conversion des noms de champ.
3. Le nom de la ressource peut être conservé sans autre modification, à moins que sa casse ne soit incompatible avec les indications données ici.
4. La clause WHERE doit être mise à jour conformément à la grammaire GAQL , car les opérateurs pris en charge par GAQL ne sont pas compatibles avec SQL, et le nom du champ doit également être converti tel que décrit dans le deuxième point.

Voici deux outils très utiles proposés par Google. Ils sont fortement recommandés lors de l'élaboration des requêtes correspondantes de GAQL :

• Générateur de requêtes GAQL interactif
• Validateur de requêtes GAQL

Nom du champ

Le nom du champ utilisé dans SQL n'est pas aligné sur GAQL. Vous devez également apprendre les règles de conversion des noms de champs dans SQL en noms de champs dans GAQL. La règle de conversion peut être formulée comme suit :

• Si le nom du champ appartient à une ressource, le trait de soulignement (_) dans SQL sera remplacé par un point (.) dans GAQL. Pour ce qui est des mots situés entre les points, les instructions de type « camelCase » utilisées dans SQL seront remplacées par des mots autonomes entre lesquels seront ajoutés des traits de soulignement. La première chaîne de type PascalCase dans SQL sera remplacée par le nom de la ressource correspondante dans GAQL.

• Si le nom du champ appartient à des segments ou à des métriques, les préfixes segments. ou metrics. doivent être ajoutés dans GAQL. Ensuite, suivez la même règle que celle décrite au premier point pour convertir le nom.

Découvrez ci-dessous des exemples concrets de conversion de nom de champ :

Différences dans Google Ads lors de l’utilisation de la version recommandée du pilote et de la version héritée du pilote

Le tableau ci-dessous présente les différences de fonctionnalités dans Google Ads lors de l’utilisation de la version recommandée du pilote et de la version héritée du pilote.

Mise à jour du connecteur Google AdWords vers le connecteur Google Ads

Mettez à jour votre service lié à Google AdWords avec la dernière version du service lié à Google Ads en suivant les étapes ci-dessous :

1. Sélectionnez Recommandé comme version du pilote pour créer un nouveau service lié à Google Ads et le configurer en vous référant aux propriétés du service lié.

2. Mettez à jour vos pipelines faisant référence au service lié Google AdWords hérité. En considérant que le service lié à Google Ads ne prend en charge que l'utilisation de la requête pour copier des données :

   1. Si votre pipeline récupère directement les données du rapport de Google AdWords, trouvez le nom de la ressource correspondante de Google Ads dans le tableau ci-dessous et utilisez cet outil pour générer la requête.

      Rapport Google AdWords	Ressource Google Ads
      ACCOUNT_PERFORMANCE_REPORT	client
      AD_PERFORMANCE_REPORT	ad_group_ad
      ADGROUP_PERFORMANCE_REPORT	ad_group
      AGE_RANGE_PERFORMANCE_REPORT	age_range_view
      AUDIENCE_PERFORMANCE_REPORT	campaign_audience_view,ad_group_audience_view
      AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT	group_placement_view
      BID_GOAL_PERFORMANCE_REPORT	bidding_strategy
      BUDGET_PERFORMANCE_REPORT	campaign_budget
      CALL_METRICS_CALL_DETAILS_REPORT	call_view
      CAMPAIGN_AD_SCHEDULE_TARGET_REPORT	ad_schedule_view
      CAMPAIGN_CRITERIA_REPORT	campaign_criterion
      CAMPAIGN_PERFORMANCE_REPORT	campagne
      CAMPAIGN_SHARED_SET_REPORT	campaign_shared_set
      CAMPAIGN_LOCATION_TARGET_REPORT	location_view
      CLICK_PERFORMANCE_REPORT	click_view
      DISPLAY_KEYWORD_PERFORMANCE_REPORT	display_keyword_view
      DISPLAY_TOPICS_PERFORMANCE_REPORT	topic_view
      GENDER_PERFORMANCE_REPORT	gender_view
      GEO_PERFORMANCE_REPORT	geographic_view,user_location_view
      KEYWORDLESS_QUERY_REPORT	dynamic_search_ads_search_term_view
      KEYWORDS_PERFORMANCE_REPORT	keyword_view
      LABEL_REPORT	label
      LANDING_PAGE_REPORT	landing_page_view,expanded_landing_page_view
      PAID_ORGANIC_QUERY_REPORT	paid_organic_search_term_view
      PARENTAL_STATUS_PERFORMANCE_REPORT	parental_status_view
      PLACEHOLDER_FEED_ITEM_REPORT	feed_item,feed_item_target
      PLACEHOLDER_REPORT	feed_placeholder_view
      PLACEMENT_PERFORMANCE_REPORT	managed_placement_view
      PRODUCT_PARTITION_REPORT	product_group_view
      SEARCH_QUERY_PERFORMANCE_REPORT	search_term_view
      SHARED_SET_CRITERIA_REPORT	shared_criterion
      SHARED_SET_REPORT	shared_set
      SHOPPING_PERFORMANCE_REPORT	shopping_performance_view
      TOP_CONTENT_PERFORMANCE_REPORT	Ce service n'est plus disponible dans l'API Google Ads.
      URL_PERFORMANCE_REPORT	detail_placement_view
      USER_AD_DISTANCE_REPORT	distance_view
      VIDEO_PERFORMANCE_REPORT	vidéo

   2. Si le pipeline utilise des requêtes pour récupérer des données de Google AdWords, utilisez l'outil Query Migration pour traduire le langage AWQL (AdWords Query Language) en langage GAQL (Google Ads Query Language).

3. Attention, cette mise à niveau comporte certaines limitations :

   1. Tous les types de rapports AWQL ne sont pas pris en charge dans GAQL.
   2. Toutes les requêtes AWQL ne sont pas systématiquement traduites en requêtes GAQL.

Contenu connexe

Pour obtenir une liste des magasins de données pris en charge comme sources et récepteurs par l’activité de copie, consultez la section sur les magasins de données pris en charge.