ドメイン監査状態サービス

[アーティクル]
02/29/2024

ドメイン監査ステータスサービスを使用すると、特定のドメインが Xandr プラットフォーム上にあるかどうか、および Xandr がどのように分類されているかをチェックできます。このサービスは、プラットフォームへのドメインの移行に関心があるが、最初にドメインがまだ Xandr によって拒否されていないことを確認したい販売者に特に役立ちます。また、一般に監査対象ドメインの塗りつぶしが増えるので、販売者はこのサービスを使用して、Xandr に監査を希望するプラットフォーム上のドメインを特定できます。

次に、動作のしくみを示します。

関心 POST のあるドメインを含む JSON ファイル。 JSON は次のように書式設定する必要があります。
```
{"urls": ["URL1.com","URL2.com","URL3.de"]}
```
注:

Xandr には、ドメインの "https://" または "www" プレフィックスは格納されません。このサービスでは、JSON で記述されているとおりにドメインが検索されるため、チェックするドメインにこれらのプレフィックスを含めないようにすることをお勧めしています。
応答は、各ドメインが Xandr プラットフォーム上にあるかどうか、および Xandr が監査した方法を示します。応答の各ドメインに関して提供される詳細の完全な一覧については、以下の「JSON フィールド」を参照してください。

REST API

HTTP メソッド	エンドポイント	説明
`POST`	`https://api.appnexus.com/url-audit-search`	1 つ以上のドメインの監査状態を表示する注: これは読み取り専用サービスです。 `POST` JSON ファイルではありますが、システムにオブジェクトは作成されません。

JSON フィールド

Xandr プラットフォーム上のドメインの場合、次のすべてのフィールドが応答に表示されます。 Xandr プラットフォーム上にないドメインの場合は、フィールドと found (値がの false) フィールドのみがurl応答に表示されます。

フィールド	種類	説明
`audit_datetime`	timestamp	Xandr によってドメインが監査された日時。
`audit_status`	列挙	ドメインの監査状態。使用可能な値: - `audited` - ドメインが Xandr 監査に合格しました。 - `rejected` - ドメインアプリが Xandr 監査に失敗しました (Xandr ポリシー違反が原因)。 - `unaudited` - ドメインが監査されませんでした。 - `unauditable` - ドメインは監査できませんでした。 - `pending` - Xandr 監査はドメインに対して引き続き保留中です (既定値)。 - `is_adserver` - ドメインが監査されず、広告サーバードメインとして検出されました。
`content_category_id`	int	Xandr によって決定されるドメインのコンテンツカテゴリ。がの`"rejected"`場合`audit_status`、これはになります`null`。読み取り専用コンテンツカテゴリサービスを使用すると、特定のコンテンツカテゴリの詳細を表示できます。
`found`	ブール値	の場合 `true`、ドメインは Xandr プラットフォーム上にあります。
`id`	int	ドメインの Xandr ID。
`intended_audience`	列挙	Xandr によって決定されたドメインの対象ユーザー。使用可能な値: - `"mature"` - `"young_adult"` - `"children"` - `"general"`. がの`"rejected"`場合`audit_status`、これはになります`null`。
`reason`	string	が `"rejected"` または `"unauditable"`の場合`audit_status`、Xandr によって提供される理由。その他の状態は、このフィールドは空白になります。
`url`	string	ドメイン。

例

プラットフォーム上の 2 つのドメインに関する情報を表示する

$ cat urls
{
    "urls": ["goodurl.com","badurl.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "urls": [
            {
                "id": 3456,
                "url": "goodurl.com",
                "reason": null,
                "content_category_id": 8380,
                "intended_audience": "general",
                "audit_status": "audited",
                "audit_datetime": null,
                "found": true
            },
            {
                "id": 2194,
                "url": "badurl.com",
                "reason": "Landing page contains an excessive number or density of units",
                "content_category_id": null,
                "intended_audience": null,
                "audit_status": "rejected",
                "audit_datetime": null,
                "found": true
            }
        ]
    }
}

プラットフォーム上にない 2 つのドメインに関する情報を表示する

$ cat urls
{
    "urls": ["not-there1.com","not-there2.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": null,
        "num_elements": null,
        "urls": [
            {
                "url": "not-there1.com",
                "found": false
            },
            {
                "url": "not-there2.com",
                "found": false
            }
        ]
    }
}

一覧のどのドメインが監査されているかを判断する

この例では、2 つのドメイン (auditedurl.com と notauditedurl.com) を検索します。どちらのドメインもプラットフォーム上にありますが、情報はクエリ文字列の条件 (audit_status=audited) を満たすドメインに対してのみ返されます。クエリ条件を満たしていないドメインは、結果には引き続き返されますが、指定されたクエリで found 見つからなかったため、の false 値が返されます。

$ cat urls
{
    "urls": ["auditedurl.com","notauditedurl.com"]
}
$ curl -b cookies -c cookies -X POST -d @urls 'https://api.appnexus.com/url-audit-search?audit_status=audited'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "urls": [
            {
                "id": 3456,
                "url": "auditedurl.com",
                "reason": null,
                "content_category_id": 8380,
                "intended_audience": "general",
                "audit_status": "audited",
                "audit_datetime": null,
                "found": true
            },
            {
                "id": 7890,
                "found": false
            }
        ]
    }
}

次の方法で共有