Пользовательские аудитории из мобильных приложений

Вы можете создавать аудитории с учетом действий пользователей в вашем приложении. Например, можно добавить в аудиторию людей, которые:

• прошли 8-й уровень за последние 10 дней;
• за последние 8 дней пользовались приложением, но ничего в нем не купили;
• добавили товар в корзину, но не завершили покупку.

Для этого используются регистрируемые именованные события, а также Facebook SDK, API App Events или один из сервисов Mobile Measurement Partner. Примеры регистрируемых событий: установка приложения, добавление товара в корзину, покупка, достижение уровня.

Ограничения

• Параметр subtype для пользовательских аудиторий на основе вовлеченности поддерживается только для видео.
• Конечная точка POST /{ad-account-id}/adsets для кампаний SKAdNetwork, направленных на пользователей iOS 14.5, больше не поддерживает пользовательские аудитории из мобильных приложений для таргетинга по включению.
• В новых кампаниях по установке приложений для iOS 14.5 больше нельзя использовать таргетинг по связям с приложением.

Создание аудитории

Чтобы создать пользовательскую аудиторию из мобильного приложения, нужно сначала принять в Ads Manager соответствующее Пользовательское соглашение. Для этого требуется следующее:

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

Вот как создать аудиторию:

curl -X POST \
  -F 'name="My Test Website Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<APP_ID>",
                 "type": "app"
               }
             ],
             "retention_seconds": 8400,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "fb_mobile_purchase"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const CustomAudience = bizSdk.CustomAudience;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Test Website Custom Audience',
  'rule' : {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
  'prefill' : '1',
};
const customaudiences = (new AdAccount(id)).createCustomAudience(
  fields,
  params
);
logApiCallResult('customaudiences api call complete.', customaudiences);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\CustomAudience;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Test Website Custom Audience',
  'rule' => array('inclusions' => array('operator' => 'or','rules' => array(array('event_sources' => array(array('id' => '<appID>','type' => 'app')),'retention_seconds' => 8400,'filter' => array('operator' => 'and','filters' => array(array('field' => 'event','operator' => 'eq','value' => 'fb_mobile_purchase'))))))),
  'prefill' => '1',
);
echo json_encode((new AdAccount($id))->createCustomAudience(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.customaudience import CustomAudience
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Test Website Custom Audience',
  'rule': {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
  'prefill': '1',
}
print AdAccount(id).create_custom_audience(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createCustomAudience()
      .setName(\"My Test Website Custom Audience\")
      .setRule(\"{\\"inclusions\\":{\\"operator\\":\\"or\\",\\"rules\\":[{\\"event_sources\\":[{\\"id\\":\\"<appID>\\",\\"type\\":\\"app\\"}],\\"retention_seconds\\":8400,\\"filter\\":{\\"operator\\":\\"and\\",\\"filters\\":[{\\"field\\":\\"event\\",\\"operator\\":\\"eq\\",\\"value\\":\\"fb_mobile_purchase\\"}]}}]}}\")
      .setPrefill(true)
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
customaudiences = ad_account.customaudiences.create({
    name: 'My Test Website Custom Audience',
    rule: {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
    prefill: '1',
})

В случае успешного выполнения этот код возвращает id аудитории. Ниже перечислены основные параметры.

В каждом рекламном аккаунте можно создать не более 200 пользовательских аудиторий из мобильного приложения. Выполните запрос POST к следующему адресу:

https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/customaudiences

Используйте следующие поля:

Правила для аудитории

Чтобы определить, кто будет попадать в пользовательскую аудиторию, задайте правило на основе событий в приложении. Правило — это объект JSON с парами "ключ — значение", который может ссылаться на несколько событий в приложении. Правила можно задавать на основе определенных событий и их параметров, а также агрегации. Дополнительную информацию см. в статье Правила для аудитории. Статьи по теме

• Синтаксис правил для аудитории
• Синтаксис наборов правил
• Синтаксис правил включения и исключения: в объекте event_sources задайте для параметра id ID вашего приложения, а для параметра type — значение app.
• Фильтры
• Правила для фильтров:

  • Если фильтр задает событие, используйте для параметра field значение 'event'. Параметры, которые соответствуют событиям, отправляемым из приложения. Примеры: _appVersion, _value и т. д.
  • Если атрибут field имеет значение "event", то в атрибуте value должно быть указано имя события. Чтобы просматривать отправляемые пикселем параметры и события в приложении, используйте API App Events.
• Агрегирующие функции. В пользовательских аудиториях мобильных приложений доступны следующие агрегирующие функции: "count", "sum", "avg", "min" и "max".

Пример: правила для пользовательской аудитории мобильного приложения

Пример стандартного события

Вот как можно создать аудиторию из всех пользователей, совершивших покупки в мобильном приложении с ID 55064006 за последние 30 дней:

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
            }
        ]
    }
}

Пример специально настроенного события с параметрами

Вот как можно создать аудиторию из всех пользователей, которых касались специально настроенные события “timeOnPanel” в приложении с ID 55064006 за последние 30 дней:

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "timeOnPanel"
                        }
                    ]
                }
            }
        ]
    }
}

Вот как можно создать аудиторию из всех пользователей, которых касались специально настроенные события “timeOnPanel” с ценностью больше 30, цветом “red” или “blue” и любимым десертом, название которого содержит слово “banana”:

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app",
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "timeOnPanel",
                        },
                        {
                            "field": "_value",
                            "operator": ">",
                            "value": 30,
                        },
                        {
                            "field": "color",
                            "operator": "is_any",
                            "value": ["red", "blue"],
                        },
                        {
                            "field": "favoriteDessert",
                            "operator": "contains",
                            "value": "banana",
                        }
                    ]
                }
            }
        ]
    }
}

Пример агрегации

Вот как можно создать аудиторию из 20 % самых активных покупателей на основе данных о покупках за последние 30 дней:

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
                "aggregation": {
                    "type": "count",
                    "method": "percentile",
                    "operator": "in_range",
                    "from": 75,  
                    "to": 100,
                }
            }
        ]
    }
}

Пример исключения

Вот как можно включить в аудиторию всех пользователей, которые добавили товар в корзину, но не купили его:

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "add_to_cart"
                        }
                    ]
                }
            }
        ]
    },
    "exclusions": {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
            }
        ]
    }
}

API App Events

Вы можете запрашивать события и параметры, которые приложение передает в Facebook. Их можно напрямую использовать для создания пользовательских аудиторий. Для этого требуется маркер доступа с нужным app_id и роль администратора, разработчика или рекламодателя.

Отправьте запрос GET к следующему адресу:

https://graph.facebook.com/<API_VERSION>/<APP_ID>/app_event_types

В качестве ответа вы получите объект JSON, содержащий массив data словарей JSON с перечисленными ниже полями.

Управление аудиториями

• Получение информации о пользовательской аудитории
• Обновление пользовательской аудитории
• Удаление пользовательской аудитории

Дополнительная информация

• Повторное вовлечение пользователей iOS с помощью ретаргетинга на основе событий в приложении
• Ретаргетинг рекламы на Android на основе событий в приложении
• Таргетинг на пользовательские аудитории
• Таргетинг на похожие аудитории
• Справочник по параметрам таргетинга
• Справочник по использованию рекламы мобильных приложений для вовлечения пользователей