類似オーディエンス

確立されたカスタマーに最もよく似た利用者にターゲットを設定します。類似オーディエンスでは、いくつかの利用者のセットを「シード(種)」として、類似した利用者のオーディエンスをFacebookが作成します。類似オーディエンスは、任意のビジネス目的に使用できます。現在のカスタマーに似た利用者にターゲットを設定することにより、ファンの獲得、サイトの登録、Facebook外での購入、クーポンの取得、または単なるブランドの認知度の向上などの目的を達成できます。

シードオーディエンスには、次が含まれます。

Facebookでは、類似が広告グループに属している場合、類似のメンバーを3日ごとに更新します。

作成

類似オーディエンスのメンバーが完全に取り込まれるまで、1時間から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

PHP広告SDKまたはPython広告SDKで類似オーディエンスを作成するには、CustomAudienceを使用します。

応答には次の情報が含まれます。

名前 説明

id

型: 整数

類似オーディエンスのID

カスタムオーディエンスの類似オーディエンス

少なくとも100人が含まれるカスタムオーディエンスがある場合は、そのオーディエンスをベースにして類似オーディエンスを作成することができます。これには、ウェブサイトからのカスタムオーディエンスや、モバイルアプリ用のカスタムオーディエンスが含まれます。

名前 説明

name

型: 文字列

必須。

カスタムオーディエンスの名前

origin_audience_id

型: long

必須。

カスタムオーディエンスのID。元のオーディエンスには少なくとも100人のメンバーが含まれている必要があります。

lookalike_spec

型: 配列

必須。

下記の説明を参照。

lookalike_spec.type

型: 文字列

必須。typeまたはratioのいずれかを設定します。

similarityまたはreach

lookalike_spec.starting_ratio

型: float

任意。

類似オーディエンスの開始パーセンテージ。たとえば、starting_ratioを0.01、ratioを0.02に設定すると、類似セグメントの1%から2%までの類似オーディエンスが作成されます。starting_ratioはratioより小さくする必要があります

lookalike_spec.ratio

型: 浮動小数点数

必須。typeまたはratioのいずれかを設定します。

0.01から0.20までの範囲で、0.01刻みで指定します。選択した国の元のオーディエンスの上位x%。

lookalike_spec.allow_international_seeds

型: ブーリアン

任意。

1つの国からの少なくとも100人のシードオーディエンスメンバー。この人数に満たない場合は、allow_international_seedstrueに設定します。これは、この最低人数のオーディエンスメンバーをFacebookが別の国から検索することを意味します。デフォルトはfalseです。

lookalike_spec.country

型: 文字列

必須。countryまたはlocation_specを設定します。

類似オーディエンスのメンバーをこの国から検索します。

lookalike_spec.location_spec

型: 配列

必須。countryまたはlocation_specのいずれかを設定します。

これらの場所からオーディエンスのメンバーを検索します。国または国のグループ(Asiaなど)のリスト

lookalike_spec.location_spec.geo_locations

型: 配列

必須。countriesまたはcountry_groups内の少なくとも1つのエントリ。

ここに指定した場所を含めます。

lookalike_spec.location_spec.geo_locations.countries

型: 文字列の配列

任意。

ターゲットにする国。国コードの配列です。検索のターゲット設定API、国を参照してください。: 'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

型: 文字列の配列

任意。

ターゲットを設定する、世界の地域や自由貿易地域に含まれる国。国グループコードの配列。すべてのオプションについては、ターゲット設定、場所、country_groupsおよび検索のターゲット設定、country_groupsを参照してください。: 'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

型: 配列

任意。

除外する場所

lookalike_spec.location_spec.excluded_geo_locations.countries

型: 文字列の配列

任意。

geo_locationscountriesと同じ

lookalike_spec.location_spec.excluded_geo_locations.country_groups

型: 文字列の配列

任意。

geo_locationscountry_groupsと同じ

タイプ

オーディエンスを「類似性」または「リーチの拡大」に対して最適化します。

  • 類似性 - オーディエンスには、選択した国でシードカスタムオーディエンスに最もよく似ている上位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人以上のメンバーを集めることをおすすめします。また、目的が類似したキャンペーンまたは広告セットを選択する必要もあります。

この類似オーディエンスを作成するには、1つ以上のキャンペーンまたは広告セットを指定してください。たとえば、1つのキャンペーンと、別のキャンペーンに含まれる2つの広告セットを指定します。

Facebookでは、過去180日までのコンバージョンデータを利用し、キャンペーンまたは広告セットでコンバージョンにつながった利用者を例として識別することができます。その後、予測モデルをトレーニングし、類似オーディエンスを作成します。Facebookでは、キャンペーンまたは広告セットで新しいコンバージョンが発生するのに合わせて、基になる予測モデルを定期的にアップデートしています。

名前 説明

lookalike_spec

型: 配列

必須。

下記の説明を参照。

lookalike_spec.origin_ids

型: 整数の配列

必須。

広告オブジェクトIDの配列。ここに指定した広告でコンバージョンにつながった利用者を、類似オーディエンスのモデルとして使用します。1つ以上のキャンペーンIDまたは広告セットID、あるいは両者の組み合わせです。

lookalike_spec.conversion_type

型: 文字列

必須。

campaign_conversions.オーディエンスが、キャンペーンコンバージョン類似オーディエンスであることを示します。

lookalike_spec.country

型: 文字列

必須。

類似メンバーを検索する国。

lookalike_spec.allow_international_seeds

型: ブーリアン

任意。

1つの国から最低100人のシードオーディエンスメンバー。この人数に満たない場合は、allow_international_seedstrueに設定します。これは、この最低人数のオーディエンスメンバーをFacebookが別の国から検索することを意味します。デフォルトはfalseです。

lookalike_spec.starting_ratio

型: 浮動小数点数

任意。

類似オーディエンスの開始パーセンテージ。たとえば、starting_ratioを0.01、ratioを0.02に設定すると、類似セグメントの1%から2%までの類似オーディエンスが作成されます。starting_ratioratioより小さくする必要があります

lookalike_spec.ratio

型: 浮動小数点数

必須。

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

型: 配列

必須。

下記の説明を参照。

lookalike_spec.page_id

型: 整数

必須。

ファンが類似オーディエンスの基として使用されるページのFacebook ID

lookalike_spec.conversion_type

型: 文字列

必須。

page_like - これがページのファンの類似オーディエンスであることを示します

lookalike_spec.country

型: 文字列

必須。

類似した利用者を検索する国。デフォルトは「US」です。

lookalike_spec.allow_international_seeds

型: ブーリアン

任意。

1つの国からの少なくとも100人のシードオーディエンスメンバーが必要です。この最低人数に満たない場合は、allow_international_seedstrueに設定します。これは、この最低人数のシードオーディエンスメンバーをFacebookが別の国から検索することを意味します。デフォルトはfalseです。

lookalike_spec.starting_ratio

型: 浮動小数点数

任意。

類似オーディエンスの開始パーセンテージ。たとえば、starting_ratioを0.01、ratioを0.02に設定すると、類似セグメントの1%から2%までの類似オーディエンスが作成されます。starting_ratioの値は、常にratioの値より小さくする必要があります。

lookalike_spec.ratio

型: 浮動小数点数

必須。

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
}, 

類似オーディエンスには値2のsubtypeがあります。また、lookalike_specも返されます。これは次の形式の配列です:

名前 説明

type

型: 文字列

similarityreach、またはcustom_ratio - 常に返されます

starting_ratio

型: 浮動小数点数

starting_ratioを指定した場合は返されます

ratio

型: 浮動小数点数

0.01の倍数。typecustom_ratioの場合は返されます

country

型: 文字列

国コード

origin

型: 配列

下記の説明を参照。

origin.deleted

型: ブーリアン

元のオーディエンスが削除されている場合はtrueが返されます

origin.id

型: 整数

元のオーディエンスのID

origin.name

型: 文字列

元のオーディエンスの名前

origin.type

型: 文字列

custom_audienceまたはpage

target_countries

型: 文字列の配列

オーディエンスの作成に使用されたすべての国

次に示す別のオーディエンスでは、subtypeLOOKALIKEです。

{
 "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
},  

配信のステータス

類似オーディエンスを作成した後、カスタムオーディエンスIDが返されます。オーディエンスは、完全に取り込まれるまで約1時間かかります。ステータスは、/{lookalike_audience_ID}?fields=delivery_statusで取得できます。応答はJSON形式で返され、オーディエンスの取り込みが完了していれば、delivery_statusまたはコード200になります。

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

テストでは、広告マネージャでリストのステータスを確認してください。

類似オーディエンスを削除するには、カスタムオーディエンスの場合と同様の操作を行います。

非アクティブなオーディエンス

類似オーディエンスは、アクティブな広告で90日間使用されなかった場合、非アクティブと見なされます。非アクティブな類似オーディエンスでは、approximate_countoperation_statusdelivery_estimateの動作が異なります。

フィールド非アクティブな類似オーディエンスでの変更

approximate_count

サイズは取得できません。非アクティブな類似オーディエンスでこのフィールドを呼び出すと、-1が返されます。

operation_status

450: この類似オーディエンスは非アクティブです。これを広告で使用することはできますが、キャンペーン公開まで推定値はありません。
100:アクティブな広告セットで使用されていない期間が2年を超えるオーディエンスは、期限切れの状態になります。90日間ずっと使用されていない期限切れオーディエンスは削除されます。

delivery_estimate

配信推定は取得できません。非アクティブな類似オーディエンスでこのフィールドを呼び出すと、-1が返されます。このフィールドは、広告アカウントノードと広告セットノードで利用可能です。どちらのノードも、非アクティブな類似オーディエンスに対して同じ動作をします。

delete_time

オーディエンスのoperation_statusに期限切れのマークが付けられている場合(コードdelete_time)、そのオーディエンスの削除予定日時は、100フィールドによってUnix時刻の形で知ることができます。

非アクティブな類似オーディエンスを使用してキャンペーンを開始することは引き続き可能です。リーチ推定の情報は、新しい広告が公開された後で入手できます。

削除

2021年6月8日以降、すべての広告主について、非アクティブな期間が2年を超えたオーディエンスは自動的に「期限切れオーディエンス」ステージに移されます。したがって、アクティブな広告セットで使用されていない期間が2年を超えるというしきい値を満たしたオーディエンスには、自動的に「期限切れオーディエンス」のフラグが付けられ、そのオーディエンス削除のスケジュールが設定された時点でdelete_timeフィールドに推定削除時刻(フラグが付けられた時点から90日)が設定されます。

その場合、そのオーディエンスを早めに削除することも、アクティブな広告セットの中で使用することによって削除を回避することもできます。期限切れステージにあるオーディエンスは、operation_statusフィールドかdelete_timeフィールドにフィルターを掛けることによって、いつでも確認できます。

詳しくは、カスタムオーディエンスの概要に関するドキュメントをご覧ください。

ベストプラクティス

  • シードカスタムオーディエンスを可能な限り大きくすると、類似した利用者を的確に検索できるデータが提供されます。
  • 類似オーディエンスをFacebookの他のターゲット設定と結合すると、利用者データや興味・関心を追加できます。
  • シードオーディエンスに性別や地域などの属性がある場合、生成される類似オーディエンスにそれらの属性が受け継がれないことがあります。

類似オーディエンスに関する今後の変更

2021年4月28日に更新: 類似オーディエンス作成からの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の応答を返します。

これらのフィールドについて詳しくは、カスタムオーディエンスをご覧ください。

広告セットに関する変更

広告の作成と編集

従来の類似オーディエンスを含む既存のキャンペーンのターゲット設定が編集された場合、Facebookは広告を自動的にアップグレードして新しい類似オーディエンスを使用するようにします。従来の類似オーディエンスは、新しく作成する広告キャンペーンでは使用できなくなります。

類似オーディエンスの作成プロセスから場所の指定が削除されたため、広告セットの作成時に場所のターゲットを設定する必要があります。場所のターゲット設定なしで広告セットを作成しようとすると、エラーが表示されます。

上記のすべての変更は、キャンペーンのexcluded_custom_audiencesflexible_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ではサポートされません。共有を処理するには、オーディエンスマネージャを使用してください。2021年5月24日以降は、次の開発者向けドキュメントに従って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エンドポイントは、新しい類似オーディエンスと国のターゲットが初めて使用されたときはusersパラメーターに対して-1を返し、その後は推定ユーザー数を返します。

estimate_dauおよびestimate_mauパラメーターは、新しい類似オーディエンスと国のターゲットが初めて使用されたときはusersパラメーターで-1を返し、その後は推定ユーザー数を返します。

応答の例

// 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 v11のリリース日の時点で有効になります。その日に、変更内容がすべてのバージョンに対して適用される予定です。

マーケティングAPI v10とv11のリリースまでの期間中、ロールアウト対象の広告アカウントとロールアウト対象外の広告アカウント間で類似オーディエンスを共有する処理は、APIではサポートされません。共有を処理するには、オーディエンスマネージャを使用してください。マーケティングAPI v11のリリース後は、APIによる共有を引き続き使用し、広告アカウント間で新しい類似オーディエンスを共有できます。