الجماهير المشابهة

استهدف الأشخاص الذين يشبهون كثيرًا عملاءك القدامى. تأخذ الجماهير المشابهة عدة مجموعات من الأشخاص "كجماهير مصدر" ثم يقوم 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.

تتضمن الاستجابة ما يلي:

الاسم الوصف

id

النوع: integer (عدد صحيح)

معرف الجمهور المشابه

جمهور مشابه من جمهور مخصص

إذا كان لديك جمهور مخصص به لا يقل عن 100 شخص، فيمكنك تكوين جماهير مشابهة استنادًا إليه. وهذا يشمل الجماهير المخصصة لموقعك على الويب والجماهير المخصصة لتطبيق الهواتف المحمولة الخاص بك.

الاسم الوصف

name

النوع: string (سلسلة)

مطلوب.

اسم الجمهور المخصص

origin_audience_id

النوع: long (طويل)

مطلوب.

معرف الجمهور المخصص. يجب أن تضم الجماهير الأصلية ما لا يقل عن 100 عضو.

lookalike_spec

النوع: array (مصفوفة)

مطلوب.

يمكنك الرجوع إلى الوصف أدناه.

lookalike_spec.type

النوع: string (سلسلة)

مطلوب. قم بتعيين type أو ratio.

similarity أو reach

lookalike_spec.starting_ratio

النوع: float (رقم عشري)

اختياري.

يمثل النسبة المئوية للبدء لدى الجمهور المشابه. فعلى سبيل المثال، ينشئ starting_ratio 0.01 وratio 0.02 جمهورًا مشابهًا من شريحة جمهور مشابه بنسبة 1% إلى 2%. ويجب أن تكون starting_ratio أقل من ratio

lookalike_spec.ratio

النوع: float (رقم عشري)

مطلوب. قم بتعيين type أو ratio.

0.01-0.20 تزايد بمعدل 0.01. أفضل x% من الجمهور الأصلي في بلد محدد

lookalike_spec.allow_international_seeds

النوع: boolean (قيمة منطقية)

اختياري.

100 عضو على الأقل من جمهور المصدر من أحد البلدان. وإذا لم يتوفر، فيعني تعيين allow_international_seeds إلى true أن Facebook يبحث في بلد آخر عن الحد الأدنى لعدد أعضاء الجماهير. علمًا بأن القيمة الافتراضية هي false.

lookalike_spec.country

النوع: string (سلسلة)

مطلوب. قم بتعيين country أو location_spec.

البحث عن أعضاء جمهور مشابه في هذا البلد

lookalike_spec.location_spec

النوع: array (مصفوفة)

مطلوب. إما country أو location_spec.

البحث عن جمهور مشابه في هذه المواقع. وتتوفر قائمة البلدان أو مجموعات البلدان مثل Asia

lookalike_spec.location_spec.geo_locations

النوع: array (مصفوفة)

مطلوب. إدخال واحد على الأقل ضمن countries أو country_groups.

إدراج هذه المواقع

lookalike_spec.location_spec.geo_locations.countries

اكتب: مصفوفة السلاسل

اختياري.

استهداف بلدان. مصفوفة تضم أكواد البلدان، ويمكنك الرجوع إلى واجهة API الاستهداف بمعايير البحث، البلدان. المثال: 'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

النوع: array of strings (مصفوفة السلاسل)

اختياري.

استهداف بلدان في المناطق العالمية ومناطق التجارة الحرة. مصفوفة تضم رموزًا لمجموعات بلدان. للحصول على الخيارات الكاملة، يمكنك الرجوع إلى الاستهداف والموقع، country_groups والاستهداف بمعايير البحث، country_groups. المثال: 'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

النوع: array (مصفوفة)

اختياري.

المواقع المطلوب استبعادها

lookalike_spec.location_spec.excluded_geo_locations.countries

النوع: array of strings (مصفوفة السلاسل)

اختياري.

يتطابق مع countries ضمن geo_locations

lookalike_spec.location_spec.excluded_geo_locations.country_groups

النوع: array of strings (مصفوفة السلاسل)

اختياري.

يتطابق مع country_groups ضمن geo_locations

الأنواع

حسِّن جمهورك من خلال "التشابه" أو "الوصول الأكبر".

  • التشابه - يضم الجمهور أفضل 1% من الأشخاص في بلد محدد الأكثر شبهًا لجمهور المصدر المخصص. وصول الجمهور الجديد أقل، ولكن المطابقة أكثر دقة.
  • الوصول الأكبر - يضم الجمهور أفضل 5% من الأشخاص في بلد محدد الذين يشبهون جمهور المصدر المخصص، ولكن بمطابقة أقل دقة.

بدلًا من استخدام الأنواع، يمكنك يدويًا تعيين 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 تحديث نموذج التوقع الأساسي كلما اكتسبت الحملات الإعلانية أو المجموعات الإعلانية تحويلات جديدة.

الاسم الوصف

lookalike_spec

النوع: array (مصفوفة)

مطلوب.

يمكنك الرجوع إلى الوصف أدناه.

lookalike_spec.origin_ids

النوع: array of integers (مصفوفة أعداد صحيحة)

مطلوب.

مصفوفة تضم معرفات كائنات الإعلان. يُستخدم الأشخاص المحولون على هذه الإعلانات في تكوين جمهور مشابه. ويتوفر واحد أو أكثر من معرفات الحملات الإعلانية أو معرفات المجموعات الإعلانية أو مزيج منهما.

lookalike_spec.conversion_type

النوع: string (سلسلة)

مطلوب.

campaign_conversions. يشير إلى أن الجمهور هو جمهور مشابه لتحويل حملة إعلانية

lookalike_spec.country

النوع: string (سلسلة)

مطلوب.

البلد المطلوب البحث فيه عن أعضاء جمهور مشابه.

lookalike_spec.allow_international_seeds

النوع: boolean (قيمة منطقية)

اختياري.

100 عضو على الأقل من جمهور المصدر الوارد من أحد البلدان. وإذا لم يتوفر، فيعني تعيين allow_international_seeds إلى true أن Facebook يبحث في بلد آخر عن الحد الأدنى لعدد الأعضاء. علمًا بأنه يتم تعيين القيمة الافتراضية إلى false.

lookalike_spec.starting_ratio

النوع: float (رقم عشري)

اختياري.

النسبة المئوية للبدء لدى الجمهور المشابه. فعلى سبيل المثال، ينشئ starting_ratio 0.01 وratio 0.02 جمهورًا مشابهًا من شريحة جمهور مشابه بنسبة 1% إلى 2%. ويجب أن تكون starting_ratio أقل من ratio

lookalike_spec.ratio

النوع: float (رقم عشري)

مطلوب.

نطاق يتراوح من 0.01 إلى 0.20. أفضل x% من الجمهور الأصلي في البلد المحدد.

تكون أنواع تحويلات الحملات الإعلانية التالية مؤهلة لاستخدام الجماهير المشابهة في الوقت الحالي:

  • النقرات على الروابط
  • إعلانات العروض
  • تسجيلات الإعجاب بالصفحة
  • عمليات تثبيت تطبيق اللوحة
  • الاستجابة لمناسبة
  • التفاعل مع المنشور
  • التحويلات على موقع الويب
  • عمليات تثبيت تطبيقات الهواتف المحمولة
  • التفاعل مع تطبيق الهواتف المحمولة
  • مشاهدات الفيديو
  • الوعي المحلي

جماهير مشابهة للمعجبين بالصفحة

يمكنك إنشاء جمهور مشابه استنادًا إلى الأشخاص الذين أبدوا الإعجاب بصفحتك:

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
الاسم الوصف

lookalike_spec

النوع: array (مصفوفة)

مطلوب.

يمكنك الرجوع إلى الوصف أدناه.

lookalike_spec.page_id

النوع: int (عدد صحيح)

مطلوب.

معرف Facebook للصفحة التي سيُستخدم معجبوها للجمهور المشابه

lookalike_spec.conversion_type

النوع: string (سلسلة)

مطلوب.

page_like - يشير إلى أن هذا جمهور مشابه من المُعجبين بالصفحة

lookalike_spec.country

النوع: string (سلسلة)

مطلوب.

البلد المطلوب البحث فيه عن أشخاص مشابهين. البلد الافتراضي هو الولايات المتحدة

lookalike_spec.allow_international_seeds

النوع: boolean (قيمة منطقية)

اختياري.

تحتاج إلى ما لا يقل عن 100 عضو من جمهور المصدر من أحد البلدان. وإذا لم يتم استيفاء هذا الحد الأدنى، فيعني تعيين allow_international_seeds إلى true أن Facebook يبحث في بلد آخر عن الحد الأدنى لعدد أعضاء الجمهور المصدر. يمكن تعيينها افتراضيًا إلى false.

lookalike_spec.starting_ratio

النوع: float (رقم عشري)

اختياري.

نسبة البدء المئوية للجمهور المشابه. على سبيل المثال، starting_ratio (نسبة البدء) 0.01 وratio (النسبة) ‏0.02 ينشئان جمهورًا مشابهًا من شريحة الجمهور المشابه التي من 1% إلى 2%. يجب أن تكون قيمة starting_ratio دائمًا أقل من ratio

lookalike_spec.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 وهي مصفوفة بهذا التنسيق:

الاسم الوصف

type

النوع: string (سلسلة)

يتم إرجاع القيم similarity أو reach أو custom_ratio دائمًا

starting_ratio

النوع: float (رقم عشري)

يتم الإرجاع في حالة تحديد starting_ratio

ratio

النوع: float (رقم عشري)

يمثل مضاعفات 0.01. يتم الإرجاع إذا كان type بالقيمة custom_ratio

country

النوع: string (سلسلة)

رمز البلد

origin

النوع: array (مصفوفة)

يمكنك الرجوع إلى الوصف أدناه.

origin.deleted

النوع: boolean (قيمة منطقية)

يتم إرجاع true عند حذف الأصل

origin.id

النوع: int (عدد صحيح)

معرف الأصل

origin.name

النوع: string (سلسلة)

اسم الأصل

origin.type

النوع: string (سلسلة)

custom_audience أو page

target_countries

النوع: 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 مختلفة.

الحقلالتغييرات الطارئة على الجماهير المشابهة غير النشطة

approximate_count

لا يمكنك استعادة الحجم. وسيؤدي إجراء استدعاء لهذا الحقل إلى إرجاع القيمة -1 بالنسبة للجماهير المشابهة غير النشطة.

operation_status

450: هذا الجمهور المشابه غير نشط. يمكن استخدامه في الإعلانات ولكن لن يحتوي على عدد تقديري حتى يتم نشر الحملة الإعلانية.
100: إذا لم يتم استخدام جمهور في مجموعة إعلانية نشطة لأكثر من عامين، فستبدأ صلاحيته في الانتهاء. وسيتم حذف الجماهير منتهية الصلاحية التي تظل دون استخدام لمدة 90 يومًا.

delivery_estimate

لا يمكنك استعادة النسبة التقديرية للعرض. وسيؤدي إجراء استدعاء لهذا الحقل إلى إرجاع القيمة -1 بالنسبة للجماهير المشابهة غير النشطة. ويتوفر هذا الحقل ضمن عقدتي الحساب الإعلاني والمجموعة الإعلانية. وتعرض كلتا العقدتان السلوك نفسه بالنسبة للجماهير المشابهة غير النشطة.

delete_time

عند وضع علامة على operation_status للجمهور باعتباره منتهي الصلاحية (الرمز 100)، يخبرك الحقل delete_time بموعد حذف الجمهور بتنسيق Unix.

لا يزال بإمكانك بدء حملة إعلانية باستخدام جمهور مشابه غير نشط. وتتوفر معلومات حول النسبة التقديرية للوصول بعد نشر إعلانك الجديد.

الحذف

بالنسبة لكل المعلنين ابتداءً من 8 يونيو 2021 فصاعدًا، سنقوم بنقل الجماهير تلقائيًا إلى مرحلة "جمهور منتهي الصلاحية" بمجرد أن يصبحوا غير نشطين لأكثر من عامين. وهذا يعني أنه بمجرد أن يبلغ الجمهور حد عدم الاستخدام في مجموعة إعلانية نشطة لمدة عامين، فسيتم تمييزه على أنه "جمهور منتهي الصلاحية" وسيتم وضع علامة على الحقل delete_time بوقت الحذف المقدر (على سبيل المثال، 90 يومًا من وقت التمييز) وموعد جدولة الجمهور للحذف.

ستتمكن بعد ذلك من اختيار حذف الجمهور بشكل استباقي أو استخدام الجمهور في مجموعة إعلانية نشطة لمنع الحذف. يمكنك معرفة الجماهير الموجودة في مرحلة انتهاء الصلاحية في أي وقت عن طريق الفلترة في الحقلين operation_status أو delete_time.

لمزيد من المعلومات، اطّلع على وثائق نظرة عامة على الجماهير المخصصة.

أفضل الممارسات

  • جمهور المصدر المخصص - اجعله بأكبر قدر ممكن حتى تكون لدينا بيانات كافية للبحث عن أشخاص مشابهين.
  • ادمج الجماهير المشابهة - مع استهداف آخر على Facebook لمعرفة معلومات ديموغرافية إضافية أو اهتمامات إضافية.
  • إذا كان الجمهور المصدر لديك يتمتع بسمات مثل الجنس أو المعلومات الجغرافية، فقد لا يلتزم إنشاء الجماهير المشابهة بهذه السمات.

التغييرات الطارئة على الجماهير المشابهة القادمة

تم التحديث في 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 لمشاركة الجماهير المشابهة الجديدة بين الحسابات الإعلانية.