Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Le coppie chiave-valore possono essere utilizzate per scegliere il target degli annunci in modo più granulare rispetto alle unità pubblicitarie. Scopri di più sulle coppie chiave-valore.
Per ogni richiesta di annuncio, puoi passare una o più chiavi, ciascuna con uno o più valori associati. Queste coppie chiave-valore verranno valutate in base alle opzioni di targeting
configurate a livello di elemento pubblicitario in Ad Manager. Ad esempio, se trasmetti una coppia chiave-valore personalizzata age=18-34, gli elementi pubblicitari indirizzati alla fascia d'età 18-34 saranno idonei alla pubblicazione, a patto che tutti gli altri criteri siano soddisfatti.
Impostare il targeting
Puoi specificare coppie chiave-valore per configurare il targeting sia a livello di area annuncio sia
a livello di pagina in base alle esigenze della tua rete.
A livello di slot
Ti consente di impostare coppie chiave-valore per le singole aree annuncio nella pagina.
Il targeting a livello di area annuncio ti consente di configurare il targeting in base a ogni area annuncio.
Questo è utile nei casi in cui i singoli slot della stessa pagina richiedono un targeting diverso, ma può essere inefficiente in situazioni in cui le stesse coppie chiave-valore vengono applicate a tutti gli slot. Utilizza
Slot.setTargeting() per utilizzare il targeting
a livello di slot, come nell'esempio seguente.
A livello di pagina
Ti consente di impostare coppie chiave-valore in tutte le aree annuncio della pagina.
Il targeting a livello di pagina garantisce che tutte le aree annuncio abbiano lo stesso insieme di coppie chiave-valore. In alcuni casi, questo potrebbe ridurre la quantità totale di codice necessaria per configurare il targeting. Utilizza
googletag.pubads().setTargeting() per utilizzare
il targeting a livello di pagina, come nell'esempio seguente.
In questo esempio sono definite due aree annuncio che specificano l'unità pubblicitaria/6355419/Travel/Asia e le dimensioni dell'annuncio 728x90. Successivamente, il targeting per chiave-valore viene applicato per limitare ulteriormente e differenziare gli annunci che possono essere pubblicati in ogni spazio.
Quando vengono utilizzati sia il targeting a livello di area annuncio sia quello a livello di pagina, le coppie chiave-valore vengono combinate
e solo gli annunci che soddisfano tutti i criteri saranno idonei alla pubblicazione in una determinata area annuncio.
In questo esempio, il targeting effettivo per ogni area è:
Area annuncio
Targeting efficace
1
color=red AND position=atf AND interests=basketball
2
position=btf AND interests=basketball
Scegli come target più chiavi o valori
Nell'esempio precedente è stata utilizzata una combinazione di targeting a livello di area annuncio e di pagina per definire più chiavi di targeting per una singola area annuncio. Ecco alcuni metodi alternativi per ottenere lo stesso targeting efficace:
Solo targeting a livello di slot
In questo esempio, le coppie chiave-valore condivise vengono ripetute per ogni area annuncio.
È anche possibile scegliere come target più valori per una singola chiave fornendo un array di valori quando chiami setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Targeting chiaro
Una volta impostato il targeting, le coppie chiave-valore configurate verranno inviate con ogni richiesta di annuncio per tutta la durata dell'area annuncio. In alcuni casi, tuttavia, potrebbe essere opportuno modificare il targeting nel tempo. Sebbene setTargeting() possa essere utilizzato per aggiungere e sovrascrivere le coppie chiave-valore, non è possibile rimuoverle in questo modo.
Per farlo, devi utilizzare Slot.clearTargeting() o
googletag.pubads().clearTargeting().
Quando clearTargeting() viene chiamato con una chiave specifica (a livello di slot o di pagina), viene rimossa solo quella chiave. Se non viene specificata alcuna chiave, tutto il targeting a quel livello viene rimosso.
Nell'esempio precedente, il targeting effettivo per l'area annuncio dopo ogni
passaggio è:
Passaggio
Targeting efficace
0
color=red AND position=atf AND interests=basketball
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-11-23 UTC."],[[["\u003cp\u003eKey-values offer granular ad targeting beyond ad units, enhancing ad relevance by enabling specific criteria like age or interests for ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eSlot-level targeting allows customization for individual ad slots, while page-level targeting applies to all slots on a page, streamlining setup when uniform targeting is desired.\u003c/p\u003e\n"],["\u003cp\u003eCombining slot- and page-level targeting creates layered targeting, where ads must satisfy all criteria to be eligible for serving, enhancing ad precision.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Ad Manager has functions for clearing targeting, such as \u003ccode\u003eclearTargeting()\u003c/code\u003e, which allows removal of specific keys or all targeting at a particular level, providing flexibility in dynamic ad scenarios.\u003c/p\u003e\n"]]],["Key-values refine ad targeting at the slot or page level. Slot-level targeting uses `Slot.setTargeting()` for individual ad slots. Page-level targeting, using `googletag.pubads().setTargeting()`, applies to all slots. Both can be combined, with slot-level values taking precedence. Multiple values for one key are set using an array. To remove key-values use `Slot.clearTargeting()` or `googletag.pubads().clearTargeting()`. Remember, page-level key values can be modified but not removed at the slot level.\n"],null,["# Key-value targeting\n\nKey-values can be used to target ads more granularly than ad units. Learn more\nabout [key-values](//support.google.com/admanager/answer/188092).\n| **Warning:** Use key-value targeting with care. Under the terms of your contract, you must not pass any data that Google Ad Manager could [use or recognize as\n| personally identifiable information](//support.google.com/admanager/answer/7686480).\n\nFor each ad request, you may pass one or more keys, each with one or more\nassociated values. These key-values will be evaluated against targeting options\nconfigured at the line item-level in Ad Manager. For example, if\nyou pass a custom key-value of `age=18-34`, line items targeted to the age range\n18-34 will be eligible to serve, assuming all other criteria matches.\n\nSet targeting\n-------------\n\nYou may specify key-values to configure targeting at both the slot- and\npage-level based on your network's needs.\n\nSlot-level\n\n: Allows you to set key-values for individual ad slots on your page.\n\n Slot-level targeting allows you to configure targeting on a per-slot basis.\n This is useful in cases where individual slots on the same page require\n different targeting, but can be inefficient in situations where the same\n key-values are applied to all slots. Use\n [`slot.setConfig({ targeting: ... })`](/publisher-tag/reference#googletag.config.SlotSettingsConfig.targeting) to utilize\n slot-level targeting, as in the following example.\n\nPage-level\n\n: Allows you to set key-values across all ad slots on your page.\n\n Page-level targeting ensures that all ad slots have the same set of\n key-values. In some cases this may reduce the total amount of code needed to\n configure targeting. Use\n [`googletag.setConfig({ targeting: ... })`](/publisher-tag/reference#googletag.config.PageSettingsConfig.targeting) to\nutilize page-level targeting, as in the following example. \n\n```javascript\nwindow.googletag = window.googletag || { cmd: [] };\n\n// GPT slots\nlet adSlots = [];\n\ngoogletag.cmd.push(() =\u003e {\n // Configure slot-level targeting.\n adSlots[0] = googletag\n .defineSlot(\"/6355419/Travel/Asia\", [728, 90], \"banner-ad-1\")\n .addService(googletag.pubads());\n adSlots[0].setConfig({\n targeting: {\n color: \"red\",\n position: \"atf\",\n },\n });\n\n adSlots[1] = googletag\n .defineSlot(\"/6355419/Travel/Asia\", [728, 90], \"banner-ad-2\")\n .addService(googletag.pubads());\n adSlots[1].setConfig({\n targeting: {\n position: \"btf\",\n },\n });\n\n // Configure page-level targeting and enable SRA.\n googletag.setConfig({\n targeting: {\n interests: \"basketball\",\n },\n singleRequest: true,\n });\n\n // Enable services.\n googletag.enableServices();\n});\n```\n\nIn this example, two ad slots are defined which specify ad unit\n`/6355419/Travel/Asia` and ad size `728x90`. Then key-value targeting is\napplied to further restrict and differentiate the ads which may serve in each\nslot.\n\nWhen both slot- and page-level targeting are used, the key-values are combined\nand only ads satisfying all criteria will be eligible to serve to a given slot.\nIn this example, the effective tageting for each slot is:\n\n| Ad slot | Effective targeting |\n|---------|-------------------------------------------------------|\n| 1 | `color=red AND position=atf AND interests=basketball` |\n| 2 | `position=btf AND interests=basketball` |\n\n| **Note:** If the same targeting key is defined at both the page- and slot-level, the slot-level value will take precedence for that slot.\n\n### Target multiple keys or values\n\nIn the preceding example, a combination of slot- and page-level targeting was\nused to define multiple targeting keys for a single ad slot. Here are some\nalternative approaches to achieve the same effective targeting: \n\n### Slot-level targeting only\n\nIn this example, shared key-values are repeated for each ad slot. \n\n // Slot-level targeting with multiple keys.\n adSlots[0] = googletag\n .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')\n .addService(googletag.pubads());\n adSlots[0].setConfig({\n targeting: {\n color: 'red',\n position: 'atf',\n interests: 'basketball'\n }\n });\n adSlots[1] = googletag\n .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')\n .addService(googletag.pubads());\n adSlots[1].setConfig({\n targeting: {\n position: 'btf',\n interests: 'basketball'\n }\n });\n\n### Page-level default targeting\n\nIn this example, default targeting is set at the page-level and overridden\nat the slot-level as necessary.\n**Caution:** Key-values set at the page-level cannot be cleared at the slot-level, only modified. \n\n // Page-level default targeting.\n googletag.setConfig({\n targeting: {\n interests: 'basketball',\n position: 'btf'\n }\n });\n\n // Slot-level targeting overrides.\n adSlots[0] = googletag\n .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')\n .addService(googletag.pubads());\n adSlots[0].setConfig({\n targeting: {\n color: 'red',\n position: 'atf'\n }\n });\n adSlots[1] = googletag\n .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')\n .addService(googletag.pubads());\n\nIt's also possible to target multiple values for a single key by providing an\narray of values when calling `setConfig()`: \n\n // Page-level targeting with multiple values for a single key.\n googletag.setConfig({ targeting: { interests: ['baseball', 'basketball'] } });\n\nClear targeting\n---------------\n\nOnce targeting has been set, the configured key-values will be sent with every\nad request for the life of the ad slot. In some circumstances, however, it may\nbe desirable for targeting to change over time. While `setConfig()` can be\nused to add and overwrite key-values, it's not possible to remove them this way.\nTo accomplish that, you must clear the targeting by setting the value to `null`\nin the `setConfig()` method. \n\n```javascript\n// Step 0, define slot- and page-level targeting.\nadSlots[0] = googletag\n .defineSlot(\"/6355419/Travel/Asia\", [728, 90], \"banner-ad-1\")\n .addService(googletag.pubads());\nadSlots[0].setConfig({\n targeting: {\n color: \"red\",\n position: \"atf\",\n },\n});\n\ngoogletag.setConfig({\n targeting: {\n interests: \"basketball\",\n },\n singleRequest: true,\n});\n\n// Step 1, clear slot-level color targeting.\nadSlots[0].setConfig({\n targeting: {\n color: null,\n },\n});\n\n// Step 2, clear all page-level targeting.\ngoogletag.setConfig({\n targeting: null,\n});\n```\n\nWhen `clearTargeting()` is called with a specific key (either at the\nslot- or page- level), only that key is removed. When no key is specified, all\ntargeting at that level is removed.\n\nIn the preceding example, the effective targeting for the ad slot after each\nstep is:\n\n| Step | Effective targeting |\n|------|-------------------------------------------------------|\n| 0 | `color=red AND position=atf AND interests=basketball` |\n| 1 | `position=atf AND interests=basketball` |\n| 2 | `position=atf` |"]]
