Saiba mais sobre os pacotes selecionados

O curators.curatedPackages recurso permite criar e gerenciar programaticamente pacotes de inventário de editores que você seleciona em nome dos planejadores de mídia.

Os pacotes selecionados permitem agrupar inventários que atendem a critérios de segmentação específicos, como tipos de dispositivos, geografia e segmentos de dados, e atribuir uma taxa de curadoria cobrada quando os compradores ganham impressões segmentadas pelo pacote.

Entenda os principais conceitos

Antes de iniciar a integração, revise os campos e as configurações que definem como os pacotes selecionados funcionam:

Controlar quem pode acessar seus pacotes selecionados

Seus pacotes selecionados só podem ser acessados por planejadores de mídia a quem você concedeu acesso explicitamente usando o CuratedPackage.accessSettings campo. É necessário preencher o campo accessSettings quando o pacote selecionado é criado.

Você pode usar o método mediaPlanners.list para conferir uma lista de planejadores de mídia qualificados para serem especificados no campo CuratedPackage.accessSettings.allowlistedMediaPlanners.

Configurar o inventário segmentado pelo pacote selecionado

Você pode usar o CuratedPackage.targeting campo para especificar o inventário segmentado pelo pacote selecionado. O campo targeting é preenchido com o PackageTargeting objeto, que oferece suporte a critérios de segmentação, como tipo de dispositivo, formato do criativo, e localização geográfica.

Também é possível especificar a segmentação personalizada com o CuratedPackage.targeting.includedDataSegments campo. O campo includedDataSegments permite segmentar segmentos de dados gerenciados por você ou por outros parceiros de curadoria.

Entender a lógica de segmentação

Os valores em campos repetidos são processados usando um OR lógico, o que significa que uma impressão aplicável a qualquer um dos valores especificados é uma correspondência. Cada campo é processado usando um AND lógico, o que significa que todos os campos especificados precisam corresponder a uma determinada impressão para que o pacote selecionado apareça na solicitação de lance correspondente.

O exemplo a seguir cria um pacote selecionado com um campo CuratedPackage.targeting preenchido para segmentar uma combinação de tipos de dispositivos e segmentos de dados:

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

A tabela a seguir mostra se o pacote selecionado do exemplo segmenta uma impressão, em que cada linha é uma impressão distinta:

Tipo de dispositivo IDs do segmento de dados O pacote selecionado segmenta?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Sim
DEVICE_TYPE_PHONE 8172, 4321 Sim
DEVICE_TYPE_PHONE 9182 Não
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Não

Indicar o valor do pacote selecionado

É necessário definir uma taxa de curadoria usando o CuratedPackage.fee campo de união ao criar um pacote selecionado. Só é possível preencher um dos tipos de taxa com suporte do CuratedPackage objeto, por exemplo, o feeCpm campo. A taxa total de curadoria para uma determinada impressão é a soma da taxa do pacote selecionado e das taxas de todos os segmentos de dados segmentados aplicáveis à impressão.

Também é possível indicar o valor das impressões segmentadas pelo pacote selecionado definindo o CuratedPackage.floorPriceCpm campo, que pode influenciar o preço mínimo especificado para os bidders em lances em tempo real. O preço mínimo enviado aos bidders é o valor mais alto ao comparar o preço mínimo especificado no campo floorPriceCpm e a soma do preço mínimo do editor e da taxa total de curadoria.

A tabela a seguir mostra exemplos de como o preço mínimo efetivo enviado na solicitação de lance do pacote selecionado é calculado:

Preço mínimo do editor (CPM) Taxa total de curadoria (CPM) Preço mínimo do pacote selecionado (CPM) Preço mínimo efetivo (CPM)
R$ 7 R$ 2 R$ 10 R$ 10
R$ 4 R$ 1 R$ 4 R$ 5

Controlar a veiculação do pacote selecionado

Um pacote selecionado pode estar em um dos seguintes estados:

  • ACTIVE:o pacote selecionado está ativo. Os planejadores de mídia inscritos podem receber solicitações de lance de lances em tempo real que contenham o ID do pacote selecionado para o inventário segmentado.
  • INACTIVE:o pacote selecionado está inativo. O ID do pacote selecionado não aparece em solicitações de lance de lances em tempo real, mesmo para planejadores de mídia inscritos.

Próximas etapas

Para saber mais sobre os fluxos de trabalho que podem ser realizados com o recurso curatedPackages, revise o conteúdo a seguir: