MatchingFunction

Abgleichfunktion, die mit einem CustomerFeed, CampaignFeed oder AnzeigengruppenFeed verknüpft ist. Die Übereinstimmungsfunktion wird verwendet, um die 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 Ausdrücke mit einzelnen Operanden verwendet werden soll, z. B. NOT.

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), stimmt der zurückgegebene Wert möglicherweise nicht mit dem String überein, 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 einen unbekannten Wert in dieser Version dar.
IN Der IN-Operator.
IDENTITY Der Operator IDENTITY
EQUALS Der Operator EQUALS
AND Operator, der zwei oder mehr Operanden vom Typ „FunctionOperand“ nimmt und prüft, ob alle Operanden als „true“ ausgewertet werden. Bei Funktionen für Anzeigenformate müssen sich alle Operanden in leftOperands befinden.
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 nicht mehr als 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 Feedattribut 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 sich auf einen Wert im Anfragekontext bezieht.

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

Zeichenfolgenwert des Operanden, wenn es sich um einen Zeichenfolgentyp 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

Doppelter Wert des Operanden, wenn es sich um einen doppelten Typ handelt.

FeedAttributeOperand

Ein Feedattribut-Operand in einer Abgleichfunktion. Wird verwendet, um ein Feedattribut im Feed darzustellen.

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

string (int64 format)

Der zugehörige Feed. Erforderlich.

feedAttributeId

string (int64 format)

ID des referenzierten Feedattributs. 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 Abgleichfunktion.

RequestContextOperand

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

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 einen unbekannten Wert in dieser Version 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