バージョン3.0

マーケティングAPI

2018年5月1日リリース | 2019年2月1日まで利用可能 | ブログ投稿

• 新機能
• 重要な変更
• 廃止
• 即時廃止

新機能

最小コスト入札戦略、bid_strategyフィールド

ビジネスの目的に基づいて広告入札戦略を選択できるようにするため、{account-id}/adsetsに新しいフィールドbid_strategyを導入しました。戦略にはそれぞれ利点とトレードオフがあります。オプションは次のとおりです。

• LOWEST_COST - 広告セットの予算と配信のoptimization_goalに基づいて最大の成果を達成します。Facebookは、予算を消費するため必要に応じて自動的に入札を増やします。このオプションでは、入札の上限を指定することも、制限を指定しないことも可能です。

• TARGET_COST - 広告セットの予算を増やした場合も、広告の平均コストを安定供給します。

詳しくは、広告の購入と最適化、入札戦略をご覧ください。

コレクション広告、作成

コレクション広告を作成するための新しいAPI - 以前は、コレクション広告を作成するたびに、バックグラウンドでキャンバスが作成されていました。そのため、基になるキャンバスへのアクセスが制限され、キャンバスエンゲージメントオーディエンスでオーディエンスをリターゲットするためにその広告を使用することができませんでした。現在は、製品セットからコレクション広告を作成する際に、正確なエレメントを使用して明示的にキャンバスを作成する必要もあります。このキャンバスをコレクション広告で使用すると、コレクション広告が自動的に生成されます。詳しくは、製品セットを使用したコレクション広告をご覧ください。

重要な変更

広告管理

• 右側の列の無効化 - Facebookの位置right_hand_columnのみをターゲットとする広告を無効にしました({ad_account_id}/adsetsのright_hand_columnの目的が無効)。現在は、次の目的を持つ、サポートされている広告フォーマットの右側の広告配置のみをサポートします。トラフィック、コンバージョン、商品カタログ販売

• v3.0以降、GETとPOSTの両方でis_autobidとis_average_price_pacingが廃止されています。

オーディエンスと広告のターゲット設定

• カスタムオーディエンス用のルール構文の変更 - ウェブサイトカスタムオーディエンス、モバイルアプリカスタムオーディエンス、ページエンゲージメントカスタムオーディエンス、リード獲得広告エンゲージメントオーディエンス、キャンバスエンゲージメントオーディエンス、オフラインカスタムオーディエンスの作成に使用されるルールの構造を更新しました。これにより、集計処理に基づくルールやさまざまなイベントソースに基づくルールの作成と、ルールの除外が可能になります。詳しくは、以下をご覧ください。

  • ウェブサイトからのカスタムオーディエンス、オーディエンスルール、

  • モバイルアプリからのカスタムオーディエンス、オーディエンスルール、

  • ページエンゲージメントカスタムオーディエンス、

  • リード獲得広告のエンゲージメントオーディエンス、

  • キャンバスのエンゲージメントオーディエンス、および

  • オフラインコンバージョンからのカスタムオーディエンス。

ダイナミック広告

• 商品カタログへのアクセス - カタログアイテムにアクセスするには、正しいカタログの業種・業界を指定する必要があります。リクエストがカタログの正しい業種・業界と一致しない場合、エラーになります。たとえば、Eコマースのカタログの場合、対応する/productsエンドポイント(GET {catalog_id}/products、GET {product_feed_id}/products、GET {product_set_id}/productsなど)でカタログにアクセスする必要があります。他の業種・業界のエンドポイント(GET {catalog_id}/autos、GET {product_feed_id}/hotels、GET {product_set_id}/flightsなど)でアクセスすることはできません。

• テンプレートタグ内の空の文字列 - ダイナミック広告でテンプレートタグオプションのパラメーターとして空の文字列を使用することはできなくなりました。たとえば、{{trip.checkin_date date_format:}}に空の文字列を渡すと、エラーになります。詳しくは、ダイナミック広告、広告管理をご覧ください。

広告インサイトと効果測定

• インサイトのタイムアウト - インサイトAPIリクエストが完了する前にタイムアウトすると推定される場合、エラーコード100とサブコード1504033でエラーが返されます。タイムアウトの推定は、リクエストのサイズと、タイムアウト制限に関連する処理の進行状況に基づいて行われます。このエラーが発生した場合は、このデータについて非同期のインサイトAPIリクエストを送信してください。インサイトAPI非同期ジョブをご覧ください。

• イベントデータ内の負の値 - 負の値を含むイベントデータを{data_set_id}/eventsに投稿すると、エラーになります。これはPOST /{data_set_id-id}/eventsのdataフィールドに影響します。

• キャンペーン予算最適化のインサイト - adset_budget_valueは、広告キャンペーンでキャンペーン予算最適化を使用している場合、using campaign budgetを返すようになりました。これは以下に影響します。

  • GET {adaccount-id}/insights

  • GET {campaign-id}/insights

  • GET {adset-id}/insights

  • GET {ad-id}/insights

  • POST {adaccount-id}/insights

  • POST {campaign-id}/insights

  • POST {adset-id}/insights

  • POST {ad-id}/insights

• ピクセルのデフォルトの並べ替え - ビジネスアカウントまたは広告アカウントのいずれかでGET {account_id}/adspixelエッジを呼び出すと、デフォルトでは、最後のピクセル起動時間ではなくピクセル名でソートされた結果が返されます。

• ピクセル統計フィールド名の変更 - ピクセル統計エッジのtimestampフィールドの名前をstart_timeに変更しました。これは、ピクセルの起動に関する1時間ごとのデータの集計が開始される時刻です。この時刻は、タイムゾーンオフセットを含むISO 8601形式で返されます。これにより、無効なUnixタイムスタンプが返される問題が解決されます。これはGET {ads-pixel-id}/statsエンドポイントに影響します。

廃止

ビジネスマネージャ

POST {pixel-id}/shared_agenciesエンドポイントを廃止しました。広告ピクセルを代理店と共有するには、ビジネスマネージャUIを使用してください。

広告管理

• /{ad_campaign_id}と/ad_account_ID/campaignsで、kpi_custom_conversion_id、kpi_type、kpi_resultsを廃止しました。

• APIを簡略化するため、以下のエンドポイントで「再ダウンロード」フラグを廃止しました。

  • POST {ad-id}/

  • POST {adset-id}/

  • POST act_{ad-account-id}

  • POST act_{ad-account-id}/ads

  • POST act_{ad-account-id}/adsets

  この情報は、引き続きfieldsパラメーターで読み取ることができます。

• POST act_{ad-account-id}/adimagesでzipbytesフィールドを廃止し、そのエッジでZIPファイルをアップロードする機能を削除しました。次の拡張子を持つ画像を使用してください: jpg、jpeg、gif、bmp、png、tiff、tif。

• すべての必須アセットをパラメーターとして受け取る1つのAPI呼び出しを使用するコレクション広告を作成する現在のメソッドを廃止しました。代わりに、最初にキャンバスを作成し、次にキャンバスリンクを使用してコレクション広告を作成する必要があります。これにより、基になるキャンバスオブジェクトにアクセスして、たとえばオーディエンスをリターゲットすることなどができます。コレクション広告をご覧ください。

• ページ投稿のエンゲージメントを目的とする広告でのカルーセル広告フォーマットの使用を廃止しました。現在、この組み合わせは無効です。検証、目的と広告素材をご覧ください。

広告の購入と入札

• POST {ad-account-id}/adsetsおよびPOST {adset-id}エンドポイントで、is_autobidおよびis_average_price_pacingフィールドを廃止しました。広告セットに特定の入札戦略を指定するには、代わりに新しいbid_strategyフィールドを使用してください。詳しくは、入札と最適化をご覧ください。

• 広告および広告アカウントについて、delivery_estimateに含まれるフィールドを廃止しました。これらの結果は広告主のニーズを満たしていませんでした。そのうえ、多くの広告主が設定するビジネスの目的は、Facebookが提案する入札額では達成できないことがあります。廃止されたフィールドとパラメーターは次のとおりです。

  • bid_estimateフィールド

  • currencyパラメーター

  • daily_budgetパラメーター

  • optimize_forパラメーター

  Facebook広告から得られる真の本質的ビジネス価値を利用し、これに基づいて入札することをおすすめします。このビジネス価値をまだ把握できていない場合は、自動入札の使用をおすすめします。詳しくは、広告ヘルプセンター、広告の入札および広告の購入と最適化をご覧ください。

• GET /{rf-prediction-id}のcurve_budget_reachフィールドから返される結果を廃止しました。現在はマップが返されます。シリアル化されたJSON文字列の戻り値は廃止されました。これはGET /{rf-prediction-id}に影響します。

• GET /{ad-account-id}/ratecardエッジを廃止しました。

• /ad_accountsの請求関連のフィールドをいくつか廃止しました。これには以下が含まれます。

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• GET /customaudienceでpixel_idおよびexternal_event_sourceフィールドを廃止しました。

広告インサイトと効果測定

• GET /{data-set-id}とGET /{data-set-upload-id}が返すOFFLINE_EVENT_SET_IDのmatched_unique_usersを廃止しました。オフラインコンバージョンAPIをご覧ください。

• attributed_eventsエッジと、GET /{data_set_id} APIのattribute_statsフィールドを廃止しました。アトリビューション分析の対象となるイベントの統計を取得するには、GET /{data_set_id}/stats API を使用してください。

• GET /{data-set-id}とGET /{data-set-upload-id}が返すOFFLINE_EVENT_SET_IDのmatched_unique_usersフィールドを廃止しました。

• GET {data_set_upload_id}で、デフォルトの戻り値を廃止しました。これにより、次のフィールドはデフォルトで返されなくなりました: first_upload_time、last_upload_time、api_calls、valid_entries、matched_entries、duplicate_entries、event_time_min、event_time_max、event_stats、matched_unique_users。

• GET {data_set_id}/statsで、デフォルトの戻り値を廃止しました。これにより、デフォルトではカウント統計のみが返されます。どの統計を返すかを指定するには、average_upload_delayなどの累積統計用のfieldsパラメーターまたはsummaryパラメーターを使用してください。

• GET {data_set_id}で、デフォルトの戻り値を廃止しました。これにより、次のフィールドはデフォルトで返されなくなりました: attribute_stats、duplicate_entries、event_stats、event_time_max、event_time_min、matched_entries、matched_unique_users、usage、valid_entries。

• GET {data-set-upload-id}/statsエッジを廃止しました。代わりに、GET {data-set-upload-id}のvalid_entriesまたはmatched_entriesフィールドを使用してください。

• インサイトAPIのcanvas_component_avg_pct_viewを廃止しました。