Meta Marketing API: реклама и таргетинг

Зачем нужен Meta Marketing API

Что доступно сразу

Таргетинг: от поиска до оценки охвата

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

import asyncio, os
from socialift import Ads

async def main():
    async with Ads(app_secret=os.environ["FACEBOOK_APP_SECRET"], graph_version="v25.0") as ads:
        token = os.environ["META_USER_TOKEN"]
        interests = await ads.search_interests(token, "fitness")
        targeting = ads.build_targeting(countries=["UZ"], age_min=18, age_max=45,
                                        interests=[{"id": interests[0]["id"]}],
                                        advantage_audience=False)  # точный возрастной диапазон
        print(await ads.delivery_estimate(token, ad_account_id="act_123", targeting=targeting))

asyncio.run(main())

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

boost_post превращает существующий пост в рекламу: последовательно создаёт кампанию, группу объявлений, креатив и объявление. Всё остаётся в статусе PAUSED — вы проверяете и включаете сами.

import asyncio, os
from socialift import Ads

async def main():
    async with Ads(app_secret=os.environ["FACEBOOK_APP_SECRET"], graph_version="v25.0") as ads:
        token = os.environ["META_USER_TOKEN"]
        result = await ads.boost_post(
            token,
            ad_account_id="act_123",
            ig_user_id="1784...",
            media_id="1790...",
            name="Reels boost",
            daily_budget_major=10.0,  # в валюте кабинета, например USD 10
            goal="traffic",
            link="https://example.uz/offer",
            targeting=ads.build_targeting(countries=["UZ"], age_min=18, platforms=["instagram"]),
        )
        # Результаты в разбивке по возрасту и полу
        rows = await ads.insights_rows(
            token, "act_123", level="campaign",
            date_preset="last_7d", breakdowns=["age", "gender"],
        )

asyncio.run(main())

Аудитории и пиксели

Помимо таргетинга, для показа рекламы конкретной группе людей используются аудитории.

Пользовательская аудитория (custom audience)

Аудитория на основе списка ваших клиентов. add_audience_users нормализует email и телефоны по правилам Meta и хеширует их SHA-256 на вашем сервере, где работает SDK, — в Meta не уходит открытый текст. В кабинете должны быть приняты условия Custom Audience.

Похожая аудитория (lookalike)

Люди в выбранной стране, максимально похожие на исходную аудиторию. ratio=0.01 — ближайший 1% населения страны; допустимый диапазон 0.01–0.20. В исходной аудитории должно быть не меньше 100 человек.

Пиксели

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

Контекст Lead Ads

К каждому лиду из Lead Ads можно приложить контекст таргетинга кампании и группы объявлений — видно, какая аудитория принесла заявку.

Как запустить рекламный поток

1. 1

   Запросите разрешения

   Добавьте в приложение Meta ads_management и ads_read. Для своего кабинета хватает Standard Access; для кабинетов клиентов получите Advanced Access через App Review и Business Verification.

2. 2

   Подключите аккаунт Facebook

   Войдите через Facebook на странице «Ulanishlar» (подключения) в кабинете: рекламные вызовы выполняются этим личным токеном пользователя.

3. 3

   Исследуйте аудиторию

   Найдите интересы и местоположения, соберите таргетинг и оцените охват без затрат.

4. 4

   Создайте кампанию

   Создайте кампанию, группу объявлений и объявление или продвиньте существующий пост Instagram через boost_post — всё в статусе PAUSED.

5. 5

   Проверьте, включите и отслеживайте

   Переведите статус в ACTIVE, следите за результатами в разбивках и корректируйте дневной бюджет.

На что обратить внимание при автоматизации рекламы

• ▸Всё создаётся в статусе PAUSED — пока вы не переведёте в ACTIVE, реклама не показывается.
• ▸Задавайте бюджет в основных единицах валюты кабинета и сверяйтесь с минимальным дневным бюджетом из ответа ad_accounts.
• ▸Периодически проверяйте сохранённые интересы — Meta удаляет устаревшие.
• ▸При загрузке списка клиентов email и телефоны хешируются SHA-256 на сервере, где работает SDK, и в Meta уходят только хеши.
• ▸Добавьте в приложение Meta ads_management и ads_read. Для своего кабинета хватает Standard Access; для кабинетов клиентов получите Advanced Access через App Review и Business Verification.
• ▸Запросы в Playground настоящие: действия, влияющие на бюджет, требуют там отдельного подтверждения.