広告コピーや、キーワード、キャンペーン、広告グループなどの設定で、項目ごとにそれぞれ一意の値を生成するには、在庫テンプレートに DoubleClick Search 関数や、在庫属性、数式列を追加します。他方、広告やキーワードなどの項目単位ですべて同じ値を使用する場合は、設定のデータタイプに応じて静的なテキストや数値を入力します。
たとえば、下記の広告テンプレートは次のように構成されています。
- [広告見出し 1] は、静的テキスト「Sale on outdoor shoes」を出力します。
- [広告見出し 2] は、次の数式を使用して、商品の価格が 25 ドルを超えた場合に「Free shipping」を生成します。
[if(max(Item_price) < 25, "Fast", "Free")] shipping
[広告見出し 2] は、2 つの関数（ifとmax）、静的な数値とテキスト、Item_price 在庫属性を組み合わせて出力を生成しています。
在庫テンプレートの構文
在庫テンプレート内でキャンペーン、広告グループ、広告、キーワードなどの設定を入力する構文は次のとおりです。
- 静的なテキストと数値はテンプレートに直接入力できます。
- 日付は、date 関数などの関数に入力する必要があります。
- 関数、在庫属性、数式列は、すべて角かっこ（
[ ]）で囲む必要があります。
広告コピー内で角かっこ（[ ]）を使用するには、次のようにエスケープします。
\[ \]
例: \ [*EngineAccountType*\]) - マクロをエスケープします。
利用上の注意: 利用できる関数はコンテキストに応じて決まる
DS には広範な関数コレクションが用意されていますが、一部の関数は、在庫データを含む数式や数式列でのみ使用できます。たとえば、max(ATTRIBUTE) は、広告グループ内のすべての項目の中で在庫属性の最も高い値を計算します。したがって、この関数を適用できるのは在庫データに限られます。
エンジン指標やコンバージョン指標を含む数式列でのみ使用できる関数もあります。たとえば、for_date_range(date) は、「Clicks.for_date_range(last_7_days())」のように必ず指標と組み合わせて使用する必要があります。
在庫テンプレートを作成する際は、現在のコンテキストで有効な関数だけが表示されます。
利用上の注意: 無効な値にあらかじめ対処しておく
データのパターンをすべて予測しておくことは不可能なため、作成した関数が潜在的なエラーを適切に処理できるようになっているか、必ずご確認ください。関数が空の値や無効な値を返した場合、DS は、キャンペーンや広告などの項目を生成しません。エラーの対処方法としては、次のようなアプローチがあります（すべてのアプローチを併用することも可能です）。
if_error(function, alternate)やif(is_error(function), alternate1, alternate2)で関数をラップします。function がエラーを返した場合や空の値だった場合、代わりに alternate が返されます。if(condition, true, else)関数を使用して、望まない結果を除外するか変更します。- 広告グループごとに在庫属性の値が 1 つだけになっている場合を除き、
min(ATTRIBUTE)や、max(ATTRIBUTE)、any(ATTRIBUTE) で在庫属性をラップします。
たとえば、広告グループ内に価格の異なる複数の商品が含まれている場合は、max(Item_price)を指定します。 - 広告テンプレートの出力が長すぎる場合に備えて、広告テンプレート内で各フィールドの予備を作成しておきます。
在庫テンプレートで使用する数式列を作成する
さまざまなテンプレートで同じ関数、在庫属性、静的テキストを頻繁に使用する場合は、数式列内でロジックを定義して、その数式列を各テンプレートで使用します。これにより、テンプレートごとにロジックを繰り返す必要がなくなります。
たとえば、商品の価格に「$」というプレフィックスを追加し、小数第 2 位までの価格を出力することが多い場合は、次のように指定します。
- 次の数式を含む数式列を作成します。
"$" & to_string(Item_price, 2) - この列にわかりやすい名前を付けます（「price_with_currency」など）。
- テンプレート内で上記の数式を必要とする場所に、この列を組み込みます。たとえば、広告テンプレートの「説明」内に次の行を組み込みます。
Prices start at [c:"price_with_currency"]
在庫テンプレートで使用できる数式列を作成するには:
-
広告主に移動します。
-
左パネルで、[在庫管理] をクリックします。
-
[在庫項目] タブをクリックします。
-
掲載結果の概要グラフの上部にあるツールバーで、[表示項目] ボタンをクリックします。
列選択ツールが表示されます。 -
[使用可能な項目] で、[数式列] をクリックします。
その広告主内ですでに作成されている数式列のリストが表示されます。 -
[新しい列を作成] をクリックします。
新しい列を設定するためのポップアップ ダイアログが表示されます。 -
列に名前を付けます。
この名前が在庫テンプレートを作成する際に表示されるため、誰が見てもわかりやすい名前を指定するようにしてください。 -
[計算式を入力] ボックスに、新しい数式を入力します。
検索フィールドを使用して、利用可能な在庫属性の名前や関数を検索します。必ず数式列の構文を使用します。数式列の構文と在庫テンプレートの構文は異なります。 - [保存] をクリックします。
- エラーが発生した場合は、[エラーを選択] をクリックして、個々のエラーをハイライト表示し、修正して、もう一度 [保存] をクリックします。
- エラーをすべて解決すると、その列は選択した列のリストに自動的に表示されます。