استهدف الأشخاص الذين يشبهون كثيرًا عملاءك القدامى. تأخذ الجماهير المشابهة عدة مجموعات من الأشخاص "كجماهير مصدر" ثم يقوم Facebook بتكوين جمهور من الأشخاص المشابهين. ويمكنك استخدام الجماهير المشابهة لدعم أحد أهداف الأنشطة التجارية: استهداف أشخاص مشابهين لعملائك بغرض اكتساب مُعجبين أو تسجيل الموقع أو تنفيذ عمليات الشراء خارج Facebook أو المطالبات بالقسيمة أو لمجرد زيادة الوعي بعلامة تجارية.
قد تكون جماهير المصدر ما يلي:
يُحدّث Facebook الأعضاء في الجمهور المشابه كل 3 أيام إذا كان الجمهور المشابه ينتمي إلى مجموعة إعلانات.
يمكن أن تستغرق تعبئة الجماهير المشابهة بالكامل من ساعة إلى 6 ساعات. أثناء تعبئة الجماهير، يمكنك إنشاء مجموعات إعلانية تستهدف الجمهور وتشغيلها. حين يكون الجمهور جاهزًا، يقوم Facebook بعرض الإعلانات على الأشخاص الذين تمت تعبئتهم بالجمهور ويستمر عرض الإعلانات بصورة طبيعية. ويمكنك الرجوع إلى حالة العرض. ويمكنك إنشاء جمهور مشابه جديد من خلال: https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences
.
مثال على استدعاء إنشاء جمهور مشابه من جمهور مخصص:
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
لإنشاء جماهير مشابهة من خلال مجموعة SDK للإعلانات بلغة PHP أو مجموعة SDK للإعلانات بلغة Python، استخدم CustomAudience
.
تتضمن الاستجابة ما يلي:
الاسم | الوصف |
---|---|
النوع: integer (عدد صحيح) | معرف الجمهور المشابه |
إذا كان لديك جمهور مخصص به لا يقل عن 100 شخص، فيمكنك تكوين جماهير مشابهة استنادًا إليه. وهذا يشمل الجماهير المخصصة لموقعك على الويب والجماهير المخصصة لتطبيق الهواتف المحمولة الخاص بك.
الاسم | الوصف |
---|---|
النوع: string (سلسلة) | مطلوب. اسم الجمهور المخصص |
النوع: long (طويل) | مطلوب. معرف الجمهور المخصص. يجب أن تضم الجماهير الأصلية ما لا يقل عن 100 عضو. |
النوع: array (مصفوفة) | مطلوب. يمكنك الرجوع إلى الوصف أدناه. |
النوع: string (سلسلة) | مطلوب. قم بتعيين
|
النوع: float (رقم عشري) | اختياري. يمثل النسبة المئوية للبدء لدى الجمهور المشابه. فعلى سبيل المثال، ينشئ |
النوع: float (رقم عشري) | مطلوب. قم بتعيين
|
النوع: boolean (قيمة منطقية) | اختياري. 100 عضو على الأقل من جمهور المصدر من أحد البلدان. وإذا لم يتوفر، فيعني تعيين |
النوع: string (سلسلة) | مطلوب. قم بتعيين البحث عن أعضاء جمهور مشابه في هذا البلد |
النوع: array (مصفوفة) | مطلوب. إما البحث عن جمهور مشابه في هذه المواقع. وتتوفر قائمة البلدان أو مجموعات البلدان مثل |
النوع: array (مصفوفة) | مطلوب. إدخال واحد على الأقل ضمن إدراج هذه المواقع |
اكتب: مصفوفة السلاسل | اختياري. استهداف بلدان. مصفوفة تضم أكواد البلدان، ويمكنك الرجوع إلى واجهة API الاستهداف بمعايير البحث، البلدان. المثال: |
النوع: array of strings (مصفوفة السلاسل) | اختياري. استهداف بلدان في المناطق العالمية ومناطق التجارة الحرة. مصفوفة تضم رموزًا لمجموعات بلدان. للحصول على الخيارات الكاملة، يمكنك الرجوع إلى الاستهداف والموقع، |
النوع: array (مصفوفة) | اختياري. المواقع المطلوب استبعادها |
النوع: array of strings (مصفوفة السلاسل) | اختياري. يتطابق مع |
النوع: array of strings (مصفوفة السلاسل) | اختياري. يتطابق مع |
حسِّن جمهورك من خلال "التشابه" أو "الوصول الأكبر".
بدلًا من استخدام الأنواع، يمكنك يدويًا تعيين ratio
لتمثل أبرز x% من الجمهور في البلد المحدد. ويجب أن تتراوح ratio
من 1% إلى 20% بفواصل زمنية بنسبة 1%.
يتضمن Facebook تشابهات لتحويلات حملات إعلانية وتحويلات مجموعات إعلانية لاستهداف أشخاص مشابهين لهؤلاء المحولين من حملات إعلانية سابقة أو حالية أو مجموعات إعلانية سابقة أو حالية؛ على سبيل المثال، الحملات الإعلانية أو الإعلانات التي تستمر في التحسين من أجل التحويلات. نقيس التحويلات بناءً على نوع الحملة الإعلانية أو نوع المجموعة الإعلانية في مواصفات التحويل. على سبيل المثال، استهداف الأشخاص الذين يتخذون إجراءات بخصوص موقع الويب الخاص بك أو الذين ثبتوا تطبيقك في غضون 28 يومًا من النقر على إعلانك.
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
تحتاج إلى ما لا يقل عن 100 تحويل فريد من حملاتك الإعلانية أو مجموعاتك الإعلانية. تؤدي زيادة عدد المحولين إلى وضع تنبؤي أفضل ونحن نقترح 200 عضو أو أكثر من الأعضاء الذين قاموا بالتحويل. كما ينبغي لك تحديد حملات إعلانية أو مجموعات إعلانية ذات أهداف مشابهة.
لإنشاء هذا الجمهور المشابه، حدد واحدة أو أكثر من حملاتك الإعلانية أو مجموعاتك الإعلانية. على سبيل المثال، حدد حملة إعلانية واحدة ومجموعتين إعلانيتين لحملة أخرى.
يستخدم Facebook بيانات ما يصل إلى 180 يومًا من بيانات التحويل السابقة ويحدد الأشخاص المحولين على حملاتك الإعلانية ومجموعاتك الإعلانية كأمثلة. نحن نقوم بإعداد نموذج توقع ثم ننشئ جمهورًا مشابهًا. ويواصل Facebook تحديث نموذج التوقع الأساسي كلما اكتسبت الحملات الإعلانية أو المجموعات الإعلانية تحويلات جديدة.
الاسم | الوصف |
---|---|
النوع: array (مصفوفة) | مطلوب. يمكنك الرجوع إلى الوصف أدناه. |
النوع: array of integers (مصفوفة أعداد صحيحة) | مطلوب. مصفوفة تضم معرفات كائنات الإعلان. يُستخدم الأشخاص المحولون على هذه الإعلانات في تكوين جمهور مشابه. ويتوفر واحد أو أكثر من معرفات الحملات الإعلانية أو معرفات المجموعات الإعلانية أو مزيج منهما. |
النوع: string (سلسلة) | مطلوب.
|
النوع: string (سلسلة) | مطلوب. البلد المطلوب البحث فيه عن أعضاء جمهور مشابه. |
النوع: boolean (قيمة منطقية) | اختياري. 100 عضو على الأقل من جمهور المصدر الوارد من أحد البلدان. وإذا لم يتوفر، فيعني تعيين |
النوع: float (رقم عشري) | اختياري. النسبة المئوية للبدء لدى الجمهور المشابه. فعلى سبيل المثال، ينشئ |
النوع: float (رقم عشري) | مطلوب. نطاق يتراوح من |
تكون أنواع تحويلات الحملات الإعلانية التالية مؤهلة لاستخدام الجماهير المشابهة في الوقت الحالي:
يمكنك إنشاء جمهور مشابه استنادًا إلى الأشخاص الذين أبدوا الإعجاب بصفحتك:
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
الاسم | الوصف |
---|---|
النوع: array (مصفوفة) | مطلوب. يمكنك الرجوع إلى الوصف أدناه. |
النوع: int (عدد صحيح) | مطلوب. معرف Facebook للصفحة التي سيُستخدم معجبوها للجمهور المشابه |
النوع: string (سلسلة) | مطلوب.
|
النوع: string (سلسلة) | مطلوب. البلد المطلوب البحث فيه عن أشخاص مشابهين. البلد الافتراضي هو الولايات المتحدة |
النوع: boolean (قيمة منطقية) | اختياري. تحتاج إلى ما لا يقل عن 100 عضو من جمهور المصدر من أحد البلدان. وإذا لم يتم استيفاء هذا الحد الأدنى، فيعني تعيين |
النوع: float (رقم عشري) | اختياري. نسبة البدء المئوية للجمهور المشابه. على سبيل المثال، starting_ratio (نسبة البدء) 0.01 وratio (النسبة) 0.02 ينشئان جمهورًا مشابهًا من شريحة الجمهور المشابه التي من 1% إلى 2%. يجب أن تكون قيمة starting_ratio دائمًا أقل من ratio |
النوع: float (رقم عشري) | مطلوب. نطاق 0.01-0.20. المقدار المطلوب استهدافه بالجمهور المشابه في البلد. |
يتطابق استهداف الجماهير المشابهة مع استهداف الجماهير المخصصة. ويمكنك الرجوع إلى الجماهير المخصصة، الاستهداف. وينطبق ذلك أيضًا على استهداف الاستبعاد واستهداف العطف باستخدام AND
. للاستهداف أثناء إنشائك الإعلان:
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
تتوفر أمثلة أخرى على مواصفات الاستهداف.
يمكنك الحصول على تفاصيل حول الجماهير المخصصة المستخدمة في إنشاء جماهير مشابهة بالإضافة إلى تفاصيل حول الجماهير المشابهة. ونقوم بإرجاع الحقول نفسها كما هو الحال في الجماهير المخصصة. ويتوفر أدناه عينة من استجابة جمهور مخصص مُستخدم في إنشاء جماهير مشابهة. وتحدد المعلمة lookalike_audience_ids
الجماهير المشابهة التي تم إنشاؤها من هذا الجمهور.
{ "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 },
تحتوي الجماهير المشابهة على subtype
بالقيمة 2. ونقوم أيضًا بإرجاع lookalike_spec
وهي مصفوفة بهذا التنسيق:
الاسم | الوصف |
---|---|
النوع: string (سلسلة) | يتم إرجاع القيم |
النوع: float (رقم عشري) | يتم الإرجاع في حالة تحديد |
النوع: float (رقم عشري) | يمثل مضاعفات |
النوع: string (سلسلة) | رمز البلد |
النوع: array (مصفوفة) | يمكنك الرجوع إلى الوصف أدناه. |
النوع: boolean (قيمة منطقية) | يتم إرجاع |
النوع: int (عدد صحيح) | معرف الأصل |
النوع: string (سلسلة) | اسم الأصل |
النوع: string (سلسلة) |
|
النوع: array of strings (مصفوفة السلاسل) | جميع البلدان المستخدمة في إنشاء جمهور |
يتوفر أدناه جمهور آخر حيث يكون subtype
بالقيمة 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 },
بعد ما تنشئ جمهورًا مشابهًا، نقوم بإرجاع معرف جمهور مخصص. قد تستغرق تعبئة الجمهور بشكلٍ كامل حوالي ساعة واحدة. ويمكنك الحصول على الحالة من خلال: /{lookalike_audience_ID}?fields=delivery_status
. ويعمل ذلك على إرجاع استجابة بلغة JSON بالحالة delivery_status
أو الرمز 200 في حالة تعبئة الجمهور:
"delivery_status": { "code": 200, "description": "This audience is ready for use." },
بالنسبة للاختبار، يجب التحقق من حالة القائمة من خلال مدير الإعلانات.
لحذف جمهور مشابه، يمكنك إجراء ذلك بالطريقة نفسها التي تستخدمها مع الجماهير المخصصة.
يتم اعتبار الجمهور المشابه أنهه جمهور غير نشط عندما لا يتم استخدامه في الإعلانات النشطة لمدة 90 يومًا. وتتوفر لدى الجماهير المشابهة غير النشطة قيم approximate_count
وoperation_status
وdelivery_estimate
مختلفة.
الحقل | التغييرات الطارئة على الجماهير المشابهة غير النشطة |
---|---|
| لا يمكنك استعادة الحجم. وسيؤدي إجراء استدعاء لهذا الحقل إلى إرجاع القيمة |
|
|
| لا يمكنك استعادة النسبة التقديرية للعرض. وسيؤدي إجراء استدعاء لهذا الحقل إلى إرجاع القيمة |
| عند وضع علامة على |
لا يزال بإمكانك بدء حملة إعلانية باستخدام جمهور مشابه غير نشط. وتتوفر معلومات حول النسبة التقديرية للوصول بعد نشر إعلانك الجديد.
بالنسبة لكل المعلنين ابتداءً من 8 يونيو 2021 فصاعدًا، سنقوم بنقل الجماهير تلقائيًا إلى مرحلة "جمهور منتهي الصلاحية" بمجرد أن يصبحوا غير نشطين لأكثر من عامين. وهذا يعني أنه بمجرد أن يبلغ الجمهور حد عدم الاستخدام في مجموعة إعلانية نشطة لمدة عامين، فسيتم تمييزه على أنه "جمهور منتهي الصلاحية" وسيتم وضع علامة على الحقل delete_time
بوقت الحذف المقدر (على سبيل المثال، 90 يومًا من وقت التمييز) وموعد جدولة الجمهور للحذف.
ستتمكن بعد ذلك من اختيار حذف الجمهور بشكل استباقي أو استخدام الجمهور في مجموعة إعلانية نشطة لمنع الحذف. يمكنك معرفة الجماهير الموجودة في مرحلة انتهاء الصلاحية في أي وقت عن طريق الفلترة في الحقلين operation_status
أو delete_time
.
لمزيد من المعلومات، اطّلع على وثائق نظرة عامة على الجماهير المخصصة.
تم التحديث في 28 أبريل 2021: يتم حاليًا تأخير إزالة المعلمتين location_spec
وcountry
من عملية إنشاء الجمهور المشابه. ستتوفر تحديثات حول موعد سريان هذا التغيير في وقت قريب.
سنعمل على إزالة المعلمتين location_spec
وcountry
من عملية إنشاء الجمهور المشابه. وسيتم تحديد موقع الجماهير المشابهة حسب موقع البلد الموجود ضمن مواصفات استهداف الحملة الإعلانية. ولن يكون الموقع المستهدف جزءًا من مواصفات الجمهور المشابه. كما ستتم تعبئة القيمة التقديرية للوصول التابع للحملة الإعلانية التي تستخدم جمهورًا مشابهًا تم إنشاؤه حديثًا في غضون ساعات قليلة فقط بعد نشر الإعلان.
لن يكون هناك أي تأثير على الحملات الإعلانية الحالية عند إجراء هذا التغيير. وسيؤثر هذا المتطلب فقط على الحملات الإعلانية الجديدة والمُعدلة.
سنعمل تلقائيًا على تحويل الجماهير المشابهة القديمة إلى جماهير مشابهة جديدة بدون استهداف المواقع.
نقطة النهاية:act_{AD_ACCOUNT_ID}/customaudiences
مثال على الطلب
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
سيتم تجاهل المعلمات التالية إذا تم إدخالها أثناء عملية الإنشاء:
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
نقطة النهاية:act_{AD_ACCOUNT_ID}?fields=approximate_count
لن يتوفر حجم مرتبط بالجماهير المشابهة الجديدة، وسيؤدي الحقل approximate_count
إلى إرجاع القيمة -1
لجميع الجماهير المشابهة.
مثال على الاستجابات
{ "approximate_count": -1, "id": "6126486105659", }
نقاط النهاية:
{AD_ACCOUNT_ID}?fields=delivery_status
{AD_ACCOUNT_ID}?fields=operation_status
سيعمل الحقل delivery_status
لدى الجماهير المشابهة القديمة التي يتوفر لديها مواصفات الموقع على إرجاع الرمز 400
مع الوصف This audience is disabled.
. وبالنسبة للجماهير المشابهة الجديدة، فسيتم إرجاع استجابة بالرمز 200
.
سيعمل الحقل operation_status
على إرجاع إشعار بالتوقف بالنسبة للجماهير المشابهة القديمة التي يتوفر لديها مواصفات الموقع. وبالنسبة للجماهير المشابهة الجديدة، فسيتم إرجاع استجابة بالرمز 200
والوصف Normal
.
لمزيد من المعلومات حول هذه الحقول، يمكنك الرجوع إلى الجماهير المخصصة.
سنعمل على ترقية الإعلانات تلقائيًا لاستخدام الجماهير المشابهة الجديدة إذا تم تعديل استهداف الحملات الإعلانية الحالية التي تحتوي على جمهور مشابه قديم. ولن يتوفر الجمهور المشابه القديم بعد الآن لاستخدامه في الحملات الإعلانية التي تم إنشاؤها حديثًا.
عند إزالة مواصفات الموقع من عملية إنشاء الجمهور المشابه، ستحتاج إلى تعيين عمليات استهداف الموقع أثناء إنشاء المجموعة الإعلانية. وستؤدي محاولة إنشاء مجموعة إعلانية بدون استهداف الموقع إلى حدوث خطأ.
ستنطبق جميع التغييرات السابقة أيضًا عند تضمين الجماهير في excluded_custom_audiences
وflexible_spec
وexclusions
داخل الحملة الإعلانية.
نقطة النهاية:act_{AD_ACCOUNT_ID}/adsets
مثال على الطلب
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
وستؤدي محاولة إنشاء مجموعة إعلانية بدون استهداف الموقع إلى حدوث خطأ.
{ "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" }
إذا كنت تحاول تعديل مجموعة إعلانية تحتوي على جمهور مشابه قديم تمت مشاركته ولم يكن لديك جمهور مشابه جديد مقابل في الحساب الإعلاني المالك، فسيحدث خطأ. ويمكنك مطالبة الحساب الإعلاني المالك بمشاركة الجمهور المشابه الجديد معك لحل المشكلة.
{ "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" }
خلال فترة طرح هذه التغييرات، لا يتم دعم مشاركة الجماهير المشابهة بين الحسابات الإعلانية الموجودة ضمن نطاق الطرح والحسابات الإعلانية الموجودة خارج نطاق الطرح عبر واجهة API. لذا يرجى استخدام مدير الجماهير لإجراء عملية المشاركة. وبعد 24 مايو 2021، يمكنك متابعة استخدام المشاركة عبر واجهة API في مستند المطوّر التالي لمشاركة الجماهير المشابهة الجديدة بين الحسابات الإعلانية.
نقطة النهاية:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}
نقاط النهاية:
act_{AD_ACCOUNT_ID}/reachestimate
act_{AD_ACCOUNT_ID}/delivery_estimate
ستعمل نقاط النهاية هذه على إرجاع معلمة targeting_status
جديدة تتضمن أحد الأوصاف التالية:
lookalike_container_without_country
— لا يتوفر بلد محدد لدى الجمهور المشابه الجديد ضمن استهداف الحملة الإعلانية. ويلزم تحديد البلد لمعرفة العدد التقديري للمستخدمين.lookalike_container_without_delivery_lookalike
— لا يتوفر لدى الجمهور المشابه الجديد جمهور مشابه قديم مقابل. ويجب استخدام الجمهور المشابه الجديد ضمن مجموعة إعلانية حتى يمكن الوصول إليه بالفعل.none
— لا توجد مشكلة في الوصول.ستعمل نقطة النهاية reachestimate
على إرجاع القيمة -1
للمعلمة users
في المرة الأولى التي يتم فيها استخدام جمهور مشابه جديد واستهداف البلد؛ وسيتم بعد ذلك إرجاع العدد التقديري للمستخدمين.
ستعمل المعلمتان estimate_dau
وestimate_mau
على إرجاع القيمة -1
للمعلمة users
في المرة الأولى التي يتم فيها استخدام جمهور مشابه جديد واستهداف البلد؛ وسيتم بعد ذلك إرجاع العدد التقديري للمستخدمين.
أمثلة على الاستجابات
// 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" }] }
سيتم تفعيل هذه التغييرات في تاريخ طرح واجهة API التسويق بالإصدار 11 عندما نطبق التغيير على جميع الإصدارات.
خلال الفترة بين واجهة API التسويق بالإصدار 10 والإصدار 11، لا يتم دعم مشاركة الجماهير المشابهة بين الحسابات الإعلانية الموجودة ضمن نطاق الطرح والحسابات الإعلانية الموجودة خارج نطاق الطرح عبر واجهة API. لذا يرجى استخدام "مدير الجمهور" لإجراء عملية المشاركة. وبعد طرح واجهة API التسويق بالإصدار 11، يمكنك متابعة استخدام المشاركة عبر واجهة API لمشاركة الجماهير المشابهة الجديدة بين الحسابات الإعلانية.