Pemirsa Serupa

Targetkan orang-orang yang paling mirip dengan pelanggan Anda yang sudah mapan. Pemirsa serupa mengambil beberapa kelompok orang sebagai "seed", kemudian Facebook membangun pemirsa serupa. Anda dapat menggunakan kemiripan ini untuk tujuan bisnis apa pun: Menargetkan orang-orang yang serupa dengan pelanggan Anda untuk akuisisi penggemar, pendaftaran situs, pembelian di luar Facebook, klaim kupon, atau sekadar untuk mendorong brand awareness.

Pemirsa seed dapat berupa:

Facebook menyegarkan anggota serupa setiap 3 hari jika yang serupa itu milik grup iklan.

Membuat

Pemirsa serupa dapat membutuhkan waktu 1-6 jam untuk terisi penuh. Saat pemirsa bertambah, Anda dapat membuat dan menjalankan set iklan yang menargetkan pemirsa. Setelah pemirsa siap, Facebook mengirimkan ke orang-orang yang terkumpul dalam pemirsa dan pengiriman iklan akan menyusul dan berfungsi seperti biasa. Lihat Status Penayangan. Buat pemirsa serupa baru di: https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences.

Contoh panggilan pembuatan untuk yang serupa dari pemirsa khusus:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::NAME => 'My lookalike audience',
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::ORIGIN_AUDIENCE_ID => <SEED_AUDIENCE_ID>,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'type' => 'similarity',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.origin_audience_id: '<SEED_AUDIENCE_ID>',
    CustomAudience.Field.lookalike_spec: {
        'type': 'similarity',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F 'lookalike_spec={"type":"similarity","country":"US"}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Untuk membuat pemirsa serupa dengan SDK Iklan PHP atau SDK Iklan Python, gunakan CustomAudience.

Tanggapannya berisi:

Nama Deskripsi

id

jenis: bilangan bulat

ID pemirsa serupa

Serupa Pemirsa Khusus

Jika Anda memiliki Pemirsa Khusus dengan setidaknya 100 orang, Anda dapat pembuat pemirsa serupa berdasarkan itu. Ini termasuk Pemirsa Khusus untuk Situs Web Anda dan Pemirsa Khusus untuk Aplikasi Seluler Anda.

Nama Deskripsi

name

jenis: string

Wajib.

Nama Pemirsa Khusus

origin_audience_id

jenis: long

Wajib.

ID Pemirsa Khusus. Pemirsa asal harus memiliki setidaknya 100 anggota.

lookalike_spec

jenis: array

Wajib.

Lihat deskripsi di bawah.

lookalike_spec.type

jenis: string

Wajib. Atur type atau ratio.

similarity atau reach

lookalike_spec.starting_ratio

jenis: float

Opsional.

Mulai persentase untuk serupa. Contoh: starting_ratio 0,01 dan ratio 0.02 membuat serupa dari 1% sampai 2% dari segmen serupa. starting_ratio harus kurang dari rasio

lookalike_spec.ratio

jenis: float

Wajib. Atur type atau ratio.

0.01-0.20 inkremental sebesar 0,01. x% teratas dari pemirsa asli di negara yang dipilih

lookalike_spec.allow_international_seeds

jenis: boolean

Opsional.

Setidaknya 100 anggota pemirsa seed dari suatu negara. Jika tidak, allow_international_seeds diatur ke true artinya Facebook menemukan jumlah minimum penonton di negara lain. Default false.

lookalike_spec.country

jenis: string

Wajib. Atur country atau location_spec.

Temukan anggota pemirsa serupa di negara ini

lookalike_spec.location_spec

jenis: array

Wajib. country atau location_spec.

Temukan anggota pemirsa di lokasi-lokasi ini. Daftar negara atau grup negara seperti Asia

lookalike_spec.location_spec.geo_locations

jenis: array

Wajib. Setidaknya satu entri di bawah countries atau country_groups.

Sertakan lokasi-lokasi ini

lookalike_spec.location_spec.geo_locations.countries

jenis: array string

Opsional.

Targetkan negara-negara. Array kode negara, lihat API Pencarian Penargetan, Negara. Contoh: 'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

jenis: array string

Opsional.

Targetkan negara-negara di kawasan global dan kawasan perdagangan bebas. Array kode grup negara. Untuk opsi lengkap, lihat Penargetan, Lokasi, country_groups dan Pencarian Penargetan, country_groups. Contoh: 'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

jenis: array

Opsional.

Lokasi yang dikecualikan

lookalike_spec.location_spec.excluded_geo_locations.countries

jenis: array string

Opsional.

Sama seperti countries di bawah geo_locations

lookalike_spec.location_spec.excluded_geo_locations.country_groups

jenis: array string

Opsional.

Sama seperti country_groups di bawah geo_locations

Jenis

Optimalkan pemirsa Anda untuk "Kemiripan" atau "Jangkauan lebih luas".

  • Kemiripan - Pemirsa mencakup 1% orang teratas di negara tertentu yang paling mirip dengan Pemirsa Khusus seed. Jangkauan pemirsa baru lebih kecil, pencocokan lebih tepat.
  • Jangkauan Lebih Luas - Pemirsa mencakup 5% teratas orang-orang di negara yang dipilih yang mirip dengan Pemirsa Khusus seed, tetapi dengan kecocokannya tidak begitu tepat.

Alih-alih menggunakan jenis, Anda dapat secara manual mengatur ratio untuk mewakili x% teratas dari pemirsa di negara yang dipilih.ratio seharusnya dari 1%-20% dan dalam interval 1%.

Serupa Konversi Kampanye atau Set Iklan

Facebook memiliki serupa konversi kampanye dan set iklan untuk menargetkan orang-orang yang mirip dengan mereka yang berkonversi dari kampanye atau set iklan sebelumnya atau saat ini; contoh: kampanye atau iklan yang mengoptimalkan konversi. Kami mengukur konversi berdasarkan kampanye atau jenis set iklan di Spesifikasi Konversi. Contoh: menargetkan orang-orang yang melakukan tindakan di situs Anda atau menginstal aplikasi Anda dalam 28 hari sejak mengeklik iklan Anda.

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'origin_ids' => <CAMPAIGN_ID>,
    'starting_ratio' => 0.03,
    'ratio' => 0.05,
    'conversion_type' => 'campaign_conversions',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'origin_ids': '<CAMPAIGN_ID>',
        'starting_ratio': 0.03,
        'ratio': 0.05,
        'conversion_type': 'campaign_conversions',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "origin_ids": "<CAMPAIGN_ID>", 
    "starting_ratio": 0.03, 
    "ratio": 0.05, 
    "conversion_type": "campaign_conversions", 
    "country": "US" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Anda membutuhkan setidaknya 100 konversi unik dari kampanye atau set iklan Anda. Makin banyak konverter menghasilkan model prediksi yang lebih baik dan kami menyarankan 200 atau lebih anggota yang berkonversi. Anda juga harus memilih kampanye atau set iklan dengan tujuan serupa.

Untuk membuat tampilan serupa ini, tentukan satu atau beberapa kampanye atau set iklan Anda. Contoh: tentukan satu kampanye dan dua set iklan dari kampanye lainnya.

Facebook menggunakan hingga 180 hari data konversi sebelumnya dan mengidentifikasi orang-orang yang berkonversi pada kampanye dan set iklan Anda sebagai contoh. Kami melatih model prediksi, lalu membuat pemirsa serupa. Facebook terus memperbarui model prediksi yang mendasarinya saat kampanye atau set iklan mendapatkan konversi baru.

Nama Deskripsi

lookalike_spec

jenis: array

Wajib.

Lihat deskripsi di bawah.

lookalike_spec.origin_ids

jenis: array bilangan bulat

Wajib.

Array ID objek iklan. Orang-orang yang berkonversi dari iklan ini terbiasa dengan model serupa. Satu atau beberapa ID kampanye atau ID set iklan, atau campurannya.

lookalike_spec.conversion_type

jenis: string

Wajib.

campaign_conversions. Menunjukkan pemirsa adalah konversi kampanye serupa

lookalike_spec.country

jenis: string

Wajib.

Negara untuk menemukan anggota serupa.

lookalike_spec.allow_international_seeds

jenis: boolean

Opsional.

Setidaknya 100 anggota pemirsa seed dari suatu negara. Jika tidak, allow_international_seeds diatur ke true artinya Facebook menemukan jumlah minimum anggota ini di negara lain. Default-nya false.

lookalike_spec.starting_ratio

jenis: float

Opsional.

Mulai persentase untuk serupa. Contoh: starting_ratio 0,01 dan ratio 0,02 membuat serupa dari 1% to 2% dari segmen serupa. starting_ratio harus kurang dari ratio

lookalike_spec.ratio

jenis: float

Wajib.

Kisaran 0.01-0.20. X% teratas dari pemirsa asli di negara yang dipilih.

Saat ini, jenis konversi kampanye berikut memenuhi syarat untuk Pemirsa Serupa:

  • Klik tautan
  • Iklan promo
  • Suka Halaman
  • Instalasi Aplikasi Canvas
  • Tanggapan acara
  • Interaksi postingan
  • Konversi situs web
  • Instalasi aplikasi seluler
  • Interaksi aplikasi seluler
  • Tayangan video
  • Kesadaran lokal

Serupa Penggemar Halaman

Buat pemirsa serupa berdasarkan orang yang menyukai Halaman Anda:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'ratio' => 0.01,
    'country' => 'US',
    'page_id' => <PAGE_ID>,
    'conversion_type' => 'page_like',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'ratio': 0.01,
        'country': 'US',
        'page_id': '<PAGE_ID>',
        'conversion_type': 'page_like',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "ratio": 0.01, 
    "country": "US", 
    "page_id": "<PAGE_ID>", 
    "conversion_type": "page_like" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Nama Deskripsi

lookalike_spec

jenis: array

Wajib.

Lihat deskripsi di bawah.

lookalike_spec.page_id

jenis: int

Wajib.

ID Facebook halaman yang penggemarnya akan digunakan untuk serupa

lookalike_spec.conversion_type

jenis: string

Wajib.

page_like - Menunjukkan bahwa ini serupa penggemar halaman

lookalike_spec.country

jenis: string

Wajib.

Negara untuk menemukan orang-orang serupa. Default-nya 'US'

lookalike_spec.allow_international_seeds

jenis: boolean

Opsional.

Anda membutuhkan setidaknya 100 anggota pemirsa seed dari suatu negara. Jika minimum ini tidak terpenuhi, allow_international_seeds diatur ke true artinya Facebook menemukan jumlah minimum pemirsa seed di negara lain. Default-nya false.

lookalike_spec.starting_ratio

jenis: float

Opsional.

Persentase awal untuk serupa. Contoh: starting_ratio 0,01 dan rasio 0,02 akan membuat serupa dari 1% sampai 2% segmen serupa. Nilai starting_ratio harus selalu lebih kecil dari rasio

lookalike_spec.ratio

jenis: float

Wajib.

Kisaran 0,01-0,20. Berapa banyak negara yang harus ditargetkan oleh serupa.

Penargetan

Penargetan serupa adalah sama seperti penargetan Pemirsa Khusus. Lihat Pemirsa Khusus, Penargetan. Ini juga berlaku untuk penargetan pengecualian dan penargetan AND konjungtif. Untuk menarget saat Anda membuat iklan:

use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdSetBillingEventValues;
use FacebookAds\Object\Values\AdSetOptimizationGoalValues;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;

$adset = new AdSet(null, 'act_<AD_ACCOUNT_ID>');
$adset->setData(array(
  AdSetFields::NAME => 'My AdSet',
  AdSetFields::OPTIMIZATION_GOAL => AdSetOptimizationGoalValues::REACH,
  AdSetFields::BILLING_EVENT => AdSetBillingEventValues::IMPRESSIONS,
  AdSetFields::BID_AMOUNT => 2,
  AdSetFields::DAILY_BUDGET => 1000,
  AdSetFields::CAMPAIGN_ID => <CAMPAIGN_ID>,
  AdSetFields::TARGETING => (new Targeting())->setData(array(
    TargetingFields::GEO_LOCATIONS => array(
      'countries' => array('US'),
    ),
    TargetingFields::CUSTOM_AUDIENCES => array(
      array(
        'id' => <LOOKALIKE_AUDIENCE_ID>,
      ),
    ),
  )),
));

$adset->create(array(
  AdSet::STATUS_PARAM_NAME => AdSet::STATUS_ACTIVE,
));
from facebookads.adobjects.adset import AdSet

adset = AdSet(parent_id='act_<AD_ACCOUNT_ID>')
adset.update({
    AdSet.Field.name: 'My Adset',
    AdSet.Field.daily_budget: 10000,
    AdSet.Field.campaign_id: '<CAMPAIGN_ID>',
    AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks,
    AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks,
    AdSet.Field.bid_amount: 150,
    AdSet.Field.daily_budget: 2000,
    AdSet.Field.targeting: {
        'geo_locations': {
            'countries': ['US'],
        },
        'custom_audiences': [
            {
                'id': <LOOKALIKE_AUDIENCE_ID>,
            },
        ],
    },
})

adset.remote_create(params={
    'status': AdSet.Status.paused,
})
AdSet adSet = new AdAccount(act_<AD_ACCOUNT_ID>, context).createAdSet()
  .setName("My AdSet")
  .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
  .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
  .setBidAmount(2L)
  .setDailyBudget(1000L)
  .setCampaignId(<CAMPAIGN_ID>)
  .setTargeting(
    new Targeting()
      .setFieldCustomAudiences(Arrays.asList(
        new IDName()
          .setFieldId(<LOOKALIKE_AUDIENCE_ID>)
      ))
      .setFieldGeoLocations(
        new TargetingGeoLocation()
          .setFieldCountries(Arrays.asList("US"))
      )
  )
  .setStatus(AdSet.EnumStatus.VALUE_ACTIVE)
  .execute();
String ad_set_id = adSet.getId();
curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "custom_audiences": [{"id":"<LOOKALIKE_AUDIENCE_ID>"}], 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Contoh lainnya ada di Spesifikasi Penargetan.

Mengelola Pemirsa

Dapatkan detail tentang pemirsa khusus yang digunakan untuk membuat serupa. Kami mengembalikan kolom yang sama seperti Pemirsa Khusus. Di bawah ini adalah contoh tanggapan untuk Pemirsa Khusus yang digunakan untuk membuat serupa. lookalike_audience_ids menentukan pemirsa serupa yang dihasilkan dari pemirsa ini.

 {
  "id": "6006164557194",
  "account_id": 12345,
  "approximate_count": 816400,
  "lookalike_audience_ids": [
    6006183285954,
    6006183285955
  ],
  "name": "Boys Apparel",
  "parent_audience_id": 0,
  "parent_category": "Custom",
  "status": "ready",
  "subtype": "CUSTOM",
  "type": 4,
  "type_name": "Advertiser Generated",
  "time_updated": 1362439491
}, 

Pemirsa serupa berisi subtype sebesar 2. Kami juga mengembalikan lookalike_spec, array dalam format ini:

Nama Deskripsi

type

jenis: string

similarity, reach, atau custom_ratio - Selalu dikembalikan

starting_ratio

jenis: float

Dikembalikan jika starting_ratio ditentukan

ratio

jenis: float

Kelipatan 0.01. Dikembalikan jika type adalah custom_ratio

country

jenis: string

Kode negara

origin

jenis: array

Lihat deskripsi di bawah.

origin.deleted

jenis: boolean

true, Dikembalikan saat aslinya dihapus

origin.id

jenis: int

ID Asli

origin.name

jenis: string

Nama asli

origin.type

jenis: string

custom_audience atau page

target_countries

jenis: array string

Semua negara yang digunakan untuk membuat pemirsa

Pemirsa lainnya di bawah yang subtype berupa LOOKALIKE:

{
 "id": "6006183285954",
 "account_id": 12345,
 "approximate_count": 1782100,
 "name": "Boys Apparel_lookalike_US_Similarity",
 "origin_audience_id": 6006567610735,
 "parent_audience_id": 0,
 "parent_category": "Custom",
 "status": "ready",
 "subtype": "LOOKALIKE",
 "type": 4,
 "type_name": "Advertiser Generated",
 "time_updated": 1362506552
},  

Status Penayangan

Setelah Anda membuat pemirsa serupa, kami mengembalikan ID Pemirsa Khusus. Diperlukan waktu sekitar satu jam untuk mengisi penuh pemirsa. Anda bisa mendapatkan statusnya di: /{lookalike_audience_ID}?fields=delivery_status. Ini mengembalikan tanggapan JSON dengan delivery_status atau kode 200 jika pemirsa mengisi:

"delivery_status": {
  "code": 200, 
  "description": "This audience is ready for use."
},

Untuk pengujian, periksa status daftar dengan Pengelola Iklan.

Untuk menghapus pemirsa serupa, Anda melakukan hal yang sama seperti yang Anda lakukan untuk Pemirsa Khusus.

Pemirsa Tidak Aktif

Pemirsa Serupa dianggap tidak aktif jika belum digunakan dalam iklan aktif selama 90 hari. Pemirsa serupa tidak aktif memiliki approximate_count, operation_status, dan delivery_estimate yang berbeda.

KolomPerubahan untuk Serupa yang Tidak Aktif

approximate_count

Anda tidak dapat mengambil ukuran. Panggilan untuk kolom ini mengembalikan -1 untuk serupa yang tidak aktif.

operation_status

450: Pemirsa serupa ini tidak aktif. Itu dapat digunakan dalam iklan tetapi tidak akan memiliki perkiraan sampai kampanye diterbitkan.
100: Jika pemirsa tidak digunakan dalam set iklan aktif selama lebih dari 2 tahun, pemirsa akan mulai kedaluwarsa. Pemirsa kedaluwarsa yang tetap tidak digunakan selama 90 hari akan dihapus.

delivery_estimate

Anda tidak dapat mengambil estimasi penayangan. Panggilan untuk kolom ini mengembalikan -1 untuk serupa yang tidak aktif. Kolom ini tersedia di bawah node Akun Iklan dan Set Iklan. Keduanya menunjukkan perilaku yang sama untuk serupa yang tidak aktif.

delete_time

Saat operation_status pemirsa telah ditandai sebagai akan kedaluwarsa (kode 100), kolom delete_time memberi tahu Anda dalam waktu Unix kapan pemirsa akan dihapus.

Anda masih dapat memulai kampanye menggunakan pemirsa serupa yang tidak aktif. Informasi estimasi jangkauan tersedia setelah iklan baru Anda diterbitkan.

Penghapusan

Untuk semua pengiklan mulai 8 Juni 2021 dan seterusnya, kami akan secara otomatis memindahkan pemirsa ke tahap "Pemirsa Kedaluwarsa" setelah mereka tidak aktif selama lebih dari dua tahun. Ini berarti bahwa setelah pemirsa memenuhi ambang batas untuk tidak digunakan dalam set iklan aktif selama lebih dari dua tahun, itu akan secara otomatis ditandai sebagai "Pemirsa Kedaluwarsa", dan kolom delete_time akan ditandai dengan perkiraan waktu penghapusan (yaitu, 90 hari sejak waktu penandaan) saat pemirsa dijadwalkan untuk dihapus.

Anda kemudian dapat menghapus pemirsa secara proaktif atau menggunakan pemirsa di set iklan aktif untuk mencegah penghapusan. Anda dapat melihat pemirsa mana yang berada dalam tahap kedaluwarsa kapan saja dengan memfilter kolom operation_status atau delete_time.

Untuk informasi selengkapnya, lihat dokumentasi Ringkasan Pemirsa Khusus.

Praktik Terbaik

  • Pemirsa Khusus Seed - Buatlah sebesar mungkin agar kami memiliki cukup data untuk menemukan orang-orang yang serupa.
  • Gabungkan Serupa - Dengan penargetan Facebook lain untuk demografi atau minat tambahan.
  • Jika pemirsa seed Anda memiliki atribut seperti jenis kelamin atau geografi, serupa yang dihasilkan mungkin tidak sesuai dengan atribut tersebut.

Perubahan Serupa yang Akan Datang

DIPERBARUI 28 APRIL 2021: Penghapusan parameter location_spec dan country dari pembuatan pemirsa serupa saat ini ditunda. Pembaruan kapan perubahan ini akan mulai berlaku akan diberitakan ke depannya.

Kami akan menghapus parameter location_spec dan country dari pembuatan pemirsa serupa. Lokasi untuk serupa tersebut akan ditentukan oleh lokasi negara dalam spesifikasi penargetan kampanye. Lokasi target tidak akan menjadi bagian dari spesifikasi pemirsa serupa. Estimasi jangkauan kampanye yang menggunakan serupa yang baru dibuat hanya akan diisi dalam beberapa jam setelah iklan diterbitkan.

Tidak akan ada dampak pada kampanye yang ada mengingat perubahan ini. Persyaratan ini hanya akan memengaruhi kampanye baru dan yang diedit.

Kami secara otomatis akan mengubah pemirsa serupa sebelumnya menjadi serupa baru tanpa lokasi target.

Perubahan Pembuatan Serupa

Perubahan parameter lokasi

Endpoint:act_{AD_ACCOUNT_ID}/customaudiences

Contoh Permintaan

curl POST \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F ‘lookalike_spec={
  "is_financial_service":false,
  "allow_international_seeds":true,
  "ratio":0.01,
  "type":"custom_ratio"}
  	’}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Parameter berikut akan diabaikan jika dilewati selama pembuatan:

  • lookalike_spec.country
  • lookalike_spec.location_spec
  • lookalike_spec.location_spec.geo_locations
  • lookalike_spec.location_spec.geo_locations.countries
  • lookalike_spec.location_spec.geo_locations.country_groups
  • lookalike_spec.location_spec.excluded_geo_locations
  • lookalike_spec.location_spec.excluded_geo_locations.countries
  • lookalike_spec.location_spec.excluded_geo_locations.country_groups

Perubahan parameter ukuran

Endpoint:act_{AD_ACCOUNT_ID}?fields=approximate_count

Tidak akan ada ukuran yang terkait dengan pemirsa serupa yang baru, dan kolom approximate_count akan mengembalikan -1 untuk semua pemirsa serupa.

Contoh Tanggapan

{
    "approximate_count": -1,
    "id": "6126486105659",
}

Status penayangan dan operasi

Endpoint:

  • {AD_ACCOUNT_ID}?fields=delivery_status
  • {AD_ACCOUNT_ID}?fields=operation_status

Kolom delivery_status untuk pemirsa serupa yang lama dengan spesifikasi lokasi akan mengembalikan 400 dengan deskripsi This audience is disabled.. Untuk pemirsa serupa yang baru, ini akan mengembalikan tanggapan 200.

Kolom operation_status akan mengembalikan notifikasi pensiun untuk pemirsa serupa yang lama dengan spesifikasi lokasi. Untuk pemirsa serupa baru, ini akan mengembalikan tanggapan deskripsi 200 dan Normal.

Lihat Pemirsa Khusus untuk informasi selengkapnya tentang kolom-kolom ini.

Perubahan untuk Set Iklan

Pembuatan dan pengeditan iklan

Kami akan secara otomatis meningkatkan iklan untuk menggunakan serupa baru jika penargetan kampanye yang ada yang berisi serupa sebelumnya diedit. Serupa legasi tidak lagi tersedia untuk digunakan dalam kampanye iklan yang baru dibuat.

Dengan menghapus spesifikasi lokasi dari pembuatan pemirsa serupa, Anda perlu mengatur target lokasi selama pembuatan Set Iklan. Mencoba membuat Set Iklan tanpa penargetan lokasi akan menyebabkan kesalahan.

Semua perubahan di atas juga akan berlaku jika pemirsa disertakan di excluded_custom_audiences, flexible_spec, dan exclusions dalam kampanye.

Endpoint:act_{AD_ACCOUNT_ID}/adsets

Contoh Permintaan

curl POST \
  -F 'targeting={
        "geo_locations":{
            "countries":["US"],
        },
        "age_min":25,
        "age_max":40,
        "custom_audiences":[{"id": <CUSTOM_AUDIENCE_ID>}]
  ‘}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Mencoba membuat Set Iklan tanpa penargetan lokasi akan menyebabkan kesalahan.

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342134,
    "is_transient": false,
    "error_user_title": "Missing Location while using Lookalike",
    "error_user_msg": "You need to use a location with your lookalike    audience.",
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

Jika Anda mencoba untuk mengedit Set Iklan yang berisi serupa legasi bersama dan tidak memiliki serupa baru yang sesuai di akun iklan pemilik, kesalahan akan terjadi. Minta akun iklan pemilik berbagi pemirsa serupa dengan Anda untuk menyelesaikan masalah.

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342135,
    "is_transient": false,
    "error_user_title": "",
    "error_user_msg": "Please ask the owner of the audience 1234 to share the new lookalike which does not contain location with you. You will be able to use the new audience"
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

Berbagi pemirsa serupa

Selama periode peluncuran perubahan ini, berbagi serupa di antara akun iklan dalam peluncuran dan akun iklan yang tidak dalam peluncuran tidak didukung melalui API. Gunakan Pengelola Pemirsa untuk menangani pembagian. Setelah 24 Mei 2021, Anda dapat terus menggunakan berbagi melalui API di dokumen developer berikut untuk berbagi pemirsa serupa baru di antara akun iklan.

Endpoint:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}

Perubahan estimasi jangkauan dan penayangan

Endpoint:

  • act_{AD_ACCOUNT_ID}/reachestimate
  • act_{AD_ACCOUNT_ID}/delivery_estimate

Endpoint ini akan mengembalikan parameter targeting_status baru dengan salah satu deskripsi berikut:

  • lookalike_container_without_country — Serupa baru tidak memiliki negara yang ditentukan dalam penargetan kampanye. Sebuah negara diperlukan untuk melihat estimasi jumlah pengguna.
  • lookalike_container_without_delivery_lookalike — Serupa baru tidak memiliki serupa backend yang sesuai. Serupa baru perlu digunakan dalam Set Iklan agar benar-benar memiliki jangkauan.
  • none — Tidak ada masalah dengan jangkauan.

Endpoint reachestimate akan mengembalikan -1 untuk parameter users pertama kali pemirsa serupa baru dan target negara digunakan; setelah itu estimasi jumlah pengguna akan dikembalikan.

Parameter estimate_dau dan estimate_mau akan mengembalikan -1 untuk parameter users saat pertama kali pemirsa serupa baru dan target negara digunakan; setelah itu estimasi jumlah pengguna akan dikembalikan.

Contoh Tanggapan

// Reach estimate response
{
    "users": -1,
    "estimate_ready": true,
    "targeting_status": "lookalike_container_without_delivery_lookalike"
}

// Delivery estimate response

{
    "data": [{
        "daily_outcomes_curve": [{
            "spend": 0,
            "reach": 0,
            "impressions": 0,
            "actions": 0
        }],
        "estimate_dau": -1,
        "estimate_mau": -1,
        "estimate_ready": true ,
        "targeting_status": "lookalike_container_without_delivery_lookalike"
    }]
}

Pertanyaan Umum

Perubahan ini berlaku mulai tanggal rilis Marketing API v11, saat kami menerapkan perubahan ke semua versi.

Selama periode antara Marketing API v10 dan v11, berbagi serupa di antara akun iklan dalam peluncuran dan akun iklan yang tidak dalam peluncuran tidak didukung melalui API. Gunakan Pengelola Pemirsa untuk menangani pembagian. Setelah rilis Marketing API v11, Anda dapat terus menggunakan berbagi melalui API untuk berbagi pemirsa serupa baru di antara akun iklan.