Tareas comunes de tráfico

En esta página, se explica cómo realizar algunas de las tareas de coordinación de anuncios más comunes mediante la API de coordinación de anuncios y de informes de DCM/DFA.

Sugerencias generales de programación

  • Propiedades y parámetros obligatorios y opcionales: Consulta la documentación de referencia para saber si se requiere una propiedad o un parámetro para una llamada a la API.
  • Búsquedas de nombres de comodines: Puedes usar el comodín de asterisco (*) cuando buscas nombres para objetos. Un asterisco coincide con cero o más caracteres. La API también admite la búsqueda de subcadenas implícitas; por lo tanto, la búsqueda de “abc” buscará implícitamente “*abc*”.
  • Actualización o aplicación de parches: Para modificar un objeto existente, tienes dos opciones:
    1. Updated: Cuando se actualice un objeto, todos los campos se reemplazarán en la inserción. Es importante cargar el objeto que deseas actualizar y realizar cambios en él. De lo contrario, se desactivarán los campos que no estén presentes en la solicitud de actualización.
    2. Patching: Cuando se aplica un parche, solo se reemplazan los campos especificados en la inserción. En este caso, puedes crear un objeto nuevo, asignarle el mismo ID que el objeto que quieres actualizar, configurar los campos que se actualizarán y ejecutar la solicitud de parche.
  • Tamaños: Las dimensiones físicas se representan con un objeto Size definido por el servicio sizes. La cuenta proporciona un conjunto de tamaños estándar, y usted puede agregar sus propios tamaños personalizados a esta lista.
  • Fechas y horas: Puedes guardar fechas y horas en formato RFC 3339 con las zonas horarias locales. Todos los valores que muestra la API están en UTC. Es diferente del sitio web en el que las fechas y las horas se muestran en la zona horaria que configuraste (de forma predeterminada, la hora de América/Nueva York).

Crear un anunciante

C#

  1. Crea un objeto Advertiser y establece las propiedades requeridas para el nombre y el estado.
    // Create the advertiser structure.
    Advertiser advertiser = new Advertiser();
    advertiser.Name = advertiserName;
    advertiser.Status = "APPROVED";
    
  2. Llama a advertisers.insert() para guardar el anunciante.
    // Create the advertiser.
    Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();
    

Java

  1. Crea un objeto Advertiser y establece las propiedades requeridas para el nombre y el estado.
    // Create the advertiser structure.
    Advertiser advertiser = new Advertiser();
    advertiser.setName(advertiserName);
    advertiser.setStatus("APPROVED");
    
  2. Llama a advertisers.insert() para guardar el anunciante.
    // Create the advertiser.
    Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();
    

PHP

  1. Crea un objeto Advertiser y establece las propiedades requeridas para el nombre y el estado.
    $advertiser = new Google_Service_Dfareporting_Advertiser();
    $advertiser->setName($values['advertiser_name']);
    $advertiser->setStatus('APPROVED');
    
  2. Llama a advertisers.insert() para guardar el anunciante.
    $result = $this->service->advertisers->insert(
        $values['user_profile_id'],
        $advertiser
    );
    

Python

  1. Crea un objeto Advertiser y establece las propiedades requeridas para el nombre y el estado.
    # Construct and save advertiser.
    advertiser = {
        'name': 'Test Advertiser',
        'status': 'APPROVED'
    }
    
  2. Llama a advertisers.insert() para guardar el anunciante.
    request = service.advertisers().insert(
        profileId=profile_id, body=advertiser)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea un objeto Advertiser y establece las propiedades requeridas para el nombre y el estado.
    # Create a new advertiser resource to insert.
    advertiser = DfareportingUtils::API_NAMESPACE::Advertiser.new(
      name: format('Example Advertiser #%s', SecureRandom.hex(3)),
      status: 'APPROVED'
    )
    
  2. Llama a advertisers.insert() para guardar el anunciante.
    # Insert the advertiser.
    result = service.insert_advertiser(profile_id, advertiser)
    

Crear una campaña

C#

  1. Crea un objeto Campaign y configura sus propiedades obligatorias:

    • advertiserId: Es el anunciante con el que se asociará esta campaña.
    • name: Debe ser único en todas las campañas de este anunciante.
    • defaultLandingPageId: Es una página de destino a la que se dirigirá a los usuarios cuando hagan clic en un anuncio de esta campaña, si no está asignado a ese anuncio. Puedes llamar a advertiserLandingPages.list para buscar páginas de destino existentes o llamar a advertiserLandingPages.insert para crear una nueva.
    • Fechas de inicio y finalización: Deben ser futuras y pueden ser precisas hasta el día. Para obtener más detalles, consulta la viñeta de fechas y horas en Información general de codificación. Las fechas de cada anuncio pueden superar la fecha de finalización, de modo que un publicador pueda intentar cumplir con un contrato por una cantidad específica de acciones, si no se completó antes de la fecha de finalización de la campaña determinada.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);
    
    // Create the campaign structure.
    Campaign campaign = new Campaign();
    campaign.Name = campaignName;
    campaign.AdvertiserId = advertiserId;
    campaign.Archived = false;
    campaign.DefaultLandingPageId = defaultLandingPage.Id;
    
    // Set the campaign start date. This example uses today's date.
    campaign.StartDate =
        DfaReportingDateConverterUtil.convertToDateString(DateTime.Now);
    
    // Set the campaign end date. This example uses one month from today's date.
    campaign.EndDate =
        DfaReportingDateConverterUtil.convertToDateString(DateTime.Now.AddMonths(1));
    
  2. Llama a campaigns.insert() para guardar la campaña.

    // Insert the campaign.
    Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();
    

Java

  1. Crea un objeto Campaign y configura sus propiedades obligatorias:

    • advertiserId: Es el anunciante con el que se asociará esta campaña.
    • name: Debe ser único en todas las campañas de este anunciante.
    • defaultLandingPageId: Es una página de destino a la que se dirigirá a los usuarios cuando hagan clic en un anuncio de esta campaña, si no está asignado a ese anuncio. Puedes llamar a advertiserLandingPages.list para buscar páginas de destino existentes o llamar a advertiserLandingPages.insert para crear una nueva.
    • Fechas de inicio y finalización: Deben ser futuras y pueden ser precisas hasta el día. Para obtener más detalles, consulta la viñeta de fechas y horas en Información general de codificación. Las fechas de cada anuncio pueden superar la fecha de finalización, de modo que un publicador pueda intentar cumplir con un contrato por una cantidad específica de acciones, si no se completó antes de la fecha de finalización de la campaña determinada.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);
    
    // Create the campaign structure.
    Campaign campaign = new Campaign();
    campaign.setName(campaignName);
    campaign.setAdvertiserId(advertiserId);
    campaign.setArchived(false);
    campaign.setDefaultLandingPageId(defaultLandingPage.getId());
    
    // Set the campaign start date. This example uses today's date.
    Calendar today = Calendar.getInstance();
    DateTime startDate = new DateTime(true, today.getTimeInMillis(), null);
    campaign.setStartDate(startDate);
    
    // Set the campaign end date. This example uses one month from today's date.
    Calendar nextMonth = Calendar.getInstance();
    nextMonth.add(Calendar.MONTH, 1);
    DateTime endDate = new DateTime(true, nextMonth.getTimeInMillis(), null);
    campaign.setEndDate(endDate);
    
  2. Llama a campaigns.insert() para guardar la campaña.

    // Insert the campaign.
    Campaign result = reporting.campaigns().insert(profileId, campaign).execute();
    

PHP

  1. Crea un objeto Campaign y configura sus propiedades obligatorias:

    • advertiserId: Es el anunciante con el que se asociará esta campaña.
    • name: Debe ser único en todas las campañas de este anunciante.
    • defaultLandingPageId: Es una página de destino a la que se dirigirá a los usuarios cuando hagan clic en un anuncio de esta campaña, si no está asignado a ese anuncio. Puedes llamar a advertiserLandingPages.list para buscar páginas de destino existentes o llamar a advertiserLandingPages.insert para crear una nueva.
    • Fechas de inicio y finalización: Deben ser futuras y pueden ser precisas hasta el día. Para obtener más detalles, consulta la viñeta de fechas y horas en Información general de codificación. Las fechas de cada anuncio pueden superar la fecha de finalización, de modo que un publicador pueda intentar cumplir con un contrato por una cantidad específica de acciones, si no se completó antes de la fecha de finalización de la campaña determinada.
    $startDate = new DateTime('today');
    $endDate = new DateTime('+1 month');
    
    $campaign = new Google_Service_Dfareporting_Campaign();
    $campaign->setAdvertiserId($values['advertiser_id']);
    $campaign->setDefaultLandingPageId($values['default_landing_page_id']);
    $campaign->setName($values['campaign_name']);
    $campaign->setStartDate($startDate->format('Y-m-d'));
    $campaign->setEndDate($endDate->format('Y-m-d'));
    
  2. Llama a campaigns.insert() para guardar la campaña.

    $result = $this->service->campaigns->insert(
        $values['user_profile_id'],
        $campaign
    );
    

Python

  1. Crea un objeto Campaign y configura sus propiedades obligatorias:

    • advertiserId: Es el anunciante con el que se asociará esta campaña.
    • name: Debe ser único en todas las campañas de este anunciante.
    • defaultLandingPageId: Es una página de destino a la que se dirigirá a los usuarios cuando hagan clic en un anuncio de esta campaña, si no está asignado a ese anuncio. Puedes llamar a advertiserLandingPages.list para buscar páginas de destino existentes o llamar a advertiserLandingPages.insert para crear una nueva.
    • Fechas de inicio y finalización: Deben ser futuras y pueden ser precisas hasta el día. Para obtener más detalles, consulta la viñeta de fechas y horas en Información general de codificación. Las fechas de cada anuncio pueden superar la fecha de finalización, de modo que un publicador pueda intentar cumplir con un contrato por una cantidad específica de acciones, si no se completó antes de la fecha de finalización de la campaña determinada.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                       advertiser_id)
    
    # Construct and save campaign.
    campaign = {
        'name': 'Test Campaign #%s' % uuid.uuid4(),
        'advertiserId': advertiser_id,
        'archived': 'false',
        'defaultLandingPageId': default_landing_page['id'],
        'startDate': '2015-01-01',
        'endDate': '2020-01-01'
    }
    
  2. Llama a campaigns.insert() para guardar la campaña.

    request = service.campaigns().insert(profileId=profile_id, body=campaign)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea un objeto Campaign y configura sus propiedades obligatorias:

    • advertiserId: Es el anunciante con el que se asociará esta campaña.
    • name: Debe ser único en todas las campañas de este anunciante.
    • defaultLandingPageId: Es una página de destino a la que se dirigirá a los usuarios cuando hagan clic en un anuncio de esta campaña, si no está asignado a ese anuncio. Puedes llamar a advertiserLandingPages.list para buscar páginas de destino existentes o llamar a advertiserLandingPages.insert para crear una nueva.
    • Fechas de inicio y finalización: Deben ser futuras y pueden ser precisas hasta el día. Para obtener más detalles, consulta la viñeta de fechas y horas en Información general de codificación. Las fechas de cada anuncio pueden superar la fecha de finalización, de modo que un publicador pueda intentar cumplir con un contrato por una cantidad específica de acciones, si no se completó antes de la fecha de finalización de la campaña determinada.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
      advertiser_id)
    
    # Create a new campaign resource to insert.
    campaign = DfareportingUtils::API_NAMESPACE::Campaign.new(
      advertiser_id: advertiser_id,
      archived: false,
      default_landing_page_id: default_landing_page.id,
      name: format('Example Campaign #%s', SecureRandom.hex(3)),
      start_date: '2014-01-01',
      end_date: '2020-01-01'
    )
    
  2. Llama a campaigns.insert() para guardar la campaña.

    # Insert the campaign.
    result = service.insert_campaign(profile_id, campaign)
    

Crea una posición

C#

  1. Crea un objeto Placement y establece las propiedades de posición requeridas (incluidas campaignId y siteId). Además, asegúrate de establecer con precisión el tipo y el tamaño de la posición para la posición que negociaste con tu sitio web.
    // Create the placement.
    Placement placement = new Placement();
    placement.Name = placementName;
    placement.CampaignId = campaignId;
    placement.Compatibility = "DISPLAY";
    placement.PaymentSource = "PLACEMENT_AGENCY_PAID";
    placement.SiteId = dfaSiteId;
    placement.TagFormats = new List<string>() { "PLACEMENT_TAG_STANDARD" };
    
    // Set the size of the placement.
    Size size = new Size();
    size.Id = sizeId;
    placement.Size = size;
    
  2. Crea un objeto PricingSchedule nuevo para asignar a la posición.
    // Set the pricing schedule for the placement.
    PricingSchedule pricingSchedule = new PricingSchedule();
    pricingSchedule.EndDate = campaign.EndDate;
    pricingSchedule.PricingType = "PRICING_TYPE_CPM";
    pricingSchedule.StartDate = campaign.StartDate;
    placement.PricingSchedule = pricingSchedule;
    
  3. Llama a placements.insert() para guardar el objeto Placement. Asegúrate de almacenar el ID que se muestra si deseas usarlo para asignarlo a un anuncio o una creatividad.
    // Insert the placement.
    Placement result = service.Placements.Insert(placement, profileId).Execute();
    

Java

  1. Crea un objeto Placement y establece las propiedades de posición requeridas (incluidas campaignId y siteId). Además, asegúrate de establecer con precisión el tipo y el tamaño de la posición para la posición que negociaste con tu sitio web.
    // Create the placement.
    Placement placement = new Placement();
    placement.setName(placementName);
    placement.setCampaignId(campaignId);
    placement.setCompatibility("DISPLAY");
    placement.setPaymentSource("PLACEMENT_AGENCY_PAID");
    placement.setSiteId(dfaSiteId);
    placement.setTagFormats(ImmutableList.of("PLACEMENT_TAG_STANDARD"));
    
    // Set the size of the placement.
    Size size = new Size();
    size.setId(sizeId);
    placement.setSize(size);
    
  2. Crea un objeto PricingSchedule nuevo para asignar a la posición.
    // Set the pricing schedule for the placement.
    PricingSchedule pricingSchedule = new PricingSchedule();
    pricingSchedule.setEndDate(campaign.getEndDate());
    pricingSchedule.setPricingType("PRICING_TYPE_CPM");
    pricingSchedule.setStartDate(campaign.getStartDate());
    placement.setPricingSchedule(pricingSchedule);
    
  3. Llama a placements.insert() para guardar el objeto Placement. Asegúrate de almacenar el ID que se muestra si deseas usarlo para asignarlo a un anuncio o una creatividad.
    // Insert the placement.
    Placement result = reporting.placements().insert(profileId, placement).execute();
    

PHP

  1. Crea un objeto Placement y establece las propiedades de posición requeridas (incluidas campaignId y siteId). Además, asegúrate de establecer con precisión el tipo y el tamaño de la posición para la posición que negociaste con tu sitio web.
    $placement = new Google_Service_Dfareporting_Placement();
    $placement->setCampaignId($values['campaign_id']);
    $placement->setCompatibility('DISPLAY');
    $placement->setName($values['placement_name']);
    $placement->setPaymentSource('PLACEMENT_AGENCY_PAID');
    $placement->setSiteId($values['site_id']);
    $placement->setTagFormats(['PLACEMENT_TAG_STANDARD']);
    
    // Set the size of the placement.
    $size = new Google_Service_Dfareporting_Size();
    $size->setId($values['size_id']);
    $placement->setSize($size);
    
  2. Crea un objeto PricingSchedule nuevo para asignar a la posición.
    // Set the pricing schedule for the placement.
    $pricingSchedule = new Google_Service_Dfareporting_PricingSchedule();
    $pricingSchedule->setEndDate($campaign->getEndDate());
    $pricingSchedule->setPricingType('PRICING_TYPE_CPM');
    $pricingSchedule->setStartDate($campaign->getStartDate());
    $placement->setPricingSchedule($pricingSchedule);
    
  3. Llama a placements.insert() para guardar el objeto Placement. Asegúrate de almacenar el ID que se muestra si deseas usarlo para asignarlo a un anuncio o una creatividad.
    // Insert the placement.
    $result = $this->service->placements->insert(
        $values['user_profile_id'],
        $placement
    );
    

Python

  1. Crea un objeto Placement y establece las propiedades de posición requeridas (incluidas campaignId y siteId). Además, asegúrate de establecer con precisión el tipo y el tamaño de la posición para la posición que negociaste con tu sitio web.
    # Construct and save placement.
    placement = {
        'name': 'Test Placement',
        'campaignId': campaign_id,
        'compatibility': 'DISPLAY',
        'siteId': site_id,
        'size': {
            'height': '1',
            'width': '1'
        },
        'paymentSource': 'PLACEMENT_AGENCY_PAID',
        'tagFormats': ['PLACEMENT_TAG_STANDARD']
    }
    
  2. Crea un objeto PricingSchedule nuevo para asignar a la posición.
    # Set the pricing schedule for the placement.
    placement['pricingSchedule'] = {
        'startDate': campaign['startDate'],
        'endDate': campaign['endDate'],
        'pricingType': 'PRICING_TYPE_CPM'
    }
    
  3. Llama a placements.insert() para guardar el objeto Placement. Asegúrate de almacenar el ID que se muestra si deseas usarlo para asignarlo a un anuncio o una creatividad.
    request = service.placements().insert(profileId=profile_id, body=placement)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea un objeto Placement y establece las propiedades de posición requeridas (incluidas campaignId y siteId). Además, asegúrate de establecer con precisión el tipo y el tamaño de la posición para la posición que negociaste con tu sitio web.
    # Create a new placement resource to insert.
    placement = DfareportingUtils::API_NAMESPACE::Placement.new(
      campaign_id: campaign_id,
      compatibility: 'DISPLAY',
      name: 'Example Placement',
      payment_source: 'PLACEMENT_AGENCY_PAID',
      site_id: site_id,
      size: DfareportingUtils::API_NAMESPACE::Size.new(
        height: 1,
        width: 1
      ),
      tag_formats: ['PLACEMENT_TAG_STANDARD']
    )
    
  2. Crea un objeto PricingSchedule nuevo para asignar a la posición.
    # Set the pricing schedule for the placement.
    placement.pricing_schedule =
      DfareportingUtils::API_NAMESPACE::PricingSchedule.new(
        end_date: campaign.end_date,
        pricing_type: 'PRICING_TYPE_CPM',
        start_date: campaign.start_date
      )
    
  3. Llama a placements.insert() para guardar el objeto Placement. Asegúrate de almacenar el ID que se muestra si deseas usarlo para asignarlo a un anuncio o una creatividad.
    # Insert the placement strategy.
    result = service.insert_placement(profile_id, placement)
    

Subir elementos

Puedes subir muchos tipos de elementos mediante un proceso conocido como carga de contenido multimedia. Si bien este proceso es similar para todos los tipos de creatividades, es posible que algunos requieran que se pasen propiedades específicas como metadatos para que se puedan usar correctamente.

C#

  1. Crea un objeto assetIdentifier y establece las propiedades requeridas. Todos los elementos, independientemente de su tipo o uso, deben especificar un assetIdentifier. Cuando se asigne el recurso a una creatividad, este objeto se utilizará para hacer referencia al recurso. Se requieren las siguientes propiedades:

    • La propiedad name, que será el nombre del recurso en el servidor. El nombre debe incluir una extensión que indique el tipo de archivo, como .png o .gif, y se mostrará al navegador como el nombre del recurso, pero no es necesario que sea igual al nombre del archivo original. Ten en cuenta que Campaign Manager 360 puede cambiar este nombre para que sea único en el servidor. Verifica el valor que se muestra para ver si se modificó.
    • La propiedad type, que identifica el tipo de activo. Esta propiedad determinará los tipos de creatividades con las que se puede asociar este recurso.
    // Create the creative asset ID and Metadata.
    CreativeAssetId assetId = new CreativeAssetId();
    assetId.Name = Path.GetFileName(assetFile);
    assetId.Type = assetType;
    
  2. Llama a creativeAssets.insert() para subir el archivo. Realiza una carga multiparte y pasa assetIdentifier y el contenido del archivo como parte de la misma solicitud. Si se ejecuta correctamente, se mostrará un recurso CreativeAsset con un elemento assetIdentifier que usarás para asignar este recurso a una creatividad.

    // Prepare an input stream.
    FileStream assetContent = new FileStream(assetFile, FileMode.Open, FileAccess.Read);
    
    
    CreativeAssetMetadata metaData = new CreativeAssetMetadata();
    metaData.AssetIdentifier = assetId;
    
    // Insert the creative.
    String mimeType = determineMimeType(assetFile, assetType);
    CreativeAssetsResource.InsertMediaUpload request =
        Service.CreativeAssets.Insert(metaData, ProfileId, AdvertiserId, assetContent, mimeType);
    
    IUploadProgress progress = request.Upload();
    if (UploadStatus.Failed.Equals(progress.Status)) {
        throw progress.Exception;
    }
    

Java

  1. Crea un objeto assetIdentifier y establece las propiedades requeridas. Todos los elementos, independientemente de su tipo o uso, deben especificar un assetIdentifier. Cuando se asigne el recurso a una creatividad, este objeto se utilizará para hacer referencia al recurso. Se requieren las siguientes propiedades:

    • La propiedad name, que será el nombre del recurso en el servidor. El nombre debe incluir una extensión que indique el tipo de archivo, como .png o .gif, y se mostrará al navegador como el nombre del recurso, pero no es necesario que sea igual al nombre del archivo original. Ten en cuenta que Campaign Manager 360 puede cambiar este nombre para que sea único en el servidor. Verifica el valor que se muestra para ver si se modificó.
    • La propiedad type, que identifica el tipo de activo. Esta propiedad determinará los tipos de creatividades con las que se puede asociar este recurso.
    // Create the creative asset ID and Metadata.
    CreativeAssetId assetId = new CreativeAssetId();
    assetId.setName(assetName);
    assetId.setType(assetType);
    
  2. Llama a creativeAssets.insert() para subir el archivo. Realiza una carga multiparte y pasa assetIdentifier y el contenido del archivo como parte de la misma solicitud. Si se ejecuta correctamente, se mostrará un recurso CreativeAsset con un elemento assetIdentifier que usarás para asignar este recurso a una creatividad.

    // Open the asset file.
    File file = new File(assetFile);
    
    // Prepare an input stream.
    String contentType = getMimeType(assetFile);
    InputStreamContent assetContent =
        new InputStreamContent(contentType, new BufferedInputStream(new FileInputStream(file)));
    assetContent.setLength(file.length());
    
    
    CreativeAssetMetadata metaData = new CreativeAssetMetadata();
    metaData.setAssetIdentifier(assetId);
    
    // Insert the creative.
    CreativeAssetMetadata result = reporting.creativeAssets()
        .insert(profileId, advertiserId, metaData, assetContent).execute();
    

PHP

  1. Crea un objeto assetIdentifier y establece las propiedades requeridas. Todos los elementos, independientemente de su tipo o uso, deben especificar un assetIdentifier. Cuando se asigne el recurso a una creatividad, este objeto se utilizará para hacer referencia al recurso. Se requieren las siguientes propiedades:

    • La propiedad name, que será el nombre del recurso en el servidor. El nombre debe incluir una extensión que indique el tipo de archivo, como .png o .gif, y se mostrará al navegador como el nombre del recurso, pero no es necesario que sea igual al nombre del archivo original. Ten en cuenta que Campaign Manager 360 puede cambiar este nombre para que sea único en el servidor. Verifica el valor que se muestra para ver si se modificó.
    • La propiedad type, que identifica el tipo de activo. Esta propiedad determinará los tipos de creatividades con las que se puede asociar este recurso.
    $assetId = new Google_Service_Dfareporting_CreativeAssetId();
    $assetId->setName($asset['name']);
    $assetId->setType($type);
    
  2. Llama a creativeAssets.insert() para subir el archivo. Realiza una carga multiparte y pasa assetIdentifier y el contenido del archivo como parte de la misma solicitud. Si se ejecuta correctamente, se mostrará un recurso CreativeAsset con un elemento assetIdentifier que usarás para asignar este recurso a una creatividad.

    $metadata = new Google_Service_Dfareporting_CreativeAssetMetadata();
    $metadata->setAssetIdentifier($assetId);
    
    $result = $service->creativeAssets->insert(
        $userProfileId,
        $advertiserId,
        $metadata,
        ['data' => file_get_contents($asset['tmp_name']),
         'mimeType' => $asset['type'],
         'uploadType' => 'multipart']
    );
    

Python

  1. Crea un objeto assetIdentifier y establece las propiedades requeridas. Todos los elementos, independientemente de su tipo o uso, deben especificar un assetIdentifier. Cuando se asigne el recurso a una creatividad, este objeto se utilizará para hacer referencia al recurso. Se requieren las siguientes propiedades:

    • La propiedad name, que será el nombre del recurso en el servidor. El nombre debe incluir una extensión que indique el tipo de archivo, como .png o .gif, y se mostrará al navegador como el nombre del recurso, pero no es necesario que sea igual al nombre del archivo original. Ten en cuenta que Campaign Manager 360 puede cambiar este nombre para que sea único en el servidor. Verifica el valor que se muestra para ver si se modificó.
    • La propiedad type, que identifica el tipo de activo. Esta propiedad determinará los tipos de creatividades con las que se puede asociar este recurso.
    # Construct the creative asset metadata
    creative_asset = {'assetIdentifier': {'name': asset_name, 'type': asset_type}}
    
  2. Llama a creativeAssets.insert() para subir el archivo. Realiza una carga multiparte y pasa assetIdentifier y el contenido del archivo como parte de la misma solicitud. Si se ejecuta correctamente, se mostrará un recurso CreativeAsset con un elemento assetIdentifier que usarás para asignar este recurso a una creatividad.

    media = MediaFileUpload(path_to_asset_file)
    if not media.mimetype():
      media = MediaFileUpload(path_to_asset_file, 'application/octet-stream')
    
    response = service.creativeAssets().insert(
        advertiserId=advertiser_id,
        profileId=profile_id,
        media_body=media,
        body=creative_asset).execute()
    

Rita

  1. Crea un objeto assetIdentifier y establece las propiedades requeridas. Todos los elementos, independientemente de su tipo o uso, deben especificar un assetIdentifier. Cuando se asigne el recurso a una creatividad, este objeto se utilizará para hacer referencia al recurso. Se requieren las siguientes propiedades:

    • La propiedad name, que será el nombre del recurso en el servidor. El nombre debe incluir una extensión que indique el tipo de archivo, como .png o .gif, y se mostrará al navegador como el nombre del recurso, pero no es necesario que sea igual al nombre del archivo original. Ten en cuenta que Campaign Manager 360 puede cambiar este nombre para que sea único en el servidor. Verifica el valor que se muestra para ver si se modificó.
    • La propiedad type, que identifica el tipo de activo. Esta propiedad determinará los tipos de creatividades con las que se puede asociar este recurso.
    # Construct the creative asset metadata
    creative_asset = DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
      asset_identifier: DfareportingUtils::API_NAMESPACE::CreativeAssetId.new(
        name: asset_name,
        type: asset_type
      )
    )
    
  2. Llama a creativeAssets.insert() para subir el archivo. Realiza una carga multiparte y pasa assetIdentifier y el contenido del archivo como parte de la misma solicitud. Si se ejecuta correctamente, se mostrará un recurso CreativeAsset con un elemento assetIdentifier que usarás para asignar este recurso a una creatividad.

    # Upload the asset.
    mime_type = determine_mime_type(path_to_asset_file, asset_type)
    
    result = @service.insert_creative_asset(
      @profile_id,
      advertiser_id,
      creative_asset,
      content_type: mime_type,
      upload_source: path_to_asset_file
    )
    

Crear una creatividad

Un objeto Creative une un elemento existente. Según cómo uses las creatividades en la página de host, puedes crear objetos Creative de diferentes tipos de creatividades. Consulta la documentación de referencia para determinar qué tipo es adecuado para ti.

En el siguiente ejemplo, se muestra cómo crear una nueva creatividad de anuncio gráfico HTML5.

C#

  1. Sube los recursos. Las distintas creatividades requieren distintos tipos y cantidades de recursos. Consulta Cómo subir recursos para obtener más información. Cada vez que subas un elemento de forma correcta, recibirás un assetIdenfitier en la respuesta. Usarás el nombre y el tipo del archivo almacenado para hacer referencia a estos elementos en tu creatividad, en lugar de un ID tradicional.
  2. Crear una creatividad y asignar los valores adecuados Crea una instancia de Creative y establece el type adecuado. No puedes cambiar el tipo de objeto Creative después de guardarlo. Especifica los elementos por AssetIdentifier y role.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);
    
    // Create the creative structure.
    Creative creative = new Creative();
    creative.AdvertiserId = advertiserId;
    creative.Name = "Test HTML5 display creative";
    creative.Size = new Size() { Id = sizeId };
    creative.Type = "DISPLAY";
    
    // Upload the HTML5 asset.
    CreativeAssetUtils assetUtils = new CreativeAssetUtils(service, profileId, advertiserId);
    CreativeAssetId html5AssetId =
        assetUtils.uploadAsset(pathToHtml5AssetFile, "HTML").AssetIdentifier;
    
    CreativeAsset html5Asset = new CreativeAsset();
    html5Asset.AssetIdentifier = html5AssetId;
    html5Asset.Role = "PRIMARY";
    
    // Upload the backup image asset.
    CreativeAssetId imageAssetId =
        assetUtils.uploadAsset(pathToImageAssetFile, "HTML_IMAGE").AssetIdentifier;
    
    CreativeAsset imageAsset = new CreativeAsset();
    imageAsset.AssetIdentifier = imageAssetId;
    imageAsset.Role = "BACKUP_IMAGE";
    
    // Add the creative assets.
    creative.CreativeAssets = new List<CreativeAsset>() { html5Asset, imageAsset };
    
    // Configure the bacup image.
    creative.BackupImageClickThroughUrl = new CreativeClickThroughUrl() {
      LandingPageId = defaultLandingPage.Id
    };
    creative.BackupImageReportingLabel = "backup";
    creative.BackupImageTargetWindow = new TargetWindow() { TargetWindowOption = "NEW_WINDOW" };
    
    // Add a click tag.
    ClickTag clickTag = new ClickTag();
    clickTag.Name = "clickTag";
    clickTag.EventName = "exit";
    clickTag.ClickThroughUrl = new CreativeClickThroughUrl() {
      LandingPageId = defaultLandingPage.Id
    };
    creative.ClickTags = new List<ClickTag>() { clickTag };
    
  3. Guarde la creatividad. Para ello, llama a creatives.insert(). Es necesario especificar un ID del anunciante con el que asociar esta creatividad.
    Creative result = service.Creatives.Insert(creative, profileId).Execute();
    
  4. (Opcional) Asocia la creatividad a una campaña. Para ello, llama a campaignCreativeAssociations.insert() y pasa los IDs de la campaña y la creatividad.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.CreativeId = creativeId;
    
    // Insert the association.
    CampaignCreativeAssociation result =
        service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();
    

Java

  1. Sube los recursos. Las distintas creatividades requieren distintos tipos y cantidades de recursos. Consulta Cómo subir recursos para obtener más información. Cada vez que subas un elemento de forma correcta, recibirás un assetIdenfitier en la respuesta. Usarás el nombre y el tipo del archivo almacenado para hacer referencia a estos elementos en tu creatividad, en lugar de un ID tradicional.
  2. Crear una creatividad y asignar los valores adecuados Crea una instancia de Creative y establece el type adecuado. No puedes cambiar el tipo de objeto Creative después de guardarlo. Especifica los elementos por AssetIdentifier y role.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);
    
    // Create the creative structure.
    Creative creative = new Creative();
    creative.setAdvertiserId(advertiserId);
    creative.setName("Test HTML5 display creative");
    creative.setSize(new Size().setId(sizeId));
    creative.setType("DISPLAY");
    
    // Upload the HTML5 asset.
    CreativeAssetId html5AssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
        advertiserId, HTML5_ASSET_NAME, PATH_TO_HTML5_ASSET_FILE, "HTML").getAssetIdentifier();
    
    CreativeAsset html5Asset =
        new CreativeAsset().setAssetIdentifier(html5AssetId).setRole("PRIMARY");
    
    // Upload the backup image asset (note: asset type must be set to HTML_IMAGE).
    CreativeAssetId imageAssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
        advertiserId, IMAGE_ASSET_NAME, PATH_TO_IMAGE_ASSET_FILE, "HTML_IMAGE")
        .getAssetIdentifier();
    
    CreativeAsset backupImageAsset =
        new CreativeAsset().setAssetIdentifier(imageAssetId).setRole("BACKUP_IMAGE");
    
    // Add the creative assets.
    creative.setCreativeAssets(ImmutableList.of(html5Asset, backupImageAsset));
    
    // Configure the backup image.
    creative.setBackupImageClickThroughUrl(
        new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
    creative.setBackupImageReportingLabel("backup");
    creative.setBackupImageTargetWindow(new TargetWindow().setTargetWindowOption("NEW_WINDOW"));
    
    // Add a click tag.
    ClickTag clickTag =
        new ClickTag().setName("clickTag").setEventName("exit").setClickThroughUrl(
            new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
    creative.setClickTags(ImmutableList.of(clickTag));
    
  3. Guarde la creatividad. Para ello, llama a creatives.insert(). Es necesario especificar un ID del anunciante con el que asociar esta creatividad.
    Creative result = reporting.creatives().insert(profileId, creative).execute();
    
  4. (Opcional) Asocia la creatividad a una campaña. Para ello, llama a campaignCreativeAssociations.insert() y pasa los IDs de la campaña y la creatividad.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.setCreativeId(creativeId);
    
    // Insert the association.
    CampaignCreativeAssociation result = reporting
        .campaignCreativeAssociations().insert(profileId, campaignId, association)
        .execute();
    

PHP

  1. Sube los recursos. Las distintas creatividades requieren distintos tipos y cantidades de recursos. Consulta Cómo subir recursos para obtener más información. Cada vez que subas un elemento de forma correcta, recibirás un assetIdenfitier en la respuesta. Usarás el nombre y el tipo del archivo almacenado para hacer referencia a estos elementos en tu creatividad, en lugar de un ID tradicional.
  2. Crear una creatividad y asignar los valores adecuados Crea una instancia de Creative y establece el type adecuado. No puedes cambiar el tipo de objeto Creative después de guardarlo. Especifica los elementos por AssetIdentifier y role.
    $creative = new Google_Service_Dfareporting_Creative();
    $creative->setAdvertiserId($values['advertiser_id']);
    $creative->setAutoAdvanceImages(true);
    $creative->setName('Test HTML5 display creative');
    $creative->setType('DISPLAY');
    
    $size = new Google_Service_Dfareporting_Size();
    $size->setId($values['size_id']);
    $creative->setSize($size);
    
    // Upload the HTML5 asset.
    $html = uploadAsset(
        $this->service,
        $values['user_profile_id'],
        $values['advertiser_id'],
        $values['html_asset_file'],
        'HTML'
    );
    
    $htmlAsset = new Google_Service_Dfareporting_CreativeAsset();
    $htmlAsset->setAssetIdentifier($html->getAssetIdentifier());
    $htmlAsset->setRole('PRIMARY');
    
    // Upload the backup image asset.
    $image = uploadAsset(
        $this->service,
        $values['user_profile_id'],
        $values['advertiser_id'],
        $values['image_asset_file'],
        'HTML_IMAGE'
    );
    
    $imageAsset = new Google_Service_Dfareporting_CreativeAsset();
    $imageAsset->setAssetIdentifier($image->getAssetIdentifier());
    $imageAsset->setRole('BACKUP_IMAGE');
    
    // Add the creative assets.
    $creative->setCreativeAssets([$htmlAsset, $imageAsset]);
    
    // Configure the default click-through URL.
    $clickThroughUrl =
        new Google_Service_Dfareporting_CreativeClickThroughUrl();
    $clickThroughUrl->setLandingPageId($values['landing_page_id']);
    
    // Configure the backup image.
    $creative->setBackupImageClickThroughUrl($clickThroughUrl);
    $creative->setBackupImageReportingLabel('backup');
    
    $targetWindow = new Google_Service_Dfareporting_TargetWindow();
    $targetWindow->setTargetWindowOption('NEW_WINDOW');
    $creative->setBackupImageTargetWindow($targetWindow);
    
    // Add a click tag.
    $clickTag = new Google_Service_Dfareporting_ClickTag();
    $clickTag->setName('clickTag');
    $clickTag->setEventName('exit');
    $clickTag->setClickThroughUrl($clickThroughUrl);
    $creative->setClickTags([$clickTag]);
    
  3. Guarde la creatividad. Para ello, llama a creatives.insert(). Es necesario especificar un ID del anunciante con el que asociar esta creatividad.
    $result = $this->service->creatives->insert(
        $values['user_profile_id'],
        $creative
    );
    
  4. (Opcional) Asocia la creatividad a una campaña. Para ello, llama a campaignCreativeAssociations.insert() y pasa los IDs de la campaña y la creatividad.
    $association =
        new Google_Service_Dfareporting_CampaignCreativeAssociation();
    $association->setCreativeId($values['creative_id']);
    
    $result = $this->service->campaignCreativeAssociations->insert(
        $values['user_profile_id'],
        $values['campaign_id'],
        $association
    );
    

Python

  1. Sube los recursos. Las distintas creatividades requieren distintos tipos y cantidades de recursos. Consulta Cómo subir recursos para obtener más información. Cada vez que subas un elemento de forma correcta, recibirás un assetIdenfitier en la respuesta. Usarás el nombre y el tipo del archivo almacenado para hacer referencia a estos elementos en tu creatividad, en lugar de un ID tradicional.
  2. Crear una creatividad y asignar los valores adecuados Crea una instancia de Creative y establece el type adecuado. No puedes cambiar el tipo de objeto Creative después de guardarlo. Especifica los elementos por AssetIdentifier y role.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                       advertiser_id)
    
    # Upload the HTML5 asset
    html5_asset_id = upload_creative_asset(service, profile_id, advertiser_id,
                                           html5_asset_name,
                                           path_to_html5_asset_file, 'HTML')
    
    # Upload the backup image asset
    backup_image_asset_id = upload_creative_asset(
        service, profile_id, advertiser_id, backup_image_name,
        path_to_backup_image_file, 'HTML_IMAGE')
    
    # Construct the creative structure.
    creative = {
        'advertiserId': advertiser_id,
        'backupImageClickThroughUrl': {
            'landingPageId': default_landing_page['id']
        },
        'backupImageReportingLabel': 'backup_image_exit',
        'backupImageTargetWindow': {'targetWindowOption': 'NEW_WINDOW'},
        'clickTags': [{
            'eventName': 'exit',
            'name': 'click_tag',
            'clickThroughUrl': {'landingPageId': default_landing_page['id']}
        }],
        'creativeAssets': [
            {'assetIdentifier': html5_asset_id, 'role': 'PRIMARY'},
            {'assetIdentifier': backup_image_asset_id, 'role': 'BACKUP_IMAGE'}
        ],
        'name': 'Test HTML5 display creative',
        'size': {'id': size_id},
        'type': 'DISPLAY'
    }
    
  3. Guarde la creatividad. Para ello, llama a creatives.insert(). Es necesario especificar un ID del anunciante con el que asociar esta creatividad.
    request = service.creatives().insert(profileId=profile_id, body=creative)
    
    # Execute request and print response.
    response = request.execute()
    
  4. (Opcional) Asocia la creatividad a una campaña. Para ello, llama a campaignCreativeAssociations.insert() y pasa los IDs de la campaña y la creatividad.
    # Construct the request.
    association = {
        'creativeId': creative_id
    }
    
    request = service.campaignCreativeAssociations().insert(
        profileId=profile_id, campaignId=campaign_id, body=association)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Sube los recursos. Las distintas creatividades requieren distintos tipos y cantidades de recursos. Consulta Cómo subir recursos para obtener más información. Cada vez que subas un elemento de forma correcta, recibirás un assetIdenfitier en la respuesta. Usarás el nombre y el tipo del archivo almacenado para hacer referencia a estos elementos en tu creatividad, en lugar de un ID tradicional.
  2. Crear una creatividad y asignar los valores adecuados Crea una instancia de Creative y establece el type adecuado. No puedes cambiar el tipo de objeto Creative después de guardarlo. Especifica los elementos por AssetIdentifier y role.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
      advertiser_id)
    
    # Upload the HTML5 asset.
    html5_asset_id = util.upload_asset(advertiser_id, path_to_html5_asset_file,
      'HTML').asset_identifier
    
    # Upload the backup image asset.
    backup_image_asset_id = util.upload_asset(advertiser_id,
      path_to_backup_image_file, 'HTML_IMAGE').asset_identifier
    
    # Construct the creative structure.
    creative = DfareportingUtils::API_NAMESPACE::Creative.new(
      advertiser_id: advertiser_id,
      backup_image_click_through_url:
        DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
          landing_page_id: default_landing_page.id
        ),
      backup_image_reporting_label: 'backup',
      backup_image_target_window:
        DfareportingUtils::API_NAMESPACE::TargetWindow.new(
          target_window_option: 'NEW_WINDOW'
        ),
      click_tags: [
        DfareportingUtils::API_NAMESPACE::ClickTag.new(
          event_name: 'exit',
          name: 'click_tag',
          click_through_url:
            DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
              landing_page_id: default_landing_page.id
            )
        )
      ],
      creative_assets: [
        DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
          asset_identifier: html5_asset_id,
          role: 'PRIMARY'
        ),
        DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
          asset_identifier: backup_image_asset_id,
          role: 'BACKUP_IMAGE'
        )
      ],
      name: 'Example HTML5 display creative',
      size: DfareportingUtils::API_NAMESPACE::Size.new(id: size_id),
      type: 'DISPLAY'
    )
    
  3. Guarde la creatividad. Para ello, llama a creatives.insert(). Es necesario especificar un ID del anunciante con el que asociar esta creatividad.
    # Insert the creative.
    result = service.insert_creative(profile_id, creative)
    
  4. (Opcional) Asocia la creatividad a una campaña. Para ello, llama a campaignCreativeAssociations.insert() y pasa los IDs de la campaña y la creatividad.
    # Create a new creative-campaign association to insert
    association =
      DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
        creative_id: creative_id
      )
    
    # Insert the advertiser group.
    result = service.insert_campaign_creative_association(profile_id, campaign_id,
      association)
    

Crear un anuncio

Un Ad es el vínculo entre una Creative y una Placement. Un elemento Ad se puede vincular a una o más posiciones y contiene una o más creatividades.

Puedes crear un Ad de forma explícita o implícita.

Explícita

C#

  1. Crea un objeto CreativeAssignment para cada creatividad con la que se debe asociar este anuncio. Asegúrate de configurar el campo CreativeAssignment.active como verdadero.
    // Create a click-through URL.
    ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
    clickThroughUrl.DefaultLandingPage = true;
    
    // Create a creative assignment.
    CreativeAssignment creativeAssignment = new CreativeAssignment();
    creativeAssignment.Active = true;
    creativeAssignment.CreativeId = creativeId;
    creativeAssignment.ClickThroughUrl = clickThroughUrl;
    
  2. Crea un objeto CreativeRotation para almacenar las CreativeAssignment. Si creas un grupo de rotación, asegúrate de establecer los demás campos obligatorios de rotación de creatividades.
    // Create a creative rotation.
    CreativeRotation creativeRotation = new CreativeRotation();
    creativeRotation.CreativeAssignments = new List<CreativeAssignment>() {
        creativeAssignment
    };
    
  3. Crea un objeto PlacementAssignment para cada posición con la que se debe asociar este anuncio. Asegúrate de configurar el campo PlacementAssignment.active como verdadero.
    // Create a placement assignment.
    PlacementAssignment placementAssignment = new PlacementAssignment();
    placementAssignment.Active = true;
    placementAssignment.PlacementId = placementId;
    
  4. Crea un objeto Ad. Establece la CreativeRotation en el campo creativeRotation del objeto Ad y la positionAssignments en el array placementAssignments del objeto Ad.
    // Create a delivery schedule.
    DeliverySchedule deliverySchedule = new DeliverySchedule();
    deliverySchedule.ImpressionRatio = 1;
    deliverySchedule.Priority = "AD_PRIORITY_01";
    
    DateTime startDate = DateTime.Now;
    DateTime endDate = Convert.ToDateTime(campaign.EndDate);
    
    // Create a rotation group.
    Ad rotationGroup = new Ad();
    rotationGroup.Active = true;
    rotationGroup.CampaignId = campaignId;
    rotationGroup.CreativeRotation = creativeRotation;
    rotationGroup.DeliverySchedule = deliverySchedule;
    rotationGroup.StartTime = startDate;
    rotationGroup.EndTime = endDate;
    rotationGroup.Name = adName;
    rotationGroup.PlacementAssignments = new List<PlacementAssignment>() {
        placementAssignment
    };
    rotationGroup.Type = "AD_SERVING_STANDARD_AD";
    
  5. Llama a ads.insert() para guardar el anuncio.
    // Insert the rotation group.
    Ad result = service.Ads.Insert(rotationGroup, profileId).Execute();
    

Java

  1. Crea un objeto CreativeAssignment para cada creatividad con la que se debe asociar este anuncio. Asegúrate de configurar el campo CreativeAssignment.active como verdadero.
    // Create a click-through URL.
    ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
    clickThroughUrl.setDefaultLandingPage(true);
    
    // Create a creative assignment.
    CreativeAssignment creativeAssignment = new CreativeAssignment();
    creativeAssignment.setActive(true);
    creativeAssignment.setCreativeId(creativeId);
    creativeAssignment.setClickThroughUrl(clickThroughUrl);
    
  2. Crea un objeto CreativeRotation para almacenar las CreativeAssignment. Si creas un grupo de rotación, asegúrate de establecer los demás campos obligatorios de rotación de creatividades.
    // Create a creative rotation.
    CreativeRotation creativeRotation = new CreativeRotation();
    creativeRotation.setCreativeAssignments(ImmutableList.of(creativeAssignment));
    
  3. Crea un objeto PlacementAssignment para cada posición con la que se debe asociar este anuncio. Asegúrate de configurar el campo PlacementAssignment.active como verdadero.
    // Create a placement assignment.
    PlacementAssignment placementAssignment = new PlacementAssignment();
    placementAssignment.setActive(true);
    placementAssignment.setPlacementId(placementId);
    
  4. Crea un objeto Ad. Establece la CreativeRotation en el campo creativeRotation del objeto Ad y la positionAssignments en el array placementAssignments del objeto Ad.
    // Create a delivery schedule.
    DeliverySchedule deliverySchedule = new DeliverySchedule();
    deliverySchedule.setImpressionRatio(1L);
    deliverySchedule.setPriority("AD_PRIORITY_01");
    
    DateTime startDate = new DateTime(new Date());
    DateTime endDate = new DateTime(campaign.getEndDate().getValue());
    
    // Create a rotation group.
    Ad rotationGroup = new Ad();
    rotationGroup.setActive(true);
    rotationGroup.setCampaignId(campaignId);
    rotationGroup.setCreativeRotation(creativeRotation);
    rotationGroup.setDeliverySchedule(deliverySchedule);
    rotationGroup.setStartTime(startDate);
    rotationGroup.setEndTime(endDate);
    rotationGroup.setName(adName);
    rotationGroup.setPlacementAssignments(ImmutableList.of(placementAssignment));
    rotationGroup.setType("AD_SERVING_STANDARD_AD");
    
  5. Llama a ads.insert() para guardar el anuncio.
    // Insert the rotation group.
    Ad result = reporting.ads().insert(profileId, rotationGroup).execute();
    

PHP

  1. Crea un objeto CreativeAssignment para cada creatividad con la que se debe asociar este anuncio. Asegúrate de configurar el campo CreativeAssignment.active como verdadero.
    // Create a click-through URL.
    $url = new Google_Service_Dfareporting_ClickThroughUrl();
    $url->setDefaultLandingPage(true);
    
    // Create a creative assignment.
    $creativeAssignment =
        new Google_Service_Dfareporting_CreativeAssignment();
    $creativeAssignment->setActive(true);
    $creativeAssignment->setCreativeId($values['creative_id']);
    $creativeAssignment->setClickThroughUrl($url);
    
  2. Crea un objeto CreativeRotation para almacenar las CreativeAssignment. Si creas un grupo de rotación, asegúrate de establecer los demás campos obligatorios de rotación de creatividades.
    // Create a creative rotation.
    $creativeRotation = new Google_Service_Dfareporting_CreativeRotation();
    $creativeRotation->setCreativeAssignments([$creativeAssignment]);
    
  3. Crea un objeto PlacementAssignment para cada posición con la que se debe asociar este anuncio. Asegúrate de configurar el campo PlacementAssignment.active como verdadero.
    // Create a placement assignment.
    $placementAssignment =
        new Google_Service_Dfareporting_PlacementAssignment();
    $placementAssignment->setActive(true);
    $placementAssignment->setPlacementId($values['placement_id']);
    
  4. Crea un objeto Ad. Establece la CreativeRotation en el campo creativeRotation del objeto Ad y la positionAssignments en el array placementAssignments del objeto Ad.
    // Create a delivery schedule.
    $deliverySchedule = new Google_Service_Dfareporting_DeliverySchedule();
    $deliverySchedule->setImpressionRatio(1);
    $deliverySchedule->SetPriority('AD_PRIORITY_01');
    
    $startDate = new DateTime('today');
    $endDate = new DateTime($campaign->getEndDate());
    
    // Create a rotation group.
    $ad = new Google_Service_Dfareporting_Ad();
    $ad->setActive(true);
    $ad->setCampaignId($values['campaign_id']);
    $ad->setCreativeRotation($creativeRotation);
    $ad->setDeliverySchedule($deliverySchedule);
    $ad->setStartTime($startDate->format('Y-m-d') . 'T23:59:59Z');
    $ad->setEndTime($endDate->format('Y-m-d') . 'T00:00:00Z');
    $ad->setName($values['ad_name']);
    $ad->setPlacementAssignments([$placementAssignment]);
    $ad->setType('AD_SERVING_STANDARD_AD');
    
  5. Llama a ads.insert() para guardar el anuncio.
    $result = $this->service->ads->insert($values['user_profile_id'], $ad);
    

Python

  1. Crea un objeto CreativeAssignment para cada creatividad con la que se debe asociar este anuncio. Asegúrate de configurar el campo CreativeAssignment.active como verdadero.
    # Construct creative assignment.
    creative_assignment = {
        'active': 'true',
        'creativeId': creative_id,
        'clickThroughUrl': {
            'defaultLandingPage': 'true'
        }
    }
    
  2. Crea un objeto CreativeRotation para almacenar las CreativeAssignment. Si creas un grupo de rotación, asegúrate de establecer los demás campos obligatorios de rotación de creatividades.
    # Construct creative rotation.
    creative_rotation = {
        'creativeAssignments': [creative_assignment],
        'type': 'CREATIVE_ROTATION_TYPE_RANDOM',
        'weightCalculationStrategy': 'WEIGHT_STRATEGY_OPTIMIZED'
    }
    
  3. Crea un objeto PlacementAssignment para cada posición con la que se debe asociar este anuncio. Asegúrate de configurar el campo PlacementAssignment.active como verdadero.
    # Construct placement assignment.
    placement_assignment = {
        'active': 'true',
        'placementId': placement_id,
    }
    
  4. Crea un objeto Ad. Establece la CreativeRotation en el campo creativeRotation del objeto Ad y la positionAssignments en el array placementAssignments del objeto Ad.
    # Construct delivery schedule.
    delivery_schedule = {
        'impressionRatio': '1',
        'priority': 'AD_PRIORITY_01'
    }
    
    # Construct and save ad.
    ad = {
        'active': 'true',
        'campaignId': campaign_id,
        'creativeRotation': creative_rotation,
        'deliverySchedule': delivery_schedule,
        'endTime': '%sT00:00:00Z' % campaign['endDate'],
        'name': 'Test Rotation Group',
        'placementAssignments': [placement_assignment],
        'startTime': '%sT23:59:59Z' % time.strftime('%Y-%m-%d'),
        'type': 'AD_SERVING_STANDARD_AD'
    }
    
  5. Llama a ads.insert() para guardar el anuncio.
    request = service.ads().insert(profileId=profile_id, body=ad)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea un objeto CreativeAssignment para cada creatividad con la que se debe asociar este anuncio. Asegúrate de configurar el campo CreativeAssignment.active como verdadero.
    # Construct creative assignment.
    creative_assignment =
      DfareportingUtils::API_NAMESPACE::CreativeAssignment.new(
        active: true,
        creative_id: creative_id,
        click_through_url: DfareportingUtils::API_NAMESPACE::ClickThroughUrl.new(
          default_landing_page: true
        )
      )
    
  2. Crea un objeto CreativeRotation para almacenar las CreativeAssignment. Si creas un grupo de rotación, asegúrate de establecer los demás campos obligatorios de rotación de creatividades.
    # Construct creative rotation.
    creative_rotation = DfareportingUtils::API_NAMESPACE::CreativeRotation.new(
      creative_assignments: [creative_assignment],
      type: 'CREATIVE_ROTATION_TYPE_RANDOM',
      weight_calculation_strategy: 'WEIGHT_STRATEGY_OPTIMIZED'
    )
    
  3. Crea un objeto PlacementAssignment para cada posición con la que se debe asociar este anuncio. Asegúrate de configurar el campo PlacementAssignment.active como verdadero.
    # Construct placement assignment.
    placement_assignment =
      DfareportingUtils::API_NAMESPACE::PlacementAssignment.new(
        active: true,
        placement_id: placement_id
      )
    
  4. Crea un objeto Ad. Establece la CreativeRotation en el campo creativeRotation del objeto Ad y la positionAssignments en el array placementAssignments del objeto Ad.
    # Construct delivery schedule.
    delivery_schedule = DfareportingUtils::API_NAMESPACE::DeliverySchedule.new(
      impression_ratio: 1,
      priority: 'AD_PRIORITY_01'
    )
    
    # Construct and save ad.
    ad = DfareportingUtils::API_NAMESPACE::Ad.new(
      active: true,
      campaign_id: campaign_id,
      creative_rotation: creative_rotation,
      delivery_schedule: delivery_schedule,
      end_time: format('%sT00:00:00Z', campaign.end_date),
      name: 'Example Rotation Group',
      placement_assignments: [placement_assignment],
      start_time: format('%sT23:59:59Z', Time.now.strftime('%Y-%m-%d')),
      type: 'AD_SERVING_STANDARD_AD'
    )
    
  5. Llama a ads.insert() para guardar el anuncio.
    result = service.insert_ad(profile_id, ad)
    

Implícitamente

C#

  1. Crea y guarda un Placement.
  2. Crea y guarda un Creative.
  3. Asocia la Creative con el mismo Campaign que se usó para la Placement mediante una llamada a campaignCreativeAssociations.insert() (consulta el paso 4 en la sección Crea una creatividad). Esto creará un anuncio predeterminado asociado tanto a la creatividad como a la posición.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.CreativeId = creativeId;
    
    // Insert the association.
    CampaignCreativeAssociation result =
        service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();
    

Java

  1. Crea y guarda un Placement.
  2. Crea y guarda un Creative.
  3. Asocia la Creative con el mismo Campaign que se usó para la Placement mediante una llamada a campaignCreativeAssociations.insert() (consulta el paso 4 en la sección Crea una creatividad). Esto creará un anuncio predeterminado asociado tanto a la creatividad como a la posición.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.setCreativeId(creativeId);
    
    // Insert the association.
    CampaignCreativeAssociation result = reporting
        .campaignCreativeAssociations().insert(profileId, campaignId, association)
        .execute();
    

PHP

  1. Crea y guarda un Placement.
  2. Crea y guarda un Creative.
  3. Asocia la Creative con el mismo Campaign que se usó para la Placement mediante una llamada a campaignCreativeAssociations.insert() (consulta el paso 4 en la sección Crea una creatividad). Esto creará un anuncio predeterminado asociado tanto a la creatividad como a la posición.
    $association =
        new Google_Service_Dfareporting_CampaignCreativeAssociation();
    $association->setCreativeId($values['creative_id']);
    
    $result = $this->service->campaignCreativeAssociations->insert(
        $values['user_profile_id'],
        $values['campaign_id'],
        $association
    );
    

Python

  1. Crea y guarda un Placement.
  2. Crea y guarda un Creative.
  3. Asocia la Creative con el mismo Campaign que se usó para la Placement mediante una llamada a campaignCreativeAssociations.insert() (consulta el paso 4 en la sección Crea una creatividad). Esto creará un anuncio predeterminado asociado tanto a la creatividad como a la posición.
    # Construct the request.
    association = {
        'creativeId': creative_id
    }
    
    request = service.campaignCreativeAssociations().insert(
        profileId=profile_id, campaignId=campaign_id, body=association)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea y guarda un Placement.
  2. Crea y guarda un Creative.
  3. Asocia la Creative con el mismo Campaign que se usó para la Placement mediante una llamada a campaignCreativeAssociations.insert() (consulta el paso 4 en la sección Crea una creatividad). Esto creará un anuncio predeterminado asociado tanto a la creatividad como a la posición.
    # Create a new creative-campaign association to insert
    association =
      DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
        creative_id: creative_id
      )
    
    # Insert the advertiser group.
    result = service.insert_campaign_creative_association(profile_id, campaign_id,
      association)
    

Cuando creas un anuncio, se guarda de forma implícita el paso adicional de crear un Ad. Ten en cuenta que esto solo puede hacerse si no existe un anuncio predeterminado del tamaño especificado en tu campaña.

Buscar objetos

Puedes buscar objetos si llamas a la operación list() que expone el servicio que define el objeto a buscar y que especificas los criterios opcionales apropiados para ese tipo de objeto. Por ejemplo, para buscar objetos Ads, deberías llamar a ads.list(). Los criterios opcionales exponen un conjunto de propiedades adecuadas para ese objeto. Completa todas las propiedades que desees buscar. La búsqueda mostrará solo los objetos que cumplan con todos tus criterios. No puedes realizar una búsqueda que coincida con alguno de los criterios. Las cadenas admiten el comodín *, no distinguen mayúsculas de minúsculas y coinciden dentro de cadenas más grandes.

Para mejorar el rendimiento, se pueden solicitar respuestas parciales con el parámetro fields. Esto le indica al servidor que devuelva solo los campos que especifiques, en lugar de la representación completa del recurso. Puedes encontrar más información sobre este tema en la guía de Sugerencias de rendimiento.

Paging

A veces, no es recomendable recuperar todos los resultados de una solicitud list(). Por ejemplo, es posible que solo te interesen los 10 anuncios más recientes de un grupo de miles. Para ayudar con esto, muchos métodos list() te permiten solicitar menos resultados a través de un proceso conocido como paginación.

Los métodos que admiten la paginación muestran subconjuntos de resultados en grupos llamados páginas. La cantidad máxima de resultados por página es 1,000 (el valor predeterminado). Puedes cambiar la cantidad de resultados por página si configuras maxResults y puedes iterar a través de las páginas con el nextPageToken que se muestra en la respuesta:

C#

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  AdsResource.ListRequest request = service.Ads.List(profileId);
  request.Active = true;
  request.Fields = fields;
  request.PageToken = nextPageToken;
  result = request.Execute();

  foreach (Ad ad in result.Ads) {
    Console.WriteLine(
        "Ad with ID {0} and name \"{1}\" is associated with advertiser" +
        " ID {2}.", ad.Id, ad.Name, ad.AdvertiserId);
  }

  // Update the next page token.
  nextPageToken = result.NextPageToken;
} while (result.Ads.Any() && !String.IsNullOrEmpty(nextPageToken));

Java

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  result = reporting.ads().list(profileId).setActive(true).setFields(fields)
      .setPageToken(nextPageToken).execute();

  for (Ad ad : result.getAds()) {
    System.out.printf(
        "Ad with ID %d and name \"%s\" is associated with advertiser ID %d.%n", ad.getId(),
        ad.getName(), ad.getAdvertiserId());
  }

  // Update the next page token.
  nextPageToken = result.getNextPageToken();
} while (!result.getAds().isEmpty() && !Strings.isNullOrEmpty(nextPageToken));

PHP

$response = null;
$pageToken = null;

do {
    // Create and execute the ads list request.
    $response = $this->service->ads->listAds(
        $values['user_profile_id'],
        ['active' => true, 'pageToken' => $pageToken]
    );

    foreach ($response->getAds() as $ads) {
        $this->printResultsTableRow($ads);
    }

    // Update the next page token.
    $pageToken = $response->getNextPageToken();
} while (!empty($response->getAds()) && !empty($pageToken));

Python

# Construct the request.
request = service.ads().list(profileId=profile_id, active=True)

while True:
  # Execute request and print response.
  response = request.execute()

  for ad in response['ads']:
    print 'Found ad with ID %s and name "%s".' % (ad['id'], ad['name'])

  if response['ads'] and response['nextPageToken']:
    request = service.ads().list_next(request, response)
  else:
    break

Rita

token = nil
loop do
  result = service.list_ads(profile_id,
    page_token: token,
    fields: 'nextPageToken,ads(id,name)')

  # Display results.
  if result.ads.any?
    result.ads.each do |ad|
      puts format('Found ad with ID %d and name "%s".', ad.id, ad.name)
    end

    token = result.next_page_token
  else
    # Stop paging if there are no more results.
    token = nil
  end

  break if token.to_s.empty?
end

Genera etiquetas de Floodlight

Las etiquetas de Floodlight son etiquetas HTML incorporadas en una página y se usan para hacer un seguimiento de las acciones de los usuarios (p.ej., compras) en un sitio. Para generar etiquetas de Floodlight, necesitas un FloodlightActivity que pertenezca a un FloodlightActivityGroup:

C#

  1. Crea un nuevo grupo de actividades de Floodlight y pasa valores para name, type y floodlightConfigurationId.
    // Create the floodlight activity group.
    FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
    floodlightActivityGroup.Name = groupName;
    floodlightActivityGroup.FloodlightConfigurationId = floodlightConfigurationId;
    floodlightActivityGroup.Type = "COUNTER";
    
  2. Para guardar el grupo de actividades de Floodlight, llama a floodlightActivityGroups.insert(), que mostrará el ID del grupo nuevo.
    // Insert the activity group.
    FloodlightActivityGroup result =
        service.FloodlightActivityGroups.Insert(floodlightActivityGroup, profileId).Execute();
    
  3. Crea una actividad de Floodlight nueva y asígnale el ID del grupo de actividades de Floodlight que acabas de crear, junto con todos los demás campos obligatorios.
    // Set floodlight activity structure.
    FloodlightActivity activity = new FloodlightActivity();
    activity.CountingMethod = "STANDARD_COUNTING";
    activity.Name = activityName;
    activity.FloodlightActivityGroupId = activityGroupId;
    activity.FloodlightTagType = "GLOBAL_SITE_TAG";
    activity.ExpectedUrl = url;
    
  4. Para guardar la actividad nueva, llama a floodlightActivities.insert(), que mostrará el ID de la nueva actividad.
    // Create the floodlight tag activity.
    FloodlightActivity result =
        service.FloodlightActivities.Insert(activity, profileId).Execute();
    
  5. Genera las etiquetas llamando a floodlightActivities.generatetag() con el floodlightActivityId de tu nueva actividad. Envíe las etiquetas al webmaster en el sitio web del anunciante.
    // Generate the floodlight activity tag.
    FloodlightActivitiesResource.GeneratetagRequest request =
        service.FloodlightActivities.Generatetag(profileId);
    request.FloodlightActivityId = activityId;
    
    FloodlightActivitiesGenerateTagResponse response = request.Execute();
    

Java

  1. Crea un nuevo grupo de actividades de Floodlight y pasa valores para name, type y floodlightConfigurationId.
    // Create the floodlight activity group.
    FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
    floodlightActivityGroup.setName(groupName);
    floodlightActivityGroup.setFloodlightConfigurationId(floodlightConfigurationId);
    floodlightActivityGroup.setType("COUNTER");
    
  2. Para guardar el grupo de actividades de Floodlight, llama a floodlightActivityGroups.insert(), que mostrará el ID del grupo nuevo.
    // Insert the activity group.
    FloodlightActivityGroup result =
        reporting.floodlightActivityGroups().insert(profileId, floodlightActivityGroup).execute();
    
  3. Crea una actividad de Floodlight nueva y asígnale el ID del grupo de actividades de Floodlight que acabas de crear, junto con todos los demás campos obligatorios.
    // Set floodlight activity structure.
    FloodlightActivity activity = new FloodlightActivity();
    activity.setName(activityName);
    activity.setCountingMethod("STANDARD_COUNTING");
    activity.setExpectedUrl(url);
    activity.setFloodlightActivityGroupId(activityGroupId);
    activity.setFloodlightTagType("GLOBAL_SITE_TAG");
    
  4. Para guardar la actividad nueva, llama a floodlightActivities.insert(), que mostrará el ID de la nueva actividad.
    // Create the floodlight tag activity.
    FloodlightActivity result =
        reporting.floodlightActivities().insert(profileId, activity).execute();
    
  5. Genera las etiquetas llamando a floodlightActivities.generatetag() con el floodlightActivityId de tu nueva actividad. Envíe las etiquetas al webmaster en el sitio web del anunciante.
    // Generate the floodlight activity tag.
    Generatetag request = reporting.floodlightActivities().generatetag(profileId);
    request.setFloodlightActivityId(activityId);
    
    FloodlightActivitiesGenerateTagResponse response = request.execute();
    

PHP

  1. Crea un nuevo grupo de actividades de Floodlight y pasa valores para name, type y floodlightConfigurationId.
    $group = new Google_Service_Dfareporting_FloodlightActivityGroup();
    $group->setFloodlightConfigurationId($values['configuration_id']);
    $group->setName($values['group_name']);
    $group->setType('COUNTER');
    
  2. Para guardar el grupo de actividades de Floodlight, llama a floodlightActivityGroups.insert(), que mostrará el ID del grupo nuevo.
    $result = $this->service->floodlightActivityGroups->insert(
        $values['user_profile_id'],
        $group
    );
    
  3. Crea una actividad de Floodlight nueva y asígnale el ID del grupo de actividades de Floodlight que acabas de crear, junto con todos los demás campos obligatorios.
    $activity = new Google_Service_Dfareporting_FloodlightActivity();
    $activity->setCountingMethod('STANDARD_COUNTING');
    $activity->setExpectedUrl($values['url']);
    $activity->setFloodlightActivityGroupId($values['activity_group_id']);
    $activity->setFloodlightTagType('GLOBAL_SITE_TAG');
    $activity->setName($values['activity_name']);
    
  4. Para guardar la actividad nueva, llama a floodlightActivities.insert(), que mostrará el ID de la nueva actividad.
    $result = $this->service->floodlightActivities->insert(
        $values['user_profile_id'],
        $activity
    );
    
  5. Genera las etiquetas llamando a floodlightActivities.generatetag() con el floodlightActivityId de tu nueva actividad. Envíe las etiquetas al webmaster en el sitio web del anunciante.
    $result = $this->service->floodlightActivities->generatetag(
        $values['user_profile_id'],
        ['floodlightActivityId' => $values['activity_id']]
    );
    

Python

  1. Crea un nuevo grupo de actividades de Floodlight y pasa valores para name, type y floodlightConfigurationId.
    # Construct and save floodlight activity group.
    activity_group = {
        'name': 'Test Floodlight Activity Group',
        'floodlightConfigurationId': floodlight_config_id,
        'type': 'COUNTER'
    }
    
  2. Para guardar el grupo de actividades de Floodlight, llama a floodlightActivityGroups.insert(), que mostrará el ID del grupo nuevo.
    request = service.floodlightActivityGroups().insert(
        profileId=profile_id, body=activity_group)
    
  3. Crea una actividad de Floodlight nueva y asígnale el ID del grupo de actividades de Floodlight que acabas de crear, junto con todos los demás campos obligatorios.
    # Construct and save floodlight activity.
    floodlight_activity = {
        'countingMethod': 'STANDARD_COUNTING',
        'expectedUrl': 'http://www.google.com',
        'floodlightActivityGroupId': activity_group_id,
        'floodlightTagType': 'GLOBAL_SITE_TAG',
        'name': 'Test Floodlight Activity'
    }
    
  4. Para guardar la actividad nueva, llama a floodlightActivities.insert(), que mostrará el ID de la nueva actividad.
    request = service.floodlightActivities().insert(
        profileId=profile_id, body=floodlight_activity)
    
  5. Genera las etiquetas llamando a floodlightActivities.generatetag() con el floodlightActivityId de tu nueva actividad. Envíe las etiquetas al webmaster en el sitio web del anunciante.
    # Construct the request.
    request = service.floodlightActivities().generatetag(
        profileId=profile_id, floodlightActivityId=activity_id)
    
    # Execute request and print response.
    response = request.execute()
    

Rita

  1. Crea un nuevo grupo de actividades de Floodlight y pasa valores para name, type y floodlightConfigurationId.
    # Create a new floodlight activity group resource to insert.
    activity_group =
      DfareportingUtils::API_NAMESPACE::FloodlightActivityGroup.new(
        floodlight_configuration_id: floodlight_config_id,
        name:
          format('Example Floodlight Activity Group #%s', SecureRandom.hex(3)),
        type: 'COUNTER'
      )
    
  2. Para guardar el grupo de actividades de Floodlight, llama a floodlightActivityGroups.insert(), que mostrará el ID del grupo nuevo.
    # Insert the floodlight activity group.
    result = service.insert_floodlight_activity_group(profile_id, activity_group)
    
  3. Crea una actividad de Floodlight nueva y asígnale el ID del grupo de actividades de Floodlight que acabas de crear, junto con todos los demás campos obligatorios.
    # Create a new floodlight activity resource to insert.
    activity = DfareportingUtils::API_NAMESPACE::FloodlightActivity.new(
      counting_method: 'STANDARD_COUNTING',
      expected_url: 'http://www.google.com',
      floodlight_activity_group_id: activity_group_id,
      floodlight_tag_type: 'GLOBAL_SITE_TAG',
      name: format('Example Floodlight Activity #%s', SecureRandom.hex(3))
    )
    
  4. Para guardar la actividad nueva, llama a floodlightActivities.insert(), que mostrará el ID de la nueva actividad.
    # Insert the floodlight activity.
    result = service.insert_floodlight_activity(profile_id, activity)
    
  5. Genera las etiquetas llamando a floodlightActivities.generatetag() con el floodlightActivityId de tu nueva actividad. Envíe las etiquetas al webmaster en el sitio web del anunciante.
    # Construct the request.
    result = service.generatetag_floodlight_activity(profile_id,
      floodlight_activity_id: activity_id)
    

Generar etiquetas de posición

El último paso es generar etiquetas HTML para enviarlas al publicador y mostrar tus anuncios. Para generar las etiquetas a través de la API, realiza una solicitud a placements.generatetags() y especifica un conjunto de placementIds y tagFormats.

C#

// Generate the placement activity tags.
PlacementsResource.GeneratetagsRequest request =
    service.Placements.Generatetags(profileId);
request.CampaignId = campaignId;
request.TagFormats =
    PlacementsResource.GeneratetagsRequest.TagFormatsEnum.PLACEMENTTAGIFRAMEJAVASCRIPT;
request.PlacementIds = placementId.ToString();

PlacementsGenerateTagsResponse response = request.Execute();

Java

// Generate the placement activity tags.
Generatetags request = reporting.placements().generatetags(profileId);
request.setCampaignId(campaignId);
request.setTagFormats(tagFormats);
request.setPlacementIds(ImmutableList.of(placementId));

PlacementsGenerateTagsResponse response = request.execute();

PHP

$placementTags = $this->service->placements->generatetags(
    $values['user_profile_id'],
    ['campaignId' => $values['campaign_id'],
     'placementIds' => [$values['placement_id']],
     'tagFormats' => ['PLACEMENT_TAG_STANDARD',
                      'PLACEMENT_TAG_IFRAME_JAVASCRIPT',
                      'PLACEMENT_TAG_INTERNAL_REDIRECT']
    ]
);

Python

# Construct the request.
request = service.placements().generatetags(
    profileId=profile_id, campaignId=campaign_id,
    placementIds=[placement_id])

# Execute request and print response.
response = request.execute()

Rita

# Construct the request.
result = service.generate_placement_tags(profile_id,
  campaign_id: campaign_id,
  placement_ids: [placement_id])