Chame o método Conversion.insert() para adicionar uma ou mais conversões. Para atribuir corretamente a conversão, sua solicitação precisa especificar o nome de uma atividade do Floodlight que o anunciante está usando para informar conversões off-line, junto com o ID da palavra-chave, do anúncio e possivelmente o clique que levou à conversão. Para informações sobre como conseguir os IDs do Search Ads 360, consulte IDs e conversões do Search Ads 360.
Informações sobre as restrições ao upload de conversões históricas podem ser encontradas na Central de Ajuda do Search Ads 360.
Se a solicitação Conversion.insert() especificar várias conversões, o Search Ads 360 tentará fazer o upload de cada uma delas da melhor maneira possível, em vez de fazer o upload de todo o lote como uma transação "tudo ou nada". Se o upload de algumas conversões em um lote falhar, o upload de outras ainda poderá ser concluído. Os uploads de conversão podem falhar devido a uma solicitação inválida ou a falhas temporárias de rede ou do sistema. Portanto, recomendamos que você leia a resposta para cada conversão inserida para garantir que o upload seja bem-sucedido.
Quando posso usar os dados enviados?
Se você especificar um
conversionTimestamp de hoje ou ontem para uma conversão, as métricas da conversão serão exibidas na interface do Search Ads 360 até uma hora após o upload. Se você especificar um conversionTimestamp anterior a ontem, as métricas serão atualizadas em várias horas.
Converta todos os carimbos de data/hora de conversões para o horário Unix (também conhecido como horário Unix).
Posso criar atividades do Floodlight usando a API?
Se o anunciante ainda não tiver criado uma atividade do Floodlight para rastrear conversões off-line, use a API Campaign Manager para criar uma. Não é possível usar a API para especificar que uma atividade do Floodlight é usada principalmente para conversões off-line. Essa é uma prática recomendada quando as estratégias de lances usam dados da conversão.
Recomendamos que, depois de usar a API para criar uma atividade do Floodlight, um usuário do Search Ads 360 faça login no Search Ads 360 e mude a configuração da atividade para indicar que a principal origem das conversões é a atividade off-line.
Práticas recomendadas para adicionar conversões
Recomendamos as seguintes práticas para adicionar conversões:
Peça a um usuário do Search Ads 360 para fazer login no Search Ads 360 e mudar as configurações de cada atividade do Floodlight que você usa para gerar relatórios sobre conversões off-line. As configurações devem indicar que a origem principal das conversões é a atividade off-line. Acesse a Central de Ajuda do Search Ads 360 para ver instruções.
Faça o upload das conversões assim que elas estiverem disponíveis. Se estiver atribuindo conversões a visitas específicas, aguarde pelo menos 30 minutos após a visita antes de fazer o upload da conversão. O Search Ads 360 poderá não reconhecer o ID de clique da visita se você fizer o upload menos de 30 minutos após a visita. Em casos raros, pode ser necessário aguardar até quatro horas para que o Search Ads 360 possa reconhecer o clickId.
Verifique se cada upload contém as conversões mais recentes. Em uma única solicitação de upload, não há problema se as entradas estiverem fora de ordem cronológica. No entanto, uma estratégia de lances pode não considerar as conversões mais antigas que você enviou mais tarde em outra solicitação.
Se você esperar mais de 24 horas para fazer o upload de conversões para uma atividade do Floodlight, envie um carimbo de data/hora de disponibilidade.
O carimbo de data/hora de disponibilidade deve ser um dos seguintes:
- Se você registrou conversões durante as últimas 24 horas, mas ainda não fez o upload delas, o carimbo de data/hora precisa ser o horário em que ocorreu a última conversão enviada. Isso informa ao Search Ads 360 que as conversões podem ter ocorrido nas últimas 24 horas, mas você ainda não forneceu os dados. As estratégias de lances e outros sistemas automatizados só vão considerar o histórico de performance até a última conversão enviada.
- Se nenhuma conversão tiver ocorrido durante as últimas 24 horas, o carimbo de data/hora deverá ter a hora e a data atuais. Isso informa ao Search Ads 360 que nenhuma conversão ocorreu durante as últimas 24 horas. As estratégias de lances e outros sistemas automatizados vão incluir as últimas 24 horas (um dia inteiro sem conversões) no histórico de performance.
Enviar uma solicitação de inserção
É possível enviar uma solicitação Conversion.insert() para realizar qualquer uma das seguintes ações:
- Atribuir uma conversão a uma visita específica
- Atribuir uma conversão somente a uma palavra-chave
Os campos obrigatórios em uma solicitação Conversion.insert() dependem do evento ou item a que a conversão é atribuída. As seções a seguir listam os campos obrigatórios e opcionais para cada evento ou item a que você pode atribuir uma conversão.
Atribuir uma conversão a uma visita específica
Quando um cliente clica em um ou mais anúncios e acessa o site de um anunciante, o Search Ads 360 considera a sessão de usuário no site do anunciante uma visita.
Para atribuir uma conversão a uma visita, especifique o seguinte na solicitação do Conversion.insert():
Campos obrigatórios
clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Procure o ID de clique ou as conversões de lista nos registros da Web do anunciante e use um ID de clique de outra conversão. O Search Ads 360 atribuirá a conversão à palavra-chave, ao anúncio e a outros objetos do Search Ads 360 responsáveis por gerar a visita.
Aguarde pelo menos 30 minutos depois que o Search Ads 360 gerar um ID de clique para fazer o upload das conversões. Se você receber a mensagem de erro "ID de clique não encontrado", aguarde quatro horas e faça o upload das conversões novamente. O upload de todas as conversões precisa ser feito em até 90 dias após a geração do ID de clique. Caso contrário, a API Search Ads 360 poderá não reconhecer a visita.conversionId: para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID significativo para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões no anunciante. No caso das conversões on-line, o Search Ads 360 copiadsConversionIdoufloodlightOrderIdpara essa propriedade, dependendo das instruções do Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer na sexta-feira, 5 de agosto de 2016, às 11:53:22 Horário de verão do Leste (GMT -4:00), especifique o carimbo de data/hora em milissegundos da época:1470412402000.segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. Atualmente, somente conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se elas pertencerem a diferentes grupos do Floodlight), a ação recomendada será renomear uma das atividades.
Como alternativa, se você sabe que o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID no
segmentationIdem vez de especificar o nome no camposegmentationName. O Campaign Manager também atribui um código à atividade do Floodlight, mas esse código é diferente do código do Search Ads 360 e não pode ser usado para atribuir conversões. Para ver o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API Reporting. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 será exibido no relatório.type: o tipo de conversão, ou seja,ACTIONouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO sim. Exemplos são inscrições em listas de e-mails (ACTION) x compras de e-commerce (TRANSACTION).Se você especificar
TRANSACTION, também precisará especificar o seguinte campo:revenueMicros: o valor monetário da conversão.
Campos opcionais
quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões ACTION, o Search Ads 360 inserirá automaticamente um valor de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é definida na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converterá o valor da receita especificada para a moeda do anunciante. Saiba mais
Use o formato alfabético ISO 4217 (3 caracteres) para especificar a moeda.
Aplicável apenas a conversões TRANSACTION.customMetricecustomDimension: faz upload de outros dados sobre uma conversão, como o país para onde um item comprado é enviado, os IDs dos produtos ou até mesmo a duração de uma chamada telefônica. Saiba mais sobre o upload de dados para variáveis personalizadas do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
"currencyCode": "USD"
}]
}
Java
/**
* Instantiate the Doubleclicksearch service, create conversions, and upload them.
*/
public static void main(String[] args) throws Exception {
Doubleclicksearch service = getService(); // See Set Up Your Application.
// Set up a List to keep track of each conversion you create.
List<Conversion> conversions = new Vector<Conversion>();
// Add a conversion to the List.
addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);
// Upload the List and handle the response.
uploadConversions(conversions, service);
}
/**
* Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
* the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
*/
private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
String clickId, String conversionId, Long revenue, Long timeStamp) {
Conversion conversion = new Conversion().setClickId(clickId)
.setConversionId(conversionId)
.setSegmentationType("FLOODLIGHT")
.setSegmentationName("Test")
.setType("TRANSACTION")
.setRevenueMicros(revenue)
.setCurrencyCode("USD")
.setConversionTimestamp(BigInteger.valueOf(timeStamp));
conversions.add(conversion);
return conversions;
}
/**
* Convert the List of conversions to a DS ConversionList, send an insert request to DS,
* and output the response to a file.
*/
private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
throws IOException {
FileOutputStream outputStream =
new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
final PrintStream printStream = new PrintStream(outputStream);
try {
// Convert the List to a ConversionList.
ConversionList conversionList = new ConversionList().setConversion(conversions);
// Insert an upload request and download the response to a file.
service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
printStream.close();
} catch (GoogleJsonResponseException e) {
System.err.println("Get request was rejected.");
for (ErrorInfo error : e.getDetails().getErrors()) {
System.err.println(error.getMessage());
}
System.exit(e.getStatusCode());
}
}
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a visit.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
'conversionId': 'test_20140206_00',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Atribuir uma conversão somente a uma palavra-chave
Se sua principal preocupação é atribuir conversões a palavras-chave (e você não está preocupado com atribuí-las a anúncios), é possível omitir a maioria dos identificadores do Search Ads 360 e especificar somente o identificador da palavra-chave junto com alguns outros campos:
Campos obrigatórios
criterionId: é o identificador de palavra-chave. Você pode conseguir ocriterionIdadicionando a macroTrackerIdaos URLs da página de destino. Para informações sobre como conseguir os IDs de palavra-chave, consulte IDs e conversões do Search Ads 360.conversionId: para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID significativo para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões no anunciante. No caso das conversões on-line, o Search Ads 360 copiadsConversionIdoufloodlightOrderIdpara essa propriedade, dependendo das instruções do Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer na sexta-feira, 5 de agosto de 2016, às 11:53:22 Horário de verão do Leste (GMT -4:00), especifique o carimbo de data/hora em milissegundos da época:1470412402000.segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. Atualmente, somente conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se elas pertencerem a diferentes grupos do Floodlight), a ação recomendada será renomear uma das atividades.
Como alternativa, se você sabe que o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID no
segmentationIdem vez de especificar o nome no camposegmentationName. O Campaign Manager também atribui um código à atividade do Floodlight, mas esse código é diferente do código do Search Ads 360 e não pode ser usado para atribuir conversões. Para ver o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API Reporting. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 será exibido no relatório.type: o tipo de conversão, ou seja,ACTIONouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO sim. Exemplos são inscrições em listas de e-mails (ACTION) x compras de e-commerce (TRANSACTION).Se você especificar
TRANSACTION, também precisará especificar o seguinte campo:revenueMicros: o valor monetário da conversão.
Campos opcionais
quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões ACTION, o Search Ads 360 inserirá automaticamente um valor de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é definida na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converterá o valor da receita especificada para a moeda do anunciante. Saiba mais
Use o formato alfabético ISO 4217 (3 caracteres) para especificar a moeda.
Aplicável apenas a conversões TRANSACTION.customMetricecustomDimension: faz upload de outros dados sobre uma conversão, como o país para onde um item comprado é enviado, os IDs dos produtos ou até mesmo a duração de uma chamada telefônica. Saiba mais sobre o upload de dados para variáveis personalizadas do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"criterionId": "43700003491981017", // Replace with your ID
"conversionId": "customerTransaction73126",
"conversionTimestamp": "1351196386000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Offline Purchase",
"type": "TRANSACTION",
"revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
"currencyCode": "USD"
}]
}
Java
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a keyword only.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'criterionId': '43700004289911004', // Replace with your ID
'conversionId': 'test_1378710000000',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Fazer upload de dados de um modelo de atribuição de terceiros
Os modelos de atribuição distribuem o crédito de uma conversão entre todas as atividades de um caminho de conversão. Por exemplo, se um consumidor clicar em um anúncio de pesquisa paga, um anúncio de display e outro anúncio de pesquisa paga antes de converter, um modelo de atribuição linear daria a cada clique 33% do crédito pela conversão.
Embora o Search Ads 360 forneça modelos de atribuição, se você usar um serviço de terceiros ou de desenvolvimento próprio para distribuir crédito por cliques, será possível fazer upload dos dados de atribuição de terceiros no Search Ads 360 e usá-los em relatórios e estratégias de lances do Search Ads 360.
Antes de começar
No Campaign Manager, crie um modelo de atribuição personalizado e importe-o para o Search Ads 360. Dê a ele o nome de Modelo de atribuição externo. Isso permite que os recursos do Search Ads 360 reconheçam que um modelo de atribuição foi aplicado aos dados de conversão enviados por você. Saiba mais
Campos obrigatórios
Para aplicar um modelo de atribuição de terceiros a uma conversão, especifique todas as opções a seguir na sua solicitação Conversion.insert():
clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Procure o ID de clique ou as conversões de lista nos registros da Web do anunciante e use um ID de clique de outra conversão. O Search Ads 360 atribuirá a conversão à palavra-chave, ao anúncio e a outros objetos do Search Ads 360 responsáveis por gerar a visita.
Aguarde pelo menos 30 minutos depois que o Search Ads 360 gerar um ID de clique para fazer o upload de uma conversão com esse ID. Caso contrário, a API Search Ads 360 poderá não reconhecer a visita.attributionModel: defina como External Attribution Model. Saiba mais.countMillis: o valor do crédito pela conversão a ser atribuído a esse clique. Aplicável somente se a solicitação também incluir o campoattributionModel.Não confunda isso com
quantityMillis, um campo opcional que especifica o número de itens em uma conversão (como o número de itens em uma compra no carrinho).conversionId: para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID significativo para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões no anunciante. No caso das conversões on-line, o Search Ads 360 copiadsConversionIdoufloodlightOrderIdpara essa propriedade, dependendo das instruções do Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer na sexta-feira, 5 de agosto de 2016, às 11:53:22 Horário de verão do Leste (GMT -4:00), especifique o carimbo de data/hora em milissegundos da época:1470412402000.segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. Atualmente, somente conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se elas pertencerem a diferentes grupos do Floodlight), a ação recomendada será renomear uma das atividades.
Como alternativa, se você sabe que o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID no
segmentationIdem vez de especificar o nome no camposegmentationName. O Campaign Manager também atribui um código à atividade do Floodlight, mas esse código é diferente do código do Search Ads 360 e não pode ser usado para atribuir conversões. Para ver o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API Reporting. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 será exibido no relatório.type: o tipo de conversão, ou seja,ACTIONouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO sim. Exemplos são inscrições em listas de e-mails (ACTION) x compras de e-commerce (TRANSACTION).Se você especificar
TRANSACTION, também precisará especificar o seguinte campo:revenueMicros: o valor monetário da conversão.
Se você acompanha a receita de conversões, verifique se o modelo distribui a receita em cada ponto de contato em um caminho de conversão.Por exemplo, se o modelo usar uma abordagem linear (distribuindo a receita igualmente em cada ponto de contato), em um caminho de conversão que inclui três cliques no anúncio, cada clique será atribuído com 33% da conversão. Se a conversão gerou uma receita de US $100, verifique se o modelo distribuiu US $33 de receita a cada clique e se revenueMicros deve especificar somente US $33 de receita para cada clique.
Campos opcionais
quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões ACTION, o Search Ads 360 inserirá automaticamente um valor de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é definida na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converterá o valor da receita especificada para a moeda do anunciante. Saiba mais
Use o formato alfabético ISO 4217 (3 caracteres) para especificar a moeda.
Aplicável apenas a conversões TRANSACTION.customMetricecustomDimension: faz upload de outros dados sobre uma conversão, como o país para onde um item comprado é enviado, os IDs dos produtos ou até mesmo a duração de uma chamada telefônica. Saiba mais sobre o upload de dados para variáveis personalizadas do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.
Exemplo
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"attributionModel": "External Attribution Model",
"countMillis": "330",
"revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
"currencyCode": "USD"
}]
}
Processar respostas do Search Ads 360
A resposta do Search Ads 360 vai indicar sucesso somente se todas as conversões na solicitação tiverem sido validadas e enviadas com sucesso.
Se a solicitação for bem-sucedida
Se a solicitação for bem-sucedida, a resposta incluirá a representação interna completa do Search Ads 360 para cada conversão enviada, como o ID da campanha, o ID do grupo de anúncios e o ID da palavra-chave (critério).
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700004289911004",
"adId": "0",
"dsConversionId": "48719131694768384",
"conversionId": "test_1383157331951",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368"
},
...
]
}
Se a solicitação não for bem-sucedida
Em caso de falha na validação ou no upload de uma ou mais conversões, a resposta inclui mensagens para cada upload de conversão com falha. A resposta não contém mensagens sobre conversões enviadas com êxito.
Veja um exemplo de resposta para uma solicitação que não é totalmente bem-sucedida:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
Cada mensagem de falha contém dois campos importantes: um motivo e uma mensagem de erro detalhada. O campo de motivo pode conter requestValidation, internalError, transactionFailed ou lateStageRequestError.
Erros de requestValidation
Os erros requestValidation indicam problemas de dados na solicitação de upload da conversão (por exemplo, a conversão já foi enviada ou o clickId não foi encontrado). Nesse tipo de erro, a mensagem details contém dois itens:
- Um código hexadecimal que identifica o tipo de erro. Você pode usar o código nos seus próprios scripts para identificar os erros.
- Uma descrição do erro de validação.
Para mais informações, consulte a lista de códigos e descrições que o Search Ads 360 pode retornar para erros de upload de conversões.
Outros tipos de erros
Todos os outros tipos de erro (internalError, transactionFailed ou lateStageRequestError) indicam que há um problema interno no Search Ads 360.
Como responder a um erro
Se a solicitação falhar, tente reenviar toda a chamada de solicitação mais tarde. O Search Ads 360 informará erros de requestValidation para todas as conversões que já foram enviadas, mas tentará fazer o upload das conversões restantes.
Se os erros persistirem após o reenvio, consulte a seção de solução de problemas para mais informações sobre como proceder.