動的 TinyTag パラメーター
TinyTag ID は、Xandr データベース内のさまざまな静的データに関連付けられています。 TinyTag に関連付けられているパラメーターの一部は、TinyTag 要求または広告呼び出し時に動的に追加または上書きできます。
ID またはメンバーとコードによる識別 (以下の「ID ではなく TinyTag をコード経由で呼び出す 」を参照) は、TinyTag の必須パラメーターです。 TinyTag ID に事前に関連付けられていない場合は、サイズも必要です。 それ以外のパラメーターの指定は任意です。
パラメーター
パラメーター | 説明 | 例 |
---|---|---|
id |
Tinytag サービスによって生成された ID。 | id=131 |
member |
ID の代わりに、TinyTag はメンバー ID と "inv_code" で参照できます。 | member=48 |
cb |
Cachebuster。 | |
inv_code |
TinyTag サービスの "code" と同じです。 "メンバー" と共に TinyTag を参照するために使用できます。 | inv_code=testcase |
default_tag_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 |
特定の bidder インスタンスに入札要求を送信するためにデバッグ インプレッションで使用されます。 debug_nodeを Bidder インスタンス サービスの bidder インスタンスの ID に設定します。 | debug_node=25 |
size |
TinyTag にまだ設定されていない場合は必須です。 このパラメーターは、事前設定されたサイズ形式をオーバーライドしません。widthXheight。 | 300x250 |
referrer |
TinyTag を含むページの URL。 注: Xandr がこの URL がインベントリを誤って表示していることを検出した場合 (つまり、インプレッションの実際の URL ではありません)、TinyTag のこの機能をオフにすることがあります。 禁止されている販売側のプラクティスの詳細については、「 サービス ポリシーの一部」を参照してください。 |
https%3A//mysite.com |
age |
数値の年齢、誕生年、またはハイフンで区切られた年齢範囲を渡すことができます。 | 56, 1974, or 25-35 |
gender |
使用可能な値: m、男性の場合は f、女性 | m |
reserve |
この在庫の予約価格。 このパラメーターは、事前設定された価格をオーバーライドします。 | 5.00 |
qsdata (Xandr のプラットフォーム API のみ) |
入札者に逐語的に渡される任意のデータ (省略可能) | yourdatahere |
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 のプラットフォームの詳細については、「Archive 2022 - Privacy and the Xandr Platform」を参照してください。 |
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 の追加情報の渡し: 動的データ: age=29、gender=male
https://ib.adnxs.com/tt?id=156&age=29&gender=male
クエリ文字列データを含む TinyTag
注:
qsdata パラメーターに querystring 変数を渡す場合は、次に示すようにデータの文字列をエンコードしてください。
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