Копирование данных из Google Ads с помощью Azure Data Factory или Synapse Analytics

ПРИМЕНИМО К: Azure Data Factory Azure Synapse Analytics

В этой статье описывается, как использовать действие копирования в конвейере Azure Data Factory или Synapse Analytics для копирования данных из Google Ads. Это продолжение статьи об обзоре действия копирования, в которой представлены общие сведения о действии копирования.

Поддерживаемые возможности

Этот соединитель Google Ads поддерживается для следующих возможностей:

(1) Azure среды выполнения интеграции (2) локальная среда выполнения интеграции

Список хранилищ данных, которые поддерживаются в качестве источников/приемников, см. в таблице Поддерживаемые хранилища данных.

Служба предоставляет встроенный драйвер для обеспечения подключения, поэтому вам не нужно вручную устанавливать какой-либо драйвер с помощью этого соединителя.

Начало работы

Для выполнения действия копирования с конвейером можно использовать один из следующих средств или пакетов SDK:

• Средство копирования данных
• портал Azure
• SDK .NET
• пакет SDK Python
• Azure PowerShell
• REST API
• шаблон Azure Resource Manager

Создание связанной службы в Google Ads с помощью пользовательского интерфейса

Выполните следующие действия, чтобы создать связанную службу с Google Ads в пользовательском интерфейсе портала Azure.

1. Перейдите на вкладку "Управление" в рабочей области Azure Data Factory или Synapse и выберите "Связанные службы", а затем нажмите кнопку "Создать".

   • Фабрика данных Azure
   • Azure Synapse

   

2. Найдите Google Ads и выберите соединитель Google Ads.

   

3. Настройте сведения о службе, проверьте подключение и создайте связанную службу.

   

Сведения о конфигурации соединителя

В следующих разделах содержатся сведения о свойствах, которые используются для определения компонентов Data Factory, относящихся к коннектору Google Ads.

Свойства связанной службы

Следующие свойства поддерживаются для связанной службы Google Ads:

Пример:

{
    "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"
        }
    }
}

Свойства набора данных

Полный список разделов и свойств, доступных для определения наборов данных, см. в статье о наборах данных. В этом разделе представлен список свойств, поддерживаемых набором данных Google Ads.

Чтобы скопировать данные из Google Ads, задайте для свойства типа набора данных значение GoogleAdWordsObject. Поддерживаются следующие свойства:

Пример

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

Свойства Copy activity

Полный список разделов и свойств, используемых для определения действий, обратитесь к статье Конвейеры. В этом разделе представлен список свойств, поддерживаемых источником Google Ads.

Google Ads в качестве источника

Чтобы скопировать данные из Google Ads, задайте тип источника в копировальном действии на GoogleAdWordsSource. В разделе source действия копирования поддерживаются следующие свойства:

Пример:

"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>"
            }
        }
    }
]

Свойства операции поиска

Подробные сведения об этих свойствах см. в разделе Действие поиска.

Обновление версии драйвера Google Ads

Чтобы обновить версию драйвера Google Ads, необходимо обновить связанную службу и узнать, как перейти с SQL на язык запросов Google Ads (GAQL).

Обновление конфигурации связанной службы

На странице "Изменить связанную службу" выберите Рекомендуется в разделе Версия драйвера и настройте связанную службу, указав свойства связанной службы.

Миграция из SQL в GAQL

Преобразуйте инструкции запроса и имена полей при миграции из SQL в GAQL.

Инструкции запросов

Если вы используете SQL-запрос в источнике действия копирования или в действии подстановки, которое ссылается на устаревшую связанную службу Google Ads, необходимо обновить их до GAQL-запроса.

В отличие от SQL, запрос в GAQL состоит из шести типов предложений:

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

Перейдите к грамматике языка запросов Google Ads для введения GAQL.

Выполните следующую инструкцию SQL в качестве примера:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Чтобы преобразовать инструкцию SQL в соответствующую инструкцию GAQL, выполните приведенные ниже инструкции:

1. Если * (звездочка) используется после SELECT предложения, необходимо указать все обязательные поля вместо звездочки, так как GAQL не поддерживает SELECT *. Перейдите к этой статье , чтобы просмотреть все доступные для выбора поля в определенном ресурсе.
2. Если имя поля используется после SELECT условия, то необходимо преобразовать его в соответствующее имя поля в GAQL, поскольку у них разные соглашения об именовании. Например, имя campaign_id поля в инструкции SQL-запроса должно быть преобразовано campaign.id в GAQL. Дополнительные сведения о преобразовании имен полей см. в разделе "Имя поля".
3. Имя ресурса можно оставить, если его написание согласуется с указанным здесь.
4. WHERE предложение должно быть обновлено в соответствии с грамматикой GAQL, поскольку операторы, которые поддерживаются GAQL, отличаются от SQL, и имя поля также необходимо преобразовать, как указано во втором пункте.

Ниже приведены два очень полезных инструмента, предлагаемых Google, и они настоятельно рекомендуется при создании соответствующих инструкций запросов GAQL:

• Построитель интерактивных запросов GAQL
• Валидатор запросов GAQL

Имя поля

Имя поля, используемое в SQL, не соответствует GAQL. Кроме того, необходимо усвоить правила преобразования из имен полей в SQL в имена полей в GAQL. Правило преобразования можно свести следующим образом:

• Если имя поля принадлежит ресурсу, символ подчеркивания (_) в SQL будет изменен на точку (.) в GAQL. И для слов в точке, выражение в стиле camelCase, используемое в SQL, будет изменено на отдельные слова с добавленными нижними подчеркиваниями между ними. Первая строка типа PascalCase в SQL будет изменена на соответствующее имя ресурса в GAQL.

• Если имя поля принадлежит сегментам или метрикам, префикс segments. или metrics. следует добавить в GAQL, то следуйте тому же правилу, как описано в первой точке, чтобы преобразовать имя.

Ниже приведены конкретные примеры преобразования имени поля:

Различия в работе Google Ads при использовании рекомендуемой и предыдущей версии драйвера.

В таблице ниже показаны различия функций между Google Ads с помощью рекомендуемой и устаревшей версии драйвера.

Обновление соединителя Google AdWords до соединителя Google Ads

Обновите связанную службу Google AdWords до последней версии связанной службы Google Ads, следуя нижеприведённым шагам:

1. Выберите рекомендуемую версию драйвера, чтобы создать связанную службу Google Ads и настроить ее, указав свойства связанной службы.

2. Обновите конвейеры, которые ссылаются на устаревшую связанную службу Google AdWords. Учитывая, что связанная служба Google Ads поддерживает только запрос для копирования данных, поэтому:

   1. Если ваш поток данных напрямую извлекает данные из отчета Google Ads, найдите соответствующее название ресурса Google Ads в таблице ниже и используйте этот инструмент для составления запроса.

      Отчет Google AdWords	Ресурс Google Ads
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_АККАУНТА	клиент
      AD_PERFORMANCE_REPORT	рекламная_группа_объявлений
      Отчет_о_производительности_группы_объявлений	группа объявлений
      ОТЧЕТ О ПРОИЗВОДИТЕЛЬНОСТИ ПО ВОЗРАСТНЫМ ГРУППАМ	просмотр диапазона возрастов
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_АУДИТОРИИ	campaign_audience_view,ad_group_audience_view
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_АВТОМАТИЧЕСКИХ_РАЗМЕЩЕНИЙ	Просмотр_размещения_группы
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_ПО_ЦЕЛЯМ_СТАВОК	стратегия торгов
      ОТЧЕТ_О_ВЫПОЛНЕНИИ_БЮДЖЕТА	бюджет_кампании
      Отчет по Метрикам Звонков и Деталям	call_view
      ОТЧЕТ_О_ЦЕЛЕВОМ_ГРАФИКЕ_РЕКЛАМНОЙ_КАМПАНИИ	Просмотр_расписания_рекламы
      ОТЧЕТ_ПО_КРИТЕРИЯМ_КАМПАНИИ	критерий_кампании
      ОТЧЕТ_О_ЭФФЕКТИВНОСТИ_КАМПАНИИ	кампания
      Отчет о общем наборе кампании	набор, общий для кампании
      ОТЧЕТ_О_ЦЕЛЕВОМ_РАСПОЛОЖЕНИИ_КАМПАНИИ	просмотр_местоположения
      ОТЧЕТ_О_ЭФФЕКТИВНОСТИ_КЛИКОВ	нажатие_просмотр
      ОТОБРАЖЕНИЕ_ОТЧЕТА_О_ЭФФЕКТИВНОСТИ_КЛЮЧЕВЫХ_СЛОВ	отображение_ключевого_слова_вид
      ОТЧЕТ О ПРОИЗВОДИТЕЛЬНОСТИ ТЕМ	вид_темы
      ОТЧЁТ_О_ПОЛОВОЙ_ПРОИЗВОДИТЕЛЬНОСТИ	вид_гендера
      GEO_PERFORMANCE_REPORT	географический_просмотр,просмотр_по_местоположению_пользователя
      Отчет_по_поисковому_запросу_без_ключевых_слов	динамические_поисковые_объявления_отображение_поисковых_терминов
      ОТЧЕТ_О_ЭФФЕКТИВНОСТИ_КЛЮЧЕВЫХ_СЛОВ	просмотр_ключевого_слова
      LABEL_REPORT	метка
      ОТЧЕТ_ПО_ПОСАДОЧНОЙ_СТРАНИЦЕ	представление_страницы_посадки,расширенное_представление_страницы_посадки
      Отчёт по платным и органическим запросам	просмотр_платного_органического_поискового_запроса
      ОТЧЕТ О РЕЗУЛЬТАТАХ ПО РОДИТЕЛЬСКОМУ СТАТУСУ	просмотр родительского статуса
      ЗАГЛУШКА_ОТЧЕТ_ЭЛЕМЕНТА_ЛЕНТЫ	feed_item,feed_item_target
      PLACEHOLDER_REPORT	feed_placeholder_view
      ОТЧЕТ_О_ЭФФЕКТИВНОСТИ_РАЗМЕЩЕНИЙ	представление_управляемого_размещения
      ОТЧЁТ_О_РАЗДЕЛЕНИИ_ПРОДУКТА	просмотр_группы_продуктов
      Отчёт об эффективности поисковых запросов	просмотр термина поиска
      SHARED_SET_CRITERIA_REPORT (Отчет по критериям общего набора)	общий_критерий
      ОТЧЕТ_О_ОБЩЕМ_НАБОРЕ	shared_set
      ОТЧЕТ_О_ЭФФЕКТИВНОСТИ_ПОКУПОК	обзор_производительности_покупок
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_СОДЕРЖАНИЯ_ТОП	Больше не доступен в API Google Ads.
      URL_PERFORMANCE_REPORT	просмотр_размещения_деталей
      ОТЧЕТ_О_ДИСТАНЦИИ_РЕКЛАМЫ_ПОЛЬЗОВАТЕЛЯ	дистанционное отображение
      ОТЧЕТ_О_ПРОИЗВОДИТЕЛЬНОСТИ_ВИДЕО	видео

3. Помните, что при этом обновлении существуют определенные ограничения:

   1. Не все типы отчетов из AWQL поддерживаются в GAQL.
   2. Не все запросы AWQL переводятся в запросы GAQL безупречно.

Связанный контент

Список хранилищ данных, которые поддерживаются в качестве источников и приемников для операции копирования, можно найти в разделе поддерживаемые хранилища данных.