次の方法で共有

Bidders - クリエイティブ マクロ チェック サービス

  • [アーティクル]

サード パーティのクリエイティブを実行している場合は、このサービスを使用して、Xandr がサード パーティのタグをチェックし、クエリ文字列にパラメーターを追加したり、ドメインを置き換えたり、Xandr クリック追跡マクロを適切な場所に挿入したりできます。 現在、MediaMind、Atlas、Fetchback、DoubleClick の広告サーバーがサポートされています。

Xandr マクロを挿入できる場合は、応答で新しいタグまたは URL が返されます。 適切なマクロが挿入されたことを確認できない場合 (または フィールドのexisting_other_macros値が応答内で 0 ではない)、または new_media_url フィールド内のnew_content値は表示unmatchedされません。

REST API

HTTP メソッド 終点 説明
PUT [https://api..com/creative-macro-check](https://api..com/creative-macro-check) (replace_pattern_in_content_url JSON) 定義済みのパターンに基づいて、URL 内のコンテンツを置き換えます。
PUT [https://api..com/creative-macro-check?include_tests=1](https://api..com/creative-macro-check?include_tests=1) (replace_pattern_in_content_url JSON) 定義済みのパターンとテスト パターンに基づいて、URL 内のコンテンツを置き換えます。

JSON フィールド

フィールド 種類 説明
content string フィールドは、コンテンツを変更するときに使用されます。 Xandr マクロを含むように変更されているコンテンツ。
必須: コンテンツを変換するときの PUT
found_urls int クリエイティブ コンテンツで見つかった 'src=' または 'href=' URL の数。
macro_replacements 配列 実行された置換に関する情報を含む配列。マクロの種類 (例: cachebuster) 別に一覧表示されます。 詳細については、以下の「マクロ置換」を参照してください。
matched_urls int 認識された広告サーバーからのの数 found_urls 。
media_url string フィールドは、メディア URL を変更するときに使用されます。 Xandr マクロを含むように変更されているメディア URL。
必須: メディア URL を変換する場合の PUT
new_content string フィールドは、コンテンツを変更するときに設定されます。 セキュリティで保護されていないすべてのマクロが評価された更新されたコンテンツ。 このフィールドには、すべての Xandr マクロが正常に挿入されない限り、同じ値 content が含まれます。
new_content_secure string フィールドは、コンテンツを変更するときに設定されます。 セキュリティで保護されたマクロとセキュリティ保護されていないマクロの両方が評価された更新されたコンテンツ。 このフィールドには、すべての Xandr マクロが正常に挿入されない限り、同じ値 content が含まれます。
new_media_url string メディア URL を変更するときにフィールドが設定されます。 セキュリティで保護されていないすべてのマクロが評価された更新されたメディア URL。 このフィールドには、すべての Xandr マクロが正常に挿入されない限り、同じ値 media_url が含まれます。
new_media_url_secure string メディア URL を変更するときにフィールドが設定されます。 セキュリティで保護され、セキュリティで保護されていないすべてのマクロが評価された更新されたメディア URL。 このフィールドには、すべての Xandr マクロが正常に挿入されない限り、同じ値 media_url が含まれます。
recognized_servers 文字列の配列 または media_url フィールド内の値に一致する URL パターンを含む広告サーバーのcontent名前。 詳細については、以下の「マクロ置換」を参照してください。
warning string または 内new_content_securenew_media_url_secureの値がセキュリティで保護されていない場合は、このフィールドに警告メッセージが表示されます。

マクロ置換

フィールド 種類 説明
existing_appnexus_macro int マクロを挿入する場所を決定できた URL の数。
existing_other_macro int マクロを挿入する場所を決定できた URL の数ですが、既に何かが存在していたため、そのままにしておきます。 この値が 0 でない場合、 または new_media_url フィールド内のnew_content値は に表示されません。
replaced int 正常に挿入された のマクロを持つ URL の type 数。
type string オブジェクトに cachebuster または に関する情報があるかどうかを指定します click_url。
unmatched int マクロの挿入方法を決定できなかった URL の数。 この値が 0 でない場合、 または new_media_url フィールド内のnew_content値は に表示されません。

認識されたサーバー

フィールド 種類 説明
adserver_name string 広告サーバーの名前。

例

サード パーティのタグ (コンテンツ) 内のマクロを置き換える

コンテンツ フィールドには複数の URL を含めることができますが、この例ではコンテンツ フィールドに含まれる URL は 1 つだけです。

replace_pattern_in_content_url
{
        "creative-macro-check": {
                "content": "<a href=\"https://clk.atdmt.com/CCC/go/329458985/direct/01">test</a>"
        }
}

{
  "response": {
    "status": "OK",
    "creative-macro-check": {
      "new_content": "<a href=\"${CLICK_URL}https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01\">test<\/a>",
      "new_content_secure": "<a href=\"${CLICK_URL}https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01\">test<\/a>",
      "content": "<a href=\"https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01\">test<\/a>",
      "media_url": null,
      "new_media_url": null,
      "new_media_url_secure": null,
      "recognized_servers": [
        "Atlas"
      ],
      "recognized_server": "Atlas",
      "found_urls": 1,
      "matched_urls": 1,
      "macro_replacements": [
        {
          "type": "click",
          "replaced": 1,
          "existing_other_macro": 0,
          "existing_appnexus_macro": 0,
          "unmatched": 0
        }
      ],
      "warning": "new_content_secure contains some non secure urls"
    },
    "count": 1,
    "start_element": null,
    "num_elements": null
  }
}

サードパーティ URL (メディア URL) 内のマクロを置き換える

replace_pattern_in_media_url
{
        "creative-macro-check": {
                "media_url": "https://clk.atdmt.com/CCC/go/329458985/direct/01"
        }
}

$ curl -b cookies -c cookies -X PUT -d 'https://api.adnxs.com/creative-macro-check'
{
  "response": {
    "status": "OK",
    "creative-macro-check": {
      "content": null,
      "new_content": null,
      "new_content_secure": null,
      "media_url": "https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01",
      "new_media_url": "${CLICK_URL}https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01",
      "matched_urls": 1,
      "new_media_url_secure": "${CLICK_URL}https:\/\/clk.atdmt.com\/CCC\/go\/329458985\/direct\/01",
      "recognized_servers": [
        "Atlas"
      ],
      "recognized_server": "Atlas",
      "found_urls": 1,
      "macro_replacements": [
        {
          "type": "click",
          "replaced": 1,
          "existing_other_macro": 0,
          "existing_appnexus_macro": 0,
          "unmatched": 0
        }
      ],
      "warning": "new_media_url_secure is not secure"
    },
    "count": 1,
    "start_element": null,
    "num_elements": null
  }
  }