needle が haystack の部分文字列である場合や needle が haystack と同一である場合に、true と評価されます。
構文
contains(needle, haystack)
needle と haystack は、次のいずれかのデータ型です:
- 一定の String。たとえば、「GDN」など。
- String の 検索広告 360 変数。たとえば、
Keyword
、Campaign
、Engine_status
など。 - String を返す式列または数式列。
大文字/小文字の区別なし
テキストの比較では、大文字と小文字は区別されません。つまり、contains("gdn", "GDN")
は true と評価されます。
空白文字
この関数に式列や数式列を含めると、式列や数式列は空白文字と評価されます。
すべての文字列は、空白の(長さがゼロの)String を含むものとみなされます。したがって、contains("", "GDN")
は true と評価されます。
ただし、contains("GDN", "")
は false と評価されます。つまり、空白の文字列は、空白でない String を含みません。
例
-
contains("hook", "fishhook")
は true と評価されます。 -
キーワードに「hoopers」が含まれる場合に、「brand」と表示し、他のキーワードの場合、「non-brand」とを表示します:
if(contains("hoopers", keyword), "brand", "non-brand")
-
キーワードに「hoopers」が含まれ、「US」で始まるキャンペーンに含まれる場合、「US brand」と表示します。
if(and(contains("hoopers", keyword), starts_with(campaign, "US")), "US brand", "non-brand")
-
キャンペーンに「Shopping」や「GDN」、「RLSA」が含まれる場合、「budget 1」と表示し、それ以外の場合、「budget 2」と表示します。
if(or(contains("Shopping", campaign), contains("GDN", campaign), contains("RLSA", campaign)), "budget 1", "budget 2")