Asignación de ID para la nueva experiencia de Search Ads 360

La nueva API de informes de Search Ads 360 ya está disponible. La nueva API proporciona una flexibilidad mejorada para crear informes personalizados y, además, integrar los datos en procesos y aplicaciones de informes. Obtén más información para migrar a la nueva API de informes de Search Ads 360 y usarla.

Las entidades de la nueva experiencia de Search Ads 360 tienen un espacio de ID diferente al de la experiencia anterior. Para obtener la asignación de ID entre la experiencia anterior y la nueva de Search Ads 360, envía una solicitud Reports.getIdMappingFile() . La respuesta incluye las asignaciones de ID para todas las entidades de un anunciante específico.

A continuación, se muestra un ejemplo del archivo que se muestra (formato CSV codificado en UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

El archivo CSV tiene 3 columnas:

  • Entity Type: Es el tipo de entidad de esta fila.

  • Legacy IDs: Una string JSON de la ruta de acceso completa de la entidad en la experiencia anterior de Search Ads 360

  • New IDs: Una string JSON de la ruta de acceso completa de la entidad en la nueva experiencia de Search Ads 360

En la siguiente tabla, se muestra una lista de entidades compatibles y ejemplos de asignaciones de ID:

Tipo de entidad Descripción ID heredados IDs nuevos
CLIENTE Asignación de ID para lo siguiente: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAÑA Asignación de ID para la campaña 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Asignación de ID para adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
VALOR Asignación de ID para lo siguiente: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Asignación de ID para ad 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Asignación de ID para lo siguiente: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Asignación de ID para un grupo de campañas 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET La asignación de ID para el objetivo de rendimiento de un grupo de campañas. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Asignación de ID para la tabla de feed 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Asignación de ID para feedItem 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Descargar informe

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

Unicidad del ID de objeto

Cada objeto en la nueva experiencia de Search Ads 360 se identifica con su propio ID. Algunos de estos IDs son únicos a nivel global en todas las cuentas de la nueva experiencia de Search Ads 360, mientras que otros son únicos dentro de un alcance limitado. Por ejemplo, debes usar tanto el grupo de anuncios como los ID de los anuncios para identificar de manera única los anuncios, ya que estos se asignan de forma única por grupo de anuncios, pero no entre grupos de anuncios. A continuación, se indica la exclusividad de cada ID de objeto en la nueva experiencia de Search Ads 360. Estas reglas de ID pueden ser útiles a la hora de diseñar un almacenamiento local para tus objetos nuevos de Search Ads 360.

ID de objeto Alcance de la unicidad ¿Único a nivel global?
ID de presupuesto Global Sí
Campaign ID Global Sí
ID del grupo de anuncios Global Sí
ID del anuncio Ad Group El par (AdGroupId, AdId) es único a nivel global.
ID de criterio del grupo de anuncios Ad Group El par (AdGroupId, CriterionId) es único a nivel global.
ID de criterio de campaña Campaña El par (CampaignId, CriterionId) es único a nivel global.
Extensiones de anuncios Campaña El par (CampaignId, AdExtensionId) es único a nivel global.
ID del feed Global Sí
ID de elemento del feed Global Sí
ID del atributo del feed Feed No
ID de asignación de feeds Global Sí
ID de etiqueta Global Sí
ID de lista de usuarios Global Sí