Chame o método Conversion.insert()
para adicionar uma ou mais conversões. Para atribuir adequadamente a conversão, sua solicitação
precisa especificar o nome de uma atividade do Floodlight que o anunciante está usando para gerar relatórios
conversões off-line, além do ID da palavra-chave, do anúncio e possivelmente do clique que levou à conversão. Para
informações sobre como conseguir IDs do Search Ads 360, consulte IDs e
Conversões.
Informações sobre as restrições ao upload de conversões históricas podem ser encontradas no Central de Ajuda do Search Ads 360.
Caso sua solicitação Conversion.insert() especifique várias conversões,
O Search Ads 360 tenta fazer o upload de cada conversão da melhor maneira possível, em vez de
fazer upload de todo o lote como uma transação "tudo ou nada". Se algumas conversões em um
não for possível fazer o upload do lote, outros ainda podem ser enviados. Os uploads de conversões podem falhar
devido a uma solicitação inválida ou falhas temporárias de rede ou do sistema. Portanto,
recomendamos que você leia a resposta para cada conversão inserida
confira se o upload foi bem-sucedido.
Quando posso usar os dados enviados?
Se você especificar um objeto
conversionTimestamp de hoje ou ontem para uma conversão, as métricas para a
conversão será exibida na interface do Search Ads 360 dentro de 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, você pode usar a API Campaign Manager para criar um. Não é possível usar a API para especificar que uma atividade do Floodlight é usada principalmente para conversões off-line, que é a melhor prática quando as estratégias de lances usarão dados da conversão.
Recomendamos que, depois de usar a API para criar uma configuração atividade, um usuário do Search Ads 360 faz login no Search Ads 360 e altera o valor para indicar que a fonte principal as conversões são atividades 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 para cada atividade do Floodlight usada 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. Consulte a Central de Ajuda do Search Ads 360 para obter instruções.
Faça o upload das conversões assim que elas estiverem disponíveis. Se você for atribuir conversões a visitas específicas, aguarde pelo menos 30 minutos após a visita antes de fazer o upload da conversão. Talvez o Search Ads 360 não reconheça o ID de clique da visita se que você enviou 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 um único de upload, pode ser que as entradas estejam fora de ordem cronológica. No entanto, uma estratégia de lances pode não consideramos as conversões mais antigas que você enviou depois em outra solicitação.
Se você esperar mais de 24 horas para fazer o upload de conversões para uma atividade do Floodlight, enviar 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 não fez o upload delas ainda assim, o carimbo de data/hora deve ser o horário em que a última conversão enviada o incidente. Isso informa ao Search Ads 360 que podem ter ocorrido conversões. nas últimas 24 horas, mas você ainda não forneceu os dados. Estratégias de lances e Outros sistemas automatizados só vão considerar o histórico de performance até o último conversão enviada.
- Se nenhuma conversão tiver ocorrido nas últimas 24 horas, o carimbo de data/hora deverá ser a hora e a data atuais. Isso informa ao Search Ads 360 que nenhuma que ocorreram durante as últimas 24 horas. Estratégias de lances e outras estratégias incluirão as últimas 24 horas (um dia inteiro sem conversões) conforme importante do histórico de desempenho.
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 você atribui a conversão. As seções a seguir listam os requisitos
e campos 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 do usuário no site do anunciante como uma visita.
Para atribuir uma conversão a uma visita, especifique o seguinte no seu Conversion.insert()
solicitação:
Campos obrigatórios
clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Confira no registros da Web do anunciante para o ID de clique ou as conversões de lista e use uma ID de clique de outra conversão. o Search Ads 360 atribuirá a conversão ao a palavra-chave, o anúncio e outros objetos do Search Ads 360 responsáveis por que gerou a visita.
Espere pelo menos 30 minutos depois de O Search Ads 360 gera um ID de clique para fazer o upload de conversões. Se você receber a mensagem "ID de clique não encontrado" um erro, aguarde quatro horas e faça o upload conversões novamente. Todas as conversões devem ser enviadas em até 90 dias após a o ID de clique é gerado. 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 que seja significativo para eles. Cada conversão em uma solicitação deve especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora deve ser exclusiva entre todas as conversões no anunciante. Para conversões on-line, o Search Ads 360 copia odsConversionIdou ofloodlightOrderIdnessa propriedade, dependendo das instruções de Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que o conversão ocorreu. Por exemplo, se o conversion ocorre na sexta-feira, 5 de agosto de 2016 às 11:53:22 AM, 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 que você está enviando conversão. No momento, somente conversões do Floodlight são compatíveis. Portanto, este campo é sempre necessário para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight em que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se as atividades pertencer a diferentes grupos do Floodlight), a ação recomendada é renomeie uma das atividades.
Como alternativa, se você souber o código que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID na
segmentationIdem vez de especificar o nome na no camposegmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas o ID do Campaign Manager é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversions.) Para acessar o ID do Search Ads 360 de uma atividade do Floodlight, faça o download do relatório de conversões (do a interface do Search Ads 360 ou a ferramenta de relatórios, API). Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, você verá o ID do Search Ads 360 no relatório.type: o tipo de conversão, ou seja,ACTION. ouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma TRANSACTION faz. Exemplos são inscrições em listas de e-mail (ACTION) versus compras de e-commerce (TRANSAÇÃO).Se você especificar
TRANSACTION, você também precisa 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 uma de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converte o valor da receita especificada para a moeda do anunciante. Saiba mais
Use a versão alfabética ISO 4217 (3 caracteres) formato para especificar a moeda.
Aplicável apenas para conversões TRANSACTION.customMetricecustomDimension: faz upload de mais dados sobre um conversão, como o país para o qual um item comprado é enviado, IDs de produtos ou até mesmo o com a duração de uma chamada telefônica. Saiba mais sobre fazer upload de dados para Variáveis do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para este .
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á atribuir anúncios, você pode omitir a maioria das consultas do Search Ads 360 identificadores e especifica apenas o identificador da palavra-chave junto com alguns outros campos:
Campos obrigatórios
criterionId: é o identificador de palavra-chave. Você pode conferir ocriterionIdadicionando oTrackerId. aos URLs da página de destino. Para informações sobre como obter IDs de palavras-chave, consulte Os IDs do Search Ads 360 e Conversões.conversionId: para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID que seja significativo para eles. Cada conversão em uma solicitação deve especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora deve ser exclusiva entre todas as conversões no anunciante. Para conversões on-line, o Search Ads 360 copia odsConversionIdou ofloodlightOrderIdnessa propriedade, dependendo das instruções de Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que o conversão ocorreu. Por exemplo, se o conversion ocorre na sexta-feira, 5 de agosto de 2016 às 11:53:22 AM, 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 que você está enviando conversão. No momento, somente conversões do Floodlight são compatíveis. Portanto, este campo é sempre necessário para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight em que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se as atividades pertencer a diferentes grupos do Floodlight), a ação recomendada é renomeie uma das atividades.
Como alternativa, se você souber o código que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID na
segmentationIdem vez de especificar o nome na no camposegmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas o ID do Campaign Manager é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversions.) Para acessar o ID do Search Ads 360 de uma atividade do Floodlight, faça o download do relatório de conversões (do a interface do Search Ads 360 ou a ferramenta de relatórios, API). Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o do relatório, você verá o ID do Search Ads 360 no relatório.type: o tipo de conversão, ou seja,ACTION. ouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma TRANSACTION faz. Exemplos são inscrições em listas de e-mail (ACTION) versus compras de e-commerce (TRANSAÇÃO).Se você especificar
TRANSACTION, você também precisa 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 uma de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converte o valor da receita especificada para a moeda do anunciante. Saiba mais
Use a versão alfabética ISO 4217 (3 caracteres) formato para especificar a moeda.
Aplicável apenas para conversões TRANSACTION.customMetricecustomDimension: faz upload de mais dados sobre um conversão, como o país para o qual um item comprado é enviado, IDs de produtos ou até mesmo o com a duração de uma chamada telefônica. Saiba mais sobre fazer upload de dados para Variáveis do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para este .
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
Um modelo de atribuição distribui o crédito de uma conversão entre todas atividade em 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 de pesquisa paga antes da conversão, um modelo de atribuição linear dar a cada clique 33% do crédito pela conversão.
O Search Ads 360 fornece modelos de atribuição, se você usa um serviço de terceiros desenvolvida para distribuir crédito por cliques, é possível fazer o upload dos dados de atribuição de terceiros no Search Ads 360 e usar os dados 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 no 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. Aprender mais
Campos obrigatórios
Para aplicar um modelo de atribuição de terceiros a uma conversão, especifique todas as opções a seguir em
sua solicitação Conversion.insert():
clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Confira no registros da Web do anunciante para o ID de clique ou as conversões de lista e use uma ID de clique de outra conversão. o Search Ads 360 atribuirá a conversão ao a palavra-chave, o anúncio e outros objetos do Search Ads 360 responsáveis por que gerou a visita.
Aguarde pelo menos 30 minutos depois de O Search Ads 360 gera um código de clique antes de fazer o upload de uma conversão com esse código. Caso contrário, a API Search Ads 360 poderá não reconhecer a visita.attributionModel: defina como External Attribution Model. Saiba maiscountMillis: 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 esse campo com
quantityMillis, um campo opcional que especifica Número de itens em uma conversão (como o número de itens em um carrinho de compras) compra).conversionId: para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID que seja significativo para eles. Cada conversão em uma solicitação deve especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora deve ser exclusiva entre todas as conversões no anunciante. Para conversões on-line, o Search Ads 360 copia odsConversionIdou ofloodlightOrderIdnessa propriedade, dependendo das instruções de Floodlight do anunciante.conversionTimestamp: indica a data e a hora em que o conversão ocorreu. Por exemplo, se o conversion ocorre na sexta-feira, 5 de agosto de 2016 às 11:53:22 AM, 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 que você está enviando conversão. No momento, somente conversões do Floodlight são compatíveis. Portanto, este campo é sempre necessário para especificarFLOODLIGHT.segmentationName: o nome da atividade do Floodlight em que o anunciante está usando para registrar a conversão.Se o anunciante tiver atividades com o mesmo nome (isso poderá acontecer se as atividades pertencer a diferentes grupos do Floodlight), a ação recomendada é renomeie uma das atividades.
Como alternativa, se você souber o código que o Search Ads 360 atribuiu a uma atividade do Floodlight, é possível especificar o ID na
segmentationIdem vez de especificar o nome na no camposegmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas o ID do Campaign Manager é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversions.) Para acessar o ID do Search Ads 360 de uma atividade do Floodlight, faça o download do relatório de conversões (do a interface do Search Ads 360 ou a ferramenta de relatórios, API). Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o do relatório, você verá o ID do Search Ads 360 no relatório.type: o tipo de conversão, ou seja,ACTION. ouTRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma TRANSACTION faz. Exemplos são inscrições em listas de e-mail (ACTION) versus compras de e-commerce (TRANSAÇÃO).Se você especificar
TRANSACTION, você também precisa 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 entre 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 ganhou US $100 em receita, verifique se seu modelo distribui US $33 de receita para cada clique, e certifique-se de que revenueMicros especifique 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 uma de1000.currencyCode: a moeda da receita de uma transação. Por padrão, a receita é na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 converte o valor da receita especificada para a moeda do anunciante. Saiba mais
Use a versão alfabética ISO 4217 (3 caracteres) formato para especificar a moeda.
Aplicável apenas para conversões TRANSACTION.customMetricecustomDimension: faz upload de mais dados sobre um conversão, como o país para o qual um item comprado é enviado, IDs de produtos ou até mesmo o com a duração de uma chamada telefônica. Saiba mais sobre fazer upload de dados para Variáveis do Floodlight.deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para este .
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 indica sucesso somente se todas as conversões em a solicitação foi validada e enviada.
Se a solicitação for bem-sucedida
Se a solicitação for bem-sucedida, a resposta incluirá a documentação interna completa representação para cada conversão enviada, como ID da campanha, ID do grupo de anúncios e 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
Se uma ou mais conversões não forem validadas ou carregadas, a resposta incluirá mensagens para cada upload de conversão com falha. A resposta não contém mensagens sobre conversões que enviado.
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 um erro detalhado mensagem. O campo de motivo pode conter requestValidation, internalError, transactionFailed ou lateStageRequestError.
Erros de requestValidation
Erros de requestValidation indicam problemas de dados no upload da conversão (por exemplo, o upload da conversão já foi feito ou o clickId não foi encontrado). Neste 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 no seu próprio 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 em caso de erros no upload de conversões.
Outros tipos de erros
Todos os outros tipos de erros (internalError, transactionFailed, ou lateStageRequestError) indicam que há um problema interno no no Search Ads 360.
Como responder a um erro
Se a solicitação falhar, tente reenviar toda a chamada de solicitação mais tarde. Search Ads 360. informará erros de requestValidation para todas as conversões que foram já tiver sido enviado, mas tentará fazer o upload das conversões restantes.
Se os erros continuarem ocorrendo após o reenvio, consulte solução de problemas para saber como proceder.