マクロ
マクロは、二重波括弧内でクリックおよびインプレッション・トラッキング URL に追加できるコンポーネントです。 バナー表示時に、これらのコンポーネントは対応する値に置き換えられます。
たとえば、マクロ {{adsetid}} は、広告の生成元の広告セット ID に置き換えられます。 したがって、インプレッション・トラッキング URL またはクリック・トラッキング URL にマクロ {{adsetid}} を含めると、どのキャンペーンの広告セットが特定の広告表示のソースであったかをトラッキングできます。 たとえば、クリック・トラッキング URL が http://mylandingpage.com/tracking?campaign={{adsetid}} である場合、広告セット 257842 の広告表示において、実際のランディング URL は http://mylandingpage.com/tracking?campaign=257842
に変換されます。クリック・トラッキング URL とインプレッション・トラッキング URL で使用できるマクロを以下の表に示します。
マクロ名 | 説明 | サンプル値 |
adsetid | キャンペーン（広告セット）の数値 ID バナーの生成元のキャンペーン（広告セット）の ID 番号 | 257842 |
creative_type |
| 1 |
device_id | （使用可能な場合）Apple デバイス ID（IDFA、大文字） または（使用可能な場合）Android デバイス ID（GAID、E57293961239（OS デバイス） または空 | 01234567-89AB-CDEF-0123-456789ABCDEF（iOS） または 01234567-89ab-cdef-0123-456789abcdef（Android） |
domain | Web 上で広告が表示される場合はパブリッシャーのドメイン名（アプリのサプライでは空） | https://exampledomain.com/ |
gdpr (*) | 広告表示が GDPR 規制の対象となるかどうかを決定する | 0（GDPR が適用されない） 1（GDPR が適用される） |
gdpr_consent_kv (*) | 同意が空でない場合の関連する IAB TCF v2 同意パラメータの文字列が含まれる Criteo 固有の GDPR 同意パラメータ。 詳細はこちら。 | 同意文字列が存在する場合、このマクロは gdpr_consent=XXX（XXX は IAB TCF v2 の同意文字列を指す）として機能します。 |
OS | デバイスのオペレーティングシステム | iOS |
random | キャッシュバスターとして使用される擬似乱数の値 | 116htg738y |
timestamp | 現在のエポック・タイムスタンプ | 1553097335 |
adid | 広告 ID、一意の広告識別子 | 12356 |
criteo_campaign_id | Criteo マーケティング・キャンペーンの ID 番号 | 213682 |
height | インプレッションのスロットの高さ（ピクセル） | 160 x 600 のバナーの場合は 600 |
width | インプレッションのスロットの幅（ピクセル） | 160 x 160 のバナーの場合は 160 |
display_env | ディスプレイの表示環境 |
|
bundle_id | アプリ内で広告が表示されるパブリッシャーのアプリのバンドル／アプリ ID | com.opera.mini（Android）、1207472156（iOS） |
bundle_name | アプリ内で広告が表示されるパブリッシャーのアプリユーザーが判読できる名前 | Opera Mini - fast web browser（Android の com.opera.mini の場合）Wordscapes（iOS の 1207472156 の場合） |
user_agent | URL 生成サービスによって取得される User-Agent ヘッダー（例：ads.criteo.com または cat.criteo.com） | Mozilla/5.0（Android 4.4; Mobile; rv:41.0）Gecko/41.0 Firefox/41.0 |
(*)：サードパーティのクリックおよびインプレッションのトラッキングURLでGDPRの変数を正しく設定するために、GDPR のセクションで提示される例を参照してください。