MatchingFunction

Abgleichfunktion, die einem CustomerFeed, CampaignFeed oder Anzeigengruppenfeed zugeordnet ist Die Abgleichfunktion wird verwendet, um die Gruppe der ausgewählten Feedelemente zu filtern.

JSON-Darstellung
{
  "operator": enum (MatchingFunctionOperator),
  "leftOperands": [
    {
      object (Operand)
    }
  ],
  "rightOperands": [
    {
      object (Operand)
    }
  ],
  "functionString": string
}
Felder
operator

enum (MatchingFunctionOperator)

Operator für eine Funktion.

leftOperands[]

object (Operand)

Die Operanden auf der linken Seite der Gleichung. Dies ist auch der Operand, der für Einzeloperandenausdrücke wie NOT verwendet werden soll.

rightOperands[]

object (Operand)

Die Operanden auf der rechten Seite der Gleichung.

functionString

string

Stringdarstellung der Funktion.

Beispiele:

  1. IDENTITY(true) oder IDENTITY(false). Alle oder keine Feedelemente wurden ausgeliefert.
  2. EQUALS(CONTEXT.DEVICE,"Mobile")
  3. IN(FEED_ITEM_ID;{1000001;1000002;1000003})
  4. CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"})
  5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile"))

Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/docs/extensions/feeds/matching-functions.

Da mehrere Strings dieselbe zugrunde liegende Funktion darstellen können (z. B. Leerzeichen und einfache oder doppelte Anführungszeichen), ist der zurückgegebene Wert möglicherweise nicht identisch mit dem String, der in einer „mutate“-Anfrage gesendet wurde.

MatchingFunctionOperator

Mögliche Operatoren in einer Abgleichfunktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
IN Der IN-Operator.
IDENTITY Der Operator IDENTITY
EQUALS Der Operator EQUALS
AND Operator, der zwei oder mehr Operanden vom Typ „FunctionOperand“ annimmt und überprüft, ob alle Operanden als „true“ ausgewertet werden. Bei Funktionen für Anzeigenformate müssen alle Operanden in leftOperands enthalten sein.
CONTAINS_ANY Operator, der „true“ zurückgibt, wenn die Elemente in leftOperands eines der Elemente in rightOperands enthalten. Andernfalls wird „false“ zurückgegeben. Die rightOperands müssen mindestens einen und dürfen höchstens drei ConstantOperands enthalten.

Operand

Ein Operand in einer Abgleichfunktion.

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld function_argument_operand. Verschiedene Operanden, die in einer Abgleichfunktion verwendet werden können. Erforderlich. Für function_argument_operand ist nur einer der folgenden Werte zulässig:
constantOperand

object (ConstantOperand)

Ein konstanter Operand in einer Abgleichfunktion.

feedAttributeOperand

object (FeedAttributeOperand)

Dieser Operand gibt ein Feed-Attribut im Feed an.

functionOperand

object (FunctionOperand)

Ein Funktionsoperand in einer Abgleichfunktion. Wird zur Darstellung verschachtelter Funktionen verwendet.

requestContextOperand

object (RequestContextOperand)

Ein Operand in einer Funktion, der auf einen Wert im Anfragekontext verweist.

ConstantOperand

Ein konstanter Operand in einer Abgleichfunktion.

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld constant_operand_value. Konstante Operandenwerte Erforderlich. Für constant_operand_value ist nur einer der folgenden Werte zulässig:
stringValue

string

Stringwert des Operanden, wenn es sich um einen Stringtyp handelt.

longValue

string (int64 format)

Int64-Wert des Operanden, wenn es sich um einen int64-Typ handelt.

booleanValue

boolean

Boolescher Wert des Operanden, wenn es sich um einen booleschen Typ handelt

doubleValue

number

Double-Wert des Operanden, wenn es sich um einen Double-Typ handelt.

FeedAttributeOperand

Ein Feedattribut-Operand in einer Abgleichfunktion. Wird zur Darstellung eines Feedattributs im Feed verwendet.

JSON-Darstellung
{
  "feedId": string,
  "feedAttributeId": string
}
Felder
feedId

string (int64 format)

Der zugehörige Feed. Erforderlich.

feedAttributeId

string (int64 format)

ID des Feedattributs, auf das verwiesen wird. Erforderlich.

FunctionOperand

Ein Funktionsoperand in einer Abgleichfunktion. Wird zur Darstellung verschachtelter Funktionen verwendet.

JSON-Darstellung
{
  "matchingFunction": {
    object (MatchingFunction)
  }
}
Felder
matchingFunction

object (MatchingFunction)

Die in diesem Operanden enthaltene Übereinstimmungsfunktion.

RequestContextOperand

Ein Operand in einer Funktion, der auf einen Wert im Anfragekontext verweist.

JSON-Darstellung
{
  "contextType": enum (MatchingFunctionContextType)
}
Felder
contextType

enum (MatchingFunctionContextType)

Werttyp, auf den im Anfragekontext verwiesen wird.

MatchingFunctionContextType

Mögliche Kontexttypen für einen Operand in einer Abgleichfunktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
FEED_ITEM_ID ID des Feedelements im Anfragekontext
DEVICE_NAME Das verwendete Gerät. Mögliche Werte sind „Computer“ oder „Mobil“.
FEED_ITEM_SET_ID ID des Feedelementsatzes im Anfragekontext