Skip to main content
GET
キーワードで、利用可能な Facebook 広告のターゲティング興味関心を検索します。 このエンドポイントは、Boost Post エンドポイントで使用する興味関心 ID を検索するために利用します。 このエンドポイントを使用すると、Facebook 広告向けの興味関心ベースのターゲティングオプションを、オーディエンス規模の推定値と併せて発見できます。
  • 興味関心 ID は、投稿をブーストする際の interests 配列で使用できます。
  • 結果は 10 分間キャッシュされます。
  • 最適な結果を得るには、具体的で関連性の高い検索語を使用してください。
  • Facebook は、広告アカウントの業界や地域に応じて異なる結果を返す場合があります。
  • JSON レスポンスの audienceSizeLowerBound および audienceSizeUpperBound フィールドは、 その興味関心のオーディエンス規模の推定範囲を示し、ターゲティングに役立ちます。
  • specialAdCategories を使用すると、特別広告カテゴリのキャンペーンに対して Meta が許可する興味関心のみを返せます。フィルタリングされたリクエストには accountId も必要です。

ヘッダーパラメータ

クエリパラメータ

Facebook 広告の興味関心を取得するための検索クエリです。検索クエリのエスケープを忘れないでください。例: Rhythm%20and%20blues%20music。
array
特別広告カテゴリのキャンペーンによるターゲティングを Meta が許可する興味関心のみに結果を制限します。住宅、雇用、金融、政治関連の投稿をブーストする前にこれを使用すると、広告が実際に承認される興味関心 ID を選択できます。同名の Boost Post パラメータと同じく、以下の値がサポートされています:
  • housing
  • employment
  • financial_product_services — financial_products_services と credit は同等の値として受け付けられ、同じカテゴリとして解決されます
  • issues_elections_politics
  • none — Boost Post との対称性のために受け付けられます。Boost Post では「特別広告カテゴリに該当しない」ことを意味します。Meta には regulated_categories=["NONE"] として送信されます: accountId が必須で、成功したレスポンスは ["NONE"] をエコーバックします。これはフィルタなしの検索と同じ結果を保証するものではなく、Meta による拒否は code: 368 を返します。通常のフィルタなし検索を行いたい場合は、none を送信するのではなく specialAdCategories 自体を省略してください。
値は大文字・小文字を区別しません。認識されない値は、受け付けられる値の一覧を示す code: 101 付きの 400 で拒否されます。このメッセージは Meta の大文字形式で記述され、上記の別の綴りも含まれるため、NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT と表示されます — ここに記載されているカテゴリと同じものであり、追加のカテゴリではありません。Boost Post も同一のメッセージを返します。?specialAdCategories= のような空の値も同様に拒否されます。複数のカテゴリを渡すには、?search=nursing&specialAdCategories=employment&specialAdCategories=housing のようにパラメータを繰り返します。?specialAdCategories[]=employment&specialAdCategories[]=housing のブラケット形式も使用できます。?specialAdCategories=employment,housing のようなカンマ区切りの文字列はサポートされておらず、code: 101 付きの 400 で拒否されます。リクエストされたすべてのカテゴリは 1 回の検索で Meta に送信されます。Ayrshare は Meta の結果をそのまま返し、個別に適格な興味関心の積集合を計算したり保証したりはしません。カテゴリの重複や、同一カテゴリの 2 つの綴りの送信は、単一のカテゴリにまとめられます。複数のカテゴリを指定した場合、レスポンスにエコーバックされる specialAdCategories フィールドは、送信した順序ではなくアルファベット順にソートされます。specialAdCategories を完全に省略すると、このエンドポイントは従来とまったく同じように動作します: フィルタなしの検索で、accountId は不要、レスポンスの形式も同じです。
string
specialAdCategories が指定されている場合は必須で、それ以外の場合は無視されます。興味関心の検索対象となる Facebook 広告アカウントの ID で、act_ プレフィックスは付けません — Boost Post が受け取るのと同じ値です。広告アカウントエンドポイントから取得できます。数値である必要があります。先頭の act_ は受け付けられて取り除かれますが、それ以外の形式は code: 101 付きの 400 で拒否されます。
Meta はカテゴリを考慮した興味関心検索を広告アカウント上でのみ提供しているため、accountId なしで specialAdCategories を指定したリクエストは、検索が実行される前に code: 101 付きの 400 で拒否されます。specialAdCategories のないリクエストは従来どおりで、引き続き accountId は不要です。
number
デフォルト:100
返される広告興味関心の数を制限します。
フィルタリングされたレスポンスは、適用されたカテゴリを specialAdCategories フィールドにエコーバックするため、結果がどのカテゴリで絞り込まれたかを確認できます。フィルタなしのレスポンスは、このフィールドを空で返すのではなく完全に省略します。また、フィルタリングされた結果では各興味関心の topic フィールドが省略されます。Meta のカテゴリを考慮した検索がこのフィールドを返さないためです — 代わりに name を参照してください。適格な興味関心が存在しない検索は、エラーではなく空の interests 配列と count: 0 を伴う 200 を返します。また、フィルタリングされた検索がフィルタなしの結果にフォールバックすることはありません。