タグなしリクエストでクリエイティブ コードを読み込む

広告タグの代わりにタグなしリクエストを使用して、アド マネージャーで入稿されたエンコード前のクリエイティブ コードをリクエストできます。タグなしリクエストは通常、セットトップ ボックスや、Google タグ設定および SDK がサポートされない環境など、カスタムの解析と表示が必要な場合に使用します。

タグなしリクエストを行うと、アド マネージャーではエンコード前のクリエイティブ コードのみが、入稿されたままの形式（コードを実行して広告を表示する前の状態）で返されます。広告が見つからない場合は、200/OK ステータスが返され、レスポンスは空になります。

コードの実行と広告の表示、およびインプレッション トラッキングの有効化は、アプリ、プレーヤー、またはサイト側で行う必要があります。

メールへの広告配信にタグなしリクエストは使用できません。他のサポートされていない機能についてもご確認ください。

手動でタグなしリクエストを作成する

タグなしリクエストを作成するには、まずベース URL を用意し、必須パラメータをすべて指定してから、省略可能なパラメータを必要に応じて追加します。各パラメータでは、広告ユニット、クリエイティブ サイズ、Key-Value、リクエストに関するその他の情報を指定します。

タグなしリクエストは、SSL（https://）を使用して安全に行う必要があります。

ベース URL を用意する

こちらのベース URL を使用します。https://securepubads.g.doubleclick.net/gampad/adx?

広告リクエストのパラメータを指定する

必須パラメータ

パラメータ	説明
iu	Google アド マネージャーのネットワーク コードを含む Google アド マネージャーの広告ユニットコードです。複数のレベルを含めるときは、スラッシュ（/）でレベルを区切ります。 例 iu=/123/homepage iu=/456/sports/baseball タグなしリクエストでクライアント管理（MCM）を使用する場合は、ネットワーク コードに parent,child 構造を使用します。 例（MCM） iu=/123,456/homepage
sz	クリエイティブのサイズです。複数のサイズを含めるには、パイプ（|）文字でサイズを区切ります。 例 sz=320x50（サイズが 1 つの場合） sz=320x50|300x50（サイズが複数の場合） タグなしリクエストでは、パイプ（|）文字を %7c でエンコードすることをおすすめします。 例 &sz=216x36|300x50|320x50 は &sz=216x36%7c300x50%7c320x50 とします。
url	最初の広告リクエストをホストするドメインの URL。MCM リクエストでのみ必須です。 例 url=www.example.com
c	correlator 値（またはキャッシュ無効化の値）です。必ず 0～9 の数字のみからなる乱数を使用します（文字は使用できません）。ページの読み込み時に毎回広告サーバーを新しく呼び出すためにパブリッシャーが作成します。これにより、インプレッションのカウントに差異が生じるのを防ぐことができます。 例 c=8362527364
tile	ウェブページでのタグの位置です。値は固有の整数にする必要があります。実装を簡単にするには、値を 1、2、3 といった番号にすることをおすすめします。 複数の広告タグが同一の広告ユニットコード（iu=）と correlator 値（c=）を同一ページで使用している場合のみ必要です。 例 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

省略可能なパラメータ

パラメータ	説明
d_imp	後発インプレッションの切り替えです。このパラメータを含めると、リクエスト時のインプレッションのカウントは無効になります。インプレッションの記録には、返されるクリエイティブの表示インプレッション マクロ、または d_imp_hdr パラメータの情報が使用されます。 例 d_imp=1 d_imp=0（Google アド マネージャーのインプレッション カウントのデフォルト値です。）
d_imp_hdr	後発インプレッション ヘッダー情報の切り替えです。このパラメータを含めると、インプレッションのカウントに使用される表示 URL が HTTP ヘッダー内に返されます。デフォルトではこのヘッダー情報は定義されていないため、インプレッションをカウントするには、パブリッシャーがこの表示 URL を手動で ping する必要があります。インプレッションのカウントとタグなしリクエストについて Google-Delayed-Impression ヘッダーには Google アド マネージャーのインプレッション URL が含まれています。 Google-3rdParty-Delayed-Impression ヘッダーには第三者インプレッション URL が含まれています（クリエイティブ内にある場合）。 例 d_imp_hdr=1 d_imp_hdr=0（後発インプレッション ヘッダー情報を明確に無効にします。）
t	スロットレベルの Key-Value ペアです。各キーと値は等号（=）で区切られ、Key-Value ペアはアンパサンド（&）で区切られます。各キーと値を個別に URL エンコードし、さらに、文字列全体を URL エンコードする必要があります。Key-Value セットに含まれるキーはそれぞれ固有である必要があります。同じキーを複数指定した場合は、関連付けられている値のうち 1 つのみが使用されます。 例 パラメータ t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith はキー「genre」を値「action」に割り当て、キー「movie」を値「Mr & Mrs Smith」に割り当てます。 Key-Value の間の「&」は 1 つずつエンコードされて「%26」になりますが、指定した値の中に含まれる「&」は 2 つまとめてエンコードされて「%2526」になります。 競合相手の除外には、特殊キーとして excl_cat を使用します。 例 t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines 次の文字はキーまたは値に使用できません。" ' ! + # * ~ ; ^ ( ) < > [ ] = .スペースは値に使用できますが（%20 または + としてエスケープ）、キーには使用できません。 例 t=a%3Db%252Bc を使用してキー「a」を値「b+c」に設定することはできません。
m	HTTP ヘッダーの MIME タイプの値です。 例 m=text/wml
mob	モバイル広告リクエストのインジケータです。 例 mob=js（この値のみ使用できます。）
ppid	パブリッシャー指定の識別子（PPID）パラメータを使うと、フリークエンシー キャップ、オーディエンス セグメンテーション、オーディエンス ターゲティング、広告の順次ローテーション、その他オーディエンスに基づく各種デバイスへの広告配信管理で使用する識別子を Google アド マネージャーに送信できます。 例 ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	モバイル デバイスの画面の幅です。広告サーバーによる自動検出よりも優先的に使用されます。 例 u_w=1024
u_h	モバイル デバイスの画面の高さです。広告サーバーによる自動検出よりも優先的に使用されます。 例 u_h=768
submodel	モバイル デバイスのハードウェア情報です。広告サーバーによる自動検出よりも優先的に使用されます。 例 submodel=iPhone4%2C1（下位機種値を区切るカンマはエンコードされています。） 下位機種値: iPhone（第 1 世代）: iPhone1,1 iPhone 3G: iPhone1,2 iPhone 3GS: iPhone2,1 iPhone 4（GSM）: iPhone3,1 iPhone 4（GSM）: iPhone3,2 iPhone 4（CDMA）: iPhone3,3 iPhone 4S: iPhone4,1 iPhone 5（GSM、LTE）: iPhone5,1 iPhone 5（CDMA、LTE）: iPhone5,2 iPhone 5c（GSM、CDMA）: iPhone5,3 iPhone 5c（GSM、CDMA）: iPhone5,4 iPhone 5s（GSM、CDMA）: iPhone6,1 iPhone 5s（GSM、CDMA）: iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2 第 1 世代 iPod: iPod1,1 第 2 世代 iPod: iPod2,1 第 3 世代 iPod: iPod3,1 第 4 世代 iPod: iPod4,1 第 5 世代 iPod: iPod5,1 第 1 世代 iPad（Wi-Fi）: iPad1,1 第 1 世代 iPad（AT&T）: iPad1,2 第 2 世代 iPad（Wi-Fi）: iPad2,1 第 2 世代 iPad（AT&T）: iPad2,2 第 2 世代 iPad（Verizon）: iPad2,3 第 2 世代 iPad（Wi-Fi）: iPad2,4 第 3 世代 iPad（Wi-Fi）: iPad3,1 第 3 世代 iPad（Verizon）: iPad3,2 第 3 世代 iPad（AT&T）: iPad3,3 第 4 世代 iPad（Wi-Fi）: iPad3,4 第 4 世代 iPad（AT&T）: iPad3,5 第 4 世代 iPad（Verizon）: iPad3,6 iPad Mini（Wi-Fi）: iPad2,5 iPad Mini（米 AT&T、GSM、LTE 4、17）: iPad2,6 iPad Mini（全世界の Verizon、GSM、DMA、LTE 1、3、5、13、25）: iPad2,7 iPad Mini Retina（Wi-Fi）: iPad4,4 iPad Mini Retina（LTE）: iPad4,5 iPad Air（Wi-Fi）: iPad4,1 iPad Air（LTE）: iPad4,2

 

フリークエンシー キャップとオーディエンス ターゲティングにリセット可能なデバイス ID（RDID）を使用することができます。タグなしリクエストについて詳しくは、RDID の設定をご覧ください。

インプレッション トラッキングを有効にする

アド マネージャーでは、タグなしリクエストのダウンロード インプレッション（「後発」インプレッション）をトラッキングできます。これには、次のいずれかの方法を使用します。両方は使用できませんのでご注意ください。両方使用すると、インプレッション数のカウントが重複する可能性があります。

おすすめは 1 の方法ですが、この方法を使用するには HTTP レスポンス ヘッダーにアクセスできることと、ヘッダーに基づくプロトコルを実装できることが必要です。

方法 1: HTTP レスポンス ヘッダーを読み取ってインプレッションのカウントを制御する

タグなしリクエストに d_imp=1 と d_imp_hdr=1 パラメータを追加します。こうすると、Google-Delayed-Impression HTTP ヘッダー URL を使ってインプレッションを手動で ping するまでは、Google アド マネージャーでインプレッションやダウンロード インプレッションは記録されません。インプレッションを ping すると、Google アド マネージャーで「広告サーバーのインプレッション」と「広告サーバーのダウンロード インプレッション」が記録されます。

インプレッションを 2 回カウントしないようにするため、タグなしリクエストから返されるクリエイティブには表示インプレッション マクロを追加しないでください。

方法 2: 表示インプレッション マクロを使用する

HTTP レスポンス ヘッダーにアクセスできない場合は、広告枠を分割して、タグなしリクエストによって返される各クリエイティブのコード スニペットに表示インプレッション マクロを追加します。このマクロはレンダリング時に、クリエイティブで送信される URL に展開されます。

タグなしリクエストでクリエイティブ コードを取得する

ウェブ コンテンツ

タグなしリクエストは通常、Google のタグ設定や SDK がサポートされない環境で使用します。ウェブでタグなしリクエストを読み込む場合は、必ず <iframe> 内に読み込んでください。そうすると、返されたエンコード前のコードを実行できるようになります。

Google SDK を使用しないカスタム環境

Google のタグ設定や SDK がサポートされない環境（Google 以外のセットトップ ボックスなど）でエンコード前のクリエイティブ コードを取得するには、次のガイドラインを参照してください。

• User-Agent リクエスト ヘッダーに有効なユーザー エージェントを設定し、ターゲティングが適切に機能するようにします。
• JavaScript とクリエイティブのエキスパンドを含め、ご利用の環境でリッチメディアの動作を管理できるようにします。
• Google アド マネージャーに HTTPS リクエストを行います。
• レスポンスのステータスを調べて、リクエストの形式が正しかったことを示す「HTTP 200/OK」を探します。

タグなしリクエストでサポートされていない機能

• アクティブ ビュー
• Ad Exchange
• トラッキングに使用される Cookie やモバイルアプリの識別子
• クリエイティブ ラッパー
• AdSense、Ad Exchange、AdMob のダイナミック アロケーション
• ネイティブ広告枠
• 優先取引
• クリエイティブのプレビュー

HTML 画像タグ（<img>）で gampad/ad を使用するタグなしリクエストでは、JavaScript トラッキング コードはサポートされていません。また、ダウンロード インプレッションはカウントされません。

このような広告についてレポートを作成するには、アド マネージャー レポートの「合計コード配信数」の指標を使用してください。