# Campaign Manager 360 API . customEvents

## Instance Methods

Inserts custom events.

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.
            "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#customEvent".
            "customVariables": [ # Custom variables associated with the event.
              { # Custom variable.
                "value": "A String", # The value of the custom variable. The length of string must not exceed 50 characters.
                "index": "A String", # The index of the custom variable.
                "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customVariable".
              },
            ],
            "timestampMicros": "A String", # The timestamp of this custom event, in Unix epoch micros. This is a required field.
            "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.
              "gclid": "A String", # The Google click ID. Use this field to annotate the click associated with the gclid.
              "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventClickAnnotation".
            },
            "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.
            "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.
              "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.
              "dv3Dimensions": { # DV360 IDs related to the custom event. # DV360 dimensions associated with the event.
                "dvCreativeId": "A String", # Creative ID for DV360.
                "dvInsertionOrderId": "A String", # Insertion Order ID for DV360.
                "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dV3Ids".
                "dvLineItemId": "A String", # Line Item ID for DV360.
                "dvCampaignId": "A String", # Campaign ID for DV360.
                "dvSiteId": "A String", # Site ID for DV360.
              },
              "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventInsert".
              "cmDimensions": { # Campaign Manager IDs related to the custom event. # Campaign Manager dimensions associated with the event.
                "adId": "A String", # Ad ID for Campaign Manager.
                "siteId": "A String", # Site ID for Campaign Manager.
                "creativeId": "A String", # Creative ID for Campaign Manager.
                "placementId": "A String", # Placement 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.
              },
              "insertEventType": "A String", # The type of event to insert.
              "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with matchId, and at least one of the two fields is required.
            },
            "floodlightConfigurationId": "A String", # Floodlight configuration ID of the advertiser the event is linked to. 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.
                "message": "A String", # A description of the error.
                "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventError".
              },
            ],
            "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.
              "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#customEvent".
              "customVariables": [ # Custom variables associated with the event.
                { # Custom variable.
                  "value": "A String", # The value of the custom variable. The length of string must not exceed 50 characters.
                  "index": "A String", # The index of the custom variable.
                  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customVariable".
                },
              ],
              "timestampMicros": "A String", # The timestamp of this custom event, in Unix epoch micros. This is a required field.
              "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.
                "gclid": "A String", # The Google click ID. Use this field to annotate the click associated with the gclid.
                "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventClickAnnotation".
              },
              "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.
              "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.
                "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.
                "dv3Dimensions": { # DV360 IDs related to the custom event. # DV360 dimensions associated with the event.
                  "dvCreativeId": "A String", # Creative ID for DV360.
                  "dvInsertionOrderId": "A String", # Insertion Order ID for DV360.
                  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#dV3Ids".
                  "dvLineItemId": "A String", # Line Item ID for DV360.
                  "dvCampaignId": "A String", # Campaign ID for DV360.
                  "dvSiteId": "A String", # Site ID for DV360.
                },
                "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customEventInsert".
                "cmDimensions": { # Campaign Manager IDs related to the custom event. # Campaign Manager dimensions associated with the event.
                  "adId": "A String", # Ad ID for Campaign Manager.
                  "siteId": "A String", # Site ID for Campaign Manager.
                  "creativeId": "A String", # Creative ID for Campaign Manager.
                  "placementId": "A String", # Placement 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.
                },
                "insertEventType": "A String", # The type of event to insert.
                "mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with matchId, and at least one of the two fields is required.
              },
              "floodlightConfigurationId": "A String", # Floodlight configuration ID of the advertiser the event is linked to. This is a required field.
            },
          },
        ],
      }

`close()`

    Close httplib2 connections.