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

La nueva API de Search Ads 360 Reporting ya está disponible. La nueva API proporciona una flexibilidad mejorada para crear informes personalizados y, además, integrar 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 de Search Ads 360 y la nueva, envía una solicitud de Reports.getIdMappingFile(). La respuesta incluye asignaciones de ID para la mayoría de las entidades de un anunciante especificado. Consulta Motivos comunes por los que faltan entidades para obtener más información sobre por qué se puede omitir una entidad del archivo de asignación.

Este es 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: Es una cadena JSON de la ruta de la entidad completa en la versión anterior de Search Ads 360.

  • New IDs: Es una cadena 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 admitidas y ejemplos de asignaciones de ID:

Tipo de entidad Descripción ID heredados IDs nuevos
CLIENTE Asignación de ID para lo siguiente: Las asignaciones para administradores y agencias no están disponibles. 
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"
}
CRITERION Asignación de ID para los criterios a nivel del grupo de anuncios: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Asignación de ID para anuncio. 
{
  "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 los criterios a nivel de la campaña: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Asignación de ID para el grupo de campañas. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Asignación de IDs 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 del 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"
}

Motivos comunes por los que faltan entidades

Si bien el archivo de asignación de un anunciante contendrá la mayoría de sus entidades, de todos modos hay algunos casos en los que faltarán entidades. Estos son algunos de los motivos más comunes por los que eso puede suceder:

  • Cada archivo de asignación se actualiza cada 3 días. Si se descarga un archivo de asignación inmediatamente después de crear una entidad nueva, es probable que esta no esté en el archivo de asignación. Es probable que se incluya después de esperar hasta 3 días.
  • Se quita la cuenta a la que pertenece la entidad. En este caso, no admitimos la asignación de ID.

Descargar el 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 de 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 solo dentro de un ámbito limitado. Por ejemplo, debes usar el grupo de anuncios y los IDs de anuncios para identificar los anuncios de forma única, ya que los IDs de anuncios se asignan de forma única por grupo de anuncios, pero no en todos los grupos de anuncios. A continuación, se indica la unicidad de cada ID de objeto en la nueva experiencia de Search Ads 360. Estas reglas de ID pueden ser útiles cuando diseñas el almacenamiento local para tus nuevos objetos de Search Ads 360.

ID de objeto Alcance de la unicidad ¿Es único a nivel global?
ID de presupuesto Global Sí
ID de la campaña Global Sí
ID del grupo de anuncios Global Sí
ID del anuncio Grupo de anuncios No. El par (AdGroupId, AdId) es único a nivel global.
ID de AdGroupCriterion Grupo de anuncios No. El par (AdGroupId, CriterionId) es único a nivel global.
ID de criterio de campaña Campaña No. El par (CampaignId, CriterionId) es único a nivel global.
Extensiones de anuncios Campaña No. El par (CampaignId, AdExtensionId) es único a nivel global.
ID del feed Global Sí
ID del 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 UserList Global Sí