O recurso de conversão tem métodos que permitem aos usuários criar, modificar e recuperar conversões do Floodlight em massa.
Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
Uma lista de conversões.
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "customerId": string, "adGroupId": long, "criterionId": long, "adId": long, "clickId": string, "dsConversionId": long, "conversionId": string, "state": string, "type": string, "revenueMicros": long, "currencyCode": string, "quantityMillis": long, "segmentationType": string, "segmentationId": long, "segmentationName": string, "conversionTimestamp": unsigned long, "conversionModifiedTimestamp": unsigned long, "floodlightOrderId": string, "customMetric": [ { "name": string, "value": double } ], "customDimension": [ { "name": string, "value": string } ], "countMillis": long, "attributionModel": string, "productGroupId": long, "inventoryAccountId": long, "productId": string, "productCountry": string, "productLanguage": string, "channel": string, "storeId": string, "deviceType": string, "adUserDataConsent": string } ] }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
conversion[] |
list |
As conversões solicitadas. | |
conversion[].adGroupId |
long |
ID do grupo de anúncios do DS. | |
conversion[].adId |
long |
ID do anúncio da DS. | |
conversion[].adUserDataConsent |
string |
Representa o consentimento para preferências dos serviços principais de plataforma (CPS) nas configurações. Nenhum valor padrão. Os valores aceitáveis são: GRANTED: o status de consentimento desejado é "concedido". Leia as preferências de CPS nas configurações de GTE. NEGADO: o status de consentimento desejado é negar. A lista de CPS está vazia. | |
conversion[].advertiserId |
long |
ID do anunciante do DS | |
conversion[].agencyId |
long |
ID da agência do DS. | |
conversion[].attributionModel |
string |
Disponível para anunciantes somente após entrar em contato com o suporte ao cliente do DoubleClick Search. | |
conversion[].campaignId |
long |
ID da campanha do DS. | |
conversion[].channel |
string |
Canal de vendas do produto. Os valores aceitáveis são:
|
|
conversion[].clickId |
string |
ID de clique do DS para a conversão. | |
conversion[].conversionId |
string |
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 do anunciante. Para conversões on-line, o DS copia dsConversionId ou floodlightOrderId para essa propriedade, dependendo das instruções do Floodlight do anunciante. |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
A hora em que a conversão foi modificada pela última vez, em época em milissegundos UTC. | |
conversion[].conversionTimestamp |
unsigned long |
A hora em que a conversão ocorreu, em época em milissegundos UTC. | |
conversion[].countMillis |
long |
Disponível para anunciantes somente após entrar em contato com o suporte ao cliente do DoubleClick Search. | |
conversion[].criterionId |
long |
ID do critério (palavra-chave) do DS. | |
conversion[].currencyCode |
string |
O código da moeda para a receita da conversão. Precisa estar no formato alfabético ISO 4217 (3 caracteres). | gravável |
conversion[].customDimension[] |
list |
Dimensões personalizadas da conversão, que podem ser usadas para filtrar dados em um relatório. | |
conversion[].customDimension[].name |
string |
Nome da dimensão personalizada. | |
conversion[].customDimension[].value |
string |
Valor da dimensão personalizada. | |
conversion[].customMetric[] |
list |
Métricas personalizadas para a conversão. | |
conversion[].customMetric[].name |
string |
Nome da métrica personalizada. | |
conversion[].customMetric[].value |
double |
Valor numérico da métrica personalizada. | |
conversion[].customerId |
string |
ID de cliente do novo Search Ads 360. Precisa ser uma conta de cliente. Quando esse campo é definido, todos os outros campos de ID precisam ser definidos como IDs do novo Search Ads 360. | |
conversion[].deviceType |
string |
O tipo de dispositivo em que a conversão ocorreu.
Os valores aceitáveis são:
|
|
conversion[].dsConversionId |
long |
ID que o DoubleClick Search gera para cada conversão. | |
conversion[].engineAccountId |
long |
ID da conta de mecanismo do DS. | |
conversion[].floodlightOrderId |
string |
O ID do pedido do Floodlight fornecido pelo anunciante para a conversão. | |
conversion[].inventoryAccountId |
long |
Código que o DS gera e usa para identificar de maneira exclusiva a conta de inventário que contém o produto. | |
conversion[].productCountry |
string |
O país registrado no feed do Merchant Center que contém o produto. Use um código ISO 3166 para especificar um país. | |
conversion[].productGroupId |
long |
ID do grupo de produtos do DS. | |
conversion[].productId |
string |
O ID do produto (SKU). | |
conversion[].productLanguage |
string |
O idioma registrado no feed do Merchant Center que contém o produto. Use um código ISO 639 para especificar um idioma. | |
conversion[].quantityMillis |
long |
A quantidade desta conversão, em milissegundos. | gravável |
conversion[].revenueMicros |
long |
O valor da receita desta conversão de TRANSACTION , em micros (valor multiplicado por 1000.000, sem números decimais). Por exemplo, para especificar um valor de receita de "10", insira "10000000" (10 milhões) em sua solicitação. |
gravável |
conversion[].segmentationId |
long |
O identificador de segmentação numérica (por exemplo, o ID de atividade do Floodlight do DoubleClick Search). | |
conversion[].segmentationName |
string |
O identificador de segmentação de fácil utilização (por exemplo, o nome da atividade do Floodlight do DoubleClick Search). | |
conversion[].segmentationType |
string |
É o tipo de segmentação dessa conversão (por exemplo, FLOODLIGHT ).
Os valores aceitáveis são os seguintes:
|
|
conversion[].state |
string |
O estado da conversão, ou seja, ACTIVE ou REMOVED . Observação: o estado DELETED foi descontinuado.
Os valores aceitáveis são os seguintes:
|
gravável |
conversion[].storeId |
string |
O código da loja local em que o produto foi anunciado. Aplicável apenas quando o canal é "local ". |
|
conversion[].type |
string |
O tipo de conversão, ou seja, ACTION ou TRANSACTION . Uma conversão de ACTION é uma ação do usuário que não tem um valor monetariamente quantificável, enquanto uma conversão TRANSACTION é uma ação que tem um valor monetariamente quantificável. Exemplos: inscrições em listas de e-mails (ACTION ) e compras de e-commerce (TRANSACTION ).
Os valores aceitáveis são:
|
|
kind |
string |
Identifica isso como um recurso ConversionList. Valor: a string fixa doubleclicksearch#conversionList . |
Métodos
- get
- Recupera uma lista de conversões de uma conta de mecanismo do DoubleClick Search.
- getByCustomerId
- Recupera uma lista de conversões de uma conta de mecanismo do DoubleClick Search usando um novo ID de cliente do Search Ads 360.
- inserir
- Insere um lote de novas conversões no DoubleClick Search.
- update
- Atualiza um lote de conversões no DoubleClick Search.
- updateAvailability
- Atualiza as disponibilidades de um lote de atividades do Floodlight no DoubleClick Search.