MatchingFunction

Abgleichfunktion, die mit einem CustomerFeed, CampaignFeed oder AdGroupFeed verknüpft ist. Die Abgleichfunktion 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. Dieser Operand wird auch für Einzel-Operandenausdrücke wie NOT verwendet.

rightOperands[]

object (Operand)

Die Operanden auf der rechten Seite der Gleichung.

functionString

string

Stringdarstellung der Funktion.

Beispiele:

  1. IDENTITY(true) oder IDENTITY(false). Es werden alle oder keine Feedelemente 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 möglicherweise dieselbe zugrunde liegende Funktion darstellen (z. B. Leerzeichen und einfache oder doppelte Anführungszeichen), ist der zurückgegebene Wert möglicherweise nicht mit dem String identisch, 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 in dieser Version unbekannten Wert dar.
IN Der IN-Operator.
IDENTITY Der IDENTITY-Operator.
EQUALS Der Operator EQUALS
AND Operator, der zwei oder mehr Operanden des Typs FunctionOperand annimmt und überprüft, ob alle Operanden als wahr ausgewertet werden. Für Funktionen in Bezug auf Anzeigenformate müssen alle Operanden in leftOperanden angegeben werden.
CONTAINS_ANY Operator, der "true" zurückgibt, wenn die Elemente in leftOperands eines der Elemente in rightOperands enthalten. Andernfalls wird „false“ zurückgegeben. Die rightOperanden 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 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, die 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

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 den Typ Double handelt.

FeedAttributeOperand

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

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

string (int64 format)

Den verknüpften Feed. Erforderlich.

feedAttributeId

string (int64 format)

Die 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 Abgleichfunktion in diesem Operanden.

RequestContextOperand

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

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

enum (MatchingFunctionContextType)

Typ des Werts, auf den im Anfragekontext verwiesen werden soll.

MatchingFunctionContextType

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

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert dar.
FEED_ITEM_ID Die ID des Feedelements im Anfragekontext.
DEVICE_NAME Das verwendete Gerät. Mögliche Werte sind „Desktop“ oder „Mobile“.
FEED_ITEM_SET_ID Die ID der Feedelement-Gruppe im Anfragekontext.