Verifica dell'identità dell'inserzionista

Per offrire agli utenti un ecosistema pubblicitario sicuro e affidabile e rispettare le normative emergenti, Google ora richiede agli inserzionisti di completare uno o più programmi di verifica.

Se devi completare un programma di verifica, potrebbe essere impostata una scadenza per la procedura di verifica. Se la scadenza è passata senza che la verifica sia stata completata, il tuo account potrebbe essere messo in pausa.

Puoi anche sottoporti alla verifica in modo proattivo, anche se non è obbligatoria. IdentityVerificationService offre metodi per:

  • Recuperare lo stato della procedura di verifica per un account cliente, incluse eventuali scadenze
  • Avvia una procedura di verifica

Recuperare lo stato della verifica

Per recuperare lo stato della procedura di verifica dell'identità dell'inserzionista per un account cliente, chiama il metodo GetIdentityVerification:

Java

This example is not yet available in Java; you can take a look at the other languages.

C#

private static IdentityVerification GetIdentityVerification(
        GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V18.IdentityVerificationService);

    try {
        GetIdentityVerificationResponse response =
            identityVerificationService.GetIdentityVerification(
                new GetIdentityVerificationRequest()
                {
                    CustomerId = customerId.ToString()
                }
            );

            if (response.IdentityVerification.Count == 0)
            {
                return null;
            }

            IdentityVerification identityVerification = response.IdentityVerification[0];
            string deadline =
                identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime;
             IdentityVerificationProgress identityVerificationProgress =
                identityVerification.VerificationProgress;
            Console.WriteLine($"Account {customerId} has a verification completion " +
                $"deadline of {deadline} and status " +
                $"{identityVerificationProgress.ProgramStatus} for advertiser identity " +
                "verification.");

            return identityVerification;
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }


}
VerifyAdvertiserIdentity.cs

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

This example is not yet available in Python; you can take a look at the other languages.

Ruby

def get_identity_verification(client, customer_id)
  response = client.service.identity_verification.get_identity_verification(
    customer_id: customer_id
  )

  return nil if response.nil? || response.identity_verification.empty?

  identity_verification = response.identity_verification.first
  deadline = identity_verification.
    identity_verification_requirement.
    verification_completion_deadline_time
  progress = identity_verification.verification_progress
  puts "Account #{customer_id} has a verification completion deadline " \
    "of #{deadline} and status #{progress.program_status} for advertiser " \
    "identity verification."

  identity_verification
end
verify_advertiser_identity.rb

Perl

sub get_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $response = $api_client->IdentityVerificationService()->get({
    customerId => $customer_id
  });

  if (!defined $response->{identityVerification}) {
    printf "Account %s does not require advertiser identity verification.",
      $customer_id;
    return;
  }

  my $identity_verification = $response->{identityVerification}[0];
  my $deadline = $identity_verification->{identityVerificationRequirement}
    {verificationCompletionDeadlineTime};
  my $identity_verification_progress =
    $identity_verification->{verificationProgress};

  printf "Account %s has a verification completion deadline of %s and status " .
    "%s for advertiser identity verification.", $customer_id, $deadline,
    $identity_verification_progress->{programStatus};
  return $identity_verification;
}
verify_advertiser_identity.pl

Se l'account cliente è registrato al programma obbligatorio di verifica dell'identità dell'inserzionista, il servizio restituisce una risposta non vuota contenente un elenco di oggetti IdentityVerification. Una risposta vuota indica che non è necessario sottoporre l'account cliente alla verifica dell'identità dell'inserzionista.

L'API Google Ads supporta solo il programma ADVERTISER_IDENTITY_VERIFICATION, pertanto questo sarà l'unico elemento dell'elenco.

Un oggetto IdentityVerification contiene le seguenti proprietà:

  • Un IdentityVerificationRequirement che descrive le scadenze per iniziare e completare la procedura di verifica

  • Un IdentityVerificationProgress che descrive lo stato corrente della procedura di verifica: può includere anche l'URL di azione per consentire all'utente di completare la procedura di verifica.

Avvia il processo di verifica

Se un account cliente è registrato al programma obbligatorio di verifica dell'identità dell'inserzionista, GetIdentityVerification ha restituito una risposta non vuota con una scadenza per il completamento della procedura di verifica, puoi avviare una sessione di verifica chiamando StartIdentityVerification:

Java

This example is not yet available in Java; you can take a look at the other languages.

C#

private static void StartIdentityVerification(GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V18.IdentityVerificationService);

    StartIdentityVerificationRequest request = new StartIdentityVerificationRequest()
    {
        CustomerId = customerId.ToString(),
        VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification
    };

    try {
        identityVerificationService.StartIdentityVerification(request);
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
VerifyAdvertiserIdentity.cs

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

This example is not yet available in Python; you can take a look at the other languages.

Ruby

def start_identity_verification(client, customer_id)
  client.service.identity_verification.start_identity_verification(
    customer_id: customer_id,
    verification_program: :ADVERTISER_IDENTITY_VERIFICATION,
  )
end
verify_advertiser_identity.rb

Perl

sub start_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $request =
    Google::Ads::GoogleAds::V18::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
verify_advertiser_identity.pl

L'operazione andrà a buon fine solo se non è in corso un'altra sessione di verifica. Una volta avviata una sessione di verifica, le chiamate successive a GetIdentityVerification restituiranno l'URL di azione che l'utente deve completare la procedura di verifica e l'ora di scadenza dell'URL di azione.

Una volta trascorso il tempo di scadenza, puoi chiamare di nuovo StartIdentityVerification per avviare una nuova sessione di verifica.

Indietro
Modifica evento