Создайте аудиторию списков электронных адресов

Создайте аудиторию Customer Match, отправив запрос CreateUserListRequest .

Сформируйте тело запроса.

Создайте ресурс UserList . Вот основные поля, которые необходимо задать.

displayName
Обязательно. Отображаемое имя списка. Имя должно быть уникальным среди всех списков, принадлежащих учетной записи.
description
Краткое описание списка.
integrationCode
Идентификатор из вашей системы.
membershipDuration

Продолжительность пребывания участника аудитории в списке после добавления. Значение должно соответствовать целым дням. Если не задано, используется максимальное значение по умолчанию.

При использовании JSON рассчитайте количество секунд, умножив продолжительность в днях на 86400 (количество секунд в день). Затем присвойте результату умножения значение, добавив s . Например, если вам нужна продолжительность членства в 90 дней, используйте значение 7776000s так как 90 * 86400 = 7776000 .

При использовании формата Protocol Buffer воспользуйтесь удобным методом для создания объекта Duration на основе количества дней, если такой метод существует. Например, библиотека protobuf-java-util для Java имеет удобный метод fromDays() . В противном случае вычислите количество секунд, умножив количество дней Duration на 86400 (количество секунд в день), и используйте результат для установки поля seconds объекта Duration .

Обязательные поля для сопоставления клиентов.

Поле ingestedUserListInfo является обязательным для отображения аудитории в функции Customer Match.

Ниже перечислены поля, которые необходимо задать в объекте IngestedUserListInfo в зависимости от типа данных, которые вы хотите использовать для добавления участников аудитории в список.

Список контактной информации

Укажите следующие поля, если вы хотите использовать контактную информацию (хешированные адреса электронной почты, номера телефонов или почтовые адреса) для определения членов вашей аудитории:

uploadKeyTypes

Установите значение в виде списка, содержащего ключ загрузки CONTACT_ID .

Список uploadKeyTypes должен содержать только одну запись.

contactIdInfo

Установите значение сообщения ContactIdInfo , при этом dataSourceType будет иметь соответствующее значение из перечисления DataSourceType .

Список мобильных идентификаторов

Если вы хотите использовать мобильные идентификаторы для определения участников вашей аудитории, укажите следующие поля:

uploadKeyTypes

Установите значение в виде списка, содержащего ключ загрузки типа MOBILE_ID .

Список uploadKeyTypes должен содержать только одну запись.

mobileIdInfo

Установите значение сообщения MobileIdInfo :

  • Установите для параметра dataSourceType соответствующее значение из перечисления DataSourceType .

  • Установите keySpace в IOS или ANDROID .

  • Установите appId в виде строки, которая однозначно идентифицирует мобильное приложение, из которого были собраны данные.

    • Для iOS идентификационный номер (ID) — это 9-значная строка, которая находится в конце URL-адреса App Store. Например, 476943146 для приложения "Flood-It!" со ссылкой на App Store https://apps.apple.com/us/app/flood-it/id476943146 .

    • Для Android строка ID — это имя пакета приложения. Например, com.labpixies.flood для приложения "Flood-It!" со ссылкой на Google Play : https://play.google.com/store/apps/details?id=com.labpixies.flood .

Список идентификаторов пользователей

Укажите следующие поля, если вы хотите использовать идентификаторы пользователей для определения участников вашей аудитории:

uploadKeyTypes

Установите значение в виде списка, содержащего ключ загрузки USER_ID .

Список uploadKeyTypes должен содержать только одну запись.

Составьте запрос

Для создания аудитории Customer Match сформируйте запрос на create ресурса UserList .

  1. В поле parent укажите имя ресурса учетной записи. Имя ресурса должно соответствовать формату accountTypes/{accountType}/accounts/{account_id} .

  2. Используйте созданный вами список UserList в качестве тела запроса.

  3. Если ваши учетные данные не относятся к учетной записи Google, которая является пользователем parent , настройте заголовки, как описано в разделе «Настройка целевых объектов и заголовков» .

Ниже приведены примеры запросов в формате JSON для различных типов информации о пользователях. В каждом запросе параметр membershipDuration устанавливается равным 2592000s , где 2592000 — количество секунд в 30 днях. Нажмите кнопку «Открыть в API Explorer», чтобы попробовать выполнить запрос.

Контактная информация

Открыть в API Explorer 
{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Идентификаторы мобильных телефонов

Открыть в API Explorer 
{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Идентификаторы пользователей

Открыть в API Explorer 
{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Отправить запрос

Отправьте запрос и, при необходимости, добавьте заголовки запроса .

Если запрос выполнен успешно, в ответе будет содержаться созданный UserList с заполненными полями id и name . Запишите значения этих полей, поскольку они понадобятся вам в запросах для добавления участников в аудиторию.

Если запрос не удается, проанализируйте ошибки , чтобы определить причину сбоя, обновите запрос и заголовки, чтобы исправить все проблемы, а затем отправьте обновленный запрос и заголовки.

Назад
Обзор
Далее
Добавить участников в аудиторию