Como usar macros para transmitir informações às tags do Floodlight

É possível transmitir informações baseadas em conversão para tags do editor usando as seguintes macros:

• Use %s para extrair o ID do site do Campaign Manager 360 do cookie do usuário. Link de IDs de site para tags específicas do editor.

  Analisar o ID do site do editor no cookie do usuário é um procedimento simples que insere esse código no local em que a macro %s é usada, como o campo da tag do editor ou o campo da tag padrão.

• Use %p para extrair informações atribuídas à tag do Floodlight na página do anunciante.

  A macro %p captura qualquer substring do caminho da solicitação, desde que corresponda ao padrão definido nos parâmetros dela. Além disso, após identificar sua correspondência, a macro passa essa informação pelo URL de redirecionamento.

• Anexe a macro %n para gerar um número aleatório, se necessário.

Exemplo

<iframe src="http://1234567.fls.doubleclick.net/ activityi;src=1234567;type=expglob;cat=kb123;u1=[PRODUCT_NAME];u2=[PRODUCT_ID];qty=1;cost=[Revenue];x=[Dsearch_prod_id];y=[Dsearch_prod_name];z=[Dsearch_price];da1=[Dsearch_quantity];ord=[OrderID]?"width="1" height="1" frameborder="0" style="display:none" ></iframe>

Quando o marcador do nome do produto do editor aceita apenas valor de 1 a 5, mas o anunciante implementou strings de texto em seu lugar, é necessário converter esses valores.

Um script semelhante a este pode executar a conversão adequada dos dados:

<SCRIPT LANGUAGE="JavaScript">
var pub_cost="%pcost=!;";
var pub_prod="%pu1=!;";
var pub_prod_id="%pu2=!;";
var pub_ord_id="%pord=!?";
var item=0;
switch (pub_prod){
case "hotel_room": item=1;
break;
case "flight": item=2;
break;
case "car_rental": item=3;
break;
case "time_share": item=4;
break;
case "package": item=5;
break;
default : item=0;
}
myImage=new Image();
myImage.src='https://www.publisher.com/u?CAMPAIGNID=1234567&ORDERID='+pub_ord+'&TYPE=89101112&ITEM='+item+'&AMOUNT='+pub_cost+'&QUANTITY=1&CURRENCY=GBP&METHOD=IMG';
</script>

Neste exemplo, é necessário converter a variável pub_cost em um número inteiro entre 1 e 5 antes de transmiti-la à tag do editor.

Para manipular os dados transmitidos pela tag do Floodlight, use uma instrução switch e mapeie os valores do servidor de anúncios para valores definidos pelo editor.

Talvez também seja necessário manipular os valores de custo e quantidade para que eles não prejudiquem a análise da conversão pelo editor.

As tags de atividade do Floodlight podem conter muitas variáveis que o site do anunciante preenche dinamicamente quando o código de atividade do Floodlight é exibido. Em alguns casos, é possível incluir as mesmas variáveis e valores nas tags dinâmicas (padrão ou de editor) que foram adicionadas à sua atividade do Floodlight. Para isso, use a macro de correspondência de padrão %p.

Usar %p para transmitir variáveis e valores para tags dinâmicas

A macro %p captura qualquer substring em um caminho de solicitação e, em seguida, transmite-a em um URL de redirecionamento. A macro usa o seguinte formato:

%p[start_key_string]![end_character]

Substitua [start_key_string] pela chave da chave-valor que você quer transmitir à tag padrão ou do editor. Por exemplo, se você transmitir o valor da chave-valor ord=, o [start_key_string] será ord=. Normalmente, [end_character] é um ponto e vírgula (;) que separa chaves-valor ou um ponto de interrogação (?) que finaliza a string. Por exemplo, a chave-valor completa para transmitir ord= será order=%pord=!?.

Exemplo de tag

Neste exemplo, você usa uma tag de GIF de 1 x 1 pixel para fins de rastreamento e inclui a tag em suas tags padrão.

Tag de marcador:

Aqui está a tag de 1 x 1 pixel com os marcadores das informações que você pretende incluir:

<img src="https://www.mywebsite.com?price=[price]&category=[category]&order=[orderID]" height="1" width="1" />

Com isso, você está criando novas chaves-valor. A nova chave pode ser o que você quiser (neste caso, price, category e order).

Tag com macros:

Com a macro %p, é possível substituir os marcadores da seguinte maneira:

<img src="https://www.mywebsite.com?price=%pcost=!;&category=%pu1=!;&order=%pord=!?" height="1" width="1" />

Para cada chave-valor, o valor é %p seguido da chave extraída da chave-valor original da tag do Floodlight, de um sinal de igual (=) e de um ponto de exclamação (!). É possível usar essa estrutura para importar qualquer chave-valor da tag original do Floodlight.

Se for a última chave-valor da tag, encerre com um ponto de interrogação (?). Encerre as outras chave-valor com ponto e vírgula (;). O separador original "e comercial" (&) permanece no lugar. Isso é necessário porque o ponto de interrogação e os pontos e vírgulas são removidos quando as macros são expandidas.

Tag com macros expandidas:

Quando as macros são expandidas, o novo valor é o valor original da chave de referência da macro %p.

<img src="https://www.mywebsite.com?price=19.95&category=books&order=BUY12834988?" height="1" width="1" />

Possíveis problemas

Veja alguns problemas que podem ocorrer ao passar as informações da tag do Floodlight para uma tag do editor de terceiros indiretos:

• Os parâmetros aplicam tipos de dados (string, inteiro e assim por diante)

• São esperados formatos numéricos diferentes (quantidade de casas decimais, limite máximo de dígitos, entre outros).

• Indicadores diferentes para os mesmos parâmetros em várias tags. Para o Floodlight, por exemplo, product=name_of_product, para tag do editor, product=integer_from_1_to_5, e assim por diante.

Tenha cuidado ao usar parâmetros nas tags. Os termos do seu contrato do Google Marketing Platform proíbem a transmissão de qualquer dado que possamos usar ou reconhecer como informações de identificação pessoal (PII, na sigla em inglês). Se você inserir certos valores em um campo de um produto do Google Marketing Platform, verá um aviso de que não é permitido usar parâmetros para transmitir dados que seriam reconhecidos como PII. Alguns nomes compatíveis com parâmetros que acionam esse aviso são email e username, entre outros. É permitido usar esses nomes se o objetivo não for coletar informações que o Google Marketing Platform possa usar ou reconhecer como PII.Por exemplo, uma variável personalizada com o nome compatível email e o valor weekly é aceitável, mas transmitir o endereço de e-mail de um usuário não é aceitável. Caso seja necessário, a DoubleClick poderá entrar em contato no futuro para verificar se os parâmetros não estão sendo usados de maneira indevida.

 

Saiba mais sobre as práticas recomendadas para evitar o envio de PII.