TinyTag ID は、Xandr データベース内のさまざまな静的データに関連付けられています。 TinyTagに関連付けられているパラメータの一部は、TinyTagリクエストまたは広告呼び出し時に動的に追加または上書きできます。
ID またはメンバーとコードによる識別 (以下の 「ID の代わりにコードを使用した TinyTags の呼び出し 」を参照) は、TinyTag の必須パラメーターです。 サイズが TinyTag ID に事前に関連付けられていない場合も必要です。 それ以外のパラメーターの指定は任意です。
パラメーター
| パラメーター | 説明 | 例 |
|---|---|---|
id |
Tinytag サービスによって生成された ID。 | id=131 |
member |
ID の代わりに、メンバー ID と "inv_code" によって TinyTag を参照できます。 | member=48 |
cb |
キャッシュバスター。 | |
inv_code |
TinyTag サービスの「コード」と同じです。 "member" と一緒に TinyTag を参照するために使用できます。 | inv_code=testcase |
default_tag_id |
メンバー サービスを介して作成されたこの ID は、メンバーが既知で "inv_code" が不明な場合の既定の ID です。 このパラメーターは、プリセット default_tag_idをオーバーライドするためにも使用できます。 | default_tag_id=456 |
pubclick |
第三者のクリック トラッキング用にパブリッシャーが指定した URL。 注: pubclick パラメーターを含める場合は、文字列の最後のパラメーターである必要があります。 この pubclick の後にパラメーターを追加すると、クリエイティブが正しくクリックスルーできなくなります。 |
pubclick=https%3A//click.adserver.com |
debug |
デバッグ インプレッションを実行するために使用されます。 注: デバッグ インプレッションでは、通知要求は送信されず、 userdata_json コマンドは実行されません。 |
debug=1 |
test |
テスト オークションを実行するために使用されます。 Xandr はテスト オークションでインプレッションを取引せず、何も記録されません。 広告の内容も無視されます。 | test=1 |
debug_node |
デバッグ インプレッションで、入札要求を特定の入札者インスタンスに送信するために使用されます。 debug_nodeを 入札者インスタンスサービスの入札者インスタンスの ID に設定します。 | debug_node=25 |
size |
TinyTag にまだ設定されていない場合は必須です。 このパラメーターは、事前設定されたサイズ形式をオーバーライドしません。widthXheight. | 300x250 |
referrer |
TinyTag を含むページの URL。 注: この URL がインベントリを誤って表現している (つまり、インプレッションの実際の URL ではない) ことを Xandr が検出した場合、TinyTag のこの機能をオフにすることがあります。 禁止されている販売側の慣行の詳細については、「 サービス ポリシーの一部」を参照してください。 |
https%3A//mysite.com |
age |
数字の年齢、生年月日、またはハイフンで囲まれた年齢範囲を渡すことができます。 | 56, 1974, or 25-35 |
gender |
使用可能な値: m、f (男性、女性) | m |
reserve |
この在庫の予約価格。 このパラメーターは、事前設定された価格をオーバーライドします。 | 5.00 |
qsdata (Xandr のプラットフォーム API のみ) |
入札者に逐語的に渡される任意のデータ (オプション) | yourdatahere |
flash |
ユーザーは Flash をインストールしていますか? 使用可能な値: 1 または 0。 | 1 |
within_iframe |
この広告が iframe 内で配信されることがありますか? 使用可能な値: 1 または 0。 | 1 |
debug_timeout |
入札要求が送信された後、インプレッション バスが入札応答を待機する最大時間 (ミリ秒単位)。 タイムアウト期間内に応答しない入札者は、"接続のスロットリング、失敗、またはタイムアウト" エラーを受け取ります。 運用環境 (および砂環境の既定値) で使用される値は 2000 ミリ秒ですが、タイムアウトに別の値を渡すことで、砂環境でオーバーライドされる場合があります。 注: タイムアウト オーバーライドは、デバッグ インプレッションを実行する場合にのみ使用されます。 |
timeout=100 |
position |
ページ上のタグの位置。 指定可能な値: 'above' (スクロールせずに表示される部分) または 'below'。 | position=above |
truncate_ip |
1 または true の場合、ユーザーの IP アドレスの最後のオクテットは入札要求で切り捨てられます。 IP アドレスが個人を特定できる情報と見なされる管轄区域の広告タグには、このフラグを使用します。 (もちろん、完全な IP アドレスは、運用目的とセキュリティのために使用されます。)プライバシーと Xandr のプラットフォームの詳細については、「アーカイブ 2022 - プライバシーと Xandr プラットフォーム」を参照してください。 |
truncate_ip=1 |
prevent_rtb |
非ディール RTB をブロックする必要があるかどうかを示します。 使用可能な値:0: Xandr のプラットフォーム API 設定を使用します。1: すべての RTB がブロックされ、Xandr のプラットフォーム API 設定は無視されます。prevent_rtb と prevent_deals の両方が 1 に設定されている場合、入札要求は送信されません。 |
prevent_rtb=1 |
prevent_deals |
すべての取引をブロックする必要があるかどうかを示します。 使用可能な値: - 0: Xandr のプラットフォーム API 設定を使用します- 1: すべての取引がブロックされ、Xandr のプラットフォーム API 設定は無視されます。prevent_rtb と prevent_deals の両方が 1 に設定されている場合、入札要求は送信されません。 |
prevent_deals=0 |
gdpr |
GDPR 規制または TCF ロジックが適用されているかどうか、またはユーザーが GDPR の影響を受ける国または地域 (EEA の国または地域) にいるかどうかを示します。 | 1 if yes, 0 if no. |
gdpr_consent |
実際の IAB GDPR 同意文字列を示します。 これは、どの TCF ベンダーがどの条件下で個人データの処理を許可されるかを意味します。 | CO2jXwtO2jXwtB7AAAENAtC4AIAAAEJAAAqIAQAAAAAEAIAAAAACAAA.YAAAAAAAAAA |
gpp |
実際の IAB GPP 同意文字列を示します。 これは、どのベンダーがどの条件下で個人データの処理を許可されているかを意味します。 | gpp=DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN |
gpp_sid |
適用される規制または GPP ロジック、またはユーザーが GPP の一部であるフレームワークを持つ国または地域 (EEA の国または地域) にいるかどうかを示します。 | gpp_sid=6,7 |
使用例
ID のみを使用する TinyTag:
https://ib.adnxs.com/tt?id=156
TinyTag passing 追加情報: 動的データ: age=29、gender=male
https://ib.adnxs.com/tt?id=156&age=29&gender=male
クエリ文字列データでの TinyTag
注:
クエリ文字列変数を qsdata パラメーターに渡す場合は、次に示すようにデータ文字列をエンコードしてください。
likes=cheese
puid=322DD1BF-B288-4271-BCA4
https://ib.adnxs.com/tt?id=156&qsdata=likes%3Dcheese%26puid%3D322DD1BF-B288-4271-BCA4
ID の代わりにコードを使用して TinyTags を呼び出す
TinyTag ID を介して TinyTag を呼び出せない場合は、"inv_code" というメンバー定義フィールドで TinyTag を呼び出すことができます。 この英数字コードは TinyTag サービスにあります。
TinyTag コード呼び出しのサンプル:
https://ib.adnxs.com/tt?member=1&inv_code=abcdef
GDPR を使用した TinyTag:
https://ib.adnxs.com/getuid?
https://somedomain.com&gdpr=1&uid=$UID&gpdr_consent=CO2jXwtO2jXwtB7AAAENAtC4AIAAAEJAAAqIAQAAAAAEAIAAAAACAAA.YAAAAAAAAAA