Condividi tramite

TargetedLocationSelector

  • Articolo

Contiene i metodi per filtrare e ordinare un elenco di posizioni di destinazione. Per informazioni sui selettori, vedere Selettori.

Utilizzo di esempio:

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var iterator = shoppingCampaign.targeting().targetedLocations()
        .withLimit(10)
        .withIds("123456789")
        .get();

    while (iterator.hasNext()) {
        var targetedLocation = iterator.next();
    }

Metodi

Nome metodo Tipo restituito Descrizione
forDateRange(Object dateFrom, Object dateTo) TargetedLocationSelector Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.
forDateRange(string dateRange) TargetedLocationSelector Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni.
Ottieni TargetedLocationIterator Ottiene un iteratore utilizzato per scorrere l'elenco di posizioni di destinazione.
orderBy(string orderBy) TargetedLocationSelector Applica l'ordinamento specificato alle posizioni di destinazione selezionate.
withCondition(string condition) TargetedLocationSelector Applica i criteri di filtro alle posizioni di destinazione.
withIds(string[] ids) TargetedLocationSelector Ottiene le posizioni di destinazione con gli ID specificati.
withLimit(int limit) TargetedLocationSelector Ottiene le prime n posizioni di destinazione che corrispondono ai criteri di selezione.

forDateRange(Object dateFrom, Object dateTo)

Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.

Specificare un intervallo di date solo se:

  • Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
  • Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il getStats() metodo .

È possibile specificare i parametri di data usando stringhe o oggetti . Per utilizzare le stringhe, specificare la data nel formato AAAAMMGG. Se si usano oggetti , creare un oggetto con i campi seguenti:

  • Anno
  • Mese
  • Giorno

Ad esempio:

var date = {year: 2018, month: 5, day: 13};

Il mese è in base uno, dove 1 è gennaio e 12 dicembre.

L'intervallo di date è inclusivo. Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Nome Tipo Descrizione
dateFrom Oggetto Data di inizio dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.
dateTo Oggetto Data di fine dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con intervallo di date applicato.

forDateRange(String dateRange)

Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni.

Valori dell'intervallo di date supportati:

  • OGGI
  • IERI
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Specificare un intervallo di date solo se:

  • Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
  • Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il getStats() metodo .

Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Nome Tipo Descrizione
dateRange Stringa Stringa di intervallo di date predefinita che specifica i dati sulle prestazioni da includere nel selettore. La stringa di intervallo di date predefinita fa distinzione tra maiuscole e minuscole.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con intervallo di date applicato.

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco di posizioni di destinazione.

Restituisce

Tipo Descrizione
TargetedLocationIterator Iteratore usato per scorrere le posizioni di destinazione selezionate.

orderBy(string orderBy)

Applica l'ordinamento specificato alle posizioni di destinazione selezionate.

Specificare il parametro orderBy nel formato "columnName orderDirection" dove:

  • columnName è una delle colonne supportate.
  • orderDirection è l'ordine in cui ordinare i risultati. Impostare su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. Il valore predefinito è ASC.

Ad esempio, la chiamata seguente restituisce risultati in ordine crescente in base a AverageCpc.

selector = selector.orderBy("AverageCpc");

I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco di entità per campo x e all'interno di x per campo y e così via. Se si specificano più chiamate orderBy() in una catena o in chiamate selettore separate, Script ordina l'elenco di entità usando il campo specificato nell'ultima orderBy() chiamata. 

Argomenti

Nome Tipo Descrizione
Orderby stringa Ordinamento da applicare.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con ordinamento applicato.

withCondition(String condition)

Applica i criteri di filtro alle posizioni di destinazione.

Specificare il parametro condition nel formato "columnName operator value" dove:

Operatori

L'operatore usato dipende dal tipo della colonna. Gli operatori fanno distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH anziché starts_with.

Operatori per le colonne che contengono valori interi e valori lunghi:

<
<=
>
>=
=
!=

Operatori per le colonne che contengono valori double:

<
>

Operatori per le colonne che contengono valori stringa:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatori per le colonne che contengono valori di enumerazione:

=
!=
IN []
NOT_IN []

Operatori per le colonne che contengono una matrice di stringhe:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonne supportate per il filtro della posizione di destinazione. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole.

Di seguito sono riportate le colonne delle metriche delle prestazioni che è possibile specificare.

Colonna Tipo Esempio Filtro dell'interfaccia utente Web di Microsoft Advertising
AbsoluteTopImpressionRate Doppia withCondition("AbsoluteTopImpressionRate > 0.25") Abs. Top Impr. Tasso
AverageCpc Doppia withCondition("AverageCpc < 2.75") Media CPC
AverageCpm Doppia withCondition("AverageCpm > 0.65") Media CPM
ClickConversionRate Doppia withCondition("ClickConversionRate > 0.25") Frequenza conv.
Clic long withCondition("Clicks >= 33") Clic
ConvertedClicks long withCondition("ConvertedClicks >= 10") Conv.
Costo Doppia withCondition("Cost > 3.25")

Il costo è nella valuta del conto.		 Trascorrere
Ctr Doppia withCondition("Ctr > 0.05")

Il CTR è compreso nell'intervallo 0..1, quindi usare 0,05 per un CTR del 5%.		 CTR
Impression long withCondition("Impressions > 10") Impr.
TopImpressionRate Doppia withCondition("TopImpressionRate > 0.25") Impr superiore. Tasso

Argomenti

Nome Tipo Descrizione
Condizione stringa Condizione da aggiungere al selettore.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene le posizioni di destinazione con gli ID specificati.

È possibile applicare una o più condizioni a un selettore. Una catena di condizioni è considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è true E la condizione B è true. Ad esempio, la chiamata seguente seleziona solo la posizione di destinazione 72.

var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

var iterator = shoppingCampaign.targeting().targetedLocations()
    .withIds(["32", "72"])
    .withIds(["72", "190"]);

Argomenti

Nome Tipo Descrizione
Id string[] Matrice di ID percorso di destinazione. Per i limiti, vedere Limiti di esecuzione dello script.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene le prime n posizioni di destinazione che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di posizioni di destinazione da restituire. Il numero effettivo può essere minore.

Restituisce

Tipo Descrizione
TargetedLocationSelector Selettore con limite applicato.

Vedere anche