Data Science ツールキット - カスタム モデルを使用した ALI ワークフロー

Bonsai ツリーやロジスティック回帰モデルや拡張広告申込情報 (ALI) などのカスタム モデルの操作は、従来のキャンペーンを操作するプロセスとかなり似ています。 このガイドでは、カスタム モデルを作成して ALI に関連付ける手順について説明します。 次の例では、Bonsai の期待値 デシジョン ツリー オブジェクト を作成し、ALI の入札戦略として使用します。

ツリーの作成と検証

Bonsai ツリーの構文と、現在キャンペーンで使用できる機能は、ALI で動作するツリーでも同じです。 カスタム モデルを作成するには、カスタム モデル サービスを使用します。 カスタム モデル パーサー サービスを使用して、Bonsai デシジョン ツリーを検証できます。 これらのサービスのドキュメントは、次のとおりです。

• カスタム モデル サービス
• カスタム モデル パーサー サービス

例

この例では、テスト広告主の下に単純なツリー (リテラル '0' 文字) を作成します。

カスタム モデル

custom_model.json

{
  "custom_model": {
    "name": "Test Custom Model",
    "code": "mcg-test-custom-model",
    "advertiser_id": 354236,
    "custom_model_structure": "decision_tree",
    "model_output": "bid",
    "model_text": "MAo="
  }
}

POST/ツリー モデルの作成

POST model (応答の省略)

$ curl -b dcc -c dcc -X POST -s -d '@json/custom-model.json' "https://api-test.appnexus.com/custom-model?advertiser_id=354236"  | jq '.'
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": "379792",
    "start_element": 0,
    "num_elements": 100,
    "custom_model": {
      "id": 379792,
      "name": "Test Custom Model",
      "code": "mcg-test-custom-model",
      "member_id": 958,
      "advertiser_id": 354236,
      "custom_model_structure": "decision_tree",
      "model_output": "bid",
      "compiled_text": null,
      "model_text": "MAo=",
      "original_text": "0
",
      "active": true,
      "last_modified": "2016-08-30 20:55:38"
    },
    "dbg_info": {...}
  }
}

API を使用した ALI の作成

カスタム モデルは、Xandr API ユーザーが評価モデル、非評価モデル、拡張広告申込情報またはキャンペーンのクリエイティブ配信に意思決定ロジックを追加できるように設計されています。 ALI の作成手順については、 ドキュメントを参照してください。

カスタム モデルと ALI の関連付け

拡張された行項目には、"' という名前の配列フィールドがあり、custom_models行項目に関連付けられているカスタム モデルが一覧表示されます。 カスタム モデルを ALI に関連付ける手順については、 品目モデル サービスのドキュメントを参照してください。

IP アドレスのターゲット設定

GDPR 規制に準拠している国の顧客は、広告申込情報、Bonsai ツリー、ロジスティック回帰モデルのいずれかで IP アドレスまたは IP 範囲をターゲットにしている場合、アドレスが切り捨てられる可能性があることに注意する必要があります。 このプロセスの詳細については、 サービス ポリシーに関するページを参照してください。

複数のカスタム モデル

異なる種類の複数のカスタム モデルを拡張された行項目に関連付けることができます。 これには、インプレッションの期待値の計算の一部をオーバーライドするために使用できるカスタム モデルの種類が多数含まれます。 次の例は、複数のカスタム モデルを 1 つの行項目に関連付けるプロセスがどのように機能するかを示しています。

カスタム モデルの例

update_models.json

// Update / Set a single model
{
  "line_item_model": {
      "custom_model_id": 123,
      "type": "click_imp"
    }
}
 
// Set / Update multiple models
{
  "line_item_models": [
    {
      "custom_model_id": 123,
      "type": "click_imp"
    },
    {
      "custom_model_id": 456,
      "type": "ev_click"
    }
  ]
}

カスタム モデル型

次のモデルの種類は、カスタム モデルとして広告申込情報に関連付けることができます。