MatchingFunction

Funkcja dopasowania związana z plikiem danych o klientach, plikiem danych kampanii lub plikiem danych grupy reklam. Funkcja dopasowania służy do filtrowania zbioru wybranych elementów kanału.

Zapis JSON
{
  "operator": enum (MatchingFunctionOperator),
  "leftOperands": [
    {
      object (Operand)
    }
  ],
  "rightOperands": [
    {
      object (Operand)
    }
  ],
  "functionString": string
}
Pola
operator

enum (MatchingFunctionOperator)

Operator funkcji.

leftOperands[]

object (Operand)

operandy po lewej stronie równania. Jest to również operand, którego należy używać w przypadku wyrażeń z jednym argumentem, np. NOT.

rightOperands[]

object (Operand)

operandy po prawej stronie równania.

functionString

string

Ciąg znaków reprezentujący funkcję.

Przykłady:

  1. IDENTITY(prawda) lub IDENTITY(fałsz). Wyświetlono wszystkie elementy kanału lub nie wyświetlono żadnych elementów.
  2. EQUALS(CONTEXT.DEVICE,"Mobile")
  3. IN(FEED_ITEM_ID;{1000001;1000002;1000003})
  4. CONTAINS_ANY(FeedAttribute[12345678,0],{"rejs na Marsie","Venus rejs"})
  5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile"))

Więcej informacji znajdziesz na stronie https://developers.google.com/google-ads/api/docs/extensions/feeds/matching-functions.

Ponieważ wiele ciągów znaków może reprezentować tę samą funkcję bazową (na przykład odstępy oraz pojedyncze i podwójne cudzysłowy), zwrócona wartość może nie być taka sama jak ciąg wysłany w żądaniu zmiany.

MatchingFunctionOperator

Możliwe operatory w funkcji dopasowania.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
IN Operator IN.
IDENTITY Operator IDENTITY.
EQUALS Operator EQUALS
AND Operator, który przyjmuje co najmniej 2 operandy typu Functionopera i sprawdza, czy wszystkie operandy zwracają wartość „prawda”. W przypadku funkcji związanych z formatami reklam wszystkie operandy muszą znajdować się w elemencie left{9/}.
CONTAINS_ANY Operator zwracający wartość „true” (prawda), jeśli elementy w elemencie left{9/}s zawierają którykolwiek z elementów z parametru rightopera. W przeciwnym razie zwracaj wartość „false” (fałsz). Argumenty prawo muszą zawierać od 1 do 3 stałych.

Operand

Argument w funkcji dopasowania.

Zapis JSON
{

  // Union field function_argument_operand can be only one of the following:
  "constantOperand": {
    object (ConstantOperand)
  },
  "feedAttributeOperand": {
    object (FeedAttributeOperand)
  },
  "functionOperand": {
    object (FunctionOperand)
  },
  "requestContextOperand": {
    object (RequestContextOperand)
  }
  // End of list of possible types for union field function_argument_operand.
}
Pola
Pole sumy function_argument_operand. Różne operandy, których można używać w funkcji dopasowania. To pole jest wymagane. function_argument_operand może mieć tylko jedną z tych wartości:
constantOperand

object (ConstantOperand)

Stały operand w funkcji dopasowania.

feedAttributeOperand

object (FeedAttributeOperand)

Ten operand określa atrybut w pliku danych.

functionOperand

object (FunctionOperand)

Argument funkcji w funkcji pasującej. Służy do reprezentowania funkcji zagnieżdżonych.

requestContextOperand

object (RequestContextOperand)

operand w funkcji odwołujący się do wartości w kontekście żądania.

ConstantOperand

Stały operand w funkcji dopasowania.

Zapis JSON
{

  // Union field constant_operand_value can be only one of the following:
  "stringValue": string,
  "longValue": string,
  "booleanValue": boolean,
  "doubleValue": number
  // End of list of possible types for union field constant_operand_value.
}
Pola
Pole sumy constant_operand_value. Stałe wartości operandu. To pole jest wymagane. constant_operand_value może mieć tylko jedną z tych wartości:
stringValue

string

Wartość ciągu operandu, jeśli jest to ciąg znaków.

longValue

string (int64 format)

Wartość Int64 operandu, jeśli jest to typ int64.

booleanValue

boolean

Wartość logiczna operandu, jeśli jest to typ logiczny.

doubleValue

number

Wartość podwójnej precyzji operandu, jeśli jest to typ zmiennoprzecinkowy.

FeedAttributeOperand

Argument atrybutu pliku danych w funkcji dopasowania. Służy do reprezentowania atrybutu pliku danych w pliku danych.

Zapis JSON
{
  "feedId": string,
  "feedAttributeId": string
}
Pola
feedId

string (int64 format)

Powiązany plik danych. To pole jest wymagane.

feedAttributeId

string (int64 format)

Identyfikator wskazanego atrybutu pliku danych. To pole jest wymagane.

FunctionOperand

Argument funkcji w funkcji pasującej. Służy do reprezentowania funkcji zagnieżdżonych.

Zapis JSON
{
  "matchingFunction": {
    object (MatchingFunction)
  }
}
Pola
matchingFunction

object (MatchingFunction)

Funkcja dopasowująca w tym operandze.

RequestContextOperand

operand w funkcji odwołujący się do wartości w kontekście żądania.

Zapis JSON
{
  "contextType": enum (MatchingFunctionContextType)
}
Pola
contextType

enum (MatchingFunctionContextType)

Rodzaj wartości, do której należy się odwoływać w kontekście żądania.

MatchingFunctionContextType

Możliwe typy kontekstu dla operandu w funkcji dopasowania.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
FEED_ITEM_ID Identyfikator elementu kanału w kontekście żądania.
DEVICE_NAME Używany telefon (możliwe wartości to „Komputer” lub „Komórka”).
FEED_ITEM_SET_ID Identyfikator zestawu elementów kanału w kontekście żądania.