AdMob API . accounts . mediationGroups . mediationAbExperiments

Instance Methods

close()

Close httplib2 connections.

create(parent, body=None, x__xgafv=None)

Create an A/B testing experiment for a specified AdMob account and a mediation group. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

stop(name, body=None, x__xgafv=None)

Stop the mediation A/B experiment and choose a variant. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

Method Details

close()
Close httplib2 connections.
create(parent, body=None, x__xgafv=None)
Create an A/B testing experiment for a specified AdMob account and a mediation group. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

Args:
  parent: string, Required. The parent which owns the mediation group. Format: accounts/{publisher_id}/mediationGroups/{mediation_group_id} (required)
  body: object, The request body.
    The object takes the form of:

{ # The mediation A/B experiment.
  "controlMediationLines": [ # Output only. The experiment mediation lines for control. They are inherited from the parent mediation group. It is an output only field.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "displayName": "A String", # The display name for the mediation A/B experiment.
  "endTime": "A String", # Output only. The time at which the experiment was ended or target to end (in UTC).
  "experimentId": "A String", # Output only. Unique identifier for the mediation A/B experiment. It is an output only property.
  "mediationGroupId": "A String", # Output only. The mediation group id this experiment belongs to. This can be used for filtering the experiments in the list experiments API.
  "name": "A String", # Resource name for this experiment. The format is accounts/{publisher_id}/ mediationGroups/{mediation_group_id}/mediationAbExperiment/ {mediation_group_experiment_id}. For example: accounts/pub-9876543210987654/mediationGroups/0123456789/ mediationAbExperiment/12345
  "startTime": "A String", # Output only. The time at which the experiment was started (in UTC).
  "state": "A String", # Output only. The state of the experiment. It is an output only field.
  "treatmentMediationLines": [ # The experiment mediation lines created for the treatment. They will be used for serving when the experiment status is RUNNING.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "treatmentTrafficPercentage": "A String", # The percentage of the mediation A/B experiment traffic that will be send to the treatment (variant B). The remainder is sent to the control (variant A). The percentage is expressed as an integer in the inclusive range of [1,99]. See https://support.google.com/admob/answer/9572326 for details.
  "variantLeader": "A String", # Output only. The variant leader for the experiment according to some key metrics.
}

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

Returns:
  An object of the form:

    { # The mediation A/B experiment.
  "controlMediationLines": [ # Output only. The experiment mediation lines for control. They are inherited from the parent mediation group. It is an output only field.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "displayName": "A String", # The display name for the mediation A/B experiment.
  "endTime": "A String", # Output only. The time at which the experiment was ended or target to end (in UTC).
  "experimentId": "A String", # Output only. Unique identifier for the mediation A/B experiment. It is an output only property.
  "mediationGroupId": "A String", # Output only. The mediation group id this experiment belongs to. This can be used for filtering the experiments in the list experiments API.
  "name": "A String", # Resource name for this experiment. The format is accounts/{publisher_id}/ mediationGroups/{mediation_group_id}/mediationAbExperiment/ {mediation_group_experiment_id}. For example: accounts/pub-9876543210987654/mediationGroups/0123456789/ mediationAbExperiment/12345
  "startTime": "A String", # Output only. The time at which the experiment was started (in UTC).
  "state": "A String", # Output only. The state of the experiment. It is an output only field.
  "treatmentMediationLines": [ # The experiment mediation lines created for the treatment. They will be used for serving when the experiment status is RUNNING.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "treatmentTrafficPercentage": "A String", # The percentage of the mediation A/B experiment traffic that will be send to the treatment (variant B). The remainder is sent to the control (variant A). The percentage is expressed as an integer in the inclusive range of [1,99]. See https://support.google.com/admob/answer/9572326 for details.
  "variantLeader": "A String", # Output only. The variant leader for the experiment according to some key metrics.
}
stop(name, body=None, x__xgafv=None)
Stop the mediation A/B experiment and choose a variant. This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.

Args:
  name: string, Name of the mediation group, the experiment for which to choose a variant for. Example: accounts/pub-9876543210987654/mediationGroups/0123456789/ mediationAbExperiments (required)
  body: object, The request body.
    The object takes the form of:

{ # Request to end the mediation A/B experiment and choose a winning variant.
  "variantChoice": "A String", # The choice for the winning variant.
}

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

Returns:
  An object of the form:

    { # The mediation A/B experiment.
  "controlMediationLines": [ # Output only. The experiment mediation lines for control. They are inherited from the parent mediation group. It is an output only field.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "displayName": "A String", # The display name for the mediation A/B experiment.
  "endTime": "A String", # Output only. The time at which the experiment was ended or target to end (in UTC).
  "experimentId": "A String", # Output only. Unique identifier for the mediation A/B experiment. It is an output only property.
  "mediationGroupId": "A String", # Output only. The mediation group id this experiment belongs to. This can be used for filtering the experiments in the list experiments API.
  "name": "A String", # Resource name for this experiment. The format is accounts/{publisher_id}/ mediationGroups/{mediation_group_id}/mediationAbExperiment/ {mediation_group_experiment_id}. For example: accounts/pub-9876543210987654/mediationGroups/0123456789/ mediationAbExperiment/12345
  "startTime": "A String", # Output only. The time at which the experiment was started (in UTC).
  "state": "A String", # Output only. The state of the experiment. It is an output only field.
  "treatmentMediationLines": [ # The experiment mediation lines created for the treatment. They will be used for serving when the experiment status is RUNNING.
    { # The mediation group line for the experiment. It will be used for serving during the run of the experiment.
      "mediationGroupLine": { # Settings for an ad network used by a mediation group. # The mediation group line used by the experiment.
        "adSourceId": "A String", # The ID of the ad source this mediation line is associated with.
        "adUnitMappings": { # References of the ad unit mappings for each ad unit associated with this mediation line. Key is the ad unit ID, value is resource name of the ad unit mapping. For mediation lines where the ad source id is the AdMob Network, ad unit mappings will be ignored.
          "a_key": "A String",
        },
        "cpmMicros": "A String", # The CPM for this allocation line. $0.01 is the minimum allowed amount. For LIVE CPM modes, the default amount is $0.01. This value is ignored if `cpm_mode` is `LIVE`. **Warning:** "USD" is the only supported currency at the moment. The unit is in micros.
        "cpmMode": "A String", # Indicates how the CPM for this mediation line is provided. Note that `MANUAL` and `LIVE` are the only fully-supported mode at the moment. Please use the AdMob UI (https://admob.google.com) if you wish to create or update to other cpm modes.
        "displayName": "A String", # User-provided label for this mediation line. The maximum length allowed is 255 characters.
        "experimentVariant": "A String", # Output only. The Mediation A/B experiment variant to which the mediation group line belongs to.
        "id": "A String", # The 16 digit ID for this mediation line e.g. 0123456789012345. When creating a new mediation group line, use a distinct negative integer as the ID place holder.
        "state": "A String", # The status of the mediation group line. Only enabled mediation group lines will be served.
      },
    },
  ],
  "treatmentTrafficPercentage": "A String", # The percentage of the mediation A/B experiment traffic that will be send to the treatment (variant B). The remainder is sent to the control (variant A). The percentage is expressed as an integer in the inclusive range of [1,99]. See https://support.google.com/admob/answer/9572326 for details.
  "variantLeader": "A String", # Output only. The variant leader for the experiment according to some key metrics.
}