Transferts Search Ads 360

Le service de transfert de données BigQuery pour le connecteur Search Ads 360 vous permet de planifier et de gérer automatiquement les tâches de chargement récurrentes pour les données de rapports Search Ads 360.

Rapports acceptés

Le service de transfert de données BigQuery pour Search Ads 360 est compatible avec l'API de création de rapports Search Ads 360 version 0 :

Pour en savoir plus sur la transformation des rapports Search Ads 360 en tables et vues du service de transfert de données BigQuery, consultez la section Transformation des rapports Search Ads 360.

Option de création de rapports Assistance
Version d'API compatible

v0

Programmation

Tous les jours, à l'heure où le transfert a été créé (par défaut)

Vous pouvez configurer une heure spécifique.

Fenêtre d'actualisation

7 derniers jours (par défaut)

Configurable jusqu'à 30 jours

Les instantanés des tableaux de correspondance sont réalisés une fois par jour, puis stockés dans la partition pour la dernière date d'exécution. Ils ne sont pas mis à jour pour les remplissages ni pour les jours chargés via l'intervalle d'actualisation.

Durée maximale du remplissage

Aucune limite

Nombre de numéros client par compte administrateur

2 000

Le service de transfert de données BigQuery accepte jusqu'à 2 000 numéros client pour chaque compte administrateur Search Ads 360.

Pour consulter le guide de transfert Search Ads 360 utilisant l'ancienne API de reporting Search Ads 360, consultez la page Transferts Search Ads 360 (obsolète).

Ingestion de données à partir de transferts Search Ads 360

Lorsque vous transférez des données de Search Ads 360 vers BigQuery, elles sont chargées dans des tables BigQuery partitionnées par date. La partition de la table dans laquelle les données sont chargées correspond à la date de la source de données. Si vous planifiez plusieurs transferts pour la même date, le service de transfert de données BigQuery remplace la partition de cette date spécifique par les données les plus récentes. Plusieurs transferts le même jour ou l'exécution de remplissages n'entraînent pas de données en double, et les partitions des autres dates ne sont pas affectées.

Limites

  • La fréquence maximale à laquelle vous pouvez configurer un transfert de données Search Ads 360 est toutes les 24 heures. Par défaut, un transfert commence au moment où vous le créez. Toutefois, vous pouvez configurer l'heure de début du transfert de données lorsque vous créez votre transfert.
  • Le service de transfert de données BigQuery n'accepte pas les transferts de données incrémentiels lors d'un transfert Search Ads 360. Lorsque vous spécifiez une date pour un transfert de données, toutes les données disponibles pour cette date sont transférées.

Avant de commencer

Avant de créer un transfert de données Search Ads 360, procédez comme suit :

Autorisations requises

Assurez-vous que l'utilisateur qui crée le transfert de données dispose des autorisations requises suivantes:

  • Service de transfert de données BigQuery :

    • Autorisations bigquery.transfers.update pour créer le transfert de données
    • Autorisations bigquery.datasets.get et bigquery.datasets.update sur l'ensemble de données cible

    Le rôle IAM prédéfini bigquery.admin inclut les autorisations bigquery.transfers.update, bigquery.datasets.update et bigquery.datasets.get. Pour en savoir plus sur les rôles IAM associés au service de transfert de données BigQuery, consultez la page Contrôle des accès.

  • Google Cloud :

    • Autorisations serviceusage.services.use pour télécharger des données à partir de Search Ads 360 dans le projet.

    Les rôles IAM prédéfinis editor, owner et serviceusage.serviceUsageConsumer incluent des autorisations serviceusage.services.use. Pour en savoir plus sur les rôles IAM dans Service Usage, consultez la documentation de référence sur le contrôle des accès.

  • Search Ads 360 :

    • Accès en lecture au numéro client Search Ads 360 ou au compte administrateur utilisé dans la configuration de transfert.

Créer un transfert de données Search Ads 360

Pour créer un transfert de données pour les rapports Search Ads 360, vous avez besoin de votre numéro client Search Ads 360 ou de votre compte administrateur. Sélectionnez l'une des options suivantes :

Console

  1. Accédez à la page "Transferts de données" dans la console Google Cloud.

    Accéder à la page Transferts de données

  2. Cliquez sur Créer un transfert.

  3. Dans la section Type de source, choisissez Search Ads 360 comme Source.

  4. Dans la section Transfer config name (Nom de la configuration de transfert), sous Display name (Nom à afficher), saisissez un nom pour le transfert de données, tel que My Transfer. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.

  5. Dans la section Schedule options (Options de programmation) :

    • Pour le champ Repeat frequency (Fréquence de répétition), choisissez la fréquence d'exécution du transfert de données : Si vous sélectionnez Jours, indiquez une heure valide au format UTC.
      • Heures
      • Jours
      • À la demande
    • Le cas échéant, sélectionnez Commencer ou Commencer à l'heure définie, puis indiquez une date de début et une heure d'exécution.
  6. Dans la section Paramètres de destination, pour le champ Ensemble de données, sélectionnez l'ensemble de données que vous avez créé pour stocker vos données.

    1. Dans la section Data source details (Détails de la source de données) :

    2. Dans le champ Numéro client, saisissez votre numéro client Search Ads 360 :

    3. Facultatif: saisissez un ID d'agence et une référence annonceur pour récupérer les tables de mappage d'identifiants.

    4. Facultatif: dans le champ Variables Floodlight personnalisées, saisissez les variables Floodlight personnalisées à inclure dans le transfert de données. Les variables Floodlight personnalisées doivent appartenir au compte Search Ads 360 spécifié par le numéro client dans la configuration du transfert. Ce paramètre accepte des entrées de chaîne au format de tableau JSON et accepte plusieurs variables Floodlight personnalisées. Dans chaque élément du tableau JSON, les paramètres suivants sont obligatoires:

      • id: ID numérique de la variable Floodlight personnalisée. Cet ID est attribué lorsqu'une variable Floodlight personnalisée est créée dans Search Ads 360. Si vous avez spécifié un id, aucun name n'est requis.
      • name : nom défini par l'utilisateur des variables Floodlight personnalisées dans Search Ads 360. Si vous avez spécifié un name, aucun id n'est requis.
      • cfv_field_name: nom exact du champ de la variable Floodlight personnalisée selon votre cas d'utilisation. Les valeurs acceptées sont conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics et raw_event_conversion_dimensions.
      • destination_table_name: liste des tables BigQuery dans lesquelles inclure les variables Floodlight personnalisées. Lorsque le service de transfert de données BigQuery récupère les données de ces tables, le transfert inclut les variables Floodlight personnalisées dans la requête.
      • bigquery_column_name_suffix: nom de colonne convivial défini par l'utilisateur. Le service de transfert de données BigQuery ajoute le suffixe après le nom de champ standard pour différencier différentes variables Floodlight personnalisées. Selon le cas d'utilisation, le service de transfert de données BigQuery génère un nom de colonne BigQuery comme suit:

        Variables Floodlight personnalisées en tant que métriques et segments Variables Floodlight personnalisées en tant qu'attributs d'événement bruts dans la ressource de conversion
        metrics metrics_conversion_custom_metrics_bigquery_column_name_suffix metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
        dimension segments_conversion_custom_dimensions_bigquery_column_name_suffix segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      Voici un exemple d'entrée de variable Floodlight personnalisée qui spécifie deux variables Floodlight personnalisées :

      [{
        "id": "1234",
        "cfv_field_name": "raw_event_conversion_metrics",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name_suffix": "suffix1"
      },{
        "name": "example name",
        "cfv_field_name": "conversion_custom_metrics",
        "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
        "bigquery_column_name_suffix": "suffix2"
      }]
      
    5. Facultatif : dans le champ Colonnes personnalisées, saisissez les colonnes personnalisées à inclure dans le transfert de données. Les colonnes personnalisées doivent appartenir au compte Search Ads 360 spécifié par le numéro client dans la configuration du transfert. Ce champ accepte des entrées de chaîne au format de tableau JSON et accepte plusieurs colonnes. Dans chaque élément du tableau JSON, les paramètres suivants sont obligatoires:

      • id: ID numérique de la colonne personnalisée. Cet ID est attribué lors de la création d'une colonne personnalisée. Si vous avez spécifié un id, aucun name n'est requis.
      • name: nom défini par l'utilisateur de la colonne personnalisée dans Search Ads 360. Si vous avez spécifié un name, aucun id n'est requis.
      • destination_table_name: liste des tables BigQuery dans lesquelles inclure la colonne personnalisée. Lorsque le service de transfert de données BigQuery récupère les données de ces tables, le transfert inclut le champ de colonne personnalisée dans la requête.
      • bigquery_column_name: nom de colonne convivial défini par l'utilisateur. Il s'agit du nom du champ de la colonne personnalisée dans les tables de destination spécifiées dans destination_table_name. Le nom de la colonne doit respecter le format requis pour les noms de colonnes BigQuery et doit être unique pour les autres champs du schéma standard de la table ou d'autres colonnes personnalisées.

      Voici un exemple d'entrée Colonnes personnalisées qui spécifie deux colonnes personnalisées :

        [{
          "id": "1234",
          "destination_table_name": ["Conversion"],
          "bigquery_column_name": "column1"
        },{
          "name": "example name",
          "destination_table_name": ["AdGroupStats","CampaignStats"],
          "bigquery_column_name": "column2"
        }]
        

    6. Facultatif : dans le champ Filtre de table, saisissez une liste de tables séparées par une virgule, par exemple Campaign, AdGroup. Ajoutez le préfixe - à cette liste pour exclure certaines tables, par exemple -Campaign, AdGroup. Toutes les tables sont incluses par défaut.

    7. Facultatif : pour Intervalle d'actualisation, saisissez une valeur comprise entre 1 et 30. Si ce champ n'est pas défini, la fenêtre d'actualisation est définie par défaut sur sept jours.

  7. Dans le menu Compte de service, sélectionnez un compte de service parmi ceux associés à votre projet Google Cloud. Vous pouvez associer un compte de service à votre transfert au lieu d'utiliser vos identifiants utilisateur. Pour en savoir plus sur l'utilisation des comptes de service avec des transferts de données, consultez la page Utiliser des comptes de service.

    • Si vous vous êtes connecté avec une identité fédérée, vous devez disposer d'un compte de service pour créer un transfert. Si vous vous êtes connecté avec un compte Google, un compte de service pour le transfert est facultatif.
    • Le compte de service doit disposer des autorisations requises.
  8. Facultatif : dans la section Notification options (Options de notification) :

    • Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail en cas d'échec de l'exécution du transfert.

    • Cliquez sur le bouton pour activer les notifications Pub/Sub. Pour le champ Select a Cloud Pub/Sub topic (Sélectionner un sujet Cloud Pub/Sub), choisissez le nom de votre sujet ou cliquez sur Create a topic (Créer un sujet). Cette option configure les notifications d'exécution Pub/Sub pour votre transfert.

  9. Cliquez sur Enregistrer.

bq

Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config. Les paramètres suivants sont également requis :

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Les options suivantes sont facultatives :

  • --project_id : spécifie le projet à utiliser. Si l'option n'est pas spécifiée, le projet par défaut est utilisé.
  • --service_account_name : indique un compte de service à utiliser pour l'authentification du transfert Search Ads 360 au lieu de votre compte utilisateur.
bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Où :

  • PROJECT_ID (facultatif): spécifie le projet à utiliser. Si l'option n'est pas spécifiée, le projet par défaut est utilisé.
  • DATASET : ensemble de données cible de la configuration de transfert.
  • NAME : nom à afficher de la configuration de transfert. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert de données si vous devez le modifier ultérieurement.

  • DATA_SOURCE. La source de données – search_ads.

  • SERVICE_ACCOUNT_NAME (facultatif) : est le nom du compte de service utilisé pour authentifier le transfert de données. Le compte de service doit appartenir au même project_id que celui utilisé pour créer le transfert et doit disposer de toutes les autorisations requises.

  • PARAMETERS correspond aux paramètres de la configuration de transfert créée, au format JSON. Exemple : --params='{"param":"param_value"}'. Vous devez indiquer le paramètre customer_id.

    • table_filter : spécifie les tables à inclure dans le transfert de données. Si l'option n'est pas spécifiée, toutes les tables sont incluses. Pour n'inclure que des tables spécifiques, utilisez une liste de valeurs séparées par des virgules (par exemple, Ad, Campaign, AdGroup). Pour exclure des tables spécifiques, ajoutez un tiret (-) comme préfixe aux valeurs exclues (par exemple, l'utilisation de -Ad, Campaign, AdGroup exclut les trois valeurs).
    • custom_columns: permet de spécifier des colonnes personnalisées pour vos rapports. Ce paramètre prend des entrées de chaîne au format de tableau JSON et peut accepter plusieurs colonnes. Dans chaque élément du tableau JSON, les paramètres suivants sont obligatoires:
      • CC_ID: ID numérique de la colonne personnalisée. Cet ID est attribué lors de la création d'une colonne personnalisée.
      • CC_DESTINATION_TABLE: liste des tables BigQuery dans lesquelles inclure la colonne personnalisée. Lorsque le service de transfert de données BigQuery récupère les données de ces tables, le transfert de données inclut le champ de colonne personnalisée dans la requête.
      • CC_COLUMN: nom de colonne convivial défini par l'utilisateur. Il s'agit du nom de champ de la colonne personnalisée dans les tables de destination spécifiées dans destination_table_name. Le nom de la colonne doit respecter le format requis pour les noms de colonnes BigQuery et doit être unique pour les autres champs du schéma standard de la table ou d'autres colonnes personnalisées.
    • custom_floodlight_variables: permet de spécifier des variables Floodlight personnalisées dans votre transfert. Ce paramètre accepte des entrées de chaîne au format de tableau JSON et accepte plusieurs variables Floodlight personnalisées. Dans chaque élément du tableau JSON, les paramètres suivants sont obligatoires:
      • CFV_ID: ID numérique de la variable Floodlight personnalisée. Cet ID est attribué lorsqu'une variable Floodlight personnalisée est créée dans Search Ads 360.
      • CFV_FIELD_NAME: nom exact du champ de la variable Floodlight personnalisée selon votre cas d'utilisation. Les valeurs acceptées sont conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics et raw_event_conversion_dimensions. Pour en savoir plus, consultez la section Métriques Floodlight personnalisées.
      • CFV_DESTINATION_TABLE: liste des tables BigQuery dans lesquelles inclure les variables Floodlight personnalisées. Lorsque le service de transfert de données BigQuery récupère les données de ces tables, le transfert de données inclut les variables Floodlight personnalisées dans la requête.
      • CFV_COLUMN_SUFFIX: nom de colonne convivial défini par l'utilisateur. Le service de transfert de données BigQuery ajoute le suffixe après le nom de champ standard pour différencier les différentes variables Floodlight personnalisées. Selon le cas d'utilisation, le service de transfert de données BigQuery génère un nom de colonne BigQuery comme suit:
    Variables Floodlight personnalisées en tant que métriques et segments Variables Floodlight personnalisées en tant qu'attributs d'événement bruts dans la ressource de conversion
    metrics metrics_conversion_custom_metrics_bigquery_column_name_suffix metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
    dimension segments_conversion_custom_dimensions_bigquery_column_name_suffix segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Par exemple, la commande suivante crée un transfert de données Search Ads 360 nommé My Transfer à l'aide du numéro client 6828088731 et de l'ensemble de données cible mydataset. Le transfert spécifie également une variable Floodlight personnalisée. Le transfert de données est créé dans le projet par défaut :

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

La première fois que vous exécutez la commande, vous recevez un message de ce type :

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Suivez les instructions du message et collez le code d'authentification sur la ligne de commande.

API

Utilisez la méthode projects.locations.transferConfigs.create et fournissez une instance de la ressource TransferConfig.

Déclencher manuellement un transfert Search Ads 360

Lorsque vous déclenchez manuellement un transfert pour Search Ads 360, les instantanés des tables de correspondances sont pris une fois par jour et stockés dans la partition à la date de dernière exécution. Lorsque vous déclenchez un transfert manuel, les instantanés des tables de correspondances des tables suivantes ne sont pas mis à jour :

  • Compte
  • Annonce
  • AdGroup
  • AdGroupCriterion
  • Toute table de mappage d'ID
  • Élément
  • BidStrategy
  • Campagne
  • CampaignCriterion
  • ConversionAction
  • Mot clé
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup

Compatibilité des comptes administrateur Search Ads 360

L'utilisation des comptes administrateur Search Ads 360 offre plusieurs avantages par rapport à l'utilisation de numéros client individuels :

  • Vous n'avez pas besoin de gérer de multiples transferts de données pour générer des rapports relatifs à différents numéros client.
  • Les requêtes multiclients sont plus simples à écrire, car tous les numéros client sont stockés dans la même table.
  • L'utilisation de comptes administrateur atténue les problèmes potentiels de quota de chargement du service de transfert de données BigQuery, car plusieurs numéros client sont chargés dans la même tâche.

Pour les clients existants qui disposent de plusieurs transferts de données Search Ads 360 spécifiques à un numéro client, nous vous recommandons de passer à un compte administrateur Search Ads 360 à la place. Pour cela, procédez comme suit :

  1. Configurez un seul transfert de données Search Ads 360 au niveau du compte administrateur ou administrateur secondaire.
  2. Programmez un remplissage.
  3. Désactivez les transferts Search Ads 360 spécifiques à un numéro client individuel.

Pour en savoir plus sur les comptes administrateur Search Ads 360, consultez À propos des comptes administrateur dans la nouvelle interface Search Ads 360 et Découvrez comment les comptes sont associés à votre compte administrateur.

Exemple

La liste suivante répertorie les numéros client associés à certains comptes administrateur Search Ads 360 :

  • 1234567890 : compte administrateur racine
    • 1234 : sous-compte administrateur
      • 1111 : numéro client
      • 2222 : numéro client
      • 3333 : numéro client
      • 4444 : numéro client
      • 567 : sous-compte administrateur
        • 5555 : numéro client
        • 6666 : numéro client
        • 7777 : numéro client
    • 89 : sous-compte administrateur
      • 8888 : numéro client
      • 9999 : numéro client
    • 0000 : numéro client

Chaque numéro client associé à un compte administrateur apparaît dans chacun des rapports. Pour en savoir plus sur la structure des rapports Search Ads 360 dans le service de transfert de données BigQuery, consultez la page Transformation des rapports Search Ads 360.

Configurer un transfert pour le numéro client 1234567890

Configurer un transfert pour le compte administrateur racine (numéro client 1234567890) génère des exécutions de transfert de données comprenant les numéros client suivants :

  • 1111 (via le sous-compte administrateur 1234)
  • 2222 (via le sous-compte administrateur 1234)
  • 3333 (via le sous-compte administrateur 1234)
  • 4444 (via le sous-compte administrateur 1234)
  • 5555 (via les sous-comptes administrateur 567 et 1234)
  • 6666 (via les sous-comptes administrateur 567 et 1234)
  • 7777 (via les sous-comptes administrateur 567 et 1234)
  • 8888 (via le sous-compte administrateur 89)
  • 9999 (via le sous-compte administrateur 89)
  • 0000 (numéro client individuel)

Configurer un transfert pour le numéro client 1234

Configurer un transfert pour le sous-compte administrateur 123 (numéro client 1234) génère des exécutions de transfert de données comprenant les numéros client suivants :

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (via le sous-compte administrateur 567)
  • 6666 (via le sous-compte administrateur 567)
  • 7777 (via le sous-compte administrateur 567)

Configurer un transfert pour le numéro client 567

Configurer un transfert pour le sous-compte administrateur 567 (numéro client 567) génère des exécutions de transfert de données comprenant les numéros client suivants :

  • 5555
  • 6666
  • 7777

Configurer un transfert pour le numéro client 89

Configurer un transfert pour le sous-compte administrateur 89 (numéro client 89) génère des exécutions de transfert de données comprenant les numéros client suivants :

  • 8888
  • 9999

Configurer un transfert pour le numéro client 0000

Configurer un transfert pour le numéro client 0000 génère des exécutions de transfert de données comprenant les numéros client suivants :

  • 0000

Interroger les données

Lorsque vos données sont transférées vers le service de transfert de données BigQuery, les données sont écrites dans des tables partitionnées par date d'ingestion. Pour plus d'informations, consultez la page Présentation des tables partitionnées.

Si vous interrogez directement les tables au lieu d'utiliser les vues générées automatiquement, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la page Interroger des tables partitionnées.

Exemples de requêtes Search Ads 360

Vous pouvez analyser les données que vous avez transférées à l'aide des exemples de requêtes Search Ads 360 suivants. Vous pouvez également afficher les données dans un outil de visualisation tel que Looker Studio.

Les requêtes suivantes illustrent des exemples permettant de commencer à interroger vos données Search Ads 360 avec le service de transfert de données BigQuery. Pour en savoir plus sur ce que vous pouvez faire avec ces rapports, contactez votre représentant technique Search Ads 360.

Si vous interrogez directement les tables au lieu d'utiliser les vues générées automatiquement, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la page Interroger des tables partitionnées.

Performances des campagnes

L'exemple de requête ci-dessous permet d'analyser les performances des campagnes Search Ads 360 au cours des 30 derniers jours.

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Remplacez les éléments suivants :

  • DATASET : nom de l'ensemble de données
  • CUSTOMER_ID : numéro client Search Ads 360

Nombre de mots clés

L'exemple de requête suivant analyse les mots clés par campagne, par groupe d'annonces et par état de mots clé.

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

Remplacez les éléments suivants :

  • DATASET : nom de l'ensemble de données
  • CUSTOMER_ID : numéro client Search Ads 360

Tables de mappage d'ID

Les entités de la nouvelle interface Search Ads 360, telles que les clients, les campagnes et les groupes d'annonces, disposent d'un espace d'ID différent de celui de l'ancienne interface Search Ads 360. Pour les utilisateurs de transfert Search Ads 360 existants qui souhaitent combiner des données de l'ancienne API Search Ads 360 avec la nouvelle API Search Ads 360, vous pouvez utiliser le service de transfert de données BigQuery pour transférer les tables de mappage d'ID si vous fournissez un ID d'agence et une référence annonceur valides dans la configuration de transfert.

Les entités compatibles contiennent deux colonnes, legacy_id et new_id, qui spécifient le mappage d'ID pour les entités dans l'ancienne et la nouvelle version de Search Ads 360, respectivement. Un élément new_secondary_id est également fourni pour les entités AD, CAMPAIGN_CRITERION et CRITERION, car ces entités ne disposent pas d'identifiants uniques globaux dans la nouvelle interface Search Ads 360. Vous trouverez ci-dessous une liste de tables de mappage d'ID.

  • IdMapping_AD
  • IdMapping_AD_GROUP
  • IdMapping_CAMPAIGN
  • IdMapping_CAMPAIGN_CRITERION
  • IdMapping_CAMPAIGN_GROUP
  • IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
  • IdMapping_CRITERION
  • IdMapping_CUSTOMER
  • IdMapping_FEED_ITEM
  • IdMapping_FEED_TABLE

Exemples de requêtes

La requête suivante utilise des tables de mappage d'ID pour agréger les métriques par campagne des tables des transferts de données de la version précédente et nouvelle de Search Ads 360 dans le nouvel espace d'ID.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Remplacez les éléments suivants :

  • DATASET : nom de l'ensemble de données
  • CUSTOMER_ID : numéro client Search Ads 360
  • ADVERTISER_ID : référence annonceur Search Ads 360
  • NEW_DATA_DATE : date de données de la nouvelle table Search Ads 360
  • OLD_DATA_DATE : date de données de la table Search Ads 360 précédente

La requête suivante utilise des tables de mappage d'ID pour agréger les métriques par campagne entre les tables des transferts de données de la version précédente et nouvelle de Search Ads 360 dans l'ancien espace d'ID.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Remplacez les éléments suivants :

  • DATASET : nom de l'ensemble de données
  • CUSTOMER_ID : numéro client Search Ads 360
  • ADVERTISER_ID : référence annonceur Search Ads 360
  • NEW_DATA_DATE : date de données de la nouvelle table Search Ads 360
  • OLD_DATA_DATE : date de données de la table Search Ads 360 précédente

Problèmes de quota potentiels

L'API Search Ads 360 Reporting attribue un quota quotidien pour le nombre de requêtes que le projet Google peut envoyer. Si votre projet utilise le service de transfert de données BigQuery et d'autres services, tous les services partagent le même quota et peuvent potentiellement atteindre la limite de quota de n'importe quel service.

Pour éviter que ce problème ne se produise sans affecter les workflows existants, envisagez les options suivantes :

  • Configurez un projet distinct pour le service de transfert de données BigQuery. Une jointure inter-projets peut se présenter comme suit :

      #standardSQL
      select count(a.item1)
      from (select item1, item2 from project-A.data_set_a.table_name_a) a
      inner join
      (select item3, item4 from project-B.data_set_b.table_name_b) b
      on a.item1 = b.item3
    

  • Contactez l'assistance Search Ads 360 pour demander une augmentation de quota.