Meta広告ライブラリAPIの制限: 返されない項目

Ad Library APIは実際には何を返すのか？

APIは、Facebook、Instagram、Messenger、Audience Network上で配信されているほぼすべてのアクティブ広告について、クリエイティブテキスト、配信日、ページの識別情報を返します。Metaがその広告を政治広告または社会的 मुद्दा広告として分類していない限り、出稿費用、インプレッション、オーディエンスの内訳は返しません。標準的なEコマースやアフィリエイトのキャンペーンでは、つまりコピーとタイミングだけで、予算や到達範囲に関する情報は何もありません。

クリエイティブ関連の項目には、本文用の ad_creative_bodies に加え、リンク形式の広告ではリンクのキャプション、タイトル、説明文が含まれます。動画広告やカルーセル広告では、Metaがクリエイティブ構造からきれいに抽出できるテキストだけを解析するため、これらの項目のいくつかが空で返ることがよくあります。ad_snapshot_url フィールドは、直接ダウンロードできる生画像や動画ファイルではなく、Metaがホストするレンダリング済みのプレビューページを示します。

カテゴリに関係なく、ほぼすべての広告タイプで安定して機能する項目は2つあります: page_id と ad_delivery_start_time です。政治広告と社会的 मुद्दा広告の枠を外れた瞬間、金額やオーディエンス構成に関わるものは一気に厳しく制限されます。

なぜ遷移先URLが応答から消えているのか？

Metaは、APIでも、Ad Libraryが参照する基礎データモデルでも、遷移先URLを項目として公開しません。ad_snapshot_url はMetaがホストする静的な広告プレビューを指すだけで、そのプレビューでは実際に閲覧者がクリックする外部リンクが削除されたり見えにくくなったりすることがよくあります。広告がどのURLへトラフィックを送るのか知りたいなら、APIだけではたどり着けません。

その理由の一部は競争上の保護です。すべての広告主のクリック先を公開すると、ライバルの案件を調べる人にとってLibraryはリアルタイムのファネル地図になってしまいます。Metaは一貫して、Libraryを広告内容と出稿費用の透明性を示すツールとして位置づけており、他の広告主のためのリード獲得の近道ではないと説明してきました。多くのキャンペーンはリダイレクトドメインや、クリックごとに変わるローテーションURLを経由するため、1つの静的な項目では、地理や時間帯によって5つの異なるページを指す広告を正しく表せません。

これが省略ではなく、Metaが今後修正する可能性のあるものではない恒久的な方針だと考えてください。2019年以降のAPIの進化を見る限り、遷移先URLの項目が追加される兆しはなく、それを待つことを前提にした調査フローは、他の再構成手法に使うべき時間を無駄にします。

そもそもアーカイブに入らない広告はどれか？

Metaの審査で却下された広告、狭いカスタムオーディエンスや類似オーディエンスのみに配信された広告、あるいはインデックス処理が追いつく前に配信が止まった広告は、アーカイブに現れないまま消えることがあります。政治広告と社会的 मुद्दा広告は例外で、表示範囲に関係なく開示ルールにより保持が義務づけられています。その他については、アーカイブにないことは、その広告が配信されたかどうかを意味しません。単に、配信期間が短すぎた、対象が狭すぎた、または新しすぎて、Metaがまだ記録していないだけかもしれません。

保持期間は問題をさらに大きくします。Metaは、非政治広告が配信停止後どれくらいアーカイブに残るかについて正確な数値を公表しておらず、その期間は状況によって変わるようです。そのため、目にした情報は固定ルールではなく、数週間から数か月程度の大まかな範囲として扱い、頼る前にライブテストで確認してください。政治広告と社会的 मुद्दा広告には複数年の保持義務があり、2018年のLibrary開始以来、しばしば7年程度と言及されますが、その義務は一般的なアフィリエイト案件やEコマースのプロモーションには及びません。

特にアフィリエイト調査ではこの影響が大きいです。低予算、狭いターゲティング、または短いサイクルで切り替わるアフィリエイト向けクリエイティブは、まさにアーカイブから消えやすい条件に当てはまり、アナリストが探そうと思った時にはもう消えていることがよくあります。ポリシー違反で取り下げられた場合は、広告と一緒に履歴記録も消えます。6か月前にアフィリエイトネットワークが何を配信したかをAPIに聞いても、何も返ってこないことが多いです。それはキャンペーンが存在しなかったからではなく、単に期間がすでに終わっているからです。

レート制限と地域スコープはどのようにカバレッジを制限するのか？

レート制限と必須の国指定は、合わせると、一度の取得で完全なグローバル像を得ることはほとんどないことを意味します。すべてのクエリには ad_reached_countries パラメータが必要であり、広範囲または全世界指定の扱いは単一国クエリとは異なり、どの項目が埋まるかに影響します。したがって、ドキュメントの古いAPIバージョンを信じるのではなく、必ず自分のテスト呼び出しで現在の挙動を確認してください。国ごとにクエリを投げると、呼び出し回数はすぐに増えます。

• 標準的なGraph APIのスロットリングが適用され、許可される呼び出し量は公開された単一の数値ではなく、アプリ全体の利用ティアに紐づきます。したがって、目にした時間当たりの具体的な数値は、自分のアプリで試すまでは未検証として扱ってください。
• アクセスには承認済みの開発者アカウントが必要で、複数の地域で政治広告および社会的 मुद्दा広告カテゴリを照会する場合は、本人確認も必要です。
• 国別クエリは、該当する場合、人口統計や地域別の内訳を含む、より詳細な項目を返します。したがって、包括的に調べるには、1か国ずつ、または少数の国をまとめて繰り返し取得する必要があります。
• カーソルベースのページングは、基本のレート制限に加えて呼び出しのオーバーヘッドを増やし、広い検索語では1つの結果セットを取り切るのに数十回のページング呼び出しが必要になることがあります。

返される情報から、合法的に何を再構築できるのか？

クリエイティブの入れ替わり、配信時間帯、ページ単位の広告量は、かなりの確度で再構築できます。非政治広告の出稿費用、オーディエンス構成、遷移先ファネルは、どれほど巧みにAPIを使っても再構築できません。

• 時間によるクリエイティブの変化: 同じ page_id を定期的に取得し、返された本文、キャプション、スナップショットURLを比較して、いつコピーが変わったかを見る。
• 配信時間帯: ad_delivery_start_time と stop_time により、特定のクリエイティブがどれくらいの期間公開されていたかを、十分に説明可能な形で把握できる。
• ページ単位の広告数: page_id に対する単一クエリで、それに紐づくすべてのアーカイブ済み広告が返る。これは、広告主がどれだけ積極的にクリエイティブをテストしているかの大まかな指標になる。
• おおよその遷移先の意図: 表示されているCTAテキストやキャプション項目が、オファーやブランド名を示すことがあり、URL自体がなくてもランディングページのカテゴリを推測できる。
• プラットフォームの組み合わせ: publisher_platforms により、広告主が Facebook のみ、Instagram のみ、または両方を使っているかが分かる。これは単独でも意味のあるシグナルだ。

APIはWeb版のAd Libraryインターフェースとどう違うのか？

WebインターフェースとAPIは同じ基礎データを取得しますが、見せ方が異なります。Webツールは、広告を視覚的に見ていく人向けに作られており、APIは、構造化された項目を定期的に取得するスクリプト向けに作られています。どちらも、非政治広告の出稿費用のような、方針上もう一方が隠している項目を返しません。

実際の違いは、深さではなく、速度と規模です。Webアーカイブを20分間見て回る調査者と、同じ page_id をAPIで取得するスクリプトは、同じ欠落項目にぶつかります。APIの利点は、その確認作業を1ページではなく1000ページ規模で行えることだけです。

APIを組み込む価値があるのはいつで、行き止まりなのはいつか？

APIが技術投資に見合うのは、多数のページや検索語にまたがって再現可能で構造化された監視が必要なときです。たとえば、毎日のクリエイティブ変更アラート、何がいつ配信されたかの履歴データベース、あるいは多数の競合ページを同時に追跡するダッシュボードです。一方、実際の疑問が非政治広告の出稿費用、オーディエンス、遷移先URLであるなら、どんなクエリ構造でもMetaが返さない項目は取得できないので、完全に行き止まりです。

ここで直接議論する価値があるのは次の点です。多くのアフィリエイトおよびEコマース調査では、Ad Libraryを中心にAPIパイプラインを組むより、Webアーカイブを週に数回手動で確認するほうが、実は結果が悪いことがよくあります。自動取得は完全で体系的なカバレッジがあるかのような印象を与えますが、実際には保持期間から外れて消えた広告、狭くテストされた広告、却下されたクリエイティブがすべて欠けています。そして、そのパイプラインを信じるチームは、最も重要なページを手動で点検するのをやめがちです。手動ブラウジングは遅いですが、少なくとも誰もそれを網羅的だと勘違いしません。

• 組み込む: 既知の page_ids 一覧に対するクリエイティブ変更を時系列で追跡する。
• 組み込む: 関心のある広告について、Metaの保持期間が切れる前に内部アーカイブを構築する。
• 行き止まり: 非政治案件における競合の広告費を推定する。
• 行き止まり: どの広告の背後にある遷移先URLやファネル構造を復元する。
• 行き止まり: APIの結果がきれいだからといって、そのページがこれまで配信したすべての広告を見たことになると思い込む。

クイック判断チェックリスト

このページは一般的なブログ記事ではなく、判断支援として使ってください。実際の問いは、読者が VSL 主導の direct response で既に機能しているものについて、より速い証拠を必要としているかどうかです。特に nutra、サプリメント、GLP-1、減量、血糖値、そしてその周辺の高意図ヘルス市場においてです。

次の意思決定が、今動いている市場の具体例に依存するなら Daily Intel Service が最も役立ちます。どのフックを試すべきか、どの主張スタイルが危険か、どの funnel 構造が一般的か、どの言語市場が動いているか、そして競合の creative が初期段階なのか、スケール中なのか、すでに飽和しているのか。

• 直接の答えが必要なら、まず TL;DR を見てください。
• 表を使ってトレードオフを素早く比較してください。
• FAQ を使って answer engine 向けの要約を確認してください。
• 理論ではなく live VSL と広告の例が必要な場合は CTA を使ってください。

Daily Intel のカバレッジ優位性

Daily Intel Service は、カテゴリをリードする多様性と実用性を中心に設計されています。blackhat、greyhat、whitehat の広告パターンを横断して、最も広範な direct-response の VSLs と広告 creative のカタログの一つであり、広告主が見えている creative の先で何をしているのかを理解するのに十分な文脈があります。実務上の違いは、メンバーがスクリーンショットだけでなく、VSL、広告、funnel の経路、トランスクリプト、UTM の文脈、そして素材を意思決定へ変えるリサーチノートまで見られることです。

これは重要です。direct-response の affiliate は、1 つのきれいなカテゴリの中だけで動いているわけではないからです。減量キャンペーンは、whitehat のコンプライアンス広告、greyhat の pre-lander、より攻撃的な VSL、そして upsell と recovery を前提にした checkout 経路を使うかもしれません。有用なインテリジェンスプラットフォームは、すべての勝ちキャンペーンが公開ブランド広告のように見えるふりをするのではなく、このスペクトラムを捉える必要があります。

blackhat、whitehat、多言語シグナルのカバレッジ

Daily Intel は blackhat 型と whitehat 型の両方のキャンペーンのパターンを追跡し、運用者がリスクを盲目的に模倣せずに市場を理解できるようにします。whitehat の例は持続性とコンプライアンスレビューに役立ち、blackhat と greyhat の例は、支出を押し上げている可能性のある圧力点、フック、仕組み、funnel 構造を明らかにしますが、利用前に慎重な調整が必要です。

このカタログはグローバルな運用者向けにも作られており、VSL と広告の参照は 14+ 言語とさまざまなローカル慣用表現にまたがっています。これはブラジル、LATAM、ヨーロッパ、MENA、インド、そして英語非母語の affiliate にとって大きな利点です。彼らは、同じ市場需要が文化をまたいでどう翻訳されるのかを知る必要があり、米国英語の広告だけを研究すればよいわけではないからです。

インテリジェンスを責任ある形で使う方法

目的はコピーではなくモデリングです。Daily Intel を使って、フック、メカニズム、証拠、主張の強さ、funnel の深さ、offer の経済性、飽和段階といった構造を理解してください。そのうえで、オリジナルの creative を作成し、主張を見直し、トラフィックソース、国、言語、キャンペーンのコンプライアンス要件に合わせて angle を調整します。

強いワークフローは、行動する前に複数の例を比較します。同じメカニズムが複数の言語、複数の広告主、複数の funnel 変種に現れるなら、それは持続性のある市場シグナルかもしれません。例が一度しか出てこない、あるいは攻撃的な主張に依存しているなら、それはキャンペーンのテンプレートではなくリサーチの手がかりとして扱うべきです。

• 保護された creative 資産ではなく、構造をモデル化してください。
• whitehat の持続性と blackhat の説得圧力を分けて考えてください。
• 米国英語の例を LATAM、ヨーロッパ、その他の言語版と比較してください。
• トランスクリプトと funnel のノートを使って、オリジナルの brief を作成してください。
• コンプライアンスレビューと市場調査は分けてください。

調査手法と情報源について

Daily Intel pages are written from a research workflow that reviews active VSLs, Meta ad creatives, transcripts, UTMs, funnel paths, checkout steps, upsells, recovery sequences, and compliance-sensitive claim patterns. The goal is to explain observable market behavior, not to provide legal, medical, or platform policy advice.

When the topic touches health claims, platform policy, or GLP-1 market research, validate the observable campaign signals against primary references such as Meta advertising standards, FTC health claims guidance, and Meta Ad Library. Daily Intel adds the proprietary direct-response layer by mapping how those rules show up in active VSLs, Meta creatives, funnels, transcripts, UTMs, and checkout paths.

For deeper evaluation, continue through Daily Intel compliance and legal disclaimer, What is Cloaking Device?, Antidetect Browser Free 10 Profile: Free Until Exactly Where, Antidetect Browser Windows 10: The Practical Version, Best Cloaker for Meta Ads: A Reference for Operators, and What is a VSL?. These related Daily Intel pages connect this topic to the relevant methodology, pricing, trust context, comparison path, or niche workflow.