確立されたカスタマーに最もよく似た利用者にターゲットを設定します。類似オーディエンスでは、いくつかの利用者のセットを「シード(種)」として、類似した利用者のオーディエンスを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 |
少なくとも100人が含まれるカスタムオーディエンスがある場合は、そのオーディエンスをベースにして類似オーディエンスを作成することができます。これには、ウェブサイトからのカスタムオーディエンスや、モバイルアプリ用のカスタムオーディエンスが含まれます。
名前 | 説明 |
---|---|
型: 文字列 | 必須。 カスタムオーディエンスの名前 |
型: long | 必須。 カスタムオーディエンスのID。元のオーディエンスには少なくとも100人のメンバーが含まれている必要があります。 |
型: 配列 | 必須。 下記の説明を参照。 |
型: 文字列 | 必須。
|
型: float | 任意。 類似オーディエンスの開始パーセンテージ。たとえば、 |
型: 浮動小数点数 | 必須。
|
型: ブーリアン | 任意。 1つの国からの少なくとも100人のシードオーディエンスメンバー。この人数に満たない場合は、 |
型: 文字列 | 必須。 類似オーディエンスのメンバーをこの国から検索します。 |
型: 配列 | 必須。 これらの場所からオーディエンスのメンバーを検索します。国または国のグループ( |
型: 配列 | 必須。 ここに指定した場所を含めます。 |
型: 文字列の配列 | 任意。 ターゲットにする国。国コードの配列です。検索のターゲット設定API、国を参照してください。例: |
型: 文字列の配列 | 任意。 ターゲットを設定する、世界の地域や自由貿易地域に含まれる国。国グループコードの配列。すべてのオプションについては、ターゲット設定、場所、 |
型: 配列 | 任意。 除外する場所 |
型: 文字列の配列 | 任意。
|
型: 文字列の配列 | 任意。
|
オーディエンスを「類似性」または「リーチの拡大」に対して最適化します。
タイプを使用する代わりに、手動で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では、キャンペーンまたは広告セットで新しいコンバージョンが発生するのに合わせて、基になる予測モデルを定期的にアップデートしています。
名前 | 説明 |
---|---|
型: 配列 | 必須。 下記の説明を参照。 |
型: 整数の配列 | 必須。 広告オブジェクトIDの配列。ここに指定した広告でコンバージョンにつながった利用者を、類似オーディエンスのモデルとして使用します。1つ以上のキャンペーンIDまたは広告セットID、あるいは両者の組み合わせです。 |
型: 文字列 | 必須。
|
型: 文字列 | 必須。 類似メンバーを検索する国。 |
型: ブーリアン | 任意。 1つの国から最低100人のシードオーディエンスメンバー。この人数に満たない場合は、 |
型: 浮動小数点数 | 任意。 類似オーディエンスの開始パーセンテージ。たとえば、 |
型: 浮動小数点数 | 必須。
|
現時点では、次のキャンペーンコンバージョンタイプが類似オーディエンスの対象になります:
自社のページに「いいね!」する利用者に基づいて、次のように類似オーディエンスを作成します。
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
名前 | 説明 |
---|---|
型: 配列 | 必須。 下記の説明を参照。 |
型: 整数 | 必須。 ファンが類似オーディエンスの基として使用されるページのFacebook ID |
型: 文字列 | 必須。
|
型: 文字列 | 必須。 類似した利用者を検索する国。デフォルトは「US」です。 |
型: ブーリアン | 任意。 1つの国からの少なくとも100人のシードオーディエンスメンバーが必要です。この最低人数に満たない場合は、 |
型: 浮動小数点数 | 任意。 類似オーディエンスの開始パーセンテージ。たとえば、starting_ratioを0.01、ratioを0.02に設定すると、類似セグメントの1%から2%までの類似オーディエンスが作成されます。starting_ratioの値は、常に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
も返されます。これは次の形式の配列です:
名前 | 説明 |
---|---|
型: 文字列 |
|
型: 浮動小数点数 |
|
型: 浮動小数点数 |
|
型: 文字列 | 国コード |
型: 配列 | 下記の説明を参照。 |
型: ブーリアン | 元のオーディエンスが削除されている場合は |
型: 整数 | 元のオーディエンスのID |
型: 文字列 | 元のオーディエンスの名前 |
型: 文字列 |
|
型: 文字列の配列 | オーディエンスの作成に使用されたすべての国 |
次に示す別のオーディエンスでは、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 },
類似オーディエンスを作成した後、カスタムオーディエンス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_count
、operation_status
、delivery_estimate
の動作が異なります。
フィールド | 非アクティブな類似オーディエンスでの変更 |
---|---|
| サイズは取得できません。非アクティブな類似オーディエンスでこのフィールドを呼び出すと、 |
|
|
| 配信推定は取得できません。非アクティブな類似オーディエンスでこのフィールドを呼び出すと、 |
| オーディエンスの |
非アクティブな類似オーディエンスを使用してキャンペーンを開始することは引き続き可能です。リーチ推定の情報は、新しい広告が公開された後で入手できます。
2021年6月8日以降、すべての広告主について、非アクティブな期間が2年を超えたオーディエンスは自動的に「期限切れオーディエンス」ステージに移されます。したがって、アクティブな広告セットで使用されていない期間が2年を超えるというしきい値を満たしたオーディエンスには、自動的に「期限切れオーディエンス」のフラグが付けられ、そのオーディエンス削除のスケジュールが設定された時点でdelete_time
フィールドに推定削除時刻(フラグが付けられた時点から90日)が設定されます。
その場合、そのオーディエンスを早めに削除することも、アクティブな広告セットの中で使用することによって削除を回避することもできます。期限切れステージにあるオーディエンスは、operation_status
フィールドかdelete_time
フィールドにフィルターを掛けることによって、いつでも確認できます。
詳しくは、カスタムオーディエンスの概要に関するドキュメントをご覧ください。
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_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ではサポートされません。共有を処理するには、オーディエンスマネージャを使用してください。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による共有を引き続き使用し、広告アカウント間で新しい類似オーディエンスを共有できます。