Meta Marketing API: reklama va targeting

Meta Marketing API nima uchun kerak?

Nimalar tayyor holda keladi

Targeting: qidiruvdan qamrov bahosigacha

Avval auditoriyani tadqiq qilasiz, keyin targetingni yig'asiz va hali hech narsa yaratmay turib, u qancha odamni qamrab olishini ko'rasiz.

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)  # aniq yosh oralig'i
        print(await ads.delivery_estimate(token, ad_account_id="act_123", targeting=targeting))

asyncio.run(main())

Instagram postini bir chaqiruvda reklamaga aylantirish

boost_post mavjud postni reklamaga aylantiradi: kampaniya, ad set, kreativ va reklamani ketma-ket yaratadi. Hammasi PAUSED holatda qoladi — tekshirib, o'zingiz yoqasiz.

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,  # kabinet valyutasida, masalan USD 10
            goal="traffic",
            link="https://example.uz/offer",
            targeting=ads.build_targeting(countries=["UZ"], age_min=18, platforms=["instagram"]),
        )
        # Natijani yosh va jins kesimida ko'rish
        rows = await ads.insights_rows(
            token, "act_123", level="campaign",
            date_preset="last_7d", breakdowns=["age", "gender"],
        )

asyncio.run(main())

Auditoriyalar va piksellar

Targetingdan tashqari reklamani aniq odamlar guruhiga yo'naltirish uchun auditoriyalar ishlatiladi.

Maxsus auditoriya (custom audience)

Mijozlaringiz ro'yxati asosidagi auditoriya. add_audience_users email va telefonni Meta qoidasi bo'yicha normallashtirib, SDK ishlayotgan serveringizda SHA-256 bilan xeshlaydi — Meta'ga ochiq matn ketmaydi. Kabinetda Custom Audience shartlari qabul qilingan bo'lishi kerak.

O'xshash auditoriya (lookalike)

Tanlangan davlat ichida manba auditoriyaga eng o'xshash odamlar. ratio=0.01 — davlat aholisining eng o'xshash 1%; ruxsat etilgan oraliq 0.01–0.20. Manba auditoriyada kamida 100 kishi bo'lishi kerak.

Piksellar

Reklama kabinetiga bog'langan piksellar ro'yxati API orqali olinadi.

Lead Ads konteksti

Lead Ads orqali kelgan har bir leadga kampaniya va ad set targeting konteksti biriktirilishi mumkin — qaysi auditoriya lead keltirgani ko'rinib turadi.

Reklama oqimini ishga tushirish

1. 1

   Ruxsatlarni so'rang

   Meta ilovangizga ads_management va ads_read qo'shing. O'z kabinetingiz uchun Standard Access yetadi; mijoz kabinetlari uchun App Review va Business Verification orqali Advanced Access oling.

2. 2

   Facebook akkauntini ulang

   Kabinetdagi Ulanishlar sahifasida Facebook orqali kiring: reklama chaqiruvlari shu shaxsiy foydalanuvchi tokeni bilan bajariladi.

3. 3

   Auditoriyani tadqiq qiling

   Qiziqish va joylashuvlarni qidiring, targetingni yig'ing va qamrovni pul sarflamasdan baholang.

4. 4

   Kampaniyani yarating

   Kampaniya, ad set va reklamani yarating yoki mavjud Instagram postini boost_post bilan ko'taring — hammasi PAUSED holatda.

5. 5

   Tekshiring, yoqing va kuzating

   Holatni ACTIVE ga o'tkazing, natijalarni kesimda kuzating va kunlik byudjetni moslang.

Reklamani avtomatlashtirishda e'tibor bering

• ▸Hamma narsa PAUSED holatda yaratiladi — ACTIVE ga o'tkazmaguningizcha reklama ko'rsatilmaydi.
• ▸Byudjetni kabinet valyutasining asosiy birligida bering va minimal kunlik byudjetni ad_accounts javobidan tekshiring.
• ▸Saqlangan qiziqishlarni vaqti-vaqti bilan tekshiring — Meta eskirganlarini olib tashlaydi.
• ▸Mijozlar ro'yxati yuklanganda email va telefonlar SDK ishlayotgan serverda SHA-256 bilan xeshlanadi va Meta'ga faqat xesh ketadi.
• ▸Meta ilovangizga ads_management va ads_read qo'shing. O'z kabinetingiz uchun Standard Access yetadi; mijoz kabinetlari uchun App Review va Business Verification orqali Advanced Access oling.
• ▸Playground'dagi so'rovlar haqiqiy: byudjetga ta'sir qiluvchi amallar u yerda alohida tasdiq so'raydi.