Campaign Manager 360 API . customEvents

Instance Methods

batchinsert(profileId, body=None, x__xgafv=None)

Inserts custom events.

close()

Close httplib2 connections.

Method Details

batchinsert(profileId, body=None, x__xgafv=None)
Inserts custom events.

Args:
  profileId: string, User profile ID associated with this request. (required)
  body: object, The request body.
    The object takes the form of:

{ # Insert Custom Events Request.
    "customEvents": [ # The set of custom events to insert.
      { # Experimental feature (no support provided) A custom event represents a third party impression, a third party click, an annotation on a first party impression, or an annotation on a first party click.
        "timestampMicros": "A String", # The timestamp of this custom event, in Unix epoch micros. This is a required field.
        "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEvent".
        "floodlightConfigurationId": "A String", # Floodlight configuration ID of the advertiser the event is linked to. This is a required field.
        "eventType": "A String", # The type of event. If INSERT, the fields in insertEvent need to be populated. If ANNOTATE, the fields in either annotateClickEvent or annotateImpressionEvent need to be populated.
        "annotateClickEvent": { # Annotate a click event. # Annotate a click event. This field is mutually exclusive with insertEvent and annotateImpressionEvent. This or insertEvent and annotateImpressionEvent is a required field.
          "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventClickAnnotation".
          "gclid": "A String", # The Google click ID. Use this field to annotate the click associated with the gclid.
        },
        "annotateImpressionEvent": { # Annotate an impression. # Annotate an impression. This field is mutually exclusive with insertEvent and annotateClickEvent. This or insertEvent and annotateClickEvent is a required field.
          "pathImpressionId": "A String", # The path impression ID. Use this field to annotate the impression associated with the pathImpressionId.
          "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventImpressionAnnotation".
        },
        "insertEvent": { # Custom event to be inserted. # Insert custom event. This field is mutually exclusive with annotateClickEvent and annotateImpressionEvent. This or annotateClickEvent and annotateImpressionEvent is a required field.
          "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventInsert".
          "insertEventType": "A String", # The type of event to insert.
          "cmDimensions": { # Campaign Manager IDs related to the custom event. # Campaign Manager dimensions associated with the event.
            "siteId": "A String", # Site ID for Campaign Manager.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignManagerIds".
            "campaignId": "A String", # Campaign ID for Campaign Manager.
            "placementId": "A String", # Placement ID for Campaign Manager.
            "creativeId": "A String", # Creative ID for Campaign Manager.
            "adId": "A String", # Ad ID for Campaign Manager.
          },
          "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with matchId, and at least one of the two fields is required.
          "dv3Dimensions": { # DV360 IDs related to the custom event. # DV360 dimensions associated with the event.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dV3Ids".
            "dvCampaignId": "A String", # Campaign ID for DV360.
            "dvLineItemId": "A String", # Line Item ID for DV360.
            "dvCreativeId": "A String", # Creative ID for DV360.
            "dvInsertionOrderId": "A String", # Insertion Order ID for DV360.
            "dvSiteId": "A String", # Site ID for DV360.
          },
          "matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with mobileDeviceId, and at least one of the two fields is required.
        },
        "customVariables": [ # Custom variables associated with the event.
          { # Custom variable.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customVariable".
            "index": "A String", # The index of the custom variable.
            "value": "A String", # The value of the custom variable. The length of string must not exceed 50 characters.
          },
        ],
        "ordinal": "A String", # The ordinal of this custom event. This is a required field.
      },
    ],
    "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventsBatchInsertRequest".
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Insert Custom Events Response.
    "hasFailures": True or False, # Indicates that some or all custom events failed to insert.
    "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventsBatchInsertResponse".
    "status": [ # The insert status of each custom event. Statuses are returned in the same order that conversions are inserted.
      { # The original custom event that was inserted and whether there were any errors.
        "errors": [ # A list of errors related to this custom event.
          { # The error code and description for a custom event that failed to insert.
            "code": "A String", # The error code.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventError".
            "message": "A String", # A description of the error.
          },
        ],
        "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventStatus".
        "customEvent": { # Experimental feature (no support provided) A custom event represents a third party impression, a third party click, an annotation on a first party impression, or an annotation on a first party click. # The original custom event that was inserted.
          "timestampMicros": "A String", # The timestamp of this custom event, in Unix epoch micros. This is a required field.
          "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEvent".
          "floodlightConfigurationId": "A String", # Floodlight configuration ID of the advertiser the event is linked to. This is a required field.
          "eventType": "A String", # The type of event. If INSERT, the fields in insertEvent need to be populated. If ANNOTATE, the fields in either annotateClickEvent or annotateImpressionEvent need to be populated.
          "annotateClickEvent": { # Annotate a click event. # Annotate a click event. This field is mutually exclusive with insertEvent and annotateImpressionEvent. This or insertEvent and annotateImpressionEvent is a required field.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventClickAnnotation".
            "gclid": "A String", # The Google click ID. Use this field to annotate the click associated with the gclid.
          },
          "annotateImpressionEvent": { # Annotate an impression. # Annotate an impression. This field is mutually exclusive with insertEvent and annotateClickEvent. This or insertEvent and annotateClickEvent is a required field.
            "pathImpressionId": "A String", # The path impression ID. Use this field to annotate the impression associated with the pathImpressionId.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventImpressionAnnotation".
          },
          "insertEvent": { # Custom event to be inserted. # Insert custom event. This field is mutually exclusive with annotateClickEvent and annotateImpressionEvent. This or annotateClickEvent and annotateImpressionEvent is a required field.
            "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventInsert".
            "insertEventType": "A String", # The type of event to insert.
            "cmDimensions": { # Campaign Manager IDs related to the custom event. # Campaign Manager dimensions associated with the event.
              "siteId": "A String", # Site ID for Campaign Manager.
              "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#campaignManagerIds".
              "campaignId": "A String", # Campaign ID for Campaign Manager.
              "placementId": "A String", # Placement ID for Campaign Manager.
              "creativeId": "A String", # Creative ID for Campaign Manager.
              "adId": "A String", # Ad ID for Campaign Manager.
            },
            "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with matchId, and at least one of the two fields is required.
            "dv3Dimensions": { # DV360 IDs related to the custom event. # DV360 dimensions associated with the event.
              "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dV3Ids".
              "dvCampaignId": "A String", # Campaign ID for DV360.
              "dvLineItemId": "A String", # Line Item ID for DV360.
              "dvCreativeId": "A String", # Creative ID for DV360.
              "dvInsertionOrderId": "A String", # Insertion Order ID for DV360.
              "dvSiteId": "A String", # Site ID for DV360.
            },
            "matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with mobileDeviceId, and at least one of the two fields is required.
          },
          "customVariables": [ # Custom variables associated with the event.
            { # Custom variable.
              "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customVariable".
              "index": "A String", # The index of the custom variable.
              "value": "A String", # The value of the custom variable. The length of string must not exceed 50 characters.
            },
          ],
          "ordinal": "A String", # The ordinal of this custom event. This is a required field.
        },
      },
    ],
  }
close()
Close httplib2 connections.