MatchingFunction

Funkcja dopasowania powiązana z plikiem danych klienta, plikiem danych kampanii lub plikiem danych grupy reklam. Funkcja dopasowania służy do filtrowania wybranych elementów w pliku danych.

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 także operand, który powinien być używany w przypadku wyrażeń zawierających jeden operand, takich jak NOT.
rightOperands[]

object (Operand)

operandy po prawej stronie równania.
functionString

string

Ciąg znaków funkcji.

Przykłady:

  1. IDENTITY(true) lub IDENTITY(false). Wyświetlono wszystkie elementy kanału lub nie wyświetlały się żadne elementy.
  2. EQUALS(CONTEXT.DEVICE,"Mobile")
  3. IN(ID_ITEM_PLIKU;{1000001;1000002;1000003})
  4. CONTAINS_ANY(FeedAttribute[12345678,0],{"rejs na Marsie","Rejs po Wenesie"})
  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 Używana tylko w przypadku wartości zwracanej. 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 FunctionPageRank i sprawdza, czy wszystkie operandy mają wartość prawda. W przypadku funkcji związanych z formatami reklam wszystkie operandy muszą znajdować się w ciągu właściwości leftValues.
CONTAINS_ANY Operator zwracający wartość „true” (prawda), jeśli elementy w argumencie leftValues zawierają którykolwiek z elementów w elemencie rightLocations. W przeciwnym razie zwracaj wartość „false” (fałsz). Argumenty parametr right muszą zawierać od 1 do 3 stałych argumentów.

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 być tylko jedną z tych wartości:
constantOperand

object (ConstantOperand)

Argument stały w funkcji dopasowania.
feedAttributeOperand

object (FeedAttributeOperand)

Ten operand określa atrybut w pliku danych.
functionOperand

object (FunctionOperand)

Argument funkcji w funkcji dopasowania. Służy do reprezentowania funkcji zagnieżdżonych.
requestContextOperand

object (RequestContextOperand)

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

ConstantOperand

Argument stały 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. Argumenty stałe. To pole jest wymagane. constant_operand_value może być tylko jedną z tych wartości:
stringValue

string

Wartość ciągu argumentu operandu, jeśli jest to typ ciągu 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ójna argumentu operandu, jeśli jest to typ zmiennoprzecinkowy.

FeedAttributeOperand

Argument atrybutu pliku danych w funkcji dopasowania. Służy do reprezentowania atrybutu 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 dopasowania. Służy do reprezentowania funkcji zagnieżdżonych.

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

object (MatchingFunction)

Funkcja dopasowania przechowywana w tym operandzie.

RequestContextOperand

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

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

enum (MatchingFunctionContextType)

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

MatchingFunctionContextType

Możliwe typy kontekstu dla operandu w funkcji dopasowania.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. 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 „Desktop” lub „Mobile”).
FEED_ITEM_SET_ID Identyfikator zestawu elementu kanału w kontekście żądania.